Acontplus.FactElect 1.2.2

Acontplus.FactElect

A comprehensive .NET 9+ library for electronic invoicing and digital document handling in Ecuador, providing models, services, and utilities to facilitate integration with SRI (Servicio de Rentas Internas) systems.

🚀 Features

• Electronic document models (invoices, credit notes, etc.)
• XML document generation, validation, and parsing
• SRI (Ecuadorian Tax Authority) web service integration
• Document validation and verification
• CAPTCHA handling for human verification processes
• ID card (cédula) and RUC validation
• XML to HTML/PDF document conversion
• Token-based authentication management
• Dependency Injection support

📦 Installation

NuGet Package Manager

Install-Package Acontplus.FactElect

.NET CLI

dotnet add package Acontplus.FactElect

PackageReference

<ItemGroup>
  <PackageReference Include="Acontplus.FactElect" Version="1.0.17" />
</ItemGroup>

🎯 Quick Start

1. Configure Services

// In Startup.cs or Program.cs
services.AddFactElectServices(Configuration);

2. Configuration in appsettings.json

{
  "FactElect": {
    "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

• ICedulaService, IRucService - Ecuadorian ID and RUC validation
• IXmlService - XML generation and parsing
• ISriWebService - SRI integration and authentication
• IDocumentConverter - XML to HTML/PDF conversion
• ComprobanteElectronico - Electronic document model
• ResponseSri - SRI response model

🤝 Contributing

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

Development Setup

git clone https://github.com/Acontplus-S-A-S/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 S.A.S. - Enterprise software solutions

Built with ❤️ for the .NET community