O que é webhook de NFS-e e para que serve
· 5 min de leitura
Webhook de NFS-e é uma notificação automática que um sistema envia para outro assim que uma nova nota de serviço é recebida, em vez de o seu sistema perguntar repetidamente “tem nota nova?”, é avisado no momento em que ela chega.
O que é um webhook
Na prática, é uma chamada HTTP que o sistema que monitora as notas (a IntegroBR, por exemplo) faz para uma URL que você configura (geralmente um endpoint da sua própria aplicação), carregando os dados do evento, como a nota recém-recebida. É o sistema avisando você, em vez de você perguntar a ele.
Diferença para consulta ativa
Consultar ativamente (via portal ou API) significa que alguém (pessoa ou sistema) precisa iniciar a pergunta “tem algo novo?” em intervalos. O webhook inverte isso: o sistema monitorado é que inicia o contato, exatamente quando há algo novo, eliminando a necessidade de perguntar repetidamente. Veja a comparação completa em webhook x consulta periódica (polling).
Casos de uso comuns
Disparar a conciliação financeira assim que uma nota chega, alertar o time responsável, ou atualizar automaticamente um sistema de contas a pagar, veja exemplos práticos em casos de uso de webhook para recebimento fiscal automático. Antes de implementar, vale também revisar como lidar com falhas e reentrega, já que nem toda chamada chega de primeira.
Perguntas frequentes
Um webhook substitui completamente a consulta por API?
Na maior parte dos casos, sim, para o propósito de saber quando uma nota nova chegou, mas vale manter uma consulta pontual disponível para reconciliação ou para recuperar um evento que eventualmente não tenha sido entregue.
Antes de expor um endpoint pra receber webhooks, vale conferir as boas práticas de segurança em webhooks de documentos fiscais. A IntegroBR NFS-e Recebidas já dispara um webhook assinado a cada nota recebida. Você escolhe o período que quer monitorar, cadastra o endpoint, e recebe o evento automaticamente, sem consultar nada manualmente.