Caso necessite, disponibilizamos a seguir alguns fluxogramas que poderão lhe auxiliar a visualizar este processo conforme a sua plataforma, assim como servir de base para que você adapte da melhor maneira ao seu próprio fluxo:

• Fluxograma para E-commerce, ERP ou Hub
• Fluxograma para Marketplace

Cotação por Produtos

Os dados devem ser enviados com suas informações unitárias:

• Dimensões (altura, largura, comprimento) em centímetros (cm);
• Peso em quilogramas (kg);
• Valor do produto em insurance_value (em double - apenas duas casas decimais);
• Quantidade (em unidades).

Exemplo de Requisição (Produto)

{
  "from": {
      "postal_code": "96020360"
  },
  "to": {
      "postal_code": "01018020"
  },
  "products": [
      {
          "id": "Produto A",
          "width": 11, //cm
          "height": 17, //cm
          "length": 11, //cm
          "weight": 1, //kg
          "insurance_value": 10.1, //BRL
          "quantity": 1 //unidade de produto
      },
      {
          "id": "Produto B",
          "width": 10,
          "height": 10,
          "length": 12,
          "weight": 0.2,
          "insurance_value": 10.1,
          "quantity": 5
      }
  ],
  "options": {
      "receipt": false,
      "own_hand": false
  },
  "services": "1,2,18"
}

Detalhes dos Parâmetros

📘

Valor segurado total

O valor segurado total (insurance_value) é calculado pela nossa API multiplicando o insurance_value unitário pela quantity de cada item.

Cotação por Pacotes

Os dados devem ser enviados com suas informações unitárias:

• Dimensões (altura, largura, comprimento) em centímetros (cm);
• Peso em quilogramas (kg);
• Valor do produto em insurance (em double - apenas duas casas decimais).

Exemplo de Requisição (Pacotes)

{
  "from": {
      "postal_code": "96020360"
  },
  "to": {
      "postal_code": "01018020"
  },
  "volumes": [
      {
          "width": 11,
          "height": 17,
          "length": 11,
          "weight": 0.3,
          "insurance": 10.1
      },
      {
          "width": 20,
          "height": 25,
          "length": 25,
          "weight": 1.5,
          "insurance": 1000
      }
  ],
  "options": {
      "receipt": false,
      "own_hand": false
  },
  "services": "1,2,18"
}

Detalhes dos Parâmetros

📘

Valor segurado

• O valor segurado (insurance) é calculado pela nossa API multiplicando o insurance unitário pela quantity de cada item.
• Serviços Adicionais (options):
• options.receipt (Aviso de Recebimento): Adiciona custo extra com Correios e JadLog.
• options.own_hand (Mãos Próprias): Adiciona custo extra apenas com Correios.

Parâmetros de Resposta

Para sua integração, utilize o custom_price e o custom _delivery_time informados no retorno da nossa API. Eles refletem os valores com as customizações (taxas ou descontos) configuradas na conta Melhor Envio do usuário integrado, em vez dos valores originais (price e delivery_time).

⚠️

Restrição (Azul Cargo)

Embora seja possível cotar fretes com a Azul Cargo, a compra de etiquetas comerciais (NFe) dessa transportadora não está disponível via API, devendo ela ser utilizada apenas para envios não-comerciais (DEC).