Endpoints NF-e Recebidas & MD-e
Listagem de compras, download do XML procNFe e eventos 210210, 210200, 210220 e 210240.
Referência técnica completa dos endpoints da API REST para consulta, sincronização, download e Manifestação do Destinatário (MD-e) de NF-e de compras e mercadorias (Modelo 55).
Endpoints Disponíveis
/api/nfe/receivedLista as NF-e emitidas contra o CNPJ com filtros por data, emitente, chave e status de manifestação.
/api/nfe/received/syncDispara consulta imediata à SEFAZ Nacional respeitando o intervalo de segurança do NSU.
/api/nfe/received/:idRetorna os detalhes completos da NF-e, grade de itens, impostos e histórico de eventos da SEFAZ.
/api/nfe/received/:id/manifestRegistra evento de Manifestação do Destinatário (210200, 210220 ou 210240) na SEFAZ Nacional.
/api/nfe/received/:id/xmlFaz o download do arquivo XML original (procNFe) autorizado com protocolo da SEFAZ.
/api/nfe/received/:id/danfeGera e faz o download do DANFE em formato PDF A4 oficial.
Como Registrar a Manifestação (MD-e)
Para manifestar uma nota, envie uma requisição POST informando o código numérico do evento desejado:
| Código Evento | Nome Oficial | Justificativa |
|---|---|---|
| 210200 | Confirmação da Operação | Não necessária. Atesta o recebimento físico. |
| 210220 | Desconhecimento da Operação | Opcional. Declara fraude/nota fria. |
| 210240 | Operação não Realizada (Recusa) | Obrigatória (mínimo de 15 caracteres). Documenta avaria ou recusa. |
Exemplo de Requisição (MD-e)
Registrando a Confirmação da Operação (210200) para consolidar o recebimento no estoque:
Resposta da SEFAZ
A SEFAZ retorna o protocolo de homologação com cStat: 135:
Exemplo: Operação não Realizada (Recusa de Carga)
Quando a mercadoria for recusada por avaria ou desacordo comercial, o código 210240 exige a justificativa: