DE — Documento Electrónico, o fiscal eletrônico do Paraguai
O DE (Documento Electrónico) é o documento fiscal eletrônico do Paraguai — o equivalente paraguaio à NFe/NFCom brasileira. Para um provedor no Paraguai, todo serviço (internet, telefonia, TV) gera um DE. Esta wiki habilita você a configurar a emissão e emitir o primeiro DE — manualmente ou de forma automática.
Quando emitir um DE (e qual tipo)
O DE é emitido eletronicamente, assinado digitalmente, validado pela SET (autoridade fiscal paraguaia, via SIFEN) e entregue ao cliente como KuDE (a representação visual em PDF). No provedor, ele nasce a partir de uma fatura/cobrança e cobre toda a receita de serviços.
Pela tela de Documento Eletrônico, o Quaza emite hoje três tipos:
| Tipo de documento |
Quando usar |
| Factura electrónica |
Venda de serviço ou produto ao cliente — é o documento do dia a dia do provedor (mensalidade, instalação, equipamento). |
| Nota de crédito electrónica |
Devolução, cancelamento ou ajuste para menos de uma Factura já aprovada. Exige informar o motivo e o documento de origem. |
| Nota de débito electrónica |
Ajuste para mais (encargo, juro, diferença) sobre uma Factura já aprovada. Também exige motivo e documento de origem. |
Os tipos Autofactura (compra de produtor sem RUC) e Nota de remisión (transporte de mercadoria) existem na legislação e no sistema, mas não estão habilitados para emissão pela tela atual do Quaza — a Nota de Crédito e a Nota de Débito são geradas a partir de uma Factura aprovada (botões na própria nota).
A
Nota de Crédito é o caminho para "cancelar" um DE depois do prazo legal de cancelamento (ver
Cancelamento
).
Passo a passo — emitir seu primeiro DE
Roteiro mínimo, do zero até o KuDE na mão do cliente. Os passos 1 a 4 são de configuração (uma vez); 5 e 6 são a operação do dia a dia.
| # |
Ação |
Onde |
| 1 |
Tenha a conta FacturaSend do contribuinte com certificado digital, timbrado vigente e API Key configurados. Toca credenciais — feito na implantação pela equipe Quaza/admin.
|
Console FacturaSend (interno) |
| 2 |
Cadastre a Empresa emissora: estabelecimento, ponto, ambiente (Teste/Produção) e o vínculo com a conta FacturaSend. |
Fiscal → Empresa (configuração do Documento Eletrônico) |
| 3 |
Garanta a série/sequência de numeração ativa para o estabelecimento e o tipo de documento. |
Fiscal → Série fiscal |
| 4 |
Defina se a emissão será automática ou manual (ver seção
). |
Configurações → Fiscal |
| 5 |
Em Ambiente de Teste: crie um DE, clique Processar e confirme que aprova. Teste também Cancelar e Nota de Crédito antes de virar produção. |
Fiscal → Documento Eletrônico |
| 6 |
Vire para Produção: a partir daí cada Factura aprovada gera CDC + KuDE; use Enviar documento para mandar o KuDE ao cliente. |
Fiscal → Documento Eletrônico |
Menu: Fiscal → Documento Eletrônico
Onde fica: menu lateral Fiscal → Documento Eletrônico (no sistema paraguaio o menu aparece em espanhol: Documento Electrónico).
Fluxo do Documento Eletrônico (PY) — Quaza → FacturaSend → SIFEN (raias: Operador · Quaza · FacturaSend · SET/SIFEN).
Configuração — pré-requisitos
Antes de emitir, três peças precisam estar prontas. As duas primeiras tocam credenciais e ficam na conta FacturaSend (configuradas na implantação); a terceira é no próprio Quaza.
| Pré-requisito |
Onde |
O que é |
| Certificado digital + Timbrado |
Console FacturaSend (interno) |
O certificado (.p12) assina o XML; o timbrado é a autorização de numeração concedida pela SET. Sem timbrado vigente não há emissão. |
| API Key |
Console FacturaSend (interno) |
Token que liga o Quaza à conta do contribuinte no FacturaSend. É a credencial de integração — não aparece em tela de cliente. |
| Empresa emissora + Série |
Quaza — Fiscal |
Estabelecimento, ponto, ambiente e a sequência de numeração por estabelecimento/tipo de documento. É o que o Quaza usa para montar o número e o CDC do DE. |
Ambiente de Teste × Produção. Configure e valide tudo em Teste primeiro. Documentos de teste não têm valor fiscal — só vire para Produção depois de confirmar emissão, cancelamento e nota de crédito funcionando.
Tela de Documento Eletrônico — listagem e detalhe
A listagem mostra todos os DEs com estabelecimento, cliente, tipo de documento, número, datas de emissão e transmissão, competência, valor total e situação. O botão verde Adicionar documento Eletrônico cria um DE manualmente (quando a geração manual está habilitada).
Listagem de Documentos Eletrônicos — a coluna Situação mostra o estado (Criado, Enviado, Aprovado, Rejeitado, Cancelado).
Ao abrir um DE, a aba Principal traz a empresa emissora, estabelecimento/ponto/série/número, CDC, cliente, datas, competência, tipo de emissão (Normal/Contingencia), valor total, tipo de transação e tipo de imposto (IVA, ISC, Renta…), além dos itens. A aba Protocolo guarda os retornos do SIFEN e a Histórico registra cada ação.
Estados do documento e transições
A situação do DE acompanha o ciclo de transmissão e a resposta do SIFEN:
| Estado |
O que significa |
| Criado |
Recém-criado no Quaza, ainda não transmitido. É o estado em que aparece o botão Processar. |
| Enviado |
Transmitido ao SIFEN; aguardando a resposta de processamento. |
| Aprovado |
Aceito pelo SIFEN — gerou CDC e KuDE. É um DE com valor fiscal. |
| Aprovado com Observação |
Aceito, porém o SIFEN anexou uma observação (válido, mas confira a mensagem). |
| Rejeitado FacturaSend |
Recusado antes de chegar ao SIFEN (sem CDC válido) — em geral erro de dados/configuração. Corrija e processe de novo. |
| Rejeitado SIFEN |
Recusado pelo SIFEN (já com CDC). Use Reenviar (permitido por até ~30 dias) após corrigir. |
| Cancelamento pendente |
Pedido de cancelamento enviado, aguardando confirmação do SIFEN. |
| Cancelado |
Cancelado no SIFEN. Não tem mais efeito fiscal. |
Barra de ações
Os botões mudam conforme o estado do documento. No estado Criado, a ação principal é Processar — é ela que transmite o DE ao FacturaSend → SIFEN.
DE no estado Criado: o botão Processar transmite o documento ao SIFEN (emissão manual).
| Botão |
Quando aparece |
O que faz |
| Processar |
Criado / Enviado |
Transmite o DE ao FacturaSend, que assina e envia ao SIFEN. É a emissão manual. |
| Reenviar |
Rejeitado SIFEN |
Reenvia o documento ao SIFEN após corrigir o motivo da rejeição (até ~30 dias). |
| Consultar |
Quando há CDC |
Pergunta ao SIFEN a situação atual e atualiza o estado no Quaza. |
| Cancelar |
Aprovado |
Solicita o cancelamento ao SIFEN (com motivo). Sujeito ao prazo legal — ver abaixo. |
| Nota de crédito / Nota de débito |
Aprovado (sobre uma Factura) |
Gera o documento de ajuste vinculado, com motivo. |
|
Ver DANFE / Ver XML
|
Quando o XML existe |
Abre o KuDE (PDF) ou o XML assinado do documento. |
| Enviar documento |
Aprovado |
Envia o KuDE ao cliente por e-mail, WhatsApp ou WhatsApp Web. |
DE Aprovado: surgem Cancelar, Nota de crédito, Nota de débito e Enviar documento.
Emissão automática × manual
O comportamento é controlado pela configuração "Geração automática de notas" (a mesma usada no fiscal Brasil), em Configurações → Fiscal:
-
Automática — a partir da fatura/cobrança, o Quaza cria e transmite o DE sozinho; você só acompanha a situação na listagem. A tarefa automática
consulta o SIFEN e atualiza o estado.
-
Manual ("na mão") — o operador cria o DE (botão Adicionar documento Eletrônico) ou parte de uma cobrança, confere os dados e clica Processar para transmitir.
Mesmo na emissão manual, quem assina e transmite ao SIFEN é o FacturaSend — o Processar apenas dispara esse envio.
Cancelamento, Nota de Crédito e Nota de Débito
Prazo de cancelamento. O SIFEN só aceita o cancelamento de um DE em até 48 horas após a aprovação. Passado esse prazo, o caminho é emitir uma Nota de Crédito (para anular/ajustar para menos) ou Nota de Débito (ajustar para mais).
Para cancelar: abra o DE Aprovado → Cancelar → informe o motivo → confirmar. Para NC/ND: na Factura aprovada, use Nota de crédito ou Nota de débito, escolha o motivo, e o Quaza cria o documento de ajuste já vinculado ao original.
Quando dá errado — Rejeitado FacturaSend × Rejeitado SIFEN
DE Rejeitado SIFEN: o motivo fica registrado; corrija e use Reenviar.
| Sintoma |
O que fazer |
|
Rejeitado FacturaSend (antes do SIFEN) |
Erro de dados/configuração (RUC inválido, IVA, timbrado). Veja o motivo na aba Histórico, corrija o cadastro e clique Processar de novo. |
|
Rejeitado SIFEN (com CDC) |
Corrija o que o SIFEN apontou e use Reenviar (até ~30 dias). Detalhes na aba Histórico. |
| Não sei se aprovou |
Abra o DE e clique Consultar — o Quaza pergunta a situação atual ao SIFEN. (A tarefa automática também faz isso periodicamente.) |
| Timbrado esgotado |
Não há emissão até obter novo timbrado na SET e atualizar a configuração no FacturaSend. |
Sempre que uma transmissão falha, o Quaza mostra um aviso e registra o detalhe na aba Histórico do documento — é lá que está o motivo real da falha.
Tarefas automáticas
A tarefa abaixo roda no servidor e toca o DE-PY (executa apenas em bases configuradas como Paraguai):
| Tarefa |
O que faz |
| Fiscal — Consulta Documento Eletrônico Paraguai |
Periodicamente consulta no SIFEN a situação dos DEs ainda pendentes (estados Enviado e Cancelamento pendente, com CDC, dos últimos dias) e atualiza o estado no Quaza — é o que faz um DE "Enviado" virar "Aprovado"/"Rejeitado" sem você precisar clicar em Consultar. |
Glossário
| Termo |
Significado |
| DE |
Documento Electrónico — o fiscal eletrônico do Paraguai. |
| SET |
Subsecretaría de Estado de Tributación — a autoridade fiscal paraguaia. |
| SIFEN |
Sistema Integrado de Facturación Electrónica Nacional — onde os DEs são validados. |
| CDC |
Código de Control — identificador único do DE, gerado na aprovação. |
| KuDE |
Representação visual do DE em PDF, entregue ao cliente. |
| Timbrado |
Autorização de numeração concedida pela SET. |
| RUC |
Registro Único de Contribuyentes (o "CNPJ/CPF" paraguaio). |
| FacturaSend |
Middleware fiscal que assina e conecta o Quaza ao SIFEN. |
| Estabelecimento / Ponto |
Identificam a filial e o ponto de expedição na numeração do DE. |
Campos do documento
| Campo |
O que é |
| Empresa emissora |
O contribuinte que emite (RUC, estabelecimento, ponto). |
| Cliente (receptor) |
RUC ou cédula (CI), nome — pode ser consumidor final sem RUC. |
| Tipo de documento |
Factura, Nota de crédito ou Nota de débito. |
| Tipo de transação |
Venta de mercadería (padrão), Prestación de servicios, etc. |
| Tipo de imposto |
IVA (10% ou 5%), ISC, Renta, Ninguno ou IVA–Renta. |
| Tipo de emissão |
Normal ou Contingencia. |
| Itens |
Produtos/serviços com quantidade, valor e IVA. |
| CDC |
Preenchido automaticamente após a aprovação no SIFEN. |
Pegadinhas frequentes
1. Timbrado esgotado/vencido. Não emite até obter novo número na SET.
2. Cancelamento fora do prazo (48h). Depois disso, só via Nota de Crédito.
3. RUC/CI do cliente inválido. O SIFEN rejeita — confira o documento do receptor.
4. IVA mal classificado. 10% ou 5% conforme o produto/serviço; reveja a categoria de IVA.
5. KuDE não enviado ao cliente. Lembre de usar Enviar documento (ou configure o envio automático).
FAQ
DE precisa de assinatura física?Não — a assinatura digital, feita pelo FacturaSend com o certificado do contribuinte, basta.
Cliente sem RUC pode receber DE?Sim — usa-se a cédula (CI); é o DE de consumidor final.
Posso emitir DE retroativo?Não. A data de emissão acompanha o envio ao SIFEN (com pequena tolerância).
Como "cancelo" um DE depois de 48h?Emitindo uma Nota de Crédito vinculada à Factura — ela anula/ajusta o valor.
O DE "Enviado" não muda de estado — e agora?Clique Consultar no documento, ou aguarde a tarefa automática
, que consulta o SIFEN periodicamente.
Onde fica o histórico dos DEs?O Quaza guarda o XML assinado e o KuDE; cada documento também tem a aba Histórico com todas as ações.
Qual a diferença entre DE-PY e NFe?DE-PY é o documento eletrônico do Paraguai (Factura/NC/ND) via FacturaSend/SIFEN; NFe é o brasileiro. Conforme o país da empresa.
O que é o FacturaSend?O intermediário que envia o DE ao SIFEN (a SEFAZ paraguaia). Ver a wiki do FacturaSend.
Posso cancelar um DE no Paraguai?Sim, dentro do prazo (em geral 48h); depois disso, use Nota de Crédito.
A emissão é automática ou manual?Pode ser as duas — config de geração automática, ou o botão Processar manual.
Como sei se o SIFEN aprovou?Pelo estado (Aprovado/Rejeitado SIFEN) + a tarefa de consulta de status.
Documentos relacionados
-
FacturaSend
— o middleware que assina e transmite ao SIFEN.
-
Fatura
— de onde nasce o DE no fluxo financeiro.