Cotações | Envio Fácil

As cotações retornam os serviços disponíveis para os dados informados, com preço e prazo estimados. Use a opção escolhida para criar o envio pela API.

Nacional

POST /api/v1/quotes/simulate
Authorization: Bearer <accessToken>
X-Tenant-Id: <lojaId>
Content-Type: application/json

{
  "originCep": "01310100",
  "destinationCep": "20040020",
  "peso": 1.5,
  "comprimento": 30,
  "largura": 20,
  "altura": 10,
  "valorDeclarado": 89.9,
  "hasPackaging": true,
  "format": "2"
}

Internacional

POST /api/v1/quotes/simulate-international

Use originPostalCode e destinationPostalCode quando a rota não usar CEP brasileiro. Envie os demais campos conforme o schema da operação.

Peso e dimensões

peso é informado em quilogramas;
comprimento, largura, altura, espessura e diametro usam centímetros;
format: "1" representa envelope e exige largura;
format: "2" representa caixa e exige largura mais altura ou espessura;
format: "3" representa cilindro e exige diametro;
a origem e o destino exigem CEP ou código postal correspondente.

Não envie dimensões inventadas apenas para passar na validação.

Resposta

{
  "shippingOptions": [
    {
      "quoteId": "64b232e7-8f9c-4d65-bb1d-95bf5c21ea46",
      "carrierId": "aaf3b0d6-bf2a-4af0-bb97-bd056a749ad1",
      "carrierSlug": "jt-express",
      "codigo": "EZ",
      "serviceCode": "EZ",
      "serviceLevelId": "22222222-2222-4222-8222-222222222222",
      "nome": "J&T Express",
      "preco": 14.17,
      "prazoEntrega": 4,
      "quotedAt": "2026-07-29T15:00:00.000Z",
      "expiresAt": "2026-07-29T15:30:00.000Z",
      "metadata": {}
    }
  ],
  "issues": []
}

serviceLevelId identifica o serviço no catálogo da Envio Fácil. Não use codigo ou serviceCode no lugar dele; preserve exatamente o UUID retornado.

Para criar o envio, persista quoteId, carrierId, serviceLevelId e expiresAt da opção selecionada. Preserve também carrierSlug, serviceCode, preco e prazoEntrega para exibição e auditoria no seu sistema.

shippingOptions: [] com issues descreve por que nenhuma opção foi encontrada. Não transforme automaticamente uma lista vazia em erro técnico.

Expiração

Use a cotação antes de expiresAt. Se ela expirar, faça outra simulação e solicite nova confirmação de preço.

Crie o envio →