DOCS

Bundles

Bundles

Venda productos agrupados con landed cost preciso y opciones de empaquetado flexibles.

Un bundle es un producto vendido como una unidad (principal) única que se desglosa en artículos componentes individuales en el checkout. Cuando un cliente compra un bundle, Zonos lo expande en sus componentes, descuenta el precio de cada componente para igualar el precio del bundle y calcula aranceles e impuestos según el código HS y el país de origen de cada componente.

Por ejemplo, un comerciante vende camisas individualmente por 30 $ cada una, o como bundle de 4 por 100 $. Cuando un cliente compra el bundle:

  • El pedido y la factura comercial muestran 4 camisas a 25 $ cada una (no 1 bundle a 100 $ ni 4 camisas a 30 $ cada una)
  • El código HS y el país de origen de cada camisa se utilizan para el cálculo del landed cost
  • Los costos de envío se calculan usando las dimensiones reales de la caja en la que el comerciante las envía

Modos de empaquetado 

Los bundles admiten dos modos de empaquetado que controlan cómo se embalan los artículos para el envío:

Assigned box

El comerciante asigna previamente los artículos a cajas específicas con dimensiones conocidas. Cada caja se define con longitud, ancho, altura y capacidad de peso. Cartonization usa estas cajas exactas en lugar de estimarlas.

Ideal para: productos de los que ya sabe en qué caja se envían, o bundles que siempre se envían en la misma caja.

Auto-box

El comerciante agrupa artículos en un bundle sin especificar cajas. En el momento del pedido, Zonos usa su algoritmo de cartonization para determinar el empaquetado óptimo de cajas según las dimensiones de los artículos y las opciones de embalaje disponibles.

Ideal para: bundles cuyo empaquetado varía, productos con embalaje flexible, o cuando desea que Zonos optimice automáticamente la selección de cajas.

Ambos modos expanden el bundle en componentes individuales con código HS, país de origen y precio con descuento por artículo. La diferencia está solo en cómo se determinan las cajas.

Cómo funcionan los bundles 

Cuando crea un bundle en Catalog, define:

  • SKU o ID de producto del bundle — el identificador del producto que coincide con su tienda
  • Precio del bundle — el precio total tal como aparece en su tienda
  • Modo de empaquetado — assigned box o auto-box
  • Artículos componentes — cada producto individual incluido en el bundle, referenciado por su ID de artículo de catálogo. Los componentes deben existir ya como artículos de catálogo antes de poder añadirlos a un bundle.
  • Asignaciones de caja (solo assigned box) — qué componentes se envían en qué caja, con dimensiones y pesos reales

Cuando se realiza un pedido que contiene un bundle, Zonos automáticamente:

  1. Expande el bundle en sus componentes individuales
  2. Descuenta cada componente usando proporciones de precio calculadas para que los precios por artículo coincidan con el precio del bundle
  3. Calcula el landed cost usando el código HS, el país de origen y las dimensiones de caja de cada componente — ofreciendo un total preciso de aranceles, impuestos y envío
  4. Genera etiquetas — los bundles assigned-box obtienen una etiqueta por cada caja definida; los bundles auto-box obtienen etiquetas según los resultados de cartonization

Requisitos previos 

Antes de crear un bundle, asegúrese de que:

  • Todos los artículos componentes existen como artículos de catálogo en su Zonos Catalog. El bundle referencia componentes por su ID de artículo de catálogo — no puede añadir artículos que aún no existan. Los componentes no necesitan venderse individualmente en su tienda — pueden existir en su catálogo únicamente como partes de bundles.
  • Cada componente tiene códigos HS, país de origen y medidas (peso y dimensiones) precisos. Estos se utilizan para cálculos de landed cost cuando se expande el bundle.
  • La SKU o ID de producto del bundle coincide con el identificador que su plataforma de comercio electrónico envía a Zonos y con la preferencia de clave de artículo en su Zonos Dashboard. Para tiendas Shopify, el ID de producto del bundle debe ser el ID de variante de Shopify del producto bundle.

Todo bundle debe contener al menos 2 artículos componentes. Un bundle de un solo artículo debería ser en su lugar un artículo de catálogo independiente.

  1. Vaya a Dashboard > Products > Bundles.
  2. Haga clic en Add Bundle en la esquina superior derecha.
  3. Introduzca la SKU o Product ID del bundle — debe coincidir con el identificador que su tienda envía a Zonos. La preferencia de clave de artículo de su Zonos Dashboard también debe estar configurada con el identificador correcto.
  4. Introduzca el nombre, precio y moneda del bundle.
  5. Seleccione Assigned box como modo de empaquetado.
  6. Añada cajas con dimensiones específicas (longitud, ancho, altura y capacidad de peso).
  7. Añada artículos componentes buscando en su catálogo y asigne cada uno a una caja. Para cada componente, especifique:
    • Quantity — cuántas unidades de este componente hay en el bundle
    • Box — en qué caja se envía este componente
    • Price ratio — la porción del precio del bundle que representa este componente (se calcula automáticamente si se deja en blanco)
  8. Haga clic en Save.

