Bundles

Um bundle é um produto vendido como uma única unidade (principal) que se desdobra em itens componentes individuais no checkout. Quando um cliente compra um bundle, a Zonos o expande em seus componentes, desconta o preço de cada componente para igualar o preço do bundle e calcula impostos e taxas com base no código HS e no país de origem de cada componente.

Por exemplo, um comerciante vende camisas individualmente por US$ 30 cada, ou como bundle de 4 por US$ 100. Quando um cliente compra o bundle:

• O pedido e a fatura comercial mostram 4 camisas a US$ 25 cada (não 1 bundle a US$ 100 nem 4 camisas a US$ 30 cada)
• O código HS e o país de origem de cada camisa são usados para o cálculo do landed cost
• Os custos de envio são calculados usando as dimensões reais da caixa em que o comerciante os envia

Modos de empacotamento 

Os bundles oferecem suporte a dois modos de empacotamento que controlam como os itens são embalados para envio:

Assigned box

O comerciante pré-atribui os itens a caixas específicas com dimensões conhecidas. Cada caixa é definida com comprimento, largura, altura e capacidade de peso. O cartonization usa essas caixas exatas em vez de fazer estimativas.

Ideal para: produtos em que você já sabe em qual caixa eles são enviados, ou bundles que sempre são enviados na mesma caixa.

Auto-box

O comerciante agrupa itens em um bundle sem especificar caixas. No momento do pedido, a Zonos usa seu algoritmo de cartonization para determinar o empacotamento ideal com base nas dimensões dos itens e nas opções de embalagem disponíveis.

Ideal para: bundles cujo empacotamento varia, produtos com embalagem flexível, ou quando você quer que a Zonos otimize a seleção de caixas automaticamente.

Ambos os modos expandem o bundle em componentes individuais com códigos HS, país de origem e preços com desconto por item. A diferença está apenas em como as caixas são determinadas.

Como os bundles funcionam 

Ao criar um bundle no Catalog, você define:

• SKU ou ID de produto do bundle — o identificador do produto que corresponde à sua loja
• Preço do bundle — o preço total como aparece em sua loja
• Modo de empacotamento — assigned box ou auto-box
• Itens componentes — cada produto individual incluído no bundle, referenciado pelo seu ID de item de catálogo. Os componentes devem existir como itens de catálogo antes de poderem ser adicionados a um bundle.
• Atribuições de caixas (somente assigned box) — quais componentes são enviados em qual caixa, com dimensões e pesos reais

Quando um pedido contendo um bundle é feito, a Zonos automaticamente:

1. Expande o bundle em seus componentes individuais
2. Desconta cada componente usando proporções de preço calculadas para que os preços por item correspondam ao preço do bundle
3. Calcula o landed cost usando o código HS, o país de origem e as dimensões de caixa de cada componente — fornecendo um total preciso de impostos, taxas e envio
4. Gera etiquetas — bundles assigned-box recebem uma etiqueta por caixa definida; bundles auto-box recebem etiquetas com base nos resultados do cartonization

Pré-requisitos 

Antes de criar um bundle, certifique-se de que:

• Todos os itens componentes existem como itens de catálogo no seu Zonos Catalog. O bundle referencia componentes pelo seu ID de item de catálogo — você não pode adicionar itens que ainda não existam. Os componentes não precisam ser vendidos individualmente em sua loja — eles podem existir em seu catálogo apenas como partes de bundles.
• Cada componente tem códigos HS, país de origem e medidas (peso e dimensões) precisos. Eles são usados para os cálculos de landed cost quando o bundle é expandido.
• O SKU ou ID de produto do bundle corresponde ao identificador que sua plataforma de comércio eletrônico envia para a Zonos e à preferência de chave de item no seu Zonos Dashboard. Para lojas Shopify, o ID de produto do bundle deve ser o ID de variante da Shopify do produto bundle.

Por que os bundles são importantes para o landed cost 

Sem bundles, a Zonos vê um único item de linha (por exemplo, "Truck Tire 4-Pack — US$ 1.000") sem visibilidade do que há dentro. Isso causa problemas:

