DOCS

Bundles

Vendez des produits groupés avec un coût rendu précis et des options d'emballage flexibles.

Un bundle est un produit vendu comme une unité unique (parent) qui se décompose en articles composants individuels lors de la création de la commande. Lorsqu'un client achète un bundle, Zonos le décompose en ses composants, ajuste le prix de chaque composant afin que le total corresponde au prix du bundle parent, et calcule les droits et taxes en fonction de chaque composant individuel.

Par exemple, un marchand vend des chemises à l'unité pour 30 $ chacune, ou sous forme de bundle de 4 pour 100 $. Lorsqu'un client achète le bundle :

  • La commande et la facture commerciale indiquent 4 chemises à 25 $ chacune (et non 1 bundle à 100 $ ou 4 chemises à 30 $ chacune)
  • Le code SH et le pays d'origine de chaque chemise sont utilisés pour le calcul du coût rendu
  • Les frais d'expédition sont calculés à partir des dimensions réelles de la boîte utilisée par le marchand pour l'expédition

Modes d'emballage 

Les bundles prennent en charge deux modes d'emballage qui déterminent comment les articles sont mis en boîte pour l'expédition :

Boîte assignée

Le marchand préassigne les articles à des boîtes spécifiques dont les dimensions sont connues. Chaque boîte est définie par sa longueur, sa largeur, sa hauteur et sa capacité de poids. La cartonisation utilise ces boîtes exactes au lieu de faire une estimation.

Idéal pour : les produits dont vous connaissez la boîte d'expédition, ou les bundles qui sont toujours expédiés dans la même boîte.

Boîte automatique

Le marchand regroupe des articles dans un bundle sans spécifier de boîtes. Au moment de la commande, Zonos utilise son algorithme de cartonisation pour déterminer l'emballage optimal en fonction des dimensions des articles et des options d'emballage disponibles.

Idéal pour : les bundles dont l'emballage varie, les produits à l'emballage flexible, ou lorsque vous souhaitez que Zonos optimise automatiquement la sélection des boîtes.

Les deux modes décomposent le bundle en composants individuels avec un code SH, un pays d'origine et un prix réduit par article. La différence réside uniquement dans la façon dont les boîtes sont déterminées.

Fonctionnement des bundles 

Lorsque vous créez un bundle dans Catalog, vous définissez :

  • SKU ou ID produit du bundle — l'identifiant produit qui correspond à votre boutique
  • Prix du bundle — le prix total tel qu'il apparaît dans votre boutique
  • Mode d'emballage — boîte assignée ou boîte automatique
  • Articles composants — chaque produit individuel inclus dans le bundle, référencé par son ID d'article de catalogue. Les composants doivent déjà exister en tant qu'articles de catalogue avant de pouvoir être ajoutés à un bundle.
  • Attribution des boîtes (boîte assignée uniquement) — quels composants sont expédiés dans quelle boîte, avec des dimensions et poids réels

Lorsqu'une commande contenant un bundle est passée, Zonos effectue automatiquement les actions suivantes :

  1. Décompose le bundle en ses composants individuels
  2. Réduit le prix de chaque composant à l'aide de ratios de prix calculés afin que les prix par article correspondent au prix du bundle
  3. Calcule le coût rendu à partir du code SH, du pays d'origine et des dimensions de la boîte de chaque composant — pour un total précis des droits, taxes et frais d'expédition
  4. Génère les étiquettes — les bundles en boîte assignée reçoivent une étiquette par boîte définie ; les bundles en boîte automatique reçoivent des étiquettes basées sur les résultats de la cartonisation

Prérequis 

Avant de créer un bundle, assurez-vous que :

  • Tous les articles composants existent en tant qu'articles de catalogue dans votre Zonos Catalog. Le bundle référence les composants par leur ID d'article de catalogue — vous ne pouvez pas ajouter d'articles qui n'existent pas déjà. Les composants n'ont pas besoin d'être vendus individuellement dans votre boutique — ils peuvent exister dans votre catalogue uniquement en tant que pièces de bundle.
  • Chaque composant possède des codes SH, un pays d'origine et des mesures (poids et dimensions) précis. Ces informations sont utilisées pour les calculs de coût rendu lorsque le bundle est décomposé.
  • Le SKU ou l'ID produit du bundle correspond à l'identifiant envoyé à Zonos par votre plateforme e-commerce et à la préférence de clé d'article dans votre Zonos Dashboard. Pour les boutiques Shopify, l'ID produit du bundle doit être l'ID de variante Shopify du produit du bundle.

