Paraguay
DNIT / SIFEN
Sección titulada «DNIT / SIFEN»En Paraguay, la facturación electrónica está a cargo de la DNIT (Dirección Nacional de Ingresos Tributarios) a través de SIFEN, el Sistema Integrado de Facturación Electrónica Nacional (conocido también como e-Kuatia). A diferencia de otros países de la región, Paraguay no exige pasar por un proveedor autorizado (PAC): la emisión es directa contra los Web Services de la DNIT.
Cómo funciona
Sección titulada «Cómo funciona»Los nodos de Paraguay en Floogos hablan directamente con SIFEN por SOAP con TLS mutuo: el certificado .p12 del contribuyente autentica cada llamada, no solo firma el documento.
- El nodo arma el XML del Documento Electrónico (DE) y calcula el CDC (Código de Control, 44 dígitos) — el identificador único del comprobante ante la DNIT.
- El DE se firma con XMLDSig usando el certificado .p12 de la credencial.
- Se envía por SOAP con TLS mutuo, de forma síncrona para un único DE o asíncrona para lotes de hasta 50 DE.
- La DNIT devuelve un código de aprobación o rechazo; el DE queda idempotente por CDC, así que reintentar el mismo envío no genera un duplicado.
El IVA en Paraguay tiene tres tasas: 10% (tasa general), 5% (bienes de primera necesidad) y 0% (exento).
Cuándo queda válido un DE
Sección titulada «Cuándo queda válido un DE»Un Documento Electrónico queda legalmente válido cuando la DNIT lo aprueba, tras el envío síncrono o la consulta del resultado (estado “Aprobado”, código 0260). Hasta ese momento el DE está firmado, pero no autorizado. Los DE enviados en lote quedan pendientes hasta que se consulta el resultado con el protocolo devuelto (dProtConsLote).
Nodos disponibles
Sección titulada «Nodos disponibles»| Nodo | Función |
|---|---|
| SifenEmitirDE | Emitir factura electrónica: arma el XML, calcula el CDC, firma y envía por SOAP/TLS |
| SifenEnviarLote | Enviar un lote de hasta 50 DE de forma asíncrona |
| SifenConsultarLote | Consultar el resultado de un lote enviado y reconciliar cada DE |
| SifenConsultarDE | Consultar el estado de un DE individual por su CDC |
| SifenConsultarRUC | Consultar un RUC en el padrón de la DNIT |
| SifenCancelarDE | Cancelar un DE ya aprobado mediante un evento firmado |
| SifenKuDE | Generar el KuDE (representación gráfica con QR) del DE |
Flujo típico
Sección titulada «Flujo típico»- SifenConsultarRUC (opcional) — validar al receptor antes de emitir
- SifenEmitirDE (un único DE) o SifenEnviarLote (varios DE en simultáneo) — emitir el o los comprobantes
- SifenConsultarDE o SifenConsultarLote — verificar la aprobación, sobre todo tras un lote asíncrono
- SifenKuDE — generar el comprobante visual con QR para entregar al receptor
- SifenCancelarDE — si hace falta anular, dentro del plazo que fija la DNIT
Credencial
Sección titulada «Credencial»Todos los nodos comparten una credencial de tipo sifen, con el certificado digital (.p12) del contribuyente, su contraseña, el RUC del emisor, el establecimiento y punto de expedición habilitados, el CSC (Código de Seguridad del Contribuyente) para el QR del KuDE, y el ambiente (test o prod).
- El ambiente de prueba (SIFEN Test) y el de producción son bases completamente separadas: un CDC generado en test no existe en producción.
- El certificado .p12 vencido bloquea la emisión y la cancelación (los nodos lo validan antes de firmar), pero no bloquea las consultas de solo lectura.