Cálculo de Fretes

Fretes podem ser calculados informando uma lista de produtos, fazendo com que sejam montados pacotes de acordo com os limites de cada serviços das transportadoras.

Os dados dos produtos devem conter suas informações unitárias, sendo que as dimensões devem ser enviadas em centímetros (cm) e o peso em quilogramas (kg).

Caso não saiba como encaixar este processo ao fluxo de seu sistema, 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:

📘
O valor segurado será calculado com base no valor unitário (insurance_value) de cada item multiplicado pela quantidade de itens (quantity).

📘
O parâmetro options.receipt é referente ao serviço adicional de Aviso de Recebimento. Caso ativado, deve resultar em cotações mais caras com Correios e JadLog apenas, visto que são serviços que apenas estas transportadoras oferecem.

📘
O parâmetro options.own_hand é referente ao serviço adicional de Mãos Próprias. Caso ativado, deve resultar em cotações mais caras com Correios apenas, visto que são serviços que apenas esta transportadora oferece.

📘
Para o caso de ser necessário customizar quais o serviços deverão ser cotados e retornados na requisição, é possível informar o parâmetro services contendo uma string com os IDs dos serviços separados por vírgula.

📘
Na resposta de uma cotação são retornados os parâmetros custom_price e custom_delivery_time que representam os valores considerando a customização feita pelo usuário na configuração do aplicativo, portanto recomendamos que sejam utilizados estes parâmetros em detrimento dos parâmetros price e delivery_time.

🚧
Importante: Embora seja possível realizar o cálculo de frete com a transportadora Azul Cargo, esta transportadora não está disponível para compra de etiquetas através da API.

Abaixo um exemplo com os parâmetros opcionais:

{
    "from": {
        "postal_code": "96020360"
    },
    "to": {
        "postal_code": "01018020"
    },
    "products": [
        {
            "id": "x",
            "width": 11,
            "height": 17,
            "length": 11,
            "weight": 0.3,
            "insurance_value": 10.1,
            "quantity": 1
        }
    ],
    "options": {
        "receipt": false,
        "own_hand": false
    },
    "services": "1,2,18"
}

Para uma documentação mais descritiva sobre como integrar a cotação de fretes, clique aqui para consultar o respectivo tópico de nossa nova documentação.

Fretes podem ser calculados informando os dados do pacote a ser enviado.

As dimensões do pacote devem ser enviadas em centímetros (cm) e o peso em quilogramas (kg).

📘
Neste método há de se realizar um cálculo prévio de empacotamento dos produtos em vias de garantir que todos os itens podem ser enviados no pacote calculado.

📘
No parâmetro optons.insurance_value deve ser informado o valor a ser segurado e tipicamente é correspondente ao valor dos produtos enviados no pacote.

📘
O parâmetro options.receipt é referente ao serviço adicional de Aviso de Recebimento. Caso ativado, deve resultar em cotações mais caras com Correios e JadLog apenas, visto que são serviços que apenas estas transportadoras oferecem.

📘
O parâmetro options.own_hand é referente ao serviço adicional de Mãos Próprias. Caso ativado, deve resultar em cotações mais caras com Correios apenas, visto que são serviços que apenas esta transportadora oferece.

📘
Na resposta de uma cotação são retornados os parâmetros custom_price e custom_delivery_time que representam os valores considerando a customização feita pelo usuário na configuração do aplicativo, portanto recomendamos que sejam utilizados estes parâmetros em detrimento dos parâmetros price e delivery_time.

📘
Para o caso de ser necessário customizar quais o serviços deverão ser cotados e retornados na requisição, é possível informar o parâmetro services contendo uma string com os IDs dos serviços separados por vírgula.

🚧
Importante: Embora seja possível realizar o cálculo de frete com a transportadora Azul Cargo, esta transportadora não está disponível para compra de etiquetas através da API.

Exemplo com os parâmetros opcionais:

{
    "from": {
        "postal_code": "01002001"
    },
    "to": {
        "postal_code": "90570020"
    },
    "package": {
        "height": 4,
        "width": 12,
        "length": 17,
        "weight": 0.3
    },
    "options": {
        "insurance_value": 1180.87,
        "receipt": false,
        "own_hand": false
    },
    "services": "1,2,3,4,7,11"
}