Guia: DFe
Consulte, manifeste e gerencie documentos fiscais recebidos de terceiros via DFe (Distribuição de Documentos Fiscais).
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:
| Evento | Código | Quando usar |
|--------|--------|------------|
| Ciencia da Operacao | 210210 | Ao tomar ciência da nota, antes de receber a mercadoria |
| Confirmacao da Operacao | 210200 | Após receber a mercadoria e confirmar os dados |
| Desconhecimento da Operacao | 210220 | Nota emitida indevidamente contra seu CNPJ |
| Operacao nao Realizada | 210240 | Recusou 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âmetro | Tipo | Descrição |
|-----------|------|-----------|
| issuerId | string | ID do emissor (obrigatório) |
| tipoDoc | string | Filtrar por tipo: NFe, CTe, NFCe |
| manifestado | boolean | true para já manifestados |
| cnpjEmitente | string | Filtrar por CNPJ do fornecedor |
| page | número | Página (padrão: 1) |
| limit | número | Itens 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
Sincronizar periodicamente
Execute POST /dfe/consultar pelo menos uma vez por dia para buscar novos documentos.
Processar documentos recebidos
Liste via GET /dfe e integre ao seu ERP ou sistema financeiro.
Manifestar confirmação
Após receber e conferir a mercadoria, manifeste 210200 (Confirmação).
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.