O meu ecommerce tem dois tipos de limite. O limite mensal vale só para o plano Grátis. O limite por minuto vale para todos os planos. Os dois são os mesmos na API e no MCP, e contam por loja.
Limite mensal do plano Grátis
Uma loja sem plano pago fica no plano Grátis, sem cartão de crédito. Ele inclui, por mês:
- 10 cotações de frete
- 10 rastreios
- 10 etiquetas
- 1 embalagem usada no cálculo
A contagem recomeça no início de cada mês, no horário UTC.
Os planos Pro e Avançado não têm limite mensal. Você vê e troca o seu plano no painel, na aba Plano.
Limite por minuto, em todos os planos
| Operação | Chamadas por minuto |
|---|---|
| Cotação de frete | 60 |
| Rastreio | 30 |
| Download de etiqueta | 30 |
| Emissão de etiqueta | 20 |
O minuto é o do relógio em UTC, e não os últimos 60 segundos. Assim, a contagem zera quando o minuto vira.
Limite por chamada
- Cotação: até 50 itens por chamada.
- Rastreio: até 50 códigos por chamada.
- Tamanho da chamada: até 32.000 bytes.
O que acontece quando um limite é atingido
- free_quota_exceeded (erro 402): a loja usou as 10 chamadas do mês daquela operação no plano Grátis. A resposta traz um link para assinar um plano. Sem assinar, a operação volta a funcionar no mês seguinte.
- rate_limited (erro 429): a loja passou do limite por minuto. Espere os segundos indicados no campo Retry-After e tente de novo.
- too_many_items, too_many_codes ou payload_too_large: a chamada passou do limite por chamada. Divida em chamadas menores.
Se você integra pelo seu sistema, trate sempre os erros 402 e 429. Para cotação e rastreio, tente de novo com espera crescente e um número máximo de tentativas. Para etiquetas, não repita a emissão automaticamente, porque cada nova tentativa pode criar outra pré-postagem nos Correios.
Os detalhes técnicos estão no portal de desenvolvedores.