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ção | Consome |
|---|---|
| Emitir NF-e / NFC-e / NFS-e | sim, 1 por emissão |
| Consultar CEP / CNPJ | sim |
| Consultar emissão, listar notas, relatórios | não |
POST /v1/nfe/verificar-campos | não |
POST /v1/nfe/preparar (emissão assistida) | não — só o confirmar |
| Baixar XML/PDF | nã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-campospara 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.