Skip to main content

​
DFe — Distribuição de Documentos Fiscais

O DFe permite que sua empresa receba, consulte e manifeste documentos fiscais emitidos por terceiros contra o seu CNPJ — NFes de compra, CTes de frete, etc. Endpoint base: https://api.engineapi.com.br/dfe

Receber notas

Consulte NFes emitidas por fornecedores contra seu CNPJ

Manifestar

Confirme ciência, desconhecimento ou não-realização da operação

Download XML

Baixe os XMLs autorizados para contabilidade e ERP

​
O que é Manifestação do Destinatário

A manifestação é obrigatória para empresas que compram mercadorias com NFe. Sem manifestar, a SEFAZ pode considerar a operação como não reconhecida:
EventoCódigoQuando usar
Ciencia da Operacao210210Ao tomar ciência da nota, antes de receber a mercadoria
Confirmacao da Operacao210200Após receber a mercadoria e confirmar os dados
Desconhecimento da Operacao210220Nota emitida indevidamente contra seu CNPJ
Operacao nao Realizada210240Recusou a mercadoria ou a operação foi desfeita

​
Sincronizar Documentos da SEFAZ

Busca os documentos fiscais recebidos na SEFAZ Nacional (DF-e): 
curl -X POST https://api.engineapi.com.br/dfe/consultar \
  -H "x-api-key: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "issuerId": "ISSUER_ID",
    "ultNSU": "000000000000000"
  }'
O campo ultNSU é o último NSU (Número Sequencial Único) recebido. Use "000000000000000" na primeira consulta para baixar todos os documentos disponíveis.

​
Listar Documentos Recebidos

curl "https://api.engineapi.com.br/dfe?issuerId=ISSUER_ID&tipoDoc=NFe" \
  -H "x-api-key: SUA_API_KEY"
Parâmetros disponíveis:
ParâmetroTipoDescrição
issuerIdstringID do emissor (obrigatório)
tipoDocstringFiltrar por tipo: NFe, CTe, NFCe
manifestadobooleantrue para já manifestados
cnpjEmitentestringFiltrar por CNPJ do fornecedor
pagenúmeroPágina (padrão: 1)
limitnúmeroItens por página (padrão: 20)

​
Manifestar um Documento

curl -X POST https://api.engineapi.com.br/dfe/DFE_ID/manifestar \
  -H "x-api-key: SUA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "evento": "210200",
    "descricao": "Confirmação da operação realizada"
  }'

​
Download do XML

curl https://api.engineapi.com.br/dfe/DFE_ID/xml \
  -H "x-api-key: SUA_API_KEY" \
  -o nota-recebida.xml

​
Response — Documento DFe

{
  "id": "dfe-uuid",
  "tipo": "NFe",
  "chave": "35260211222333000144550010000000011000000019",
  "cnpjEmitente": "11222333000144",
  "nomeEmitente": "Fornecedor Exemplo SA",
  "valor": 1500.00,
  "dataEmissao": "2026-04-25T10:00:00.000Z",
  "status": "AUTHORIZED",
  "manifestado": false,
  "nsu": "000000000001234",
  "xmlDisponivel": true
}

​
Fluxo Recomendado

1

Sincronizar periodicamente

Execute POST /dfe/consultar pelo menos uma vez por dia para buscar novos documentos.
2

Processar documentos recebidos

Liste via GET /dfe e integre ao seu ERP ou sistema financeiro.
3

Manifestar confirmação

Após receber e conferir a mercadoria, manifeste 210200 (Confirmação).
4

Baixar XMLs para contabilidade

Use GET /dfe/{id}/xml para arquivar os XMLs autorizados.
A manifestação de destinatário é obrigatória por lei para empresas contribuintes do ICMS. O prazo é de até 180 dias após a autorização da nota.

​
Próximos passos

Webhooks

Receba notificações automáticas ao receber novos DFes

Erros e Rejeições

Tratamento de erros de manifestação