Webhooks do Monitor Fiscal (DF-e Recebidos)

Eventos de NF-e recebidas de fornecedores, NFS-e tomadas e fretes CT-e em tempo real.

Os Webhooks de Entrada conectam o motor de sincronização contínua do Monitor Fiscal (DF-e Recebidos) ao seu sistema de gestão ou ERP. Sempre que um fornecedor emitir uma NF-e de compra, uma prefeitura emitir uma NFS-e tomada ou uma transportadora emitir um CT-e contra o seu CNPJ, a NFER captura o documento e notifica seu endpoint em tempo real.

NF-e de Compras

Captura do resumo da NF-e emitida pelo fornecedor perante o Ambiente Nacional da SEFAZ.

NFS-e Tomadas (ADN)

Sincronização de serviços tomados com retenção de impostos capturados no Ambiente de Dados Nacional.

CT-e de Frete

Captura dos conhecimentos de transporte rodoviário vinculados a cargas da sua empresa.

1. Eventos de Documentos Recebidos

Evento de EntradaOrigem GovernamentalAção Sugerida no seu ERP
nfe.recebida.detectadaSEFAZ Nacional (resNFe)Resumo detectado na SEFAZ. O NFER dá Ciência automática para liberar o XML completo.
nfe.recebida.completaSEFAZ Nacional (procNFe)XML completo disponibilizado com todos os itens, tributos e DANFE para conferência.
nfe.recebida.manifestadaSEFAZ NacionalAtualizar status interno da manifestação registrada (Ciência, Confirmação, Desconhecimento).
nfe.recebida.eventoSEFAZ Nacional / TerceirosEventos fiscais externos vinculados à nota (ex: cancelamento pelo emitente ou CC-e).
cte.recebidoSEFAZ / SVRSConhecimento de Transporte Eletrônico emitido contra seu CNPJ como tomador do frete.
nfse.recebidaAmbiente Nacional ADN / PrefeiturasNota fiscal de serviço tomado emitida contra seu CNPJ com retenções tributárias.

2. Estrutura do Payload de NF-e Recebida

Exemplo de notificação do evento nfe.recebida.detectada:

{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"type": "nfe.recebida.detectada",
"createdAt": "2026-09-20T19:15:00.000Z",
"data": {
"nfeReceivedId": "b1a2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"chaveAcesso": "35260912345678000195550010000456781000045679",
"numero": 45678,
"emitenteCnpj": "12345678000195",
"emitenteRazaoSocial": "FORNECEDOR DISTRIBUIDOR DE MATERIAIS LTDA",
"valorTotal": 12850.0,
"dataEmissao": "2026-09-20T18:40:00.000Z",

Assim que o XML completo é sincronizado pela SEFAZ, o evento nfe.recebida.completa é despachado:

{
"id": "4ab91f75-6828-4673-c4fd-3d074f77bfb7",
"type": "nfe.recebida.completa",
"createdAt": "2026-09-20T19:20:00.000Z",
"data": {
"nfeReceivedId": "b1a2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
"chaveAcesso": "35260912345678000195550010000456781000045679",
"numero": 45678,
"serie": 1,
"emitenteCnpj": "12345678000195",
"emitenteRazaoSocial": "FORNECEDOR DISTRIBUIDOR DE MATERIAIS LTDA",
"valorTotal": 12850.0,

3. Automação do Fluxo de Manifestação (MD-e)

Embora o NFER realize a Ciência da Operação de forma transparente na detecção, você pode confirmar a operação ou informar desacordo a qualquer momento:

curl -X POST "https://api.nfer.me/v1/nfe/received/b1a2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d/manifest" \
-H "Authorization: Bearer sec_live_sua_chave_secreta" \
-H "Content-Type: application/json" \
-d '{
"codigoEvento": 210200
}'

Códigos aceitos: 210200 (Confirmação da Operação), 210210 (Ciência da Operação), 210220 (Desconhecimento da Operação) e 210240 (Operação não Realizada — requer campo justificativa de no mínimo 15 caracteres).

Disponibilidade

Os recursos de sincronização e webhooks do Monitor Fiscal exigem plano Corporate ou Enterprise ativo na conta e Certificado Digital A1 configurado. Consulte a documentação de Visão Geral do Monitor Fiscal.