DOCS

Bundles

Venda produtos agrupados com landed cost preciso e opções flexíveis de empacotamento.

Um bundle é um produto vendido como uma única unidade (principal) que se desdobra em itens componentes individuais na criação do pedido. Quando um cliente compra um bundle, a Zonos o expande em seus componentes, ajusta proporcionalmente o preço de cada componente para que o total corresponda ao preço do bundle principal e calcula impostos e taxas com base em cada componente individual.

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
  • **Informações incorretas na fatura comercial - a fatura comercial mostrará 1 item em vez de cada item individual
  • **Romaneios de embalagem genéricos - os romaneios de embalagem não mostram cada item que deve ir no pedido, apenas um único item de linha para o bundle inteiro

Os bundles resolvem os cinco 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 e uma fatura comercial que refletem 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 

Os componentes de bundles assigned-box usam caixas definidas pelo comerciante em vez do algoritmo padrão de bin-packing. O packingPreference de cada componente é definido como ASSIGNED_BOX, o que indica ao cartonization para colocá-lo na caixa especificada por packageOptionId e packageOptionIdIndex.

Essa é a principal vantagem dos bundles assigned-box — o comerciante sabe exatamente como seu produto é enviado, portanto, as dimensões e pesos de caixa usados para o cálculo do landed cost são precisos, não estimados.

Cada caixa de um bundle gera sua própria etiqueta de envio com seu próprio número de rastreamento. Um bundle com duas caixas produz duas 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ções com plataformas 

Cada plataforma de comércio eletrônico lida com bundles de forma diferente. As seções abaixo descrevem como os bundles da Zonos interagem com cada plataforma compatível.

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

Esta página foi útil?