Documento Electrónico Paraguay (DE-PY)

Documento Electrónico Paraguay (DE) — Factura, Auto-factura, Nota de Crédito/Débito enviadas al SIFEN de la SET

Esta wiki cubre el Documento Electrónico (DE) de Paraguay. Cada factura emitida en Quaza Paraguay se registra en el SIFEN (sistema oficial de la SET) y recibe un CDC de 44 dígitos como prueba fiscal. El público es el cliente operador (oficina del proveedor), no el desarrollador.

Por qué existe el DE

Desde 2022, la SET (Subsecretaría de Estado de Tributación) exige que toda factura en Paraguay se registre electrónicamente en el SIFEN (Sistema Integrado de Facturación Electrónica Nacional). Cada factura recibe un CDC (Código de Control, 44 dígitos) que permite a la SET cruzar ingresos/egresos en tiempo real.

Quaza no se comunica directamente con el SIFEN — usa el FacturaSend como gateway intermediario, que se encarga de la firma digital, la cola de envío y los webhooks de actualización de estado.

Flujo general — de la factura al KuDE

Toda factura paraguaya sigue un ciclo de 4 etapas principales. Cada paso del operador puede hacerse manualmente (haciendo clic en el botón) o automáticamente (mediante una tarea programada).

Glosario

Tipos de Documento Electrónico (tiDE) — cobertura en Quaza

CDC — Código de Documento

El CDC es el identificador único global de cada documento electrónico, generado por el SIFEN. Tiene 44 dígitos y se devuelve tras la aprobación. No puede ser personalizado por el usuario — es el control fiscal Paraguayo.

Pantalla de Documentos Electrónicos

Acceso por el menú — haga clic en el ícono ☰ en la esquina superior izquierda, expanda el grupo FISCAL (marcado en rojo) y seleccione DOCUMENTO ELECTRÓNICO (también marcado).

Listado

Pantalla Listar documentos Electrónicos — columnas: ícono imprimir KuDE (IMP), atajo editar (lápiz), código, tipo (Factura/Auto-factura/NC/ND), establecimiento, cliente, número, tipo de transacción, fecha de emisión, fecha de transmisión al SIFEN, período, valor total en guaraníes (Gs.), situación (8 estados) y modificador. Botón verde marcado (1) arriba a la derecha: Agregar documento Electrónico manualmente.

Detalle — factura recién creada

Detalle de una factura en situación Creado. El CDC todavía está vacío — solo se completa después de la aprobación del SIFEN. Botón marcado (1) Procesar a la derecha: haga clic ahí (o deje que la tarea lo haga) para enviar al SIFEN.

Detalle — factura aprobada

La misma pantalla con la factura Aprobado y el CDC completado (44 dígitos). Botones marcados a la derecha: 1 Cancelar (hasta 48h de la aprobación), 2 Nota de crédito (reduce el valor), 3 Nota de débito (aumenta el valor). Una factura aprobada es inmutable — cualquier ajuste exige una NC o ND.

Detalle — factura rechazada

Cuando el SIFEN devuelve un error, la factura queda Rechazado SIFEN. Haga clic en Acciones arriba a la derecha para ver el motivo del rechazo, corrija el dato problemático y haga clic en Procesar nuevamente. Puede reenviar las veces que necesite dentro de 30 días.

Generar un DE a partir de una venta/mensualidad

El Documento Electrónico no nace solo — siempre se genera a partir de un documento financiero que ya existe en Quaza (una venta, un cobro de deuda o un lote de pagos). Hay 3 caminos:

Pantalla Editar venta — el botón azul Generar factura (marcado en verde, 1) aparece a la derecha cuando la venta todavía no tiene un Documento Electrónico asociado. Haga clic para abrir el popup de generación.

Pantalla Editar registro (mensualidad/cuota) — botón azul Generar factura (marcado en verde, 1) entre los demás botones de acción (Eximir débito, Generar renegociación, Crear cobranza, etc.). Aparece solo en mensualidades sin DE asociado.

Pantalla Listar recibos (Lote de pagos) — botón verde Generar facturas (marcado, 1) en la esquina superior derecha. Úselo para emitir DEs de varias cobranzas de una sola vez (facturación mensual).

Los 8 estados del DE

Estados completos del DE-PY

Anatomía del documento — JSON y XML e-Kuatia

El Documento Electrónico pasa por dos representaciones antes de llegar al SIFEN:

1. JSON — Quaza arma los datos de la factura en ese formato y los envía al FacturaSend.
2. XML e-Kuatia — el FacturaSend convierte el JSON en el XML oficial del SIFEN (formato e-Kuatia), lo firma con el certificado digital y lo transmite.

Rara vez necesitará abrir esos archivos, pero conocer la estructura ayuda a entender los rechazos.

1. El JSON que Quaza envía

