¿Cómo se registra una venta de Kit que proviene de MercadoLibre?

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:

1. Leer la venta usando el endpoint de Get Checkout
2. 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.

3. 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:

• 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.