Pular para o conteúdo principal

Erros comuns e soluções

SituaçãoO que fazer
Nota rejeitadaLeia a mensagem exibida, corrija o campo indicado e emita novamente
Limite atingidoAcesse Assinatura → Mudar de plano ou aguarde a virada do mês
Certificado vencidoEnvie o novo .pfx em Empresas → Certificado
Boleto não geradoConfira o motivo no detalhe da nota e os dados bancários e do tomador
Recorrência não rodouConsulte o histórico da recorrência e, após corrigir a causa, use Executar agora

API respondendo erro (4xx)

HTTPCódigoComo resolver
400VALIDACAOCorrija o campo indicado na mensagem
400PERFIL_TRIBUTARIOSelecione um perfil válido, ativo e pertencente à empresa emissora
409IDEMPOTENCIA_MODONão reutilize entre emissão síncrona e assíncrona uma chave já usada
409IDEMPOTENCIA_CONFLITONão reutilize a mesma chave com um corpo diferente
413LOTE_GRANDEReduza o lote síncrono ou use ?async=true
401NAO_AUTORIZADOConfira a chave, a expiração e o header de autenticação
402BILLINGPlano ou limite bloqueou a emissão (inclui teto de reserva atingido); regularize a assinatura ou mude de plano
403ESCOPO_INSUFICIENTEUse uma chave com escopo EMISSAO para emitir
403PLANO_SEM_INTEGRACOESRegularize a assinatura ou use um plano que inclua Integrações
404NAO_ENCONTRADOConfira o recurso e se a chave pertence à conta correta
429rate limitRespeite 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.