Webhooks NFC-e
Notificações em tempo real com buffer binário ESC/POS para impressão rápida.
Webhooks para NFC-e (Modelo 65) fornecem atualizações instantâneas no seu PDV ou servidor de retaguarda. No momento em que o cupom é autorizado pela SEFAZ, o NFER envia um POST com os links de XML, DANFE e o buffer binário ESC/POS em Base64 pronto para disparo na impressora do caixa.
Eventos de NFC-e
| Evento | Gatilho / Momento | Ação no PDV |
|---|---|---|
nfe.autorizada | SEFAZ autorizou o cupom fiscal (cStat 100). | Imprimir cupom no caixa via ESC/POS e liberar o cliente. |
nfe.erro | SEFAZ rejeitou o cupom ou erro de validação (ex: CSC inválido). | Exibir mensagem no PDV, corrigir dados ou acionar contingência. |
nfe.cancelada | Cancelamento da NFC-e homologado na SEFAZ (cStat 135). | Estornar lançamento no caixa e atualizar estoque. |
Payload de NFC-e Autorizada (com ESC/POS)
Note que para NFC-e, o payload inclui automaticamente as chaves escpos (comandos em Base64) e escpos_url, dispensando requisições adicionais do PDV:
1
2
3
4
5
6
7
8
9
10
11
12
{
"event": "nfe.autorizada",
"data": {
"id": "18f4a132-728b-4d43-982c-fb75c2e19a4e",
"numero": 1042,
"serie": 1,
"modelo": "65",
"status": "autorizada",
"chaveAcesso": "35260312345678000195650010000010421000010420",
"protocolo": "135260000123456",
"valorTotal": 35.00,
"ambiente": "producao",
Cadastrar Endpoint de Webhook
POST
/v1/webhooksCadastra uma URL HTTPS para receber notificações.
1
2
3
4
5
6
7
8
curl -s -X POST https://api.nfer.me/v1/webhooks \
-H "X-API-Key: $NFER_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://seu-pdv.com.br/api/webhooks/nfer",
"secret": "whsec_chave_secreta_para_validar_hmac",
"events": ["nfe.autorizada", "nfe.erro", "nfe.cancelada"]
}'