Pourquoi les bundles sont importants pour le coût rendu 

Sans bundles, Zonos ne voit qu'un seul article de ligne (par exemple, « Truck Tire 4-Pack — 1 000 $ ») sans aucune visibilité sur son contenu. Cela pose plusieurs problèmes :

  • Pas de codes SH par article — Zonos ne peut pas classer les composants pour des taux de droits précis
  • Pas de dimensions de boîte réelles — les frais d'expédition sont estimés à l'aide de l'algorithme d'emballage automatique au lieu des boîtes réelles du marchand
  • Pas de tarification par article — le prix total du bundle est utilisé pour les calculs de droits au lieu du prix réduit par composant
  • **Informations incorrectes sur la facture commerciale - la facture commerciale indique 1 seul article au lieu de chaque article individuel
  • **Bordereaux d'emballage génériques - les bordereaux d'emballage n'indiquent pas chaque article à inclure dans la commande, mais une seule ligne d'article pour l'ensemble du bundle

Les bundles résolvent ces cinq problèmes en fournissant à Zonos, dès le départ, la répartition des composants, les attributions de boîtes (ou le regroupement en boîte automatique) et la répartition des prix. Le résultat est un devis de coût rendu et une facture commerciale qui reflètent ce que le client paiera réellement à la frontière.

Ratios de prix et tarification par composant 

Lorsqu'un bundle est vendu, Zonos doit connaître la valeur individuelle de chaque composant. En effet, les expéditions internationales nécessitent une valeur déclarée par article sur la facture commerciale, et les droits/taxes sont calculés séparément pour chaque article.

Le priceRatio détermine comment le prix total du bundle est réparti entre ses composants. Vous n'êtes pas obligé de le définir vous-même — si vous le laissez vide, Zonos répartit automatiquement le prix de façon égale entre tous les composants.

Par exemple, un bundle à 1 000 $ avec 4 pneus et aucun ratio de prix défini déclarerait automatiquement chaque pneu à 250 $ (0,25 chacun). Si vos composants ont des valeurs différentes — par exemple 2 pneus haut de gamme et 2 pneus standards — vous pouvez définir manuellement des ratios comme 0,35 et 0,15 pour refléter la différence de valeur réelle.

Zonos normalise automatiquement les ratios afin que vous n'ayez pas à vous soucier des calculs :

  • Si vous laissez certains ratios vides, la valeur restante est répartie de façon égale entre ces composants
  • Si les ratios ne totalisent pas exactement 1,0, Zonos les ajuste proportionnellement
  • Les ratios finaux totalisent toujours exactement 1,0

Cartonisation et étiquettes 

Les composants des bundles en boîte assignée utilisent des boîtes définies par le marchand au lieu de l'algorithme standard de bin-packing. Le packingPreference de chaque composant est défini sur ASSIGNED_BOX, ce qui indique à la cartonisation de le placer dans la boîte spécifiée par packageOptionId et packageOptionIdIndex.

C'est l'avantage principal des bundles en boîte assignée — le marchand sait exactement comment son produit est expédié, de sorte que les dimensions et poids de boîte utilisés pour le calcul du coût rendu sont précis, et non estimés.

Chaque boîte d'un bundle génère sa propre étiquette d'expédition avec son propre numéro de suivi. Un bundle avec deux boîtes produit deux étiquettes.

Commandes mixtes

Les articles hors bundle d'une même commande sont emballés séparément à l'aide de l'algorithme de cartonisation standard, quel que soit le mode d'emballage utilisé par les bundles.

Commandes avec bundles mixtes 

Une même commande peut contenir plusieurs bundles et articles autonomes simultanément. Par exemple, une commande avec :

  • 1x bundle de 4 en boîtes assignées (expédié en 2 boîtes)
  • 1x bundle en boîte automatique de 3 articles (la cartonisation détermine l'emballage)
  • 1x article autonome unique

Zonos décompose chaque bundle indépendamment. Le calcul du coût rendu couvre toutes les boîtes avec des dimensions précises et tous les prix des composants individuels. Chaque boîte reçoit sa propre étiquette.

Intégrations de plateformes 

Chaque plateforme e-commerce gère les bundles différemment. Les sections ci-dessous décrivent comment les bundles Zonos interagissent avec chaque plateforme prise en charge.

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

Cette page a-t-elle été utile?