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 :
- Décompose le bundle en ses composants individuels
- 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
- 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
- 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.
Créer un bundle
Chaque bundle doit contenir au moins 2 articles composants. Un bundle à un seul article doit plutôt être un article de catalogue autonome.
- Accédez à Dashboard > Products > Bundles.
- Cliquez sur Add Bundle dans le coin supérieur droit.
- Saisissez le SKU ou l'ID produit du bundle — celui-ci doit correspondre à l'identifiant envoyé à Zonos par votre boutique. La préférence de clé d'article de votre Zonos Dashboard doit également être configurée sur le bon identifiant.
- Saisissez le nom, le prix et la devise du bundle.
- Sélectionnez Assigned box comme mode d'emballage.
- Ajoutez des boîtes avec des dimensions spécifiques (longueur, largeur, hauteur et capacité de poids).
- Ajoutez des articles composants en recherchant dans votre catalogue et attribuez chacun à une boîte. Pour chaque composant, précisez :
- Quantity — le nombre d'unités de ce composant dans le bundle
- Box — la boîte dans laquelle ce composant est expédié
- Price ratio — la portion du prix du bundle que représente ce composant (calculée automatiquement si laissé vide)
- Cliquez sur Save.
Importer des bundles via CSV
Deux options d'import sont disponibles depuis Manage > Import :
Importer des bundles
Crée des bundles qui référencent des articles de catalogue existants. Les articles composants doivent déjà exister dans votre catalogue avant l'import.
- Accédez à Dashboard > Products > Bundles.
- Cliquez sur Manage > Import bundles.
- Téléchargez un modèle CSV d'exemple — choisissez le format Assigned box ou Auto-box.
- Remplissez une ligne par article composant. Les champs au niveau du bundle (SKU, nom, prix) se répètent sur chaque ligne pour un même bundle.
- Importez votre fichier CSV rempli et cliquez sur Import.
Champs CSV du bundle
| Colonne↕ | Description↕ |
|---|---|
| Bundle SKU | Le SKU du bundle tel qu'il apparaît dans votre boutique. |
| Bundle Product ID | L'ID produit du bundle tel qu'il apparaît dans votre boutique. |
| Bundle Name | Le nom du bundle. |
| Bundle Description | Une description du bundle. |
| Bundle Image URL | URL de l'image du bundle. |
| Bundle Amount | Le prix total du bundle. |
| Bundle Currency | La devise du prix du bundle, par exemple USD. |
| Box Number | Le numéro de boîte dans laquelle le composant de cette ligne est expédié, par exemple 1 ou 2. Utilisez le même numéro pour tous les composants d'une même boîte. |
| Box Length | Longueur de la boîte pour cette ligne. |
| Box Width | Largeur de la boîte pour cette ligne. |
| Box Height | Hauteur de la boîte pour cette ligne. |
| Box Dimensional Unit | Unité de dimension de la boîte, par exemple INCH. |
| Box Weight Capacity | Capacité de poids maximale de la boîte. |
| Box Weight Unit | Unité de poids pour la capacité de la boîte, par exemple POUND. |
| Item SKU | Le SKU de cet article composant. Doit correspondre à un article de catalogue existant. |
| Item Product ID | L'ID produit de cet article composant. Doit correspondre à un article de catalogue existant. |
| Item Quantity | Le nombre d'unités de ce composant dans le bundle. |
Remarque : Les préfixes de colonne
"Bundle"et"Kit"sont tous deux acceptés pour des raisons de rétrocompatibilité (par exemple,"Kit SKU"fonctionne de la même façon que"Bundle SKU").
Règles de validation de l'import CSV
Les règles de validation suivantes s'appliquent à tous les imports CSV de bundles :
- Minimum 2 articles — Chaque bundle doit contenir au moins 2 articles composants. Un bundle à un seul article doit plutôt être un article de catalogue autonome.
- Champs de boîte tout-ou-rien — Pour les bundles en boîte assignée, les 6 champs de boîte doivent être présents sur chaque ligne : Box Length, Box Width, Box Height, Box Dimensional Unit, Box Weight Capacity et Box Weight Unit. Si un champ de boîte est renseigné, les 6 sont requis. Si tous les champs de boîte sont vides, le bundle est traité comme une boîte automatique.
- Pas de mélange des modes d'emballage — Un même bundle ne peut pas mélanger des lignes en boîte assignée (avec dimensions de boîte) et des lignes en boîte automatique (sans dimensions de boîte). Toutes les lignes d'un même bundle doivent utiliser le même mode.
- Normalisation du code SH — Les codes SH sont automatiquement formatés lors de l'import. Les caractères non alphanumériques (points, tirets, espaces) sont supprimés et le code est normalisé dans un format à nombre pair de chiffres.
Importer des bundles + articles de catalogue
Crée à la fois des articles de catalogue ET des bundles en un seul import. Utilisez cette option lorsque vos articles composants n'existent pas encore dans le catalogue — ils seront créés ou mis à jour automatiquement.
- Accédez à Dashboard > Products > Bundles.
- Cliquez sur Manage > Import bundles + catalog items.
- Téléchargez un modèle CSV d'exemple — choisissez le format Assigned box ou Auto-box.
- Remplissez une ligne par article composant, en incluant les colonnes de détails de l'article (nom, code SH, pays d'origine, mesures).
- Importez votre fichier CSV rempli et cliquez sur Import.
L'import crée ou met d'abord à jour les articles de catalogue enfants, puis crée les bundles qui les référencent. Si un article avec le même SKU ou ID produit existe déjà, ses détails sont mis à jour avec les valeurs du CSV. Les codes SH sont automatiquement normalisés lors de l'import (les caractères non alphanumériques sont supprimés et le code est formaté selon le format standard à nombre pair de chiffres).
Champs CSV combinés
Comprend tous les champs CSV du bundle ainsi que les colonnes de détails de l'article :
| Colonne↕ | Description↕ |
|---|---|
| Bundle SKU | Le SKU du bundle. |
| Bundle Product ID | L'ID produit du bundle. |
| Bundle Name | Le nom du bundle. |
| Bundle Description | Une description du bundle. |
| Bundle Image URL | URL de l'image du bundle. |
| Bundle Amount | Le prix total du bundle. |
| Bundle Currency | La devise du prix du bundle, par exemple USD. |
| Box Number | La boîte dans laquelle ce composant est expédié. |
| Box Length | Longueur de la boîte. |
| Box Width | Largeur de la boîte. |
| Box Height | Hauteur de la boîte. |
| Box Dimensional Unit | Unité de dimension, par exemple INCH. |
| Box Weight Capacity | Capacité de poids de la boîte. |
| Box Weight Unit | Unité de poids, par exemple POUND. |
| Item SKU | Le SKU de l'article composant. |
| Item Product ID | L'ID produit de l'article composant. |
| Item Name | Nom d'affichage de l'article de catalogue. |
| Item Description | Description de l'article. |
| Item HS Code | Code du Système Harmonisé pour la classification douanière. |
| Item Country of Origin | Code pays à deux lettres où l'article est fabriqué, par exemple CN. |
| Item Weight | Poids de l'article. |
| Item Weight Unit | Unité de poids, par exemple POUND. |
| Item Length | Longueur de l'article. |
| Item Width | Largeur de l'article. |
| Item Height | Hauteur de l'article. |
| Item Dimensional Unit | Unité de dimension pour les mesures de l'article, par exemple INCH. |
| Item Quantity | Le nombre d'unités de ce composant dans le bundle. |
| Item Amount | Le prix de l'article composant individuel. Utilisé lors de la création ou de la mise à jour de l'article de catalogue. |
| Item Currency | La devise du prix de l'article, par exemple USD. |
| Item Packing Preference | La façon dont cet article doit être emballé. Utilisez ASSIGNED_BOX pour les articles emballés dans la boîte spécifiée, CONSOLIDATED pour la cartonisation, ou SHIPS_ALONE pour les articles qui doivent être expédiés séparément. Facultatif — la valeur par défaut est ASSIGNED_BOX lorsque les colonnes de boîte sont présentes. |
Exporter des bundles
- Accédez à Dashboard > Products > Bundles.
- Cliquez sur Manage > Export.
- Choisissez une option d'export :
- Export all bundles — exporte tous les bundles
- Export assigned box bundles — exporte uniquement les bundles avec des boîtes préassignées
- Export auto bundles — exporte uniquement les bundles en boîte automatique
- Cliquez sur Export. Le CSV vous sera envoyé par e-mail une fois prêt.
Modifier un bundle
Remarque : Les modifications apportées à un bundle n'affectent que les commandes futures. Les commandes déjà passées et exécutées ne sont pas concernées.
- Accédez à Dashboard > Products > Bundles.
- Cliquez sur le bundle que vous souhaitez modifier.
- Mettez à jour les champs et cliquez sur Save.
Vous pouvez changer le mode d'emballage, ajouter ou supprimer des composants, mettre à jour les attributions de boîtes et modifier le prix du bundle.
Supprimer un bundle
Pour supprimer un seul bundle, ouvrez le bundle et cliquez sur Delete.
Pour supprimer plusieurs bundles à la fois :
- Sélectionnez les bundles que vous souhaitez supprimer à l'aide des cases à cocher.
- Cliquez sur Delete selected.
- Confirmez la suppression.
Pour supprimer tous les bundles de la page actuelle, cliquez sur Manage > Delete page.
Utiliser les bundles dans le devis
Vous pouvez ajouter des bundles à un devis directement depuis l'outil de devis pour prévisualiser le coût rendu avant de passer une commande.
- Dans l'outil de devis, basculez vers l'onglet Search bundles dans la section Items.
- Recherchez un bundle par nom, SKU ou ID produit.
- Sélectionnez un bundle. Zonos effectue automatiquement les actions suivantes :
- Décompose le bundle en articles composants individuels dans la liste des articles, chacun avec son propre code SH, pays d'origine et prix réduit.
- Renseigne les boîtes (bundles en boîte assignée uniquement) — les boîtes prédéfinies du bundle sont ajoutées à la section Boxes avec leurs dimensions préremplies.
- Ignore le remplissage des boîtes (bundles en boîte automatique) — la cartonisation détermine les boîtes lors du calcul du devis.
- Les articles composants apparaissent regroupés sous le nom du bundle dans la liste des articles.
- Calculez le devis. Le coût rendu reflète la structure réelle du bundle — droits, taxes et frais d'expédition par composant, basés sur des dimensions de boîte réelles ou déterminées automatiquement.
Vous pouvez ajouter plusieurs bundles et articles autonomes à un même devis. Chaque bundle est décomposé indépendamment.
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
Les bundles résolvent ces trois 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 qui reflète 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égration Shopify
Les bundles ont un comportement spécifique lorsqu'ils sont utilisés avec des boutiques Shopify.
Configuration
L'ID produit du bundle dans Zonos Catalog doit correspondre à l'ID de variante Shopify du produit du bundle. C'est ainsi que Zonos fait correspondre l'article de ligne Shopify à la définition du bundle. Vous pouvez trouver l'ID de variante dans l'URL d'administration Shopify lorsque vous consultez la variante du produit.
Flux de commande
Lorsqu'un client commande un bundle sur une boutique Shopify :
- Shopify envoie un seul article de ligne pour le bundle parent (par exemple, « Truck Tire 4-Pack x 1 »).
- Zonos fait correspondre l'ID de variante de l'article de ligne à l'ID produit du bundle dans votre catalogue.
- Zonos décompose le bundle en ses composants individuels pour le calcul du coût rendu — le code SH, le pays d'origine et le prix réduit de chaque composant sont utilisés pour des droits et taxes précis.
- La commande Shopify continue d'afficher l'article de ligne unique du bundle — la décomposition des composants est entièrement gérée par Zonos.
Exécution
Lors de la création des exécutions, Zonos associe les composants décomposés du bundle à l'article de ligne d'origine du bundle Shopify. Le marchand voit le bundle parent exécuté dans Shopify (par exemple, « Truck Tire 4-Pack x 1 fulfilled »), tandis que la facture commerciale et les documents douaniers répertorient chaque composant séparément.
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 au moment du paiement. Lorsqu'un client achète un bundle, Zonos le décompose en ses composants, réduit le prix de chaque composant pour qu'il corresponde au prix du bundle, et calcule les droits et taxes en fonction du code SH et du pays d'origine de chaque composant.
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 :