Documentación Mercado Libre
Descubre toda la información que debes conocer sobre las APIs de Mercado Libre.
Documentación
Mercado Envíos - Costos y cotizaciones
El endpoint requiere más contexto que solo dimensions: conviene enviar item_id o, si se usa dimensions, además item_price, listing_type_id, mode/logistic_type y free_shipping si aplica. Solo enviar dimensions sin otros parámetros puede devolver list_cost=0 porque no hay suficiente contexto para calcular el costo.
El peso en dimensions debe ser pasado en gramos como entero (number_unit). Convierte 0.7605 kg a gramos (ej. 761 g) y envíalo como valor entero; el API no acepta fracciones en kilogramos en ese campo.
Para saber quién pagó el flete, consulte /shipments/{id}/costs. receiver.cost refleja el costo final pagado por el comprador; senders[].cost refleja el monto asociado al vendedor. Si receiver.cost == 0, el comprador no pagó el flete. Si senders[].cost == 0, el vendedor no fue cobrado. Los campos promoted_amount y save son informativos, pero los valores determinantes son receiver.cost y senders[].cost.
promoted_amount puede representar el monto final subsidiado; en algunos flujos receiver.promoted_amount refleja el monto cubierto, pero para cálculo de reembolsos y costos al vendedor, use senders[].cost. El campo save es informativo y su uso puede variar según la lógica interna; no siempre debe usarse como base para facturación.
Las discrepancias pueden ocurrir si no se envían todos los parámetros necesarios (dimensions, item_price, logistic_type), si hay simulaciones en front o si existen reglas de contingencia. La recomendación es usar /shipments/{id}/costs para obtener el costo final que aplicará al pedido.
El costo de envío se devuelve en la moneda del sitio (p. ej. UYU para MLU). Si trabajas con precios en otra moneda, debes convertir el valor devuelto a la moneda que uses para tu cálculo.
Para conocer lo cobrado al vendedor, consulte senders[].cost en /shipments/{id}/costs; receiver.cost muestra lo que paga el comprador. promoted_amount y campos de discounts explican subsidios o bonos aplicados.