Cotação de fretes

Integrando a cotação de fretes em sua plataforma, você estará disponibilizando em tempo real para seus usuários os preços do Melhor Envio.

Existem duas formas de realizar o cálculo de fretes:

Caso 1: se sua plataforma já possuir um gerenciamento de pacotes/volumes ou faça o cálculo do empacotamento dos produtos de alguma forma, você pode realizar o cálculo informando os pacotes/volumes previamente calculados;
Caso 2: se sua plataforma não possuir um gerenciamento de pacotes próprio, você pode informar apenas os dados dos produtos a serem enviados. O Melhor Envio se encarrega de fazer o cálculo de empacotamento com base nos limites de cada serviço de cada transportadora e retorna para você já a cotação com todos os volumes calculados.

A principal diferença entre estas duas formas é no payload que será informado no corpo da requisição.

Para o caso 1:

Serão informados os volumes como um array no parâmetro volumes.

Para o caso 2:

Serão informados os produtos como um array no parâmetro products.
Ambos os modelos estão devidamente representados na referência da API.

Parâmetros obrigatórios

Os únicos parâmetros obrigatórios para realizar uma cotação de fretes são:

CEP de origem
CEP de destino
informações de produtos/volumes.

Todas as informações de dimensões deverão ser informadas em centímetros (cm), as informações relativas a peso deverão ser informadas em quilogramas (kg) e as informações relacionadas aos valores dos itens a serem enviados deverão ser informados em reais. Todos os valores informados na sua respectiva representação como integer ou float.

Parâmetros opcionais

Há uma série de parâmetros opcionais que podem ser incluídos nas requisições de cotação de fretes, servindo para o caso de se necessitar realizar alguma requisição personalizada.

Prazo e valor adicionais

De maneira geral, as customizações de cotação de fretes podem ser feitas pelo usuário a qualquer momento direto na configuração do aplicativo, no painel Integrações dentro do Melhor Envio, bastando o usuário possuir um token válido para o aplicativo em questão.

No resultado de uma cotação, o recomendado é utilizar os campos custom, por exemplo custom_price e custom_delivery_time, pois estes campos representam os valores com base na customização realizada pelo usuário nas configurações do aplicativo.

Caso seja integrada também a compra de fretes via API, é recomendado que as informações da cotação sejam salvas no momento do checkout do pedido para garantir que o envio seja criado no Melhor Envio respeitando as informações retornadas na cotação.

Cotação de múltiplos fretes

Para cada requisição de cotação são calculados apenas os valores para 1 frete. Ou seja, 1 usuário vendedor e/ou 1 par de CEPs para origem e destino.

Para calcular os valores para mais fretes, como no carrinho ou checkout de um marketplace, onde há produtos de diversas origens, deverão ser realizadas diversas requisições de cotação e realizar o agrupamento após receber todos os resultados.

Os agrupamentos de fretes normalmente são realizados de 2 formas:

“frete econômico”:, agrupando os fretes mais baratos e mostrando como “frete econômico”
“frete expresso”: agrupando os fretes mais rápidos e mostrando como “frete expresso”.

Essa é uma decisão inteiramente da plataforma. Fique à vontade para implementar apenas uma destas opções, ambas ou mais alguma ideia própria.

Para detalhes técnicos sobre Cotação de fretes, clique aqui para consultar o respectivo tópico de nossa referência à API.