Fluxo Completo DE-PY
Detalhamento técnico do fluxo de geração, transmissão, aprovação e disponibilização do Documento Eletrônico Paraguai. Aprofunda
DE-PY
e
FacturaSend
.
Glossário
| Termo |
Significado |
| Estado CRIADA |
Documento gerado no Quaza |
| Estado ENVIADA |
Mandada ao FacturaSend |
| Estado APROVADA |
SIFEN validou — CDC gerado |
| Estado REJEITADA |
SIFEN não aprovou |
| Estado CANCELADA |
Cancelada via NC (Nota de Crédito) |
| Estado INUTILIZADA |
Numeração descartada |
| Webhook |
Callback HTTP que notifica mudança de estado |
| Timbrado |
Numeração autorizada pela SET |
| CDC |
Código de Control único do documento aprovado |
Estágios
+----------------------------------------------------------+
| 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 possíveis
| Estado |
Significado |
| CRIADA |
Gerada no Quaza, ainda não enviada |
| ENVIADA |
Enviada ao FacturaSend, aguardando SIFEN |
| APROVADA |
SIFEN aprovou — CDC gerado |
| REJEITADA |
SIFEN rejeitou — motivo no log |
| CANCELADA |
Cancelada via NC (Nota de Crédito) |
| INUTILIZADA |
Numeração inutilizada (não vai usar) |
Pegadinhas frequentes
1. Webhook não chega
FacturaSend chama webhook do Quaza pra notificar. Se URL não acessível externamente, estado fica ENVIADA indefinidamente. Verifique firewall + SSL.
2. Timbrado vencido
Cada timbrado tem validade. Vencido = SIFEN rejeita. Configure alerta 30 dias antes.
3. Reenvio cria duplicata
Não dá pra reenviar documento já APROVADO. Cancele com NC primeiro, depois emita novo.
Falta de auditoria periódica. Mesmo módulos automáticos precisam revisão mensal. Sem revisão, problemas se acumulam silenciosamente.
Permissões mal definidas. Operador com acesso de admin = risco. Defina papéis claros.
Não treinar nova equipe. Funcionário novo opera no escuro, faz besteira por desconhecimento.
Galeria de telas
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
Como obtenho o ID CSC para FacturaSend?
Cadastre-se no FacturaSend, configure a empresa, e o sistema gera as credenciais técnicas. Quaza armazena o token criptografado.
Posso ter mais de uma empresa emitente no mesmo Quaza?
Sim. Cada empresa tem suas próprias credenciais SET/FacturaSend isoladas.
Como cancelar fatura emitida?
Pelo Quaza: gere CDC (Cancelamento de Documento). Dentro do prazo (48h normalmente) SET aceita. Após o prazo, só por inversão (NCE).
Faturas em moeda estrangeira são suportadas?
Sim — Quaza permite USD/EUR/BRL. Conversão para guarani usa câmbio do dia da emissão.
FAQ
Quanto tempo SIFEN demora?
5-30s em condições normais. Picos de horário (fim de mês) podem demorar minutos.
Boas práticas operacionais
Esta seção reúne hábitos que provedores experientes adotam pra evitar problemas recorrentes neste módulo. Aplicação consistente faz diferença grande no longo prazo — diferença entre operação caótica e operação previsível.
Revisão periódica
Reserve 30 minutos por semana pra revisar o estado do módulo: o que rodou, o que falhou, o que ficou pendente. Anomalia detectada cedo custa 10x menos que descoberta tarde.
Documentação de procedimentos
Crie checklists internos pra operações recorrentes — abertura/fechamento do mês, processamento em lote, correção de inconsistências. Não dependa de quem "sabe de cabeça" — funcionário pode sair, ficar doente, ter dia ruim.
Backup antes de operações em massa
Qualquer mudança que afete 100+ registros deve ser precedida de backup ou export. Restaurar uma alteração massiva equivocada é caro; prevenir é simples.
Comunicação com cliente
Mudanças que impactam o cliente (preço, cobrança, regra) devem ser comunicadas com antecedência. Cliente surpreendido reclama; cliente avisado entende.
Indicadores acompanhados
Defina 2-3 indicadores que medem a saúde do módulo. Acompanhe semanalmente. Quando algum sai do range esperado, investigue antes de virar problema visível.