DOCS

Bundles

Bundles

Verkoop gebundelde producten met nauwkeurige landed cost en flexibele pakopties.

Een bundle is een product dat wordt verkocht als één (bovenliggende) eenheid en dat bij checkout wordt opgesplitst in de afzonderlijke componenten. Wanneer een klant een bundle koopt, splitst Zonos deze op in de componenten, verlaagt de prijs van elk component evenredig zodat deze samen de bundleprijs vormen, en berekent rechten en belastingen op basis van de HS-code en het land van herkomst van elk component.

Een merchant verkoopt bijvoorbeeld shirts los voor $30 per stuk, of als bundle van 4 voor $100. Wanneer een klant de bundle koopt:

  • De order en de commerciële factuur tonen 4 shirts van elk $25 (niet 1 bundle van $100 of 4 shirts van elk $30)
  • De HS-code en het land van herkomst van elk shirt worden gebruikt voor de landed cost-berekening
  • Verzendkosten worden berekend op basis van de werkelijke afmetingen van de doos waarin de merchant ze verzendt

Pakmodi 

Bundles ondersteunen twee pakmodi die bepalen hoe items worden verpakt voor verzending:

Toegewezen doos

De merchant wijst items vooraf toe aan specifieke dozen met bekende afmetingen. Elke doos wordt gedefinieerd met lengte, breedte, hoogte en gewichtscapaciteit. Cartonization gebruikt deze exacte dozen in plaats van een schatting te maken.

Het meest geschikt voor: producten waarvan u weet in welke doos ze worden verzonden, of bundles die altijd in dezelfde doos worden verzonden.

Auto-doos

De merchant groepeert items in een bundle zonder dozen op te geven. Op het moment van bestellen gebruikt Zonos het cartonization-algoritme om de optimale doosindeling te bepalen op basis van de afmetingen van de items en de beschikbare verpakkingsopties.

Het meest geschikt voor: bundles waarbij de verpakking varieert, producten met flexibele verpakking, of wanneer u wilt dat Zonos de doosselectie automatisch optimaliseert.

Beide modi splitsen de bundle op in afzonderlijke componenten met een HS-code, land van herkomst en verlaagde prijs per item. Het enige verschil zit in hoe de dozen worden bepaald.

Hoe bundles werken 

Wanneer u een bundle aanmaakt in Catalog, definieert u:

  • Bundle-SKU of product-ID — de productidentificatie die overeenkomt met uw winkel
  • Bundleprijs — de totaalprijs zoals deze in uw winkel wordt weergegeven
  • Pakmodus — toegewezen doos of auto-doos
  • Componentitems — elk afzonderlijk product dat in de bundle is opgenomen, verwezen via de catalog item-ID. Componenten moeten al als catalog items bestaan voordat u ze aan een bundle kunt toevoegen.
  • Doostoewijzingen (alleen toegewezen doos) — welke componenten in welke doos worden verzonden, met werkelijke afmetingen en gewichten

Wanneer een order met een bundle wordt geplaatst, doet Zonos automatisch het volgende:

  1. Splitst de bundle op in de afzonderlijke componenten
  2. Verlaagt de prijs van elk component met berekende prijsratio's, zodat de prijzen per item samen de bundleprijs vormen
  3. Berekent de landed cost op basis van de HS-code, het land van herkomst en de afmetingen van de doos van elk component — voor een nauwkeurig totaal aan rechten, belastingen en verzendkosten
  4. Genereert labels — bundles met toegewezen doos krijgen één label per gedefinieerde doos; bundles met auto-doos krijgen labels op basis van de cartonization-resultaten

Vereisten 

Zorg er voordat u een bundle aanmaakt voor dat:

  • Alle componentitems bestaan als catalog items in uw Zonos Catalog. De bundle verwijst naar componenten via hun catalog item-ID — u kunt geen items toevoegen die nog niet bestaan. Componenten hoeven niet afzonderlijk in uw winkel te worden verkocht — ze kunnen uitsluitend in uw catalog bestaan als onderdeel van een bundle.
  • Elk component heeft nauwkeurige HS-codes, land van herkomst en afmetingen (gewicht en maten). Deze worden gebruikt voor de landed cost-berekeningen wanneer de bundle wordt opgesplitst.
  • De SKU of product-ID van de bundle komt overeen met de identificatie die uw e-commerceplatform naar Zonos stuurt en met de Item key-voorkeur in uw Zonos Dashboard. Voor Shopify-winkels moet de product-ID van de bundle de Shopify variant-ID van het bundleproduct zijn.

