Acontplus.Billing 1.3.0

Acontplus.Billing

A comprehensive .NET library for electronic invoicing and digital document handling in Ecuador, fully compliant with SRI (Servicio de Rentas Internas) normatives v2.32. Provides complete support for all electronic document types, XML generation, validation, parsing, and web service integration.

🚀 Features

📋 Complete SRI Document Type Support

All 6 electronic document types according to SRI Ficha Técnica v2.32:

• ✅ Factura (01) - Invoice with embedded XSD schemas (v1.0.0, v1.1.0, v2.0.0, v2.1.0)
• ✅ Liquidación de Compra (03) - Purchase Settlement with XSD validation (v1.0.0)
• ✅ Nota de Crédito (04) - Credit Note with schemas (v1.0.0, v1.1.0)
• ✅ Nota de Débito (05) - Debit Note with XSD validation (v1.0.0)
• ✅ Guía de Remisión (06) - Delivery Guide with schema support (v1.0.0)
• ✅ Comprobante de Retención (07) - Withholding Receipt with schemas (v1.0.0, v2.0.0)

🔧 Core Capabilities

• XML Generation: Complete XML document generation for all SRI document types
• XML Parsing: Robust parsing and deserialization of SRI-authorized documents
• XSD Validation: Embedded XSD schemas for all document types and versions
• SRI Web Services: Full integration with SRI authentication and submission endpoints
• Document Conversion: XML to HTML/PDF rendering for all document types
• ATS Support: Anexo Transaccional Simplificado (ATS) generation and parsing
• Identity Validation: Ecuadorian ID card (cédula) and RUC format/checksum verification
• Reimbursement Support: Complete reimbursement (reembolsos) handling
• Payment Methods: Multi-payment method support with installment tracking
• Additional Info: Flexible additional information fields (up to 15 custom fields)

📦 Installation

NuGet Package Manager

Install-Package Acontplus.Billing

.NET CLI

dotnet add package Acontplus.Billing

PackageReference

<ItemGroup>
  <PackageReference Include="Acontplus.Billing" Version="1.3.0" />
</ItemGroup>

🎯 Quick Start

1. Register Services

// In Program.cs - register Billing services
services.AddSingleton<IWebServiceSri, WebServiceSri>();
services.AddSingleton<IDocumentConverter, DocumentConverter>();
services.AddSingleton<IElectronicDocumentService, ElectronicDocumentService>();
// Add other services as needed

2. Configuration in appsettings.json

{
  "Billing": {
    "Environment": "Development",
    "ValidateBeforeSend": true,
    "DefaultTimeoutSeconds": 30,
    "DocumentStoragePath": "Documents",
    "CompanyRuc": "0991234567001",
    "CompanyLegalName": "ACME COMPANY S.A.",
    "CompanyCommercialName": "ACME",
    "EnableCaching": true,
    "CacheDurationMinutes": 60,
    "SriConnection": {
      "BaseUrl": "https://celcer.sri.gob.ec/",
      "TimeoutSeconds": 30,
      "MaxRetryAttempts": 3,
      "ValidateSslCertificate": true
    }
  }
}

3. Usage Examples

Parse an SRI-Authorized XML Document

public class DocumentParser
{
    private readonly IElectronicDocumentService _documentService;
    public DocumentParser(IElectronicDocumentService documentService) => _documentService = documentService;

    public ComprobanteElectronico? Parse(string xmlContent)
    {
        var xmlDoc = new XmlDocument();
        xmlDoc.LoadXml(xmlContent);
        return _documentService.TryParseDocument(xmlDoc, out var comprobante, out _) ? comprobante : null;
    }
}

Send Document to SRI

public class DocumentSender
{
    private readonly IWebServiceSri _sriService;
    public DocumentSender(IWebServiceSri sriService) => _sriService = sriService;

    public async Task<ResponseSri> ReceiveAsync(string xmlSigned, string receptionUrl)
        => await _sriService.ReceptionAsync(xmlSigned, receptionUrl);

    public async Task<ResponseSri> AuthorizeAsync(string claveAcceso, string authorizationUrl)
        => await _sriService.AuthorizationAsync(claveAcceso, authorizationUrl);
}

