Descrição
Este webhook é acionado automaticamente sempre que uma nota fiscal eletrônica (NF-e) ou nota fiscal de consumidor eletrônica (NFC-e) for emitida e autorizada pela SEFAZ.Quando é Acionado
- Autorização de NF-e pela SEFAZ
- Autorização de NFC-e pela SEFAZ
- Emissão de NFS-e (Nota Fiscal de Serviço)
- Cancelamento de nota fiscal
- Carta de correção emitida
Estrutura da Notificação
Campos da Notificação
Exemplo de Implementação
PHP
Python
Node.js
Configuração
Para ativar este webhook:- Acesse Configurações > Integrações > Webhooks
- Clique em Novo Webhook
- Selecione o evento Envio de Nota Fiscal
- Informe a URL do seu endpoint
- Salve as configurações
Casos de Uso
- E-mail automático: Envie NF-e automaticamente para clientes
- Backup de XMLs: Armazene XMLs em servidores próprios ou cloud
- Integração contábil: Envie notas para sistema do contador
- Dashboard financeiro: Atualize dashboards com vendas faturadas
- Compliance: Mantenha histórico completo de notas emitidas
- Integração com ERP: Sincronize com sistemas de gestão externos
Boas Práticas
- Armazene XMLs: Guarde os XMLs por no mínimo 5 anos (obrigação fiscal)
- Backup redundante: Mantenha cópias em múltiplos locais
- Validação de chave: Valide o formato da chave de acesso (44 dígitos)
- E-mail profissional: Use templates bem formatados para envio ao cliente
- Consulta SEFAZ: Implemente consulta periódica do status na SEFAZ
- Tratamento de erros: Prepare-se para notas denegadas ou rejeitadas
Situações Possíveis
Observações
- O XML e PDF ficam disponíveis por 90 dias nas URLs fornecidas
- Após 90 dias, utilize a API para obter novamente os arquivos
- A chave de acesso é única e permite consulta na SEFAZ
- Notas canceladas também geram webhook com situação “cancelado”
- Para NFC-e, o campo
danfe_urlaponta para o DANFCE - NFS-e tem estrutura similar mas sem chave de acesso
