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
monitor.document_receivedSEFAZ Nacional (NF-e) / ADN / SVRSRegistrar pedido de compras pendente e disparar Ciência da Emissão (210210).
monitor.nfe_proc_receivedSEFAZ NacionalBaixar XML procNFe completo e importar itens no estoque da empresa.
monitor.manifest_recordedSEFAZ NacionalAtualizar status interno da manifestação realizada (Ciência, Confirmação ou Desconhecimento).
monitor.document_canceledSEFAZ Nacional / SVRSAlertar setor fiscal: nota fiscal original foi cancelada pelo emitente.

2. Estrutura do Payload de NF-e Recebida

{
"id": "evt_01HXYZ7890ABCDEF3333",
"event": "monitor.document_received",
"created_at": "2026-09-20T19:15:00.000Z",
"data": {
"inbound_id": "inb_nfe_123456",
"tipo_documento": "nfe",
"nsu": 10542,
"chave_acesso": "35260912345678000195550010000456781000045679",
"serie": 1,
"numero": 45678,
"emitente": {

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

Ao receber o webhook monitor.document_received, seu backend pode registrar automaticamente a Ciência da Operação para liberar o download do XML completo na SEFAZ:

curl -X POST "https://api.nfer.me/v1/nfe/received/inb_nfe_123456/manifest" \
-H "Authorization: Bearer sec_live_sua_chave_secreta" \
-H "Content-Type: application/json" \
-d '{
"acao": 210210
}'

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.