Implementación de multiboxing con la API de Multivende

¿Cuándo es útil Multiboxing?

Multiboxing te permite dividir un pedido en varias cajas, asignando a cada una su propia guía de rastreo. Así puedes dar seguimiento individual a cada paquete, tanto tú como tu cliente.
Esta opción es especialmente útil cuando:

• El producto no cabe en una sola caja.
• El pedido incluye varias piezas grandes o voluminosas.
• La paquetería exige separar los productos por peso o dimensiones.
• Deseas optimizar costos o tiempos de entrega distribuyendo mejor el contenido.
   

¿Cómo configurar Multiboxing paso a paso?

A continuación te mostramos el flujo recomendado para configurar tus cajas y generar múltiples etiquetas desde Multivende.

1. Obtén las dimensiones de los productos en tu despacho (opcional, si necesitas calcular manualmente tus cajas)

Puedes consultar las dimensiones de los productos incluidos en tu pedido usando el endpoint:

👉 Get Delivery Order in Checkout Items
GET /delivery-order/checkout-items - Ver endpoint en Postman

Con esta información podrás aplicar la lógica que prefieras para determinar cuántas cajas necesitas y qué producto irá en cada una.

Este paso es opcional si ya cuentas con configuraciones previas o deseas usar cajas por defecto.

2. Consulta las cajas configuradas o las cajas por defecto

Multivende ofrece la opción de revisar las cajas que ya tengas registradas, o bien visualizar las cajas por defecto que aplicaremos cuando no edites la configuración.

👉 Get Boxes
GET /boxes - Ver endpoint en Postman

Si una caja corresponde a la configuración por defecto, verás el campo:

"default": true

3. Configura las cajas que utilizarás para este despacho

Una vez que tengas claro cómo vas a distribuir los productos, debes registrar las cajas necesarias para tu envío.

👉 Post Boxes
POST /boxes - Ver endpoint en Postman

Este endpoint recibe un array en el que debes indicar:

• Las dimensiones de cada caja (alto, ancho, largo, peso).
• Los productos asignados a cada caja.
   

Con esto, Multivende podrá generar las guías correspondientes de forma individual.

4. Cambia el estado de la orden para continuar con el proceso de despacho

Una vez configuradas las cajas, debes mover la orden al estado En manejo, lo que confirma que estás listo para generar las etiquetas.

Guía relacionada:
🔗 Estados de una orden con despacho

5. Genera las etiquetas de envío

Finalmente, puedes solicitar la generación de etiquetas tus cajas utilizando el flujo estándar de etiquetas en Multivende.

Guía relacionada:
🔗 Cómo generar y consultar etiquetas de los Marketplace