Documentação do Mercado Livre
Confira todas as informações necessárias sobre as APIs Mercado Livre.
Documentação do
Mercado Envios — Custos e cotações
O endpoint requer mais contexto do que apenas dimensions: é recomendável enviar item_id ou, se usar dimensions, também item_price, listing_type_id, mode/logistic_type e free_shipping se aplicável. Enviar apenas dimensions sem outros parâmetros pode retornar list_cost=0 porque não há contexto suficiente para calcular o custo.
O peso em dimensions deve ser passado em gramas como inteiro (number_unit). Converta 0.7605 kg para gramas (ex. 761 g) e envie como valor inteiro; a API não aceita frações em quilogramas nesse campo.
Para saber quem pagou o frete, consulte /shipments/{id}/costs. receiver.cost reflete o custo final pago pelo comprador; senders[].cost reflete o valor associado ao vendedor. Se receiver.cost == 0, o comprador não pagou o frete. Se senders[].cost == 0, o vendedor não foi cobrado. Os campos promoted_amount e save são informativos, mas os valores determinantes são receiver.cost e senders[].cost.
promoted_amount pode representar o valor final subsidiado; em alguns fluxos receiver.promoted_amount reflete o valor coberto, mas para cálculo de reembolsos e custos ao vendedor, use senders[].cost. O campo save é informativo e seu uso pode variar conforme a lógica interna; nem sempre deve ser usado como base para faturamento.
As discrepâncias podem ocorrer se não forem enviados todos os parâmetros necessários (dimensions, item_price, logistic_type), se houver simulações no front ou se existirem regras de contingência. A recomendação é usar /shipments/{id}/costs para obter o custo final que será aplicado ao pedido.
O custo de envio é retornado na moeda do site (ex. BRL para MLB). Se você trabalha com preços em outra moeda, deve converter o valor retornado para a moeda que usa em seu cálculo.
Para saber o que foi cobrado ao vendedor, consulte senders[].cost em /shipments/{id}/costs; receiver.cost mostra o que o comprador paga. promoted_amount e campos de discounts explicam subsídios ou bônus aplicados.