Webhooks do Monitor Fiscal
Eventos em tempo real de documentos recebidos, manifestações e cancelamentos.
Os Webhooks do Monitor Fiscal disparam eventos HTTP POST em tempo real para o endpoint configurado na sua conta assim que novos documentos ou alterações de status forem detectados nos servidores da SEFAZ, SVRS ou ADN.
Eventos Suportados
| Evento | Descrição | Quando é disparado |
|---|---|---|
| nfe.received | Nova NF-e detectada na SEFAZ Nacional | No instante em que uma NF-e modelo 55 é emitida contra seu CNPJ. |
| nfe.manifested | Manifestação do Destinatário registrada | Quando um evento MD-e (210200, 210220, etc.) é homologado. |
| nfse.received | Nova NFS-e detectada no ADN Nacional | Assim que um serviço tomado é autorizado na Receita Federal. |
| nfse.cancelled | Cancelamento de NFS-e tomado detectado | Alerta crítico: prestador cancelou a nota fiscal. |
| nfse.substituted | NFS-e substituída por outra no ADN | Alerta de nota substituta emitida pelo prestador. |
| cte.received | Novo CT-e rodoviário detectado na SVRS | Quando uma transportadora emite frete contra sua empresa. |
| cte.desacordo | Evento 610110 registrado na SEFAZ | Quando a prestação em desacordo é homologada com sucesso. |
Exemplo de Payload: nfe.received
1
2
3
4
5
6
7
8
9
10
11
12
{
"event": "nfe.received",
"created_at": "2026-09-18T11:00:25.142Z",
"data": {
"id": "nfe_rec_8819",
"chave_acesso": "35260907358761000169550010000120041000120045",
"numero": 12004,
"serie": 1,
"emitente": {
"cnpj": "07.358.761/0001-69",
"razao_social": "Gerdau Aços Longos S/A",
"uf": "SP"
Validação de Segurança com Assinatura HMAC
Todo webhook disparado pelo NFER inclui o cabeçalho X-NFER-Signature contendo a assinatura criptográfica HMAC SHA-256 do payload bruto calculada com o seu Webhook Secret, garantindo que a requisição partiu legitimamente dos nossos servidores.