Elke bundle moet ten minste 2 componentitems bevatten. Een bundle met één item moet in plaats daarvan een zelfstandig catalog item zijn.

  1. Ga naar Dashboard > Products > Bundles.
  2. Klik rechtsboven op Add Bundle.
  3. Voer de SKU of Product ID van de bundle in — deze moet overeenkomen met de identificatie die uw winkel naar Zonos stuurt. De Item key-voorkeur in uw Zonos Dashboard moet ook zijn ingesteld op de juiste identificatie.
  4. Voer de naam, prijs en valuta van de bundle in.
  5. Selecteer Assigned box als pakmodus.
  6. Voeg dozen toe met specifieke afmetingen (lengte, breedte, hoogte en gewichtscapaciteit).
  7. Voeg componentitems toe door in uw catalog te zoeken en wijs elk item toe aan een doos. Geef voor elk component het volgende op:
    • Quantity — hoeveel eenheden van dit component in de bundle zitten
    • Box — in welke doos dit component wordt verzonden
    • Price ratio — het deel van de bundleprijs dat dit component vertegenwoordigt (automatisch berekend indien leeg gelaten)
  8. Klik op Save.

Er zijn twee importopties beschikbaar via Manage > Import:

Bundles importeren 

Maakt bundles aan die verwijzen naar bestaande catalog items. Componentitems moeten al in uw catalog bestaan voordat u importeert.

  1. Ga naar Dashboard > Products > Bundles.
  2. Klik op Manage > Import bundles.
  3. Download een voorbeeld-CSV-sjabloon — kies de indeling Assigned box of Auto-box.
  4. Vul één rij per componentitem in. Velden op bundleniveau (SKU, naam, prijs) worden op elke rij voor dezelfde bundle herhaald.
  5. Upload uw ingevulde CSV en klik op Import.

CSV-velden voor bundles 

ColumnDescription
Bundle SKUDe SKU van de bundle zoals deze in uw winkel wordt weergegeven.
Bundle Product IDDe product-ID van de bundle zoals deze in uw winkel wordt weergegeven.
Bundle NameDe naam van de bundle.
Bundle DescriptionEen beschrijving van de bundle.
Bundle Image URLAfbeeldings-URL voor de bundle.
Bundle AmountDe totaalprijs van de bundle.
Bundle CurrencyDe valuta van de bundleprijs, bijv. USD.
Box NumberHet doosnummer waarin het component van deze rij wordt verzonden, bijv. 1 of 2. Gebruik hetzelfde nummer voor alle componenten in dezelfde doos.
Box LengthLengte van de doos voor deze rij.
Box WidthBreedte van de doos voor deze rij.
Box HeightHoogte van de doos voor deze rij.
Box Dimensional UnitMaateenheid voor de doos, bijv. INCH.
Box Weight CapacityMaximale gewichtscapaciteit van de doos.
Box Weight UnitGewichtseenheid voor de doos capaciteit, bijv. POUND.
Item SKUDe SKU van dit componentitem. Moet overeenkomen met een bestaand catalog item.
Item Product IDDe product-ID van dit componentitem. Moet overeenkomen met een bestaand catalog item.
Item QuantityHoeveel eenheden van dit component in de bundle zitten.

Opmerking: Zowel de kolomprefix "Bundle" als "Kit" wordt geaccepteerd voor achterwaartse compatibiliteit (bijv. "Kit SKU" werkt hetzelfde als "Bundle SKU").

Validatieregels voor CSV-import 

