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), em conformidade com a Nota Técnica 2014.002 v1.40 (Julho/2026) e suporte ao CNPJ Alfanumérico.
Endpoints Disponíveis
| Operação | Método e Rota | Referência Técnica |
|---|---|---|
| Listar NF-e Recebidas | GET /api/nfe/received | Ver Filtros & Parâmetros → |
| Status da Sincronização | GET /api/nfe/received/sync-status | Ver NSU & Cooldown → |
| Sincronizar sob Demanda | POST /api/nfe/received/sync | Ver Sincronização → |
| Configurar Busca Periódica | PUT /api/nfe/received/settings | Ver Opt-in → |
| Detalhes da NF-e | GET /api/nfe/received/:id | Ver Detalhamento → |
| Registrar Manifestação (MD-e) | POST /api/nfe/received/:id/manifest | Ver Eventos MD-e → |
| Manifesto em Massa | POST /api/nfe/received/manifest-batch | Ver Envio em Lote → |
| Importar Itens ao Estoque | POST /api/nfe/received/:id/import-products | Ver Catálogo → |
| Download XML (procNFe) | GET /api/nfe/received/:id/xml | Ver Download do XML → |
| Download DANFE (PDF) | GET /api/nfe/received/:id/danfe | Ver Download do PDF → |
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:
Cadastro de Produtos & Entrada de Estoque
Após a liberação do XML completo (procNFe), você pode cadastrar todos os produtos faturados no catálogo da sua empresa e dar entrada no saldo de estoque com uma única requisição:
Webhooks em Tempo Real
Elimine chamadas periódicas repetitivas (*polling*). O NFER notifica seu backend instantaneamente nos seguintes eventos:
| Evento | Gatilho | Payload |
|---|---|---|
nfe.recebida.detectada | SEFAZ entregou o resumo inicial (resNFe) por NSU. | nfeReceivedId, chaveAcesso, fornecedor, valorTotal |
nfe.recebida.completa | XML procNFe integral com itens e impostos decodificados. | nfeReceivedId, chaveAcesso, totalItens, danfeUrl, xmlUrl |
nfe.recebida.manifestada | Homologação de Confirmação, Recusa ou Desconhecimento. | nfeReceivedId, chaveAcesso, statusManifestacao, protocolo |
nfe.recebida.evento | Cancelamento pelo emitente ou registro de CC-e vinculada. | nfeReceivedId, chaveAcesso, tipoEvento, protocolo |
Prazos e Limites Técnicos da SEFAZ
Disponibilidade de 90 Dias
A SEFAZ mantém notas na fila de distribuição de NSU por até 90 dias após a autorização. Notas mais antigas devem ser importadas via upload manual de XML.
Interrupção por 60 Dias Inativos
Se uma empresa passar mais de 60 dias sem consultar suas notas, a SEFAZ interrompe o envio de novos documentos. A coleta só é restabelecida após uma nova consulta manual.
Troca de Manifestação (Até 2x)
Eventos conclusivos (Confirmação, Desconhecimento ou Recusa) podem ser retificados até 2 vezes por NF-e. Perante o Fisco, prevalece com validade jurídica sempre o último evento homologado.
Limite de 20 Eventos / Hora
A SEFAZ limita o registro a 20 manifestações por hora por CNPJ. Nossa fila de processamento enfileira requisições excedentes para evitar o erro de consumo indevido.