Developer Docs
Introdução
Visão geral da API pública da Infiny, com onboarding do seller, fluxo de autorização e escopo real da integração disponível hoje.
Nesta página
Escopo atual
A integração pública atual cobre frete, criação de pedido, cancelamento, envio de XML de nota fiscal para Mercado Livre e tracking. O conteúdo desta documentação foi montado a partir dos controllers reais do TMS.
Frete
Cotação antes da operação
Consulte valor e prazo antes de abrir o pedido no fluxo operacional.
Pedido
Criação com tracking_code
Abra o pedido e receba o tracking_code já no retorno da API.
Retorno
Tracking e webhook
Use o webhook como canal principal de status e o tracking como leitura complementar.
Sem inventar endpoint
Onboarding
A Infiny usa um fluxo de autorização assistida para que o seller libere o token sem compartilhar credenciais diretamente com o parceiro.
Parâmetros obrigatórios do fluxo /integrate-seller
| Parâmetro | Descrição | Obrigatório |
|---|---|---|
| reference | Identificador único do seller no sistema do parceiro. | Sim |
| webhook | URL que vai receber mudanças de status da integração pública. | Sim |
| redirectTo | URL para onde o seller retorna após autorizar a integração. | Sim |
URL de autorização assistida
texthttps://use.infiny.com.br/integrate-seller?reference=cliente-123&webhook=https://seusistema.com/webhooks/infiny&redirectTo=https://seusistema.com/integracao/infinyFluxo resumido
- O parceiro redireciona o seller para /integrate-seller com reference, webhook e redirectTo.
- O seller entra no painel da Infiny e autoriza a integração.
- A Infiny redireciona o seller para o redirectTo com token e reference na query string.
- O parceiro armazena o token vinculado à referência do seller e passa a usar a API pública.
Como o token nasce hoje
Primeiros passos
O melhor caminho para uma primeira integração é simples: validar cobertura, abrir pedido, guardar tracking e tratar o webhook como retorno principal.
- Provisione o token no painel ou pelo fluxo /integrate-seller e armazene o token junto com a referência do seller.
- Valide cobertura e preço com /api/integration/shipping/quote antes de subir o fluxo de pedidos em produção.
- Envie o pedido com /api/integration/orders usando o company_document do seller dono do token.
- Armazene o tracking_code retornado pela criação para conciliação, atendimento e auditoria.
- Consuma o webhook de status e use /api/integration/orders/tracking como leitura complementar.
O webhook é parte do fluxo
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.