Hay dos opciones de importación disponibles en Manage > Import:

Import bundles 

Crea bundles que referencian artículos de catálogo existentes. Los artículos componentes deben existir ya en su catálogo antes de la importación.

  1. Vaya a Dashboard > Products > Bundles.
  2. Haga clic en Manage > Import bundles.
  3. Descargue una plantilla CSV de muestra — elija el formato Assigned box o Auto-box.
  4. Complete una fila por artículo componente. Los campos a nivel de bundle (SKU, nombre, precio) se repiten en cada fila del mismo bundle.
  5. Cargue su CSV completado y haga clic en Import.

Campos CSV de bundles 

ColumnaDescripción
Bundle SKULa SKU del bundle tal como aparece en su tienda.
Bundle Product IDEl ID de producto del bundle tal como aparece en su tienda.
Bundle NameEl nombre del bundle.
Bundle DescriptionUna descripción del bundle.
Bundle Image URLURL de imagen del bundle.
Bundle AmountEl precio total del bundle.
Bundle CurrencyLa moneda del precio del bundle, p. ej., USD.
Box NumberEl número de caja en el que se envía el componente de esta fila, p. ej., 1 o 2. Use el mismo número para todos los componentes en la misma caja.
Box LengthLongitud de la caja para esta fila.
Box WidthAncho de la caja para esta fila.
Box HeightAltura de la caja para esta fila.
Box Dimensional UnitUnidad dimensional de la caja, p. ej., INCH.
Box Weight CapacityCapacidad máxima de peso de la caja.
Box Weight UnitUnidad de peso para la capacidad de la caja, p. ej., POUND.
Item SKULa SKU de este artículo componente. Debe coincidir con un artículo de catálogo existente.
Item Product IDEl ID de producto de este artículo componente. Debe coincidir con un artículo de catálogo existente.
Item QuantityCuántas unidades de este componente hay en el bundle.

Nota: Se aceptan tanto el prefijo de columna "Bundle" como "Kit" por compatibilidad con versiones anteriores (p. ej., "Kit SKU" funciona igual que "Bundle SKU").

Reglas de validación de la importación CSV 

Las siguientes reglas de validación se aplican a todas las importaciones de CSV de bundles:

  • Mínimo 2 artículos — Todo bundle debe contener al menos 2 artículos componentes. Un bundle de un solo artículo debería ser en su lugar un artículo de catálogo independiente.
  • Campos de caja de todo o nada — Para bundles assigned-box, los 6 campos de caja deben estar presentes en cada fila: Box Length, Box Width, Box Height, Box Dimensional Unit, Box Weight Capacity y Box Weight Unit. Si se establece algún campo de caja, los 6 son obligatorios. Si todos los campos de caja están vacíos, el bundle se trata como auto-box.
  • Sin mezclar modos de empaquetado — Un mismo bundle no puede mezclar filas assigned-box (con dimensiones de caja) y filas auto-box (sin dimensiones de caja). Todas las filas de un bundle deben usar el mismo modo.
  • Normalización de códigos HS — Los códigos HS se formatean automáticamente en la importación. Los caracteres no alfanuméricos (puntos, guiones, espacios) se eliminan y el código se normaliza a un formato de número de dígitos par.

Import bundles + catalog items 

Crea artículos de catálogo Y bundles en una sola carga. Use esta opción cuando sus artículos componentes aún no existan en el catálogo — se crearán o actualizarán automáticamente.

  1. Vaya a Dashboard > Products > Bundles.
  2. Haga clic en Manage > Import bundles + catalog items.
  3. Descargue una plantilla CSV de muestra — elija el formato Assigned box o Auto-box.
  4. Complete una fila por artículo componente, incluyendo las columnas de detalle del artículo (nombre, código HS, país de origen, medidas).
  5. Cargue su CSV completado y haga clic en Import.

La importación primero crea o actualiza los artículos de catálogo hijos, y luego crea los bundles que los referencian. Si ya existe un artículo con la misma SKU o ID de producto, sus datos se actualizan con los valores del CSV. Los códigos HS se normalizan automáticamente durante la importación (se eliminan los caracteres no alfanuméricos y el código se formatea al formato estándar de número de dígitos par).

Campos CSV combinados 

Incluye todos los campos CSV de bundles más las columnas de detalle del artículo:

