Tratamento de Erros

A API utiliza códigos HTTP padrão para indicar o sucesso ou falha das requisições.

Códigos de Erro

Código	Mensagem	Causa Provável
400	Bad Request	Filtros inválidos ou período > 30 dias
401	Unauthorized	Token inválido ou expirado
404	Not Found	Recurso ou página não encontrada
500	Internal Error	Instabilidade temporária no serviço

Exemplo de Resposta de Erro

{
  "status": 401,
  "error": "Unauthorized",
  "message": "Usuário ou token não localizados."
}

Erros Comuns

Cenário	Solução
Período > 30 dias	Reduza o intervalo entre data_inicial e data_final
Token expirado	Gere um novo token no Portal Developers
Página não encontrada	Verifique se a remessa já foi concluída e o número da página é válido
Limite de requisições	Aguarde 60 segundos (limite: 10 req/s)