Começando
Limites da API
Regras que valem hoje para toda chamada à API -- atualizamos esta página assim que algo mudar.
Idempotência
Toda operação de emissão aceita uma chave de idempotência, enviada no corpo
(idempotencia) ou no cabeçalho Idempotency-Key. Reenviar a
mesma chave nunca gera um segundo documento -- a API devolve o
resultado da primeira tentativa. Use isso para retry seguro em caso de timeout de rede.
Recomendação prática: use o identificador do pedido no seu próprio sistema como
chave de idempotência -- assim um retry automático do seu ERP nunca duplica uma nota.
Limite de requisições (rate limit)
Hoje não há um limite fixo de requisições por segundo aplicado por contrato. Isso
não é uma garantia de capacidade ilimitada -- é o estado real no momento: nenhum
429 Too Many Requests é retornado por rate limit hoje. Se sua
integração faz volume alto (lotes de centenas de documentos), fale com o time antes
de ir para produção para alinharmos expectativa de capacidade.
Tamanho de payload
Não há um limite documentado de tamanho de corpo da requisição além do razoável para um documento fiscal individual (poucos KB de JSON). Envio de anexos binários (XML, PDF) é sempre via download por URL na resposta, nunca embutido no corpo da requisição.