API
API atual
Developer Docs
Erros
Status codes, mensagens mais comuns e leitura prática do que cada falha significa na API pública atual da Infiny.
Mapa de erros
A API atual mistura status HTTP tradicionais com algumas respostas de negócio herdadas do backend. Estes são os casos mais relevantes para a integração.
Erros mais frequentes
| Status | Quando acontece | Como tratar |
|---|---|---|
| 400 | CEP inválido, região sem cobertura, pedido duplicado ou cancelamento inválido. | Revise o payload e trate como erro de negócio. |
| 401 | Token ausente, inválido ou seller incompatível com a empresa informada. | Revisar Authorization e vínculo entre token e seller. |
| 403 | Consulta de tracking sem value. | Garantir os query params obrigatórios antes de chamar o endpoint. |
| 404 | Empresa ou pedido não encontrado. | Validar company_document, orderId e escopo da integração. |
| 422 | Payload inválido na validação do Laravel ou arquivo XML ausente/inválido. | Corrigir o formato do payload antes de reenviar. |
Tratamento
Quanto mais cedo o seu integrador registrar o contexto da chamada, menor o custo de suporte quando algo sair do esperado.
- Salve endpoint, método, payload mínimo, status code e mensagem recebida.
- Logue orderId, company_document e tracking_code sempre que esses campos existirem.
- Separe erro de validação de erro de negócio para não disparar retries desnecessários.
- Use alertas para 401, 404 recorrente e crescimento anormal de 422.
Mensagens literais do backend
Algumas respostas preservam textos do TMS exatamente como estão hoje. Isso ajuda a bater suporte e logs sem tradução intermediária.
Suporte
Precisa validar um fluxo específico?
Se você estiver homologando uma integração ou precisar conferir um comportamento da API pública atual, fale com a equipe da Infiny antes de subir volume real.