SfeFirmador.Core 1.2.9

SfeFirmador

Libreria .NET para la generacion, validacion y firma digital de documentos fiscales electronicos del Sistema de Facturacion Electronica (SFE) del Servicio de Impuestos Nacionales (SIN) de Bolivia.

Instalacion

dotnet add package SfeFirmador.Core

El paquete SfeFirmador.Domain (interfaces) se instala automaticamente como dependencia.

Requisitos

• .NET 10 SDK

Estructura del proyecto

SfeFirmadorSolution.sln
|
|-- SfeFirmador.Domain        # Interfaces y contratos (ICabecera, IDetalle, IDocumentoSector, etc.)
|-- SfeFirmador.Core           # Logica de negocio, entidades, generacion XML y firma digital
|-- SfeFirmador.Client         # Aplicacion de consola de ejemplo
|-- SfeFirmador.Test           # Tests unitarios (MSTest)

Configuracion

Las credenciales (clave privada RSA, certificado digital, CUIS, CUFD y codigo de control) se manejan via archivos appsettings.json que estan excluidos del repositorio por seguridad.

1. Crear el archivo de configuracion

Copiar la plantilla y completar con sus credenciales:

cp SfeFirmador.Client/appsettings.example.json SfeFirmador.Client/appsettings.json

Estructura del archivo:

{
  "Firmador": {
    "ClavePrivada": "-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----",
    "CertificadoDigital": "-----BEGIN CERTIFICATE-----\n...\n-----END CERTIFICATE-----",
    "Cuis": "SU_CUIS",
    "Cufd": "SU_CUFD",
    "CodigoControl": "SU_CODIGO_CONTROL"
  }
}

2. Para los tests

Crear SfeFirmador.Test/appsettings.test.json con la misma estructura usando credenciales de prueba.

Compilar

dotnet build SfeFirmadorSolution.sln

Ejecutar tests

dotnet test SfeFirmador.Test/SfeFirmador.Test.csproj

Uso basico

using Microsoft.Extensions.Configuration;
using SfeFirmador.Core.Core;
using SfeFirmador.Core.Enum;
using System.Text.Json;

// Cargar configuracion
var configuration = new ConfigurationBuilder()
    .SetBasePath(AppContext.BaseDirectory)
    .AddJsonFile("appsettings.json")
    .Build();

var section = configuration.GetSection("Firmador");
string clavePrivada = section["ClavePrivada"];
string certificadoDigital = section["CertificadoDigital"];

// Serializar la factura a JSON
string jsonData = JsonSerializer.Serialize(factura);

// Generar documento fiscal (XML firmado o sin firmar segun modalidad)
var respuesta = DocumentoFiscal.ObtenerDocumentoFiscal(
    jsonData,
    certificadoDigital,
    clavePrivada,
    TipoDocumentoSectorEnum.FacturaCompraVenta,
    TipoModalidadEnum.FacturaElectronicaLinea
);

// Resultado
byte[] archivo = respuesta.Archivo;       // XML como byte array
string hashArchivo = respuesta.HashArchivo; // Hash SHA-256
string xml = respuesta.Xml;               // XML como string

Tipos de documento soportados

La libreria soporta 53 tipos de documento fiscal en modalidad computarizada y electronica:

Arquitectura

DocumentoFiscal

Punto de entrada principal. Utiliza un registro de tipos (diccionario) para mapear la combinacion (TipoDocumentoSector, TipoModalidad) al tipo de entidad concreto, eliminando la necesidad de metodos individuales por tipo de documento.

Tres flujos de procesamiento:

• Estandar - Documentos con cabecera + List<detalle> (la mayoria)
• Boleto Aereo - Solo cabecera (sin detalle)
• Conciliacion - cabecera + List<detalleOriginal> + List<detalleConciliacion>

Modalidades

• Factura Electronica - Genera XML, firma digital con certificado X.509 y valida la firma
• Factura Computarizada - Genera XML sin firma digital

Validacion

Los objetos se validan automaticamente usando DataAnnotations antes de generar el XML.

Paquetes NuGet utilizados

Autor

Deyvi Josue Ortiz Vidaurre

Licencia

Proyecto privado. Todos los derechos reservados.