DOCS

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 al crearse el pedido. Cuando un cliente compra un bundle, Zonos lo expande en sus componentes, ajusta proporcionalmente el precio de cada componente para que el total coincida con el precio del bundle principal y calcula aranceles e impuestos en función de cada componente individual.

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.

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
  • **Información incorrecta en la factura comercial - la factura comercial mostrará 1 artículo en lugar de cada artículo individual
  • **Albaranes genéricos - los albaranes no muestran cada artículo que debe ir en el pedido, sino una sola línea de pedido para todo el bundle

Los bundles resuelven los cinco problemas 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 y una factura comercial que reflejan 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:

  • 1x bundle de 4 unidades con cajas asignadas (se envía en 2 cajas)
  • 1x bundle auto-box de 3 artículos (cartonization determina el empaquetado)
  • 1x 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.

Integraciones de plataformas 

Cada plataforma de comercio electrónico gestiona los bundles de forma diferente. Las secciones siguientes describen cómo interactúan los bundles de Zonos con cada plataforma compatible.

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

¿Fue útil esta página?