Acontplus.Billing 1.1.6

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 validation with digit verification
• CAPTCHA Handling: Automated CAPTCHA processing for SRI web interactions
• Token Management: Secure token-based authentication with automatic renewal
• 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.2.0" />
</ItemGroup>

🎯 Quick Start

1. Register Services

// In Startup.cs or Program.cs
// Services are registered manually or through your DI container
// Example:
services.AddSingleton<ICedulaService, CedulaService>();
services.AddSingleton<IRucService, RucService>();
// 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

Validate Ecuadorian ID Card

public class IdentityValidator
{
    private readonly ICedulaService _cedulaService;
    public IdentityValidator(ICedulaService cedulaService) => _cedulaService = cedulaService;
    public bool ValidateIdentity(string cedula) => _cedulaService.ValidateCedula(cedula);
}

Generate Electronic Invoice XML

public class InvoiceGenerator
{
    private readonly IXmlService _xmlService;
    public InvoiceGenerator(IXmlService xmlService) => _xmlService = xmlService;
    public string GenerateInvoice(ComprobanteElectronico comprobante) => _xmlService.GenerateInvoiceXml(comprobante);
}

Send Document to SRI

public class DocumentSender
{
    private readonly ISriWebService _sriService;
    public DocumentSender(ISriWebService sriService) => _sriService = sriService;
    public async Task<ResponseSri> SendDocumentAsync(string xmlContent, string username, string password)
    {
        var token = await _sriService.AuthenticateAsync(username, password);
        return await _sriService.SendDocumentAsync(xmlContent, token);
    }
}

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

• ICedulaService, IRucService - Ecuadorian ID and RUC validation with checksum verification
• IWebServiceSri - SRI web service authentication and document submission
• 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

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

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

git clone https://github.com/acontplus/acontplus-dotnet-libs.git
cd acontplus-dotnet-libs
dotnet restore
dotnet build

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🆘 Support

• 📧 Email: proyectos@acontplus.com
• 🐛 Issues: GitHub Issues
• 📖 Documentation: Wiki

👨‍💻 Author

Ivan Paz - @iferpaz7

🏢 Company

Acontplus - Software solutions

Built with ❤️ for the .NET community