Resumen de los campos principales (varios campos opcionales fueron omitidos):

{
"tipoDocumento": 1,            # 1=Factura · 4=Autofactura · 5=Nota de crédito
# 6=Nota de débito · 7=Nota de remisión
"establecimiento": "001",
"punto": "001",
"numero": 1234567,
"fecha": "2026-05-14T10:30:00",
"tipoEmision": 1,              # 1=Normal · 2=Contingencia
"tipoTransaccion": 1,          # Venta de mercadería, prestación de servicio...
"tipoImpuesto": 1,             # 1=IVA
"moneda": "PYG",               # Guaraníes (o USD, BRL...)
"cliente": {
"ruc": "80012345-6",           # o Cédula / Pasaporte
"razonSocial": "Cliente Ejemplo",
"tipoContribuyente": 1,        # 1=Persona física · 2=Persona jurídica
"email": "cliente@ejemplo.com.py",
"direccion": "Av. Ejemplo 123",
"ciudad": "Asunción",
"departamento": "Central"
},
"items": [
{
"codigo": 1,
"descripcion": "Internet 100 Mbps - mensualidad Mayo/2026",
"unidadMedida": 77,           # 77=Unidad (tabla e-Kuatia)
"cantidad": 1,
"precioUnitario": 150000,      # en guaraníes
"ivaTipo": 1,                 # 1=Gravado · 2=Exonerado · 3=Exento
"iva": 10                     # alícuota: 10% o 5%
}
]
}

2. El XML e-Kuatia que el FacturaSend genera

El FacturaSend transforma el JSON de arriba en el XML oficial del SIFEN. La raíz es con el namespace http://ekuatia.set.gov.py/sifen/xsd:

<rde xmlns="http://ekuatia.set.gov.py/sifen/xsd">
<de id="01800123456...">          # Id = CDC, 44 dígitos
<ddvid>2</ddvid>                  # dígito verificador del CDC
<dfecfirma>2026-05-14T10:30:05</dfecfirma>
<gopede> ... </gopede>            # datos de la operación
<gtimb> ... </gtimb>              # timbrado (autorización SET)
<gdatgralope>
<gemis> ... </gemis>              # emisor: su empresa
<gdatrec> ... </gdatrec>          # receptor: el cliente
</gdatgralope>
<gdtipde>
<gcamitem> ... </gcamitem>        # ítems de la factura
</gdtipde>
<gtotsub> ... </gtotsub>          # subtotales y total
</de>
<signature> ... </signature>      # firma digital (certificado A1)
<gcamfufd>
<dcarqr>https://ekuatia.set.gov.py/consultas/qr?...</dcarqr>
</gcamfufd>
</rde>

Barra de acciones por estado

Los botones que aparecen en la esquina superior derecha (y a la derecha) de la pantalla de edición cambian según la situación del DE. Resumen de lo que hace cada uno:

Motivos comunes de rechazo

Configuración — prerrequisitos

Antes de que pueda emitirse cualquier DE, hace falta:

1. Cuenta en FacturaSend activa, con el certificado digital A1 de la empresa instalado.
2. Establecimiento autorizado por la SET (registrado en la cuenta de FacturaSend).
3. Empresa NFE configurada en Quaza apuntando a la cuenta de FacturaSend (clave de API y webhook).
4. Cliente con RUC o Cédula válida y datos completos.
5. Productos con la Forma del IVA registrada (Gravado 10%, Gravado 5%, Exonerado, Exento).
6. Tipos de transacción registrados (venta, prestación, mixto, etc.).

Trampas frecuentes

Preguntas frecuentes

¿Puedo editar una factura después de aprobada?

No. Tras la aprobación en el SIFEN, el contenido de la factura es inmutable — es una regla de la SET, no de Quaza. Para corregir, use una Nota de Crédito (reduce) o una Nota de Débito (aumenta).

¿Qué es el KuDE?

Es el comprobante físico/PDF de la factura electrónica, con un código QR que permite verificar la autenticidad en el portal de la SET.

Mi factura está en "Enviado" hace más de 5 minutos. ¿Qué hago?

Haga clic en Consultar en el detalle del DE. Quaza le pregunta al FacturaSend el estado actual y lo actualiza. Si queda más de 30 minutos en Enviado, contacte al soporte.

¿Cuántas veces puedo reenviar una factura rechazada por el SIFEN?

Las que necesite, dentro de los 30 días de la primera transmisión. Después de eso, hay que emitir una nueva factura con la fecha actual.

¿Diferencia entre Nota de Crédito y Nota de Débito?

NC reduce el valor (devolución parcial, descuento retroactivo, anulación). ND aumenta el valor (recargo cobrado después — intereses, tasa adicional).

Documentos relacionados

• Configuración FacturaSend — los pasos para configurar la integración antes de emitir el primer DE.