ColumnaDescripción
Bundle SKULa SKU del bundle.
Bundle Product IDEl ID de producto del bundle.
Bundle NameEl nombre del bundle.
Bundle DescriptionUna descripción del bundle.
Bundle Image URLURL de imagen del bundle.
Bundle AmountEl precio total del bundle.
Bundle CurrencyLa moneda del precio del bundle, p. ej., USD.
Box NumberEn qué caja se envía este componente.
Box LengthLongitud de la caja.
Box WidthAncho de la caja.
Box HeightAltura de la caja.
Box Dimensional UnitUnidad dimensional, p. ej., INCH.
Box Weight CapacityCapacidad de peso de la caja.
Box Weight UnitUnidad de peso, p. ej., POUND.
Item SKULa SKU del artículo componente.
Item Product IDEl ID de producto del artículo componente.
Item NameNombre para mostrar del artículo de catálogo.
Item DescriptionDescripción del artículo.
Item HS CodeCódigo del Sistema Armonizado para la clasificación aduanera.
Item Country of OriginCódigo de país de dos letras donde se fabrica el artículo, p. ej., CN.
Item WeightPeso del artículo.
Item Weight UnitUnidad de peso, p. ej., POUND.
Item LengthLongitud del artículo.
Item WidthAncho del artículo.
Item HeightAltura del artículo.
Item Dimensional UnitUnidad dimensional para las medidas del artículo, p. ej., INCH.
Item QuantityCuántas unidades de este componente hay en el bundle.
Item AmountEl precio del artículo componente individual. Se usa al crear o actualizar el artículo de catálogo.
Item CurrencyLa moneda del precio del artículo, p. ej., USD.
Item Packing PreferenceCómo debe empaquetarse este artículo. Use ASSIGNED_BOX para artículos empaquetados en la caja especificada, CONSOLIDATED para cartonization, o SHIPS_ALONE para artículos que deben enviarse por separado. Opcional — el valor predeterminado es ASSIGNED_BOX cuando hay columnas de caja presentes.
  1. Vaya a Dashboard > Products > Bundles.
  2. Haga clic en Manage > Export.
  3. Elija una opción de exportación:
    • Export all bundles — exporta todos los bundles
    • Export assigned box bundles — exporta solo los bundles con cajas preasignadas
    • Export auto bundles — exporta solo los bundles auto-box
  4. Haga clic en Export. El CSV se le enviará por correo electrónico cuando esté listo.

Nota: Las ediciones de un bundle afectan solo a pedidos futuros. Los pedidos ya realizados y cumplidos no se ven afectados.

  1. Vaya a Dashboard > Products > Bundles.
  2. Haga clic en el bundle que desea editar.
  3. Actualice los campos y haga clic en Save.

Puede cambiar el modo de empaquetado, añadir o eliminar componentes, actualizar las asignaciones de caja y modificar el precio del bundle.

Para eliminar un solo bundle, ábralo y haga clic en Delete.

Para eliminar varios bundles a la vez:

  1. Seleccione los bundles que desea eliminar mediante las casillas de verificación.
  2. Haga clic en Delete selected.
  3. Confirme la eliminación.

Para eliminar todos los bundles de la página actual, haga clic en Manage > Delete page.

Puede añadir bundles a una cotización directamente desde el quoter para previsualizar el landed cost antes de realizar un pedido.

  1. En el quoter, cambie a la pestaña Search bundles en la sección Items.
  2. Busque un bundle por nombre, SKU o ID de producto.
  3. Seleccione un bundle. Zonos automáticamente:
    • Expande el bundle en artículos componentes individuales en la lista de artículos, cada uno con su propio código HS, país de origen y precio con descuento.
    • Rellena las cajas (solo bundles assigned-box) — las cajas predefinidas del bundle se añaden a la sección Boxes con sus dimensiones ya completadas.
    • Omite el llenado de cajas (bundles auto-box) — cartonization determina las cajas al calcular la cotización.
  4. Los artículos componentes aparecen agrupados bajo el nombre del bundle en la lista de artículos.
  5. Calcule la cotización. El landed cost refleja la estructura real del bundle — aranceles, impuestos y envío por componente, según dimensiones de caja reales o determinadas automáticamente.

Puede añadir varios bundles y artículos independientes a la misma cotización. Cada bundle se expande de forma independiente.

Por qué los bundles importan para el landed cost 

Sin bundles, Zonos ve una sola línea de pedido (p. ej., "Truck Tire 4-Pack — 1.000 $") sin visibilidad de lo que hay dentro. Esto causa problemas:

  • Sin códigos HS por artículo — Zonos no puede clasificar los componentes para tasas arancelarias precisas
  • Sin dimensiones reales de caja — los costos de envío se estiman con el algoritmo de empaquetado automático en lugar de las cajas reales del comerciante
  • Sin precios por artículo — se utiliza el precio completo del bundle para cálculos arancelarios en lugar del precio con descuento por componente

