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
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. 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. 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:
id: Identificador do serviço. company: Nome da transportadora. name: Nome do serviço (PAC, SEDEX, etc.). delivery_time: Prazo de entrega em dias úteis. Como Integrar no Marketplace
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. 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). O comprador seleciona a opção de frete desejada. Adicione o custo ao valor total do pedido. Exemplo Prático para Marketplaces
Se o comprador adquirir produtos de dois vendedores com CEPs de origem diferentes:
Vendedor A (CEP 01001-000): Envia o produto 1kg, 30x10x20 cm. Vendedor B (CEP 02030-010): Envia o produto 2kg, 40x20x30 cm. Você deve:
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. Considerações Importantes
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. Verifique se o Melhor Envio cobra taxas adicionais por serviços. Considere utilizar o seguro para envios de produtos de alto valor. Benefícios do Melhor Envio
Integração com múltiplas transportadoras (Correios, JadLog, etc.). Cálculo de frete em tempo real. Preços competitivos e suporte a seguros.
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
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). 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:
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. 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:
Distribuição dos Produtos: Vendedor A recebe R$50 (produto) + R$10 (frete) = R$60. Vendedor B recebe R$30 (produto) + R$15 (frete) = R$45. Vendedor C recebe R$20 (produto) + R$5 (frete) = R$25. Se o frete for dividido proporcionalmente entre todos os vendedores, você deve calcular a parte do frete que cada um deve receber. O frete pode ser atribuído a um único vendedor, se for uma política do marketplace (por exemplo, o vendedor que fará o envio do produto). Exemplo de Configuração JSON para Split
Vamos considerar que a divisão do pagamento seja feita via uma API de pagamento como o Asaas. O objeto split pode ser configurado da seguinte forma:
json
Copiar código
{
"value": 130.00,
"split": [
{
"walletId": "vendedor_A",
"fixedValue": 60.00 // Inclui produto e frete
},
{
"walletId": "vendedor_B",
"fixedValue": 45.00 // Inclui produto e frete
},
{
"walletId": "vendedor_C",
"fixedValue": 25.00 // Inclui produto e frete
}
]
}
Considerações Importantes
Se você optar por um frete único (o valor total de frete é repassado a um único vendedor), configure o split para que o valor do frete vá para a conta do vendedor que vai fazer o envio. Se for dividir o frete proporcionalmente, deve-se calcular a porcentagem de frete para cada vendedor com base no valor total de suas partes. Utilize a API do Melhor Envio para calcular o frete e fazer a divisão automática ou manual do frete com base nas regras do seu marketplace. Certifique-se de que a API de pagamento que você está usando (exemplo: Asaas) suporte a divisão de pagamento entre múltiplas contas de forma granular, considerando diferentes valores de produto e frete. Fluxo Geral
O comprador faz a compra no marketplace, e a plataforma calcula o frete total. A API do Melhor Envio é utilizada para calcular o frete e atribuí-lo aos vendedores relevantes. A transação é criada e configurada com um split de pagamento onde o valor total é dividido entre os vendedores, incluindo as partes do frete. O pagamento é processado, e cada vendedor recebe o valor correspondente, de acordo com a configuração do split.
