Pular para o conteúdo principal

Limites e cotas

Os planos do Conota definem cotas de consumo por tipo de operação. As cotas existentes hoje cobrem nfe, nfse, nfce, cep, cnpj e assinatura eletrônica — além dos documentos de transporte, quando disponíveis.

Os números ficam no painel, não aqui

Valores de cota variam por plano e mudam comercialmente. Consulte o consumo da sua conta no painel; esta página descreve o comportamento, não os limites.

O que consome cota

OperaçãoConsome
Emitir NF-e / NFC-e / NFS-esim, 1 por emissão
Consultar CEP / CNPJsim
Consultar emissão, listar notas, relatóriosnão
POST /v1/nfe/verificar-camposnão
POST /v1/nfe/preparar (emissão assistida)não — só o confirmar
Baixar XML/PDFnão

Reenvio idempotente da mesma referencia_externa não debita de novo: não houve emissão nova.

Boas práticas

  • acompanhe o consumo no painel;
  • respeite os códigos HTTP e nunca entre em retentativa infinita;
  • não faça polling agressivo — ver processamento assíncrono;
  • use consulta em lote (POST /v1/jobs/consultar-lote) em vez de N chamadas;
  • use verificar-campos para validar payload sem gastar cota;
  • não repita uma emissão apenas para descobrir o estado dela — use /v1/jobs/localizar.

Janela dos relatórios

As rotas por período (/v1/jobs/erros, /v1/jobs/rejeitadas) aceitam no máximo 90 dias por consulta. Sem datas, retornam os últimos 7 dias. Acima de 90 dias, a resposta é 400 — pagine por períodos em vez de pedir o histórico inteiro.