Pular para o conteúdo
Docs

Limites da plataforma e da API

Atualizado em

Nesta página

Referência rápida dos limites que afetam integrações. Os detalhes de cada um estão nas páginas indicadas.

Por plano#

Plano Notas por mês Chamadas à API por minuto
Essencial 30 60
Profissional 150 120
Escala 600 600
Contador 1.500 (somadas entre os CNPJs) 600
Enterprise Sob medida Sob medida
Chaves de teste (sandbox) Não consomem cota 30
  • O rate limit vale por chave e por empresa. Os headers X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset mostram a situação em cada resposta; o 429 traz Retry-After. Veja Rate limits.
  • As notas emitidas pela API contam na mesma cota das emitidas pelo painel. A cota é contada na autorização.
  • Os valores atuais da sua empresa (plano, limites e uso do mês) estão em GET /integracao/me. Veja Conta e referência.

API#

Limite Valor Mais em
Tamanho máximo do corpo da requisição 1 MB
Itens por página (limit) padrão 50, máximo 200 Paginação
Validade de uma Idempotency-Key 24 horas Idempotência
Tamanho de uma Idempotency-Key até 120 caracteres Idempotência
Validade de uma chave de API obrigatória, até 1 ano Autenticação
Link temporário de XML/PDF 60 segundos NFS-e
Política de depreciação 6 meses de aviso, com header Sunset Versionamento

Webhooks#

Limite Valor
Tempo de resposta do seu endpoint 10 segundos
Tentativas por entrega até 7 (1 min, 5 min, 30 min, 2 h, 6 h, 24 h)
Falhas seguidas até desativar o endpoint 20
Retenção do log de entregas 90 dias
Protocolo e porta https, porta 443

Veja Retries e boas práticas.

Uploads#

Limite Valor
Certificado A1 (PFX) 256 KB
Planilha de emissão em lote 5 MB e 2.000 linhas
XML para conversão ou importação 5 MB por arquivo
Envio de vários XMLs 50 MB ou 500 arquivos
ZIP descompactado 200 MB no total, razão de compressão até 100×
Validador de DPS e ferramentas públicas 1 MB por arquivo
Ferramentas públicas 10 usos por hora por IP, por ferramenta

Retenção#

Dado Por quanto tempo
XML fiscal autorizado mínimo de 5 anos
Link de download de exportação 24 horas
Arquivo de exportação 7 dias
Resultado de conversão 24 horas
Planilha original de lote 90 dias
Dados criados com chaves de teste 30 dias
Eventos de conectores (Asaas) 90 dias
Logs técnicos 90 dias

Próximos passos#

Esta página foi útil?