Limites e cotas

429: limite por minuto e cota do dia

Acima do limite, a resposta é 429 com o cabeçalho Retry-After (segundos) e application/problem+json. O codigo diz qual limite foi:

codigo	O que é
limite_excedido	Limite por minuto. Espere o Retry-After
cota_diaria_excedida	Cota do dia. Volta no dia seguinte
limite_de_recusas_excedido	Muitos envios recusados no dia. Corrija a causa antes de repetir

Toda resposta das operações com limite traz os cabeçalhos RateLimit-Policy e RateLimit, no formato do rascunho atual da IETF:

RateLimit-Policy: "default";q=60;w=60
RateLimit: "default";r=57;t=23

q é a cota da janela, w a janela em segundos, r o que resta e t os segundos até renovar. Use os cabeçalhos em vez de fixar números no seu código: as cotas dependem do plano da conta, e o sandbox tem cotas 10 vezes menores.

Em 429, espere o tempo de Retry-After e tente de novo. Em 5xx, repita com espera exponencial, até 5 vezes. Os exemplos do portal já fazem isso; veja a primeira chamada.

Consumo do dia

GET /v1/conta/uso (escopo conta:ler) mostra o consumo do dia e do mês por cota. As cotas fixas do contrato são:

Cota	Limite
empresas_dia	50 cadastros de empresa por dia
recusas_envio_dia	50 envios recusados por dia (só empresa_nao_cadastrada e arquivo_corrompido)
reenvios_dia	100 reenvios de evento de webhook por dia

Tamanhos

Item	Máximo
SPED (EFD ICMS/IPI e EFD Contribuições)	400 MB (20 MB no sandbox)
ZIP de XML de NF-e ou CF-e	200 MB (20 MB no sandbox)
XML por ZIP	50.000
ZIP descompactado	10 vezes o ZIP e no máximo 2 GB
Lote de consulta de ICMS	500 itens por chamada
Período de consulta de ICMS	240 meses

Arquivo acima do limite é recusado pelo Content-Length, antes de ser lido, com 413 arquivo_grande_demais. Lote acima de 500 itens: 413 lote_grande_demais.