Notavia Central de Ajuda Documentação da API →

Integração e chaves de API

O Notavia tem uma API REST para conectar seu ERP, e-commerce ou sistema interno: emitir notas, registrar eventos e sincronizar cadastros automaticamente. A documentação técnica completa está em /devs — esta página cobre o que se faz no portal: gerar a chave de acesso e configurar o webhook.

Gerando uma chave de API

A chave de API é a "senha" que o sistema externo usa para se autenticar. Só Administradores podem gerar e revogar chaves.

  1. Abra Administração → Integração (API).
  2. Em "Chaves de API", clique em Nova chave.
  3. Dê um nome que identifique quem vai usar (ex.: ERP, Loja virtual).
  4. Copie a chave na hora: ela é exibida uma única vez. Por segurança, o Notavia guarda só uma "impressão digital" (hash) — nem o suporte consegue recuperá-la depois.
  5. Entregue a chave ao responsável pela integração por um canal seguro (cofre de senhas; nunca por e-mail ou chat).

A chave dá acesso aos dados fiscais da sua empresa (emissão de notas inclusive). Trate-a como uma senha de banco: uma chave por sistema, e revogue na hora se houver suspeita de vazamento.

Revogando

Na mesma tela, o botão Revogar desativa a chave imediatamente — o sistema que a usava passa a receber erro de autenticação. Revogar uma chave não afeta as demais. Toda criação e revogação fica na auditoria.

A listagem mostra o prefixo (início) de cada chave e a data do último uso — útil para descobrir chaves esquecidas que podem ser revogadas.

Webhook (avisos automáticos)

Ainda na tela Integração, você pode cadastrar uma URL de webhook: o Notavia chama o seu sistema sempre que um job da API termina (nota autorizada, cancelamento processado…), em vez de o sistema ficar perguntando. O campo segredo assina as chamadas para o seu sistema verificar a autenticidade. Detalhes técnicos: /devs/webhooks.

Limites de uso

A API tem limite de requisições por minuto conforme o plano: 20/min no Free e 100/min nos planos pagos. As notas emitidas pela API contam na mesma franquia do plano — não há cota separada.

Para o desenvolvedor

Envie ao responsável técnico estes links: