Consultar DFe na SEFAZ

POST /dfe/consultar

Consulta novos documentos fiscais destinados ao CNPJ do emissor via serviço de Distribuição DFe da SEFAZ. Documentos novos são salvos automaticamente no banco.

Autenticação

Authorization: Bearer {token}

Body

Campo	Tipo	Obrigatório	Descrição
issuerId	string	✅	ID da empresa destinatária
ultimoNsu	string		Último NSU consultado (para paginação incremental). Ex: "000000000000000"

Exemplo

curl -X POST https://api.engineapi.com.br/dfe/consultar \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "issuerId": "ISSUER_ID",
    "ultimoNsu": "000000000000000"
  }'

Resposta (200)

{
  "success": true,
  "ultimoNsu": "000000000000150",
  "maxNsu": "000000000000200",
  "documentos": 5,
  "message": "5 novos documentos encontrados e salvos"
}