API para integrar ao seu sistema

Ative o módulo API e webhooks em *Configurações → Módulos* (planos Rede e Integrador) e crie uma chave em *Configurações → API*. A chave aparece uma única vez; guarde-a no seu sistema.

• Autenticação: cabeçalho Authorization: Bearer np_live_...
• Idempotência: envie Idempotency-Key em POST /api/v1/notas; repetir a mesma chave devolve a mesma nota, sem emitir duas vezes.
• Toda chamada é contada em *Plano e cobrança → Uso da API*.
• Documentação completa com exemplos curl: /api/docs.

Fluxo típico: POST /api/v1/notas (calcula e confere) → POST /api/v1/notas/{id}/emitir → receber o webhook nota.emitida (assinado com HMAC) → GET /api/v1/notas/{id}/xml e /danfse.pdf.

Em cofre com chave do operador, a chave de API criada com o cofre aberto carrega uma cópia da chave de dados e funciona sem sessão web.