Skip to main content

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:
  1. Acesse Configurações > Integrações > Webhooks
  2. Clique em Novo Webhook
  3. Selecione o evento Envio de Nota Fiscal
  4. Informe a URL do seu endpoint
  5. 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_url aponta para o DANFCE
  • NFS-e tem estrutura similar mas sem chave de acesso