Publicamos Egeek.Sifen 0.4.0, una nueva versión estable del núcleo open source para integrar aplicaciones .NET con SIFEN. Este incremento mejora la cercanía entre el contrato de software y la terminología fiscal oficial, y completa el flujo stateless de eventos sin incorporar persistencia ni decisiones propias de cada negocio.
El problema que abordamos
Los códigos numéricos dispersos son difíciles de leer, validar y mantener. Además, emitir documentos electrónicos no cubre todo el ciclo operativo: una integración también necesita generar, firmar, enviar y conciliar eventos como cancelaciones, conformidades o actualizaciones de transporte.
La versión 0.4.0 reemplaza los catálogos cerrados por valores simbólicos y agrega una superficie tipada para los eventos SIFEN v150. El resultado es un contrato más explícito para consumidores de la librería y de la WebApi.
Qué incorpora 0.4.0
- Catálogos simbólicos compartidos entre DTO, validación, generación XML, WebApi y OpenAPI.
- Catálogos oficiales de actividades económicas y obligaciones tributarias.
- Generación y firma de eventos de cancelación, inutilización, recepción, conformidad, disconformidad, desconocimiento, nominación y actualización de transporte.
- Envío SOAP de uno a quince eventos firmados con resultados funcionales correlacionados.
- Consulta de documentos con conciliación y tipo normalizado para los eventos asociados.
- Controles opt-in para que las pruebas reales no transmitan información accidentalmente.
Cómo lo verificamos
La release aprobó 392 pruebas automatizadas, compilación sin advertencias, auditoría sin vulnerabilidades conocidas y pruebas de consumo desde los cuatro paquetes publicados. También validamos el host WebApi publicado y completamos una matriz controlada de aceptación contra SIFEN TEST, sin reintentos automáticos.
Compatibilidad y límites
Esta versión contiene cambios incompatibles respecto a 0.3.x: los consumidores deben migrar los códigos numéricos de catálogos cerrados a nombres simbólicos. El core continúa siendo stateless; no incorpora base de datos, scheduler, polling automático ni almacenamiento fiscal. Tampoco incluye todavía Boleta de Venta Electrónica ni Boleta Resimple Electrónica.
Egeek.Sifen es un proyecto independiente y no es un producto oficial de la DNIT. Cada implementación sigue siendo responsable de su validación fiscal, jurídica y operativa.
Instalación
dotnet add package Egeek.Sifen.Infrastructure --version 0.4.0Recursos
El siguiente incremento se definirá a partir de necesidades verificables de integración, manteniendo la separación entre el núcleo open source y las decisiones empresariales de cada implementación.