---
updatedAt: 2025-11-10T23:08:43.000Z
agentTools:
  projectIndex: https://docs.melhorenvio.com.br/llms.txt
---

# Cotação de fretes

Saiba como desenvolver a integração da cotação de fretes

<div style={{ textAlign: "justify" }}>

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 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.
* Caso 2: 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;

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 produtos como um array no parâmetro `products`.\
  Ambos os modelos estão devidamente representados na referência da API.

**Para o caso 2**:

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

### 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 detalhes técnicos sobre Cotação de fretes, clique [aqui](https://docs.melhorenvio.com.br/reference/calculo-de-fretes-por-produtos) para consultar o respectivo tópico de nossa referência à API.

</div>