Documento Eletrônico Paraguai (DE-PY)

Documento Eletrônico Paraguai (DE) — Factura, Auto-factura, Nota de Crédito/Débito enviadas ao SIFEN da SET

Esta wiki cobre o Documento Eletrônico (DE) do Paraguai — equivalente paraguaio da NFe brasileira. Cada fatura emitida no Quaza Paraguay é registrada no SIFEN (sistema oficial da SET) e ganha um CDC de 44 dígitos como prova fiscal. A audiência é cliente operador (escritório do provedor), não desenvolvedor.

Por que o DE existe

Desde 2022, a SET (Subsecretaría de Estado de Tributación) exige que toda fatura no Paraguai seja registrada eletronicamente no SIFEN (Sistema Integrado de Facturación Electrónica Nacional). Cada fatura ganha um CDC (Código de Controle, 44 dígitos) que permite à SET cruzar receitas/despesas em tempo real.

O Quaza não conversa direto com o SIFEN — usa o FacturaSend como gateway intermediário, que cuida da assinatura digital, fila de envio e webhooks de atualização de estado.

Fluxo geral — da fatura ao KuDE

Toda fatura paraguaia segue um ciclo de 4 etapas principais. Cada passo do operador pode ser feito manualmente (clicando o botão) ou automaticamente (via tarefa agendada).

Glossário

Tipos de Documento Eletrônico (tiDE) — cobertura no Quaza

CDC — Código de Documento

O CDC é o identificador único global de cada documento eletrônico, gerado pelo SIFEN. Tem 44 dígitos e é retornado na resposta após aprovação. Não pode ser customizado pelo usuário — é o controle fiscal Paraguaio.

Tela de Documentos Eletrônicos

Acesso pelo menu — clique no ícone ☰ no topo esquerdo, expanda o grupo FISCAL (marcado em vermelho) e selecione DOCUMENTO ELETRÔNICO (também marcado).

Listagem

Tela Listar documentos Eletrônicos — colunas: ícone imprimir KuDE (IMP), atalho editar (lápis), código, tipo (Factura/Auto-factura/NC/ND), estabelecimento, cliente, número, tipo de transação, data emissão, data transmissão ao SIFEN, competência, valor total em guarani (Gs.), situação (8 estados) e alterador. Botão verde marcado (1) no topo direito: Adicionar documento Eletrônico manualmente.

Detalhe — fatura recém-criada

Detalhe de uma fatura em situação Criado (verde no topo). CDC ainda em branco — só preenche depois da aprovação SIFEN. Botão marcado (1) Processar à direita: clica nele (ou deixa a tarefa fazer) para enviar ao SIFEN.

Detalhe — fatura aprovada

Mesma tela com fatura Aprovado (verde) e CDC preenchido (44 dígitos). Botões marcados à direita: 1 Cancelar (até 48h da aprovação), 2 Nota de crédito (reduz valor), 3 Nota de débito (aumenta valor). Fatura aprovada é imutável — qualquer ajuste exige NC ou ND.

Detalhe — fatura rejeitada

Quando o SIFEN devolve erro, a fatura fica Rejeitado SIFEN (vermelho). Clique em Ações no topo direito para ver o motivo da rejeição, corrija o dado problemático e clique em Processar novamente. Pode reenviar quantas vezes precisar dentro de 30 dias.

Gerar DE a partir de uma venda/mensalidade

O Documento Eletrônico não nasce sozinho — ele é sempre gerado a partir de um documento financeiro já existente no Quaza (uma venda, um recebimento de dívida ou um lote de pagamentos). Existem 3 caminhos:

Tela Editar venta — o botão azul Generar factura (marcado em verde, 1) aparece à direita quando a venda ainda não tem Documento Eletrônico associado. Clique para abrir o popup de geração.

Tela Editar registro (mensalidade/cuota) — botão azul Generar factura (marcado em verde, 1) entre os outros botões de ação (Eximir débito, Generar renegociación, Crear cobranza, etc.). Aparece apenas em mensalidades sem DE associado.

Tela Listar recibos (Lote de pagamentos) — botão verde Generar facturas (marcado, 1) no canto superior direito. Use para emitir DEs de várias cobranças de uma vez (faturamento mensal).

Os 8 estados do DE

Estados completos do DE-PY

Anatomia do documento — JSON e XML e-Kuatia

O Documento Eletrônico passa por duas representações antes de chegar ao SIFEN:

1. JSON — o Quaza monta os dados da fatura nesse formato e envia ao FacturaSend.
2. XML e-Kuatia — o FacturaSend converte o JSON no XML oficial do SIFEN (formato e-Kuatia), assina com o certificado digital e transmite.

