Cuando un comprador adquiere un Kit (Pack) en MercadoLibre, se genera una única venta que represente al kit completo.
En su lugar:
- MercadoLibre crea una orden de venta por cada ítem que compone el kit.
- Todas esas órdenes:
- Corresponden a una misma venta en Multivende
- Están relacionadas entre sí
- Comparten información común como el envío y el pack
Implicaciones importantes:
- Siempre habrá múltiples órdenes para una venta de kit en Mercadolibre lo que en Multivende se traduce como un mismo checkout, debido a que Mercadolibre los asocia como un mismo pack.
- Cada orden representa un producto específico del kit y el descuento del stock va asociado a cada ítem componente del kit. Esto quiere decir que las órdenes de kit van a mostrar los productos componentes del pack y no el pack en si.
Flujo general para identificar una venta de Kit vía API Multivende:
El proceso recomendado para un integrador de Multivende es el siguiente:
- Leer la venta usando el endpoint de Get Checkout
- Validar si la orden corresponde a un Kit mediante el campo tags, dentro de esta respuesta, se debe revisar el campo "tags": "pack_order,kit_component,kit,paid,not_delivered,test_order".
Tags clave a validar:
- Kit
- Kit_component
Interpretación: Si alguno de estos tags está presente, la venta contiene productos de kit.
- Si deseas identificar todas los números de las órdenes de Mercadolibre relacionadas al Kit lo puedes hacer usando externalContent -> kit_orders, esto es un paso no requerido.
Este campo contiene un arreglo con la información de cada orden que compone el kit.
Ejemplo de kit_orders:
"kit_orders": [
{
"order_id": 200001408888XXXX,
"item_id": "MLB595574XXXX",
"variation_id": null,
"pack_id": 20000103169XXXX,
"shipment_id": 4598979XXXX,
"parent_item_id": "MLB595731XXXX"
},
{
"order_id": 20000140888XXXX,
"item_id": "MLB595581XXXX",
"variation_id": null,
"pack_id": 200001031698XXXX,
"shipment_id": 4598979XXXX,
"parent_item_id": "MLB595731XXXX"
},
{
"order_id": 200001408888XXXX,
"item_id": "MLB595585XXXX",
"variation_id": null,
"pack_id": 200001031698XXXX,
"shipment_id": 4598979XXXX,
"parent_item_id": "MLB595731XXXX"
}
]Cada objeto dentro de kit_orders representa una orden individual del kit:
| Campo | Descripción |
| order_id | ID de la orden individual del componente |
| item_id | ID del producto vendido |
| variation_id | ID de la variación (si aplica) |
| pack_id | Identificador único del Kit (Pack) |
| shipment_id | ID del envío compartido |
| parent_item_id | ID del ítem principal del Kit |
- Todos las órdenes comparten el mismo:
- Pack_id
- shipment_id , ya que se envían juntos
- parent_item_id, identifica el producto principal del Kit
Cualquier duda o consulta adicional referente a este artículo, puedes escribirnos a api@multivende.com.
0 comentarios
Inicie sesión para dejar un comentario.