Primeiros passos
Checklist de produção
Antes de usar a chave de produção (ntm_prod_), confira cada item:
Chaves e segurança
- A chave de produção está guardada no cofre de segredos do servidor, nunca no código-fonte nem no navegador.
- O sistema registra o
X-Request-Idde cada resposta, para informar ao suporte. - Existe um procedimento para trocar a chave sem interrupção (duas chaves ativas durante a troca). Veja Autenticação.
Empresas
-
GET /empresas/{id}/situacaocom a chave de produção devolvepronta_para_emitir: true. - O certificado A1 está válido e o sistema acompanha
certificado.vencendo. - A configuração fiscal foi conferida com o contador da empresa. Veja Configuração fiscal.
- Os serviços têm classificação IBS/CBS completa (obrigatória a partir de 01/01/2027). Veja IBS/CBS.
Emissão
- Toda emissão, cancelamento e substituição envia uma
Idempotency-Keyprópria e a reutiliza em reenvios. Veja Idempotência. - O sistema trata
202(nota em verificação) sem reenviar com outra chave. - As recusas
422mostram ao usuário amensagemde cada item deerro.detalhes. - O sistema respeita
429e o cabeçalhoRetry-After. Veja Limites de uso.
Webhooks
- O endereço de produção está cadastrado no painel, com HTTPS.
- A assinatura
Notem-Assinaturaé validada antes de usar o conteúdo. Veja Assinatura. - O sistema responde
2xxem até 10 segundos e ignora eventos repetidos peloid.