Você raramente precisa abrir esses arquivos, mas conhecer a estrutura ajuda a entender as rejeições.

1. O JSON que o Quaza envia

Resumo dos principais campos (vários campos opcionais foram 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=Contingência
  "tipoTransaccion": 1,          # Venta de mercadería, prestación de servicio...
  "tipoImpuesto": 1,             # 1=IVA
  "moneda": "PYG",               # Guaraníes (ou USD, BRL...)
  "cliente": {
    "ruc": "80012345-6",           # ou Cédula / Pasaporte
    "razonSocial": "Cliente Exemplo",
    "tipoContribuyente": 1,        # 1=Persona física · 2=Persona jurídica
    "email": "cliente@exemplo.com.py",
    "direccion": "Av. Exemplo 123",
    "ciudad": "Asunción",
    "departamento": "Central"
  },
  "items": [
    {
      "codigo": 1,
      "descripcion": "Internet 100 Mbps - mensalidade Maio/2026",
      "unidadMedida": 77,           # 77=Unidad (tabela e-Kuatia)
      "cantidad": 1,
      "precioUnitario": 150000,      # em guaraníes
      "ivaTipo": 1,                 # 1=Gravado · 2=Exonerado · 3=Exento
      "iva": 10                     # alíquota: 10% ou 5%
    }
  ]
}

2. O XML e-Kuatia que o FacturaSend gera

O FacturaSend transforma o JSON acima no XML oficial do SIFEN. A raiz é com o 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 do CDC
    <dfecfirma>2026-05-14T10:30:05</dfecfirma>
    <gopede> ... </gopede>            # dados da operação
    <gtimb> ... </gtimb>              # timbrado (autorização SET)
    <gdatgralope>
      <gemis> ... </gemis>              # emissor: sua empresa
      <gdatrec> ... </gdatrec>          # receptor: o cliente
    </gdatgralope>
    <gdtipde>
      <gcamitem> ... </gcamitem>        # itens da fatura
    </gdtipde>
    <gtotsub> ... </gtotsub>          # subtotais e total
  </de>
  <signature> ... </signature>      # assinatura digital (certificado A1)
  <gcamfufd>
    <dcarqr>https://ekuatia.set.gov.py/consultas/qr?...</dcarqr>
  </gcamfufd>
</rde>

Barra de ações por estado

Os botões que aparecem no canto superior direito (e à direita) da tela de edição mudam conforme a situação do DE. Resumo do que cada um faz:

Motivos comuns de rejeição

Configuração — pré-requisitos

Antes que qualquer DE seja emitido, é preciso:

1. Conta no FacturaSend ativa com certificado digital A1 da empresa instalado.
2. Estabelecimento autorizado pela SET (cadastrado na conta FacturaSend).
3. Empresa NFE configurada no Quaza apontando para a conta FacturaSend (chave de API e webhook).
4. Cliente com RUC ou Cédula válida e dados completos.
5. Produtos com Forma de IVA cadastrada (Gravado 10%, Gravado 5%, Exonerado, Exento).
6. Tipos de transação cadastrados (venda, prestação, mixto, etc.).

Pegadinhas frequentes

FAQ

Posso editar uma fatura depois de aprovada?

Não. Após aprovação no SIFEN, o conteúdo da fatura é imutável — regra da SET, não do Quaza. Para corrigir, use Nota de Crédito (reduz) ou Nota de Débito (aumenta).

O que é o KuDE?

Comprovante físico/PDF da fatura eletrônica, com QR Code que permite verificar a autenticidade no portal da SET. Equivale ao DANFE da NFe brasileira.

Minha fatura está em "Enviado" há mais de 5 minutos. O que faço?

Clique em Consultar no detalhe do DE. O Quaza pergunta ao FacturaSend o estado atual e atualiza. Se ficar mais de 30 minutos em Enviado, contate o suporte.

Quantas vezes posso reenviar uma fatura rejeitada pelo SIFEN?

Quantas precisar, dentro de 30 dias da primeira transmissão. Depois disso, precisa emitir nova fatura com data atual.

Diferença entre Nota de Crédito e Nota de Débito?

NC reduz valor (devolução parcial, desconto retroativo, anulação). ND aumenta valor (acréscimo cobrado depois — juros, taxa adicional).

Documentos relacionados

• Configuração FacturaSend — os 13 passos para configurar a integração antes de emitir o primeiro DE.
• NFe — Nota Fiscal Eletrônica Modelo 55 — equivalente brasileiro do Documento Eletrônico.