Cómo Funciona Sifende
Arquitectura general de Sifende — tu sistema, la API, SIFEN y el flujo completo de un documento electrónico.
Sifende actúa como una capa de integración entre tu sistema (ERP, e-commerce, software propio) y SIFEN, el Sistema Integrado de Facturación Electrónica Nacional administrado por la DNIT. Tu sistema solo habla JSON con Sifende. Toda la complejidad de SOAP, XML, XSD, firma digital XAdES y reintentos queda absorbida del lado nuestro.
Arquitectura general
Tu negocio
Tu sistema genera la venta y se comunica con nosotros.
SifenDE
Validamos, firmamos y enviamos por vos.
DNIT
Procesa y aprueba la factura electrónica.
Flujo de una factura electrónica
Tu sistema envía un POST con JSON al endpoint de Sifende con los datos del documento (receptor, ítems, condición de pago).
Sifende valida el payload contra las reglas de SIFEN: RUC del receptor, formato de campos, totales, IVA, timbrado vigente, numeración disponible.
Sifende construye el XML según el Manual Técnico V150 y todas las Notas Técnicas vigentes. Calcula el CDC (Código de Control) de 44 caracteres y se lo asigna al documento.
Sifende firma el XML con tu certificado P12 (que se guarda de forma segura desde la configuración inicial). La firma usa XAdES-BES, como exige SIFEN.
Sifende empaqueta el documento en un lote y lo transmite a SIFEN vía SOAP (siRecepLoteDE). SIFEN responde al toque con un identificador de lote.
Sifende retorna el CDC a tu sistema. La respuesta es síncrona: en cuestión de segundos recibís el código que identifica al documento.
Sifende consulta los resultados (siResultLoteDE) cada 60 segundos hasta obtener el veredicto de SIFEN. El documento pasa a estado APROBADO o RECHAZADO.
Tu sistema consulta el estado vía GET /api/v1/documento-electronico/status/:cdc o recibe la confirmación por webhook (próximamente).
¿Qué hace Sifende por vos?
| Responsabilidad | Sifende | Tu sistema |
|---|---|---|
| Validar campos de SIFEN | ✅ | — |
| Generar XML según Manual Técnico V150 | ✅ | — |
| Calcular CDC y dígito verificador | ✅ | — |
| Firmar con certificado digital P12 | ✅ | — |
| Comunicación SOAP con e-kuatia | ✅ | — |
| Reintentos y backoff ante caídas de SIFEN | ✅ | — |
| Consulta periódica de resultados | ✅ | — |
| Generar el KuDE (representación gráfica) | ✅ | — |
| Enviar el JSON con los datos comerciales | — | ✅ |
| Guardar el CDC retornado | — | ✅ |
La respuesta inmediata de Sifende contiene el CDC. El estado final APROBADO o RECHAZADO llega minutos después, cuando SIFEN procesa el lote. Ver Ciclo de Vida.
Componentes internos
- API REST: recibe los requests JSON de tu sistema (autenticada con API key).
- Motor de generación de DE: construye el XML respetando el formato exigido por SIFEN.
- Worker asíncrono: envía lotes y firma documentos en background.
- Scheduler de consulta: corre cada 60 segundos para obtener resultados de lotes pendientes.
- Panel web: para gestionar contribuyentes, certificados, timbrados y monitorear documentos.
Próximos pasos
- Autenticación: cómo identificarte ante la API.
- Documentos Electrónicos: qué tipos podés emitir.
- Ciclo de Vida: qué pasa después de emitir.