Erros e limites da API

Erros

Reaja pelo error.code (estável), não pela mensagem. 4xx de validação/negócio não se resolve repetindo — corrija a causa.

HTTP	code	O que fazer
401	`token_ausente` / `token_invalido`	Corrigir a chave
403	`requer_chave_dev` / `requer_chave_empresa`	Usar `aca_`/`ace_` certo
403	`produto_nao_vinculado`	Vincular o produto à empresa
409	`empresa_ja_cadastrada`	Buscar a existente / regenerar token
422	`emissao_rejeitada`	Ler o motivo, corrigir e reemitir
429	`rate_limit`	Respeitar `Retry-After` e re-tentar

Tratamento

{ "ok": false, "status": 403,
  "error": {
    "code": "produto_nao_vinculado",
    "message": "Empresa sem o produto nfe." } }

try {
  $cli->nfe()->emitir($nota);
} catch (AceleraApiException $e) {
  $e->getApiCode();     // "emissao_rejeitada"
  $e->isRateLimit();
  $e->getRetryAfter();
}

try
  R := Api.EmitirNFe(P);
except
  on E: EAceleraError do
    ShowMessage(E.Code + ': ' + E.Message);
end;

Limites de uso

60 requisições/minuto e 10.000/dia por chave.
Estouro → 429 rate_limit com header Retry-After.
Cobrança por unidade: 1 nota autorizada = 1 unidade; consulta = 1 unidade. Rejeição, configuração e downloads não cobram.

Acompanhe o consumo em GET /consumo.

429

HTTP/1.1 429 Too Many Requests
Retry-After: 30

{ "ok": false,
  "error": { "code": "rate_limit" } }

Não achou o que procurava? Índice da documentação · tabela de erros · servidor MCP · contexto para IA · suporte · [email protected]