De volgende validatieregels gelden voor alle CSV-imports van bundles:

  • Minimaal 2 items — Elke bundle moet ten minste 2 componentitems bevatten. Een bundle met één item moet in plaats daarvan een zelfstandig catalog item zijn.
  • Alles-of-niets dooskolommen — Voor bundles met toegewezen doos moeten alle 6 dooskolommen op elke rij aanwezig zijn: Box Length, Box Width, Box Height, Box Dimensional Unit, Box Weight Capacity en Box Weight Unit. Als één dooskolom is ingevuld, zijn alle 6 verplicht. Als alle dooskolommen leeg zijn, wordt de bundle als auto-doos behandeld.
  • Geen gemengde pakmodi — Eén bundle kan geen rijen met toegewezen doos (met doosafmetingen) combineren met rijen met auto-doos (zonder doosafmetingen). Alle rijen voor één bundle moeten dezelfde modus gebruiken.
  • HS-code-normalisatie — HS-codes worden bij import automatisch geformatteerd. Niet-alfanumerieke tekens (punten, streepjes, spaties) worden verwijderd en de code wordt genormaliseerd naar een even-cijferig formaat.

Bundles + catalog items importeren 

Maakt zowel catalog items ALS bundles aan in één upload. Gebruik dit wanneer uw componentitems nog niet in de catalog bestaan — ze worden automatisch aangemaakt of bijgewerkt.

  1. Ga naar Dashboard > Products > Bundles.
  2. Klik op Manage > Import bundles + catalog items.
  3. Download een voorbeeld-CSV-sjabloon — kies de indeling Assigned box of Auto-box.
  4. Vul één rij per componentitem in, inclusief de detailkolommen van het item (naam, HS-code, land van herkomst, afmetingen).
  5. Upload uw ingevulde CSV en klik op Import.

De import maakt eerst de onderliggende catalog items aan of werkt ze bij, en maakt vervolgens de bundles aan die ernaar verwijzen. Als er al een item met dezelfde SKU of product-ID bestaat, worden de gegevens ervan bijgewerkt met de waarden uit de CSV. HS-codes worden tijdens de import automatisch genormaliseerd (niet-alfanumerieke tekens worden verwijderd en de code wordt geformatteerd naar het standaard even-cijferige formaat).

Gecombineerde CSV-velden 

Bevat alle CSV-velden voor bundles plus detailkolommen voor items:

ColumnDescription
Bundle SKUDe SKU van de bundle.
Bundle Product IDDe product-ID van de bundle.
Bundle NameDe naam van de bundle.
Bundle DescriptionEen beschrijving van de bundle.
Bundle Image URLAfbeeldings-URL voor de bundle.
Bundle AmountDe totaalprijs van de bundle.
Bundle CurrencyDe valuta van de bundleprijs, bijv. USD.
Box NumberIn welke doos dit component wordt verzonden.
Box LengthLengte van de doos.
Box WidthBreedte van de doos.
Box HeightHoogte van de doos.
Box Dimensional UnitMaateenheid, bijv. INCH.
Box Weight CapacityGewichtscapaciteit van de doos.
Box Weight UnitGewichtseenheid, bijv. POUND.
Item SKUDe SKU van het componentitem.
Item Product IDDe product-ID van het componentitem.
Item NameWeergavenaam voor het catalog item.
Item DescriptionBeschrijving van het item.
Item HS CodeHarmonized System-code voor douaneclassificatie.
Item Country of OriginTweeletterige landcode waar het item is vervaardigd, bijv. CN.
Item WeightGewicht van het item.
Item Weight UnitGewichtseenheid, bijv. POUND.
Item LengthLengte van het item.
Item WidthBreedte van het item.
Item HeightHoogte van het item.
Item Dimensional UnitMaateenheid voor de afmetingen van het item, bijv. INCH.
Item QuantityHoeveel eenheden van dit component in de bundle zitten.
Item AmountDe prijs van het afzonderlijke componentitem. Wordt gebruikt bij het aanmaken of bijwerken van het catalog item.
Item CurrencyDe valuta van de itemprijs, bijv. USD.
Item Packing PreferenceHoe dit item moet worden verpakt. Gebruik ASSIGNED_BOX voor items die in de opgegeven doos worden verpakt, CONSOLIDATED voor cartonization, of SHIPS_ALONE voor items die apart moeten worden verzonden. Optioneel — standaard ASSIGNED_BOX wanneer dooskolommen aanwezig zijn.
  1. Ga naar Dashboard > Products > Bundles.
  2. Klik op Manage > Export.
  3. Kies een exportoptie:
    • Export all bundles — exporteert alle bundles
    • Export assigned box bundles — exporteert alleen bundles met vooraf toegewezen dozen
    • Export auto bundles — exporteert alleen bundles met auto-doos
  4. Klik op Export. De CSV wordt naar u gemaild zodra deze klaar is.

