Flujo Completo DE-PY
Detalle técnico del flujo de generación, transmisión, aprobación y disponibilización del Documento Electrónico Paraguay. Profundiza
DE-PY
y
FacturaSend
.
Glosario
| Término |
Significado |
| Estado CRIADA |
Documento generado en Quaza |
| Estado ENVIADA |
Enviada al FacturaSend |
| Estado APROVADA |
SIFEN validó — CDC generado |
| Estado REJEITADA |
SIFEN no aprobó |
| Estado CANCELADA |
Cancelada vía NC (Nota de Crédito) |
| Estado INUTILIZADA |
Numeración descartada |
| Webhook |
Callback HTTP que notifica cambio de estado |
| Timbrado |
Numeración autorizada por la SET |
| CDC |
Código de Control único del documento aprobado |
Etapas
+----------------------------------------------------------+
| 1. CRIACAO no Quaza |
| Mensalidade/Fatura/Venda gera registro fiscal |
| Estado: CRIADA |
+----------------------------------------------------------+
v
+----------------------------------------------------------+
| 2. ENVIO ao FacturaSend (API HTTP) |
| Quaza monta payload JSON com dados do documento |
| POST https://api.facturasend.com.py/de/v1/de |
| Estado: ENVIADA |
+----------------------------------------------------------+
v
+----------------------------------------------------------+
| 3. FACTURASEND processa |
| Valida formato, assina XML, envia ao SIFEN |
+----------------------------------------------------------+
v
+----------------------------------------------------------+
| 4. SIFEN valida (5-30s) |
| Aprovado: gera CDC + protocolo |
| Rejeitado: motivo no log |
+----------------------------------------------------------+
v
+----------------------------------------------------------+
| 5. RETORNO via webhook |
| Quaza recebe estado: APROVADA ou REJEITADA |
| URL: /webhook/fiscal/facturasend |
+----------------------------------------------------------+
v
+----------------------------------------------------------+
| 6. DISPONIBILIZACAO |
| KUDE PDF gerado pelo FacturaSend |
| Quaza envia ao cliente (email/WhatsApp) |
+----------------------------------------------------------+
Estados posibles
| Estado |
Significado |
| CRIADA |
Generada en Quaza, aún no enviada |
| ENVIADA |
Enviada al FacturaSend, esperando SIFEN |
| APROVADA |
SIFEN aprobó — CDC generado |
| REJEITADA |
SIFEN rechazó — motivo en el log |
| CANCELADA |
Cancelada vía NC (Nota de Crédito) |
| INUTILIZADA |
Numeración inutilizada (no se usará) |
Trampas frecuentes
1. Webhook no llega
FacturaSend llama webhook de Quaza para notificar. Si URL no accesible externamente, estado queda ENVIADA indefinidamente. Verifica firewall + SSL.
2. Timbrado vencido
Cada timbrado tiene validez. Vencido = SIFEN rechaza. Configura alerta 30 días antes.
3. Reenvío crea duplicado
No se puede reenviar documento ya APROBADO. Cancela con NC primero, después emite nuevo.
Falta de auditoría periódica. Incluso módulos automáticos precisan revisión mensual. Sin revisión, problemas se acumulan silenciosamente.
Permisos mal definidos. Operador con acceso de admin = riesgo. Defina roles claros.
No entrenar equipo nuevo. Funcionario nuevo opera a ciegas, hace tonterías por desconocimiento.
Galería de pantallas
Menu caminho
Listagem
Detalhe aprovado
Detalhe rejeitado sifen
Detalhe criado
Tela de configura o do estabelecimento
Dados do estabelecimento
Configura o de ambiente
Facturasend certificado digital
Gera o da api key
Configura o da empresa no
Configura o fiscal
Permiss es de grupo
S rie fiscal
Configura o de categoria
Configura o de iva
Cria o da integra o
Dados da integra o
Configura o de webhooks
Documentos relacionados
¿Cómo obtengo el ID CSC para FacturaSend?
Registre en FacturaSend, configure empresa, sistema genera credenciales.
¿Puedo tener más de una empresa emisora en Quaza?
Sí. Cada empresa tiene sus credenciales SET/FacturaSend aisladas.
¿Cómo cancelar factura emitida?
Por Quaza: genere CDC. Dentro del plazo (48h normalmente) SET acepta.
¿Facturas en moneda extranjera son soportadas?
Sí — USD/EUR/BRL. Conversión para guaraní usa cambio del día.
FAQ
¿Cuánto tarda SIFEN?
5-30s en condiciones normales. Picos de horario (fin de mes) pueden tardar minutos.
Buenas prácticas operacionales
Esta sección reúne hábitos que proveedores experimentados adoptan para evitar problemas recurrentes en este módulo. Aplicación consistente hace diferencia grande en el largo plazo — diferencia entre operación caótica y operación previsible.
Revisión periódica
Reserve 30 minutos por semana para revisar el estado del módulo: lo que corrió, lo que falló, lo que quedó pendiente. Anomalía detectada temprano cuesta 10× menos que descubierta tarde.
Documentación de procedimientos
Cree checklists internos para operaciones recurrentes — apertura/cierre del mes, procesamiento en lote, corrección de inconsistencias. No dependa de quien "sabe de memoria" — funcionario puede salir, enfermar, tener día malo.
Backup antes de operaciones masivas
Cualquier cambio que afecte 100+ registros debe ser precedido de backup o export. Restaurar una alteración masiva equivocada es caro; prevenir es simple.
Comunicación con cliente
Cambios que impactan al cliente (precio, cobranza, regla) deben comunicarse con antelación. Cliente sorprendido reclama; cliente avisado entiende.
Indicadores acompañados
Defina 2-3 indicadores que miden la salud del módulo. Acompañe semanalmente. Cuando alguno sale del rango esperado, investigue antes de volverse problema visible.