Skip to content
Cadastrar-se no Melhor Envio:Crie uma conta no Melhor Envio.Obtenha as credenciais de acesso à API (Token de Autenticação).Cadastrar Vendedores e Endereços de Origem:Certifique-se de que cada vendedor no marketplace tenha um endereço de origem cadastrado no sistema.Isso é essencial para calcular o frete com base na localização de envio.Endpoint para Calcular Frete:Utilize o endpoint GET /api/v2/me/shipment/calculate para obter as cotações de frete.Parâmetros necessários:CEP de origem (fornecido pelo vendedor).CEP de destino (fornecido pelo comprador).Dimensões e peso do pacote:Altura, largura, comprimento e peso do produto (ou da encomenda).Valor declarado (opcional):O valor do produto para seguro.
id: Identificador do serviço.company: Nome da transportadora.name: Nome do serviço (PAC, SEDEX, etc.).price: Valor do frete.delivery_time: Prazo de entrega em dias úteis.
Vendedores Cadastrados:Cada vendedor deve ter seu CEP de origem configurado.Comprador escolhe produtos:No carrinho, calcule o frete total considerando:Produtos de diferentes vendedores.Dimensões e peso do pacote.O CEP de destino.API do Melhor Envio:Para cada vendedor, envie os dados necessários para calcular o frete.Retorne as opções de frete disponíveis para o comprador (PAC, SEDEX, transportadoras privadas).Escolha do frete:O comprador seleciona a opção de frete desejada.Adicione o custo ao valor total do pedido.
Vendedor A (CEP 01001-000):Envia o produto 1kg, 30x10x20 cm.Valor do produto: R$100.Vendedor B (CEP 02030-010):Envia o produto 2kg, 40x20x30 cm.Valor do produto: R$200.Fazer duas requisições à API para calcular o frete de cada vendedor.Exibir as opções de frete individualmente.Somar os custos de frete no total do pedido.
Dimensões e Peso:Certifique-se de coletar dimensões precisas para evitar discrepâncias nos custos de envio.Divisão do Frete no Split de Pagamento:Caso o frete seja pago pelo comprador, configure o split de pagamento no seu sistema para enviar o valor do frete ao vendedor responsável.Segurança e Taxas:Verifique se o Melhor Envio cobra taxas adicionais por serviços.Considere utilizar o seguro para envios de produtos de alto valor.
Integração com múltiplas transportadoras (Correios, JadLog, etc.).Cálculo de frete em tempo real.Preços competitivos e suporte a seguros.
Calcule o valor total do pedido, incluindo o preço dos produtos e o frete.Divida o valor dos produtos entre os vendedores com base nos produtos que eles forneceram.Divida o valor do frete de forma proporcional, se necessário, ou conforme a política do marketplace (exemplo: frete dividido de forma equitativa ou atribuído apenas ao vendedor que vai fazer o envio).
Vendedor A: Produto de R$50 e frete de R$10.Vendedor B: Produto de R$30 e frete de R$15.Vendedor C: Produto de R$20 e frete de R$5.
Distribuição dos Produtos:Vendedor A recebe R$50 (produto) + R$10 (frete) = R$60.
API - Melhor Envios
Cep de origem do seller
Cep destino do cliente
Dados essenciais para calcular o frete do produto
Altura
Largura
Comprimento
Peso
Seguro
Fluxo de Integração com a API do Melhor Envio
Exemplo de Requisição para Calcular Frete
http
Copiar código
GET https://www.melhorenvio.com.br/api/v2/me/shipment/calculate
Authorization: Bearer {seu_token}
Content-Type: application/json
Payload:
json
Copiar código
{
"from": {
"postal_code": "01001-000"
},
"to": {
"postal_code": "02020-020"
},
"products": [
{
"weight": 1.5,
"width": 30,
"height": 10,
"length": 20,
"insurance_value": 100.00,
"quantity": 1
}
],
"services": "1,2" // IDs das transportadoras, se desejar limitar.
}
Resposta da API (Exemplo)
json
Copiar código
[
{
"id": 1,
"company": "Correios",
"name": "PAC",
"price": 29.90,
"delivery_time": 7,
"currency": "BRL"
},
{
"id": 2,
"company": "Correios",
"name": "SEDEX",
"price": 49.90,
"delivery_time": 3,
"currency": "BRL"
}
]
Campos importantes na resposta:
Como Integrar no Marketplace
Exemplo Prático para Marketplaces
Se o comprador adquirir produtos de dois vendedores com CEPs de origem diferentes:
Você deve:
Considerações Importantes
Benefícios do Melhor Envio
Múltiplos sellers (vendedores) como funciona o split do sellers
Quando você tem múltiplos sellers (vendedores) em um mesmo pedido, a divisão do pagamento, incluindo o valor do frete, precisa ser configurada para garantir que cada um receba sua parte de forma correta. Aqui está como o processo pode ser estruturado:
Cenário de Múltiplos Sellers em um Pedido
Um pedido pode incluir produtos de diferentes vendedores, e cada vendedor pode ter um custo de frete associado. O objetivo é distribuir os valores dos produtos e do frete corretamente entre os vendedores responsáveis.
Estrutura do Split de Pagamento
Exemplo de Como Funciona o Split com Múltiplos Sellers
Suponha que um comprador faça um pedido que inclui produtos de três vendedores diferentes:
O total do pedido é de R$130 (R$100 de produtos + R$30 de frete).
Configuração do Split de Pagamento
O split pode ser configurado da seguinte forma:
Want to print your doc?
This is not the way.
This is not the way.
Try clicking the ··· in the right corner or using a keyboard shortcut (
CtrlP
) instead.