• Sem códigos HS por item — a Zonos não pode classificar os componentes para taxas de imposto precisas
• Sem dimensões reais de caixa — os custos de envio são estimados usando o algoritmo de empacotamento automático em vez das caixas reais do comerciante
• Sem preços por item — o preço total do bundle é usado para os cálculos de imposto em vez do preço com desconto por componente

Os bundles resolvem os três pontos ao fornecer à Zonos o detalhamento dos componentes, as atribuições de caixas (ou o agrupamento auto-box) e a alocação de preços com antecedência. O resultado é uma cotação de landed cost que reflete o que o cliente realmente pagará na fronteira.

Proporções de preço e preços de componentes 

Quando um bundle é vendido, a Zonos precisa saber quanto vale cada componente individualmente. Isso ocorre porque os envios internacionais exigem um valor declarado por item na fatura comercial, e o imposto/taxa é calculado em cada item separadamente.

O priceRatio controla como o preço total do bundle é dividido entre seus componentes. Você não precisa definir isso manualmente — se deixar em branco, a Zonos divide automaticamente o preço de forma igual entre todos os componentes.

Por exemplo, um bundle de US$ 1.000 com 4 pneus e sem proporções de preço definidas declararia automaticamente cada pneu a US$ 250 (0,25 cada). Se seus componentes tiverem valores diferentes — digamos 2 pneus premium e 2 padrão — você pode definir manualmente proporções como 0,35 e 0,15 para refletir a diferença real de valor.

A Zonos normaliza automaticamente as proporções para que você não precise se preocupar com a matemática:

• Se você deixar algumas proporções em branco, o valor restante é dividido igualmente entre esses componentes
• Se as proporções não somarem exatamente 1,0, a Zonos as ajusta proporcionalmente
• As proporções finais sempre somam exatamente 1,0

Cartonization e etiquetas 

Pedidos mistos

Itens que não são bundles no mesmo pedido são empacotados separadamente usando o algoritmo padrão de cartonization, independentemente do modo de empacotamento usado pelos bundles.

Pedidos com bundles mistos 

Um único pedido pode conter vários bundles e itens independentes simultaneamente. Por exemplo, um pedido com:

• 1x bundle de 4 unidades com caixas atribuídas (enviado em 2 caixas)
• 1x bundle auto-box de 3 itens (o cartonization determina o empacotamento)
• 1x item independente único

A Zonos expande cada bundle de forma independente. O cálculo do landed cost cobre todas as caixas com dimensões precisas e todos os preços de componentes individuais. Cada caixa recebe sua própria etiqueta.

Integração com a Shopify 

Os bundles têm um comportamento específico quando usados com lojas Shopify.

Configuração

O ID de produto do bundle no Zonos Catalog deve corresponder ao ID de variante da Shopify do produto bundle. É assim que a Zonos associa o item de linha da Shopify à definição do bundle. Você pode encontrar o ID de variante na URL do administrador da Shopify ao visualizar a variante do produto.

Fluxo do pedido

Quando um cliente pede um bundle em uma loja Shopify:

1. A Shopify envia um único item de linha para o bundle principal (por exemplo, "Truck Tire 4-Pack x 1").
2. A Zonos associa o ID de variante do item de linha ao ID de produto do bundle em seu catálogo.
3. A Zonos expande o bundle em seus componentes individuais para o cálculo do landed cost — o código HS, o país de origem e o preço com desconto de cada componente são usados para impostos e taxas precisos.
4. O pedido da Shopify continua mostrando o único item de linha do bundle — a expansão dos componentes é gerenciada inteiramente pela Zonos.

Fulfillment

Ao criar fulfillments, a Zonos associa os componentes expandidos do bundle de volta ao item de linha original do bundle na Shopify. O comerciante vê o bundle principal concluído na Shopify (por exemplo, "Truck Tire 4-Pack x 1 fulfilled"), enquanto a fatura comercial e os documentos aduaneiros listam cada componente separadamente.