Exemplos

Exemplos práticos de chamadas para as rotas públicas da Infiny, organizados de forma simples para acelerar a primeira integração.

Ir para a primeira secao Voltar ao portal

Nesta página

Ordem sugerida para uma primeira integração Cotação, criação e tracking Cancelamento e XML de nota fiscal

Fluxo mínimo

Ordem sugerida para uma primeira integração

Se você estiver começando agora, esta é a sequência mais segura para sair de uma POC para uma integração em produção.

Autorizar o seller e salvar token + reference.
Testar a autenticação com uma cotação de frete.
Criar um pedido de teste e guardar o tracking_code.
Consultar tracking para validar a leitura do pedido.
Configurar e validar o webhook antes de subir volume real.

Requests principais

Cotação, criação e tracking

Os exemplos abaixo cobrem o ciclo mínimo da API pública e já são suficientes para um primeiro fluxo funcional.

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"
  }'

Request de criação

json

{
  "company_document": "12345678000199",
  "orderId": "ORDER-2026-000184",
  "orderCost": 159.9,
  "trackingCode": "INF-ORDER-2026-000184",
  "service": "infiny",
  "items": [
    {
      "description": "Kit same day",
      "dimensions": "20x12x10,1.4",
      "quantity": 1,
      "price": 159.9
    }
  ],
  "receiver": {
    "name": "Ana Costa",
    "phone": "1133334444",
    "cellphone": "11999998888",
    "email": "ana@example.com",
    "document": "12345678900",
    "address": {
      "state": "SP",
      "city": "São Paulo",
      "zipCode": "04538132",
      "street": "Rua Helena",
      "streetNumber": "245",
      "neighborhood": "Vila Olímpia",
      "complement": "Conj. 11"
    }
  },
  "invoice": {
    "series": "1",
    "number": "18492",
    "issueDate": "2026-03-25 14:30:00",
    "value": 159.9,
    "key": "35260312345678000199550010000184921000018492"
  }
}

Tracking por número do pedido

bash

curl -G "https://use.infiny.com.br/api/integration/orders/tracking" \
  -H "Authorization: Basic pk_xxxxxxxxxxxxxxxxx" \
  --data-urlencode "type=order_number" \
  --data-urlencode "value=ORDER-2026-000184"

Complementos

Cancelamento e XML de nota fiscal

Depois do fluxo principal, estes são os exemplos mais úteis para completar a integração atual da Infiny.

Request de cancelamento

json

{
  "orderId": "ORDER-2026-000184"
}

Upload via cURL

bash

curl -X POST "https://use.infiny.com.br/api/integration/invoices/mercado-livre" \
  -H "Authorization: Basic pk_xxxxxxxxxxxxxxxxx" \
  -F "nfe=@nota-fiscal.xml"

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.

Falar com a Infiny Revisar endpoints