Erros comuns e soluções
| Situação | O que fazer |
|---|---|
| Nota rejeitada | Leia a mensagem exibida, corrija o campo indicado e emita novamente |
| Limite atingido | Acesse Assinatura → Mudar de plano ou aguarde a virada do mês |
| Certificado vencido | Envie o novo .pfx em Empresas → Certificado |
| Boleto não gerado | Confira o motivo no detalhe da nota e os dados bancários e do tomador |
| Recorrência não rodou | Consulte o histórico da recorrência e, após corrigir a causa, use Executar agora |
API respondendo erro (4xx)
| HTTP | Código | Como resolver |
|---|---|---|
| 400 | VALIDACAO | Corrija o campo indicado na mensagem |
| 400 | PERFIL_TRIBUTARIO | Selecione um perfil válido, ativo e pertencente à empresa emissora |
| 409 | IDEMPOTENCIA_MODO | Não reutilize entre emissão síncrona e assíncrona uma chave já usada |
| 409 | IDEMPOTENCIA_CONFLITO | Não reutilize a mesma chave com um corpo diferente |
| 413 | LOTE_GRANDE | Reduza o lote síncrono ou use ?async=true |
| 401 | NAO_AUTORIZADO | Confira a chave, a expiração e o header de autenticação |
| 402 | BILLING | Plano ou limite bloqueou a emissão (inclui teto de reserva atingido); regularize a assinatura ou mude de plano |
| 403 | ESCOPO_INSUFICIENTE | Use uma chave com escopo EMISSAO para emitir |
| 403 | PLANO_SEM_INTEGRACOES | Regularize a assinatura ou use um plano que inclua Integrações |
| 404 | NAO_ENCONTRADO | Confira o recurso e se a chave pertence à conta correta |
| 429 | rate limit | Respeite o header Retry-After |
Não achou seu caso?
Consulte o capítulo Mensagens de erro. Se ainda precisar de ajuda, use o canal indicado pelo NotasPJ.