Convert XML to HTML for Display

public class DocumentRenderer
{
    private readonly IDocumentConverter _converter;
    public DocumentRenderer(IDocumentConverter converter) => _converter = converter;
    public string RenderDocument(string xmlContent) => _converter.ConvertToHtml(xmlContent);
}

📚 API Documentation

Document Type Constants

using Acontplus.Billing.Constants;

// Access document type codes
DocumentTypes.Factura;                  // "01"
DocumentTypes.LiquidacionCompra;        // "03"
DocumentTypes.NotaCredito;              // "04"
DocumentTypes.NotaDebito;               // "05"
DocumentTypes.GuiaRemision;             // "06"
DocumentTypes.ComprobanteRetencion;     // "07"

// Get document name
var name = DocumentTypes.GetDocumentName("01"); // "Factura"

// Validate document code
bool isValid = DocumentTypes.IsValidDocumentCode("01"); // true

Core Services

• IWebServiceSri - SRI SOAP web service: document reception, authorization, and XML retrieval
• IDocumentConverter - XML to HTML/PDF conversion for all document types
• IXmlDocumentParser - Parse SRI-authorized XML documents
• IAtsXmlService - Generate ATS (Anexo Transaccional Simplificado) XML
• IElectronicDocumentService - High-level document management
• IDocumentValidator - XSD schema validation
• ISriSigner - XAdES-BES electronic signature for SRI Ecuador

Document Models

All document types include complete model classes:

• ComprobanteElectronico - Base electronic document container
• InfoFactura - Invoice information
• InfoLiquidacionCompra - Purchase settlement information
• InfoNotaCredito - Credit note information
• InfoNotaDebito - Debit note information with motivos
• InfoGuiaRemision - Delivery guide information
• InfoCompRetencion - Withholding information
• Destinatario - Delivery guide recipients with details
• DocSustento - Supporting documents with retentions and reimbursements

✍️ XAdES-BES Electronic Signature

SriSigner provides a native, cross-platform implementation of the XAdES-BES signature required by SRI Ecuador, replicating the MITyCLibXADES output format.

Register the service

services.AddSingleton<ISriSigner, SriSigner>();

Sign a comprobante

public class SigningService(ISriSigner signer)
{
    /// <summary>
    /// Signs the comprobante XML and sends it to SRI for reception.
    /// </summary>
    public string SignAndSend(string xmlUnsigned, string claveAcceso)
    {
        // Load the PFX certificate from disk or a secret store.
        byte[] pfxBytes = File.ReadAllBytes("certificate.p12");
        string password = Environment.GetEnvironmentVariable("CERT_PASSWORD")!;

        // Returns the signed XML string ready for SriService.ReceptionAsync().
        return signer.Sign(xmlUnsigned, password, pfxBytes, claveAcceso);
    }
}

Typical full workflow

public class ElectronicInvoiceWorkflow(ISriSigner signer, IWebServiceSri sri)
{
    private const string ReceptionUrl = "https://celcer.sri.gob.ec/comprobantes-electronicos-ws/RecepcionComprobantesOffline";
    private const string AuthUrl      = "https://celcer.sri.gob.ec/comprobantes-electronicos-ws/AutorizacionComprobantesOffline";

    public async Task<string> ProcessAsync(
        string xmlUnsigned, string claveAcceso,
        byte[] pfxBytes,    string pfxPassword)
    {
        // 1. Sign
        string xmlSigned = signer.Sign(xmlUnsigned, pfxPassword, pfxBytes, claveAcceso);

        // 2. Send to SRI
        ResponseSri reception = await sri.ReceptionAsync(xmlSigned, ReceptionUrl);
        if (reception.Estado != "RECIBIDA")
            throw new InvalidOperationException($"SRI rejected the document: {reception.Estado}");

        // 3. Authorize
        ResponseSri auth = await sri.AuthorizationAsync(claveAcceso, AuthUrl);
        return auth.NumeroAutorizacion ?? throw new InvalidOperationException("Authorization failed.");
    }
}

Signature details