Los bundles resuelven los tres puntos al proporcionar a Zonos el desglose de componentes, las asignaciones de cajas (o la agrupación auto-box) y la asignación de precios por adelantado. El resultado es una cotización de landed cost que refleja lo que el cliente pagará realmente en la frontera.

Proporciones de precio y precios de componentes 

Cuando se vende un bundle, Zonos necesita saber cuánto vale cada componente individualmente. Esto se debe a que los envíos internacionales requieren un valor declarado por artículo en la factura comercial, y los aranceles/impuestos se calculan sobre cada artículo por separado.

El priceRatio controla cómo se divide el precio total del bundle entre sus componentes. No tiene que establecerlo usted mismo — si lo deja en blanco, Zonos divide automáticamente el precio de forma uniforme entre todos los componentes.

Por ejemplo, un bundle de 1.000 $ con 4 neumáticos y sin proporciones de precio establecidas declararía automáticamente cada neumático a 250 $ (0,25 cada uno). Si sus componentes tienen valores diferentes — por ejemplo, 2 neumáticos premium y 2 estándar — puede establecer manualmente proporciones como 0,35 y 0,15 para reflejar la diferencia de valor real.

Zonos normaliza automáticamente las proporciones para que no tenga que preocuparse por los cálculos:

  • Si deja algunas proporciones en blanco, el valor restante se divide uniformemente entre esos componentes
  • Si las proporciones no suman exactamente 1,0, Zonos las escala proporcionalmente
  • Las proporciones finales siempre suman exactamente 1,0

Cartonization y etiquetas 

Los componentes de bundles assigned-box utilizan cajas definidas por el comerciante en lugar del algoritmo estándar de bin packing. El packingPreference de cada componente se establece en ASSIGNED_BOX, lo que indica a cartonization que lo coloque en la caja especificada por packageOptionId y packageOptionIdIndex.

Esta es la ventaja central de los bundles assigned-box — el comerciante sabe exactamente cómo se envía su producto, por lo que las dimensiones y pesos de caja utilizados para el cálculo del landed cost son precisos, no estimados.

Cada caja de un bundle genera su propia etiqueta de envío con su propio número de seguimiento. Un bundle con dos cajas produce dos etiquetas.

Pedidos mixtos

Los artículos que no son bundles en el mismo pedido se empaquetan por separado usando el algoritmo estándar de cartonization, independientemente del modo de empaquetado que utilicen los bundles.

Pedidos con bundles mixtos 

Un solo pedido puede contener varios bundles y artículos independientes simultáneamente. Por ejemplo, un pedido con:

  • 1× bundle de 4 unidades con cajas assigned box (se envía en 2 cajas)
  • 1× bundle auto-box de 3 artículos (cartonization determina el empaquetado)
  • 1× artículo individual independiente

Zonos expande cada bundle de forma independiente. El cálculo del landed cost cubre todas las cajas con dimensiones precisas y todos los precios de componentes individuales. Cada caja obtiene su propia etiqueta.

Integración con Shopify 

Los bundles tienen un comportamiento específico cuando se utilizan con tiendas Shopify.

Configuración

El ID de producto del bundle en Zonos Catalog debe coincidir con el ID de variante de Shopify del producto bundle. Así es como Zonos asocia la línea de pedido de Shopify con la definición del bundle. Puede encontrar el ID de variante en la URL del administrador de Shopify al ver la variante del producto.

Flujo del pedido

Cuando un cliente pide un bundle en una tienda Shopify:

  1. Shopify envía una sola línea de pedido para el bundle principal (p. ej., "Truck Tire 4-Pack x 1").
  2. Zonos asocia el ID de variante de la línea de pedido con el ID de producto del bundle en su catálogo.
  3. Zonos expande el bundle en sus componentes individuales para el cálculo del landed cost — el código HS, el país de origen y el precio con descuento de cada componente se utilizan para aranceles e impuestos precisos.
  4. El pedido de Shopify sigue mostrando la única línea de pedido del bundle — la expansión de componentes la gestiona Zonos por completo.

Fulfillment

Al crear fulfillments, Zonos asocia los componentes expandidos del bundle de nuevo con la línea de pedido original del bundle de Shopify. El comerciante ve el bundle principal cumplido en Shopify (p. ej., "Truck Tire 4-Pack x 1 fulfilled"), mientras que la factura comercial y los documentos aduaneros listan cada componente por separado.

GraphQL API ReferenceTypes, inputs, and operations used in this guide

¿Fue útil esta página?