API pública atual

Base no TMS real

Produção

Developer Portal

API pública da Infiny

Documentação técnica da integração pública da Infiny, escrita a partir dos endpoints reais do TMS. Os caminhos da docs usam nomes mais didáticos, sem quebrar compatibilidade com as rotas legadas já existentes.

Começar pela introdução Ver endpoints ativos

Rotas públicas

Frete, pedido, cancelamento, XML de nota fiscal e tracking.

Autenticação

Basic token

Header Authorization com token provisionado no painel.

Base URL

use.infiny.com.br/api

As chamadas públicas saem do host do painel com prefixo /api.

Retorno assíncrono

Webhook

Mudanças de status podem voltar para o integrador automaticamente.

Quickstart

Suba a integração sem inventar fluxo paralelo

O caminho real hoje é simples: seller autoriza, parceiro salva o token, valida frete, cria pedido, guarda tracking e consome webhook.

Autorize o seller no painel ou pelo fluxo /integrate-seller

O token público nasce no TMS. O redirecionamento devolve token e reference para o seu redirectTo.

Use o host do painel com prefixo /api

A documentação prefere caminhos mais claros, mas as rotas legadas continuam aceitas no backend atual.

Autentique com Authorization: Basic <TOKEN>

O middleware público valida o token puro logo após Basic. Não é usuário e senha em base64.

Siga o ciclo frete → pedido → tracking → webhook

Valide cobertura, abra o pedido, armazene o tracking_code e trate o webhook como retorno principal de status.

Como o token nasce hoje

No TMS atual, o token público nasce no painel de integrações. No fluxo assistido de /integrate-seller, o seller autoriza a integração e o token volta para o redirectTo informado pelo parceiro.

Nuance importante do header Authorization

O middleware CheckPublicAPIAuth aceita o formato Authorization: Basic <TOKEN>. Hoje o valor após Basic é tratado como token puro e comparado diretamente na tabela public_integrations.

Requisição autenticada

bash

curl -X POST "https://use.infiny.com.br/api/integration/shipping/quote" \
  -H "Authorization: Basic pk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "origin": "01001000",
    "destination": "20040030"
  }'

Endpoints atuais

A referência pública já está separada por função

Os nomes abaixo priorizam clareza na documentação. Se você já usa os caminhos legados, o backend continua aceitando as rotas antigas.

Abrir referência completa

POST

/api/integration/shipping/quote

Cotar frete

Retorna valor e prazo para uma origem, um destino e um pacote.

POST

/api/integration/orders

Criar pedido

Abre um pedido com remetente, destinatário, itens e nota fiscal opcional.

POST

/api/integration/orders/cancel

Cancelar pedido

Cancela um pedido ainda não entregue.

POST

/api/integration/invoices/mercado-livre

Enviar XML de NFe

Recebe um XML e associa os pedidos do Mercado Livre encontrados em xPed.

GET

/api/integration/orders/tracking

Consultar tracking

Retorna tracking_code e histórico de status para pedidos vinculados ao token.

Comece pelo fluxo

Onboarding do seller

O fluxo /integrate-seller entrega token e referência sem expor credencial do seller ao seu sistema.

Abrir página

Referência técnica

Endpoints ativos

Cotação, criação, cancelamento, XML e tracking documentados a partir dos controllers reais do TMS.

Abrir página

Retorno operacional

Webhook de status

O TMS pode notificar o seu sistema quando o status do pedido muda em produção.

Abrir página

Saúde do ambiente

Monitor ao vivo

Leitura em tempo real de site, painel, APIs, filas e conectores ativos do ecossistema.

Abrir página

Rotas didáticas com compatibilidade legada

A documentação usa aliases mais claros para facilitar leitura. O backend também mantém compatibilidade com os caminhos legados já usados por integrações existentes.

API atual

Recomendações de idempotência, reconciliação, logging e rollout para integrar a API pública da Infiny com menos retrabalho e menos risco operacional.

Abrir página