Opmerking: Wijzigingen aan een bundle gelden alleen voor toekomstige orders. Orders die al zijn geplaatst en afgehandeld, worden niet beïnvloed.

  1. Ga naar Dashboard > Products > Bundles.
  2. Klik op de bundle die u wilt bewerken.
  3. Werk de velden bij en klik op Save.

U kunt de pakmodus wijzigen, componenten toevoegen of verwijderen, doostoewijzingen bijwerken en de bundleprijs aanpassen.

Om een enkele bundle te verwijderen, opent u de bundle en klikt u op Delete.

Om meerdere bundles tegelijk te verwijderen:

  1. Selecteer de bundles die u wilt verwijderen met de selectievakjes.
  2. Klik op Delete selected.
  3. Bevestig de verwijdering.

Om alle bundles op de huidige pagina te verwijderen, klikt u op Manage > Delete page.

U kunt bundles rechtstreeks vanuit de quoter aan een quote toevoegen om de landed cost te bekijken voordat u een order plaatst.

  1. Schakel in de quoter naar het tabblad Search bundles in de sectie Items.
  2. Zoek een bundle op naam, SKU of product-ID.
  3. Selecteer een bundle. Zonos doet automatisch het volgende:
    • Splitst de bundle op in afzonderlijke componentitems in de itemlijst, elk met een eigen HS-code, land van herkomst en verlaagde prijs.
    • Vult dozen in (alleen bundles met toegewezen doos) — de vooraf gedefinieerde dozen van de bundle worden toegevoegd aan de sectie Boxes, met de afmetingen al ingevuld.
    • Slaat het invullen van dozen over (bundles met auto-doos) — cartonization bepaalt de dozen wanneer de quote wordt berekend.
  4. Componentitems worden gegroepeerd onder de bundlenaam in de itemlijst weergegeven.
  5. Bereken de quote. De landed cost weerspiegelt de daadwerkelijke bundlestructuur — rechten, belastingen en verzendkosten per component op basis van werkelijke of automatisch bepaalde doosafmetingen.

U kunt meerdere bundles en losse items aan dezelfde quote toevoegen. Elke bundle wordt onafhankelijk opgesplitst.

Waarom bundles belangrijk zijn voor landed cost 

Zonder bundles ziet Zonos slechts één regelitem (bijv. "Truck Tire 4-Pack — $1.000") zonder inzicht in de inhoud. Dit veroorzaakt problemen:

  • Geen HS-codes per item — Zonos kan de componenten niet classificeren voor nauwkeurige invoerrechten
  • Geen werkelijke doosafmetingen — verzendkosten worden geschat met het auto-pakalgoritme in plaats van de daadwerkelijke dozen van de merchant
  • Geen prijs per item — de volledige bundleprijs wordt gebruikt voor de berekening van invoerrechten in plaats van de verlaagde prijs per component

Bundles lossen alle drie de problemen op door Zonos vooraf de uitsplitsing van componenten, doostoewijzingen (of auto-doos-groepering) en prijsverdeling te geven. Het resultaat is een landed cost-quote die weergeeft wat de klant daadwerkelijk aan de grens zal betalen.

Prijsratio's en componentprijzen 

Wanneer een bundle wordt verkocht, moet Zonos weten hoeveel elk component afzonderlijk waard is. Dit komt doordat internationale zendingen een aangegeven waarde per item op de commerciële factuur vereisen, en rechten/belastingen voor elk item afzonderlijk worden berekend.

De priceRatio bepaalt hoe de totale bundleprijs wordt verdeeld over de componenten. U hoeft dit niet zelf in te stellen — als u dit leeg laat, verdeelt Zonos de prijs automatisch gelijk over alle componenten.

Een bundle van $1.000 met 4 banden en geen ingestelde prijsratio's geeft bijvoorbeeld automatisch elke band aan voor $250 (0,25 elk). Als uw componenten verschillende waarden hebben — bijvoorbeeld 2 premiumbanden en 2 standaardbanden — kunt u handmatig ratio's zoals 0,35 en 0,15 instellen om het werkelijke waardeverschil weer te geven.

Zonos normaliseert de ratio's automatisch, zodat u zich geen zorgen hoeft te maken over de berekening:

  • Als u sommige ratio's leeg laat, wordt de resterende waarde gelijk verdeeld over die componenten
  • Als de ratio's niet precies optellen tot 1,0, schaalt Zonos deze proportioneel
  • De uiteindelijke ratio's tellen altijd op tot precies 1,0

Cartonization en labels 

Componenten van bundles met toegewezen doos gebruiken door de merchant gedefinieerde dozen in plaats van het standaard bin-packing-algoritme. De packingPreference van elk component is ingesteld op ASSIGNED_BOX, wat cartonization de opdracht geeft om het component te plaatsen in de doos die is opgegeven via packageOptionId en packageOptionIdIndex.

Dit is het belangrijkste voordeel van bundles met toegewezen doos — de merchant weet precies hoe het product wordt verzonden, waardoor de doosafmetingen en gewichten die worden gebruikt voor de landed cost-berekening nauwkeurig zijn in plaats van geschat.

Elke doos in een bundle genereert zijn eigen verzendlabel met een eigen trackingnummer. Een bundle met twee dozen levert twee labels op.

Gemengde orders

Items die geen deel uitmaken van een bundle worden in dezelfde order apart verpakt met het standaard cartonization-algoritme, ongeacht welke pakmodus de bundles gebruiken.

Gemengde bundle-orders 

Eén order kan tegelijk meerdere bundles en losse items bevatten. Bijvoorbeeld een order met:

  • 1x 4-pack bundle met toegewezen dozen (verzonden in 2 dozen)
  • 1x auto-doos-bundle met 3 items (cartonization bepaalt de verpakking)
  • 1x los, zelfstandig item

Zonos splitst elke bundle onafhankelijk op. De landed cost-berekening omvat alle dozen met nauwkeurige afmetingen en alle afzonderlijke componentprijzen. Elke doos krijgt zijn eigen label.

Shopify-integratie 

Bundles hebben specifiek gedrag wanneer ze worden gebruikt met Shopify-winkels.

Instellen

De product-ID van de bundle in Zonos Catalog moet overeenkomen met de Shopify variant-ID van het bundleproduct. Zo koppelt Zonos het Shopify-regelitem aan de bundledefinitie. U vindt de variant-ID in de Shopify-beheer-URL bij het bekijken van de productvariant.

Bestelverloop

Wanneer een klant een bundle bestelt in een Shopify-winkel:

  1. Shopify stuurt één regelitem voor de bovenliggende bundle (bijv. "Truck Tire 4-Pack x 1").
  2. Zonos koppelt de variant-ID van het regelitem aan de product-ID van de bundle in uw catalog.
  3. Zonos splitst de bundle op in de afzonderlijke componenten voor de landed cost-berekening — de HS-code, het land van herkomst en de verlaagde prijs van elk component worden gebruikt voor nauwkeurige rechten en belastingen.
  4. De Shopify-order toont nog steeds het ene regelitem van de bundle — het opsplitsen in componenten wordt volledig door Zonos afgehandeld.

Uitvoering

Bij het aanmaken van fulfillments koppelt Zonos de opgesplitste bundlecomponenten terug aan het oorspronkelijke Shopify-regelitem van de bundle. De merchant ziet de bovenliggende bundle in Shopify als afgehandeld (bijv. "Truck Tire 4-Pack x 1 fulfilled"), terwijl de commerciële factuur en douanedocumenten elk component afzonderlijk vermelden.

GraphQL API ReferenceTypes, inputs, and operations used in this guide
Boek een demo

Was deze pagina nuttig?