NFER
Visão GeralAutenticaçãoQuick StartChangelogConceitosEndpointsWebhooksErrosConceitosCódigos de ServiçoEndpointsWebhooksErrosEmpresaCadastrosNumeraçãoPlanos

Webhooks NFS-e

Eventos em tempo real da NFS-e autorizada e cancelada.

Os webhooks da NFS-e permitem que seu sistema receba notificações assíncronas em tempo real sempre que uma nota de serviço for autorizada, rejeitada ou cancelada no Ambiente de Dados Nacional.

Recomendação de Arquitetura

O uso de webhooks é o modelo recomendado para produção. Seu backend não precisa fazer polling na SEFIN.

Eventos Disponíveis

EventoDescriçãoMomento de Disparo
nfse.authorizedNFS-e autorizada com sucesso na SEFIN.Disparado assim que a DPS é processada e o DANFSE/chave de 50 dígitos são gerados.
nfse.rejectedDPS rejeitada pela SEFIN / Receita Federal.Disparado quando ocorrem inconsistências cadastrais ou tributárias com mensagem de erro explicativa.
nfse.canceledNFS-e cancelada com sucesso.Disparado após a confirmação do evento de cancelamento no ADN.

Exemplo de Payload (nfse.authorized)

O webhook envia um POST HTTPS com o payload JSON e a assinatura de segurança:

Webhook Payload (POST /seu-webhook)json
{
  "event": "nfse.authorized",
  "created_at": "2026-08-22T01:50:02Z",
  "data": {
    "id": "nfse_98b1a2c3-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
    "numero_nfse": 1420,
    "chave_acesso_50": "35260812345678000195000000000000000001420123456789",
    "prestador_cnpj": "00000000000191",
    "tomador_cpf_cnpj": "12345678000195",
    "tomador_nome": "Tech Solutions LTDA",
    "valor_total": 4500.00,
    "valor_iss": 135.00,
    "danfse_url": "https://api.nfer.me/v1/nfse/nfse_98b1a2c3/danfse.pdf",
    "xml_url": "https://api.nfer.me/v1/nfse/nfse_98b1a2c3/xml"
  }
}

Resposta do seu Servidor

Seu endpoint deve responder com status HTTP 200 OK em até 5 segundos. Caso seu servidor retorne erro ou timeout, a NFER realiza até 5 tentativas com backoff exponencial.

AnteriorEndpointsPróximoErros