Glosario SIFEN
Conceptos clave
Antes de integrar la API, conviene entender los términos del sistema de facturación electrónica paraguayo (e-Kuatia) y cómo DiFACT los abstrae.
SIFEN
El Sistema Integrado de Facturación Electrónica Nacional es la plataforma de la SET (Subsecretaría de Estado de Tributación) que recibe, valida y almacena todos los documentos electrónicos tributarios del Paraguay. DiFACT se conecta a SIFEN en nombre de tu empresa usando tu certificado digital.
CDC (Código de Control)
El Código de Control es un identificador único de 44 dígitos que SIFEN asigna a cada documento electrónico. Es inmutable y se usa para consultar el estado del documento en cualquier momento. DiFACT lo expone como el campo cdc en la respuesta de cada factura.
{
"cdc": "01800695631001001000101001000007942024060111111111"
}KuDE
El Komprobante de Documento Electrónico es el PDF que se entrega al receptor como representación visual del documento. No tiene valor tributario por sí solo, pero es el comprobante estándar de la transacción. DiFACT genera el KuDE automáticamente y lo expone vía endpoint de descarga.
XML del DE
El Documento Electrónico en formato XML firmado digitalmente es el documento con validez tributaria ante SIFEN. DiFACT genera el XML, lo firma con tu certificado y lo envía. También podés descargarlo para tus registros.
Timbrado
El timbrado es la autorización de la SET para emitir documentos de un determinado tipo (factura, nota de crédito, remisión…) en un rango de numeración. DiFACT gestiona tus timbrados activos automáticamente y selecciona el correcto según el tipo de documento a emitir.
Tipos de documento
| Código | Tipo | Descripción |
|---|---|---|
1 | Factura electrónica | Documento principal de venta de bienes o servicios. |
4 | Autofactura electrónica | Emitida cuando el receptor no posee RUC. |
5 | Nota de crédito electrónica | Reversión total o parcial de una factura. |
6 | Nota de débito electrónica | Ajuste por diferencia de precio. |
7 | Remisión electrónica | Traslado de mercaderías (sin efecto tributario directo). |
Estados de un documento
Cada factura pasa por los siguientes estados a lo largo de su ciclo de vida:
| Estado | Descripción |
|---|---|
| pending | Documento generado, en cola para envío a SIFEN. |
| sent | Enviado a SIFEN, esperando respuesta de validación. |
| approved | Aprobado por SIFEN. Documento válido tributariamente. |
| rejected | Rechazado por SIFEN por errores en los datos. |
| cancelled | Anulado. Solo posible antes de que el receptor lo acepte. |
e-Kuatia vs. e-Kuatia'i
Paraguay tiene dos regímenes de FE. DiFACT opera bajo e-Kuatia (integración vía API), el régimen para empresas con volumen que integran sus sistemas de gestión directamente con SIFEN. e-Kuatia'i es el portal web de la SET para emisión manual individual y no es reemplazado por DiFACT.
