DOCS

Bundles

Bundles

Verkaufen Sie gebündelte Produkte mit präzisem Landed Cost und flexiblen Verpackungsoptionen.

Ein Bundle ist ein Produkt, das als einzelne (übergeordnete) Einheit verkauft wird und beim Checkout in einzelne Komponentenartikel aufgeschlüsselt wird. Wenn ein Kunde ein Bundle kauft, schlüsselt Zonos es in seine Komponenten auf, reduziert den Preis jeder Komponente entsprechend dem Bündelpreis und berechnet Zölle und Steuern anhand des HS-Codes und Ursprungslands jeder Komponente.

Beispiel: Ein Händler verkauft Hemden einzeln für je 30 $ oder als Bundle mit 4 Stück für 100 $. Wenn ein Kunde das Bundle kauft:

  • Bestellung und Handelsrechnung zeigen 4 Hemden zu je 25 $ (nicht 1 Bundle zu 100 $ oder 4 Hemden zu je 30 $)
  • Der HS-Code und das Ursprungsland jedes Hemdes werden für die Landed-Cost-Berechnung verwendet
  • Die Versandkosten werden anhand der tatsächlichen Kartonabmessungen berechnet, in denen der Händler sie versendet

Verpackungsmodi 

Bundles unterstützen zwei Verpackungsmodi, die steuern, wie Artikel für den Versand verpackt werden:

Assigned box

Der Händler weist Artikel vorab bestimmten Kartons mit bekannten Abmessungen zu. Jeder Karton wird mit Länge, Breite, Höhe und Gewichtskapazität definiert. Cartonization verwendet diese exakten Kartons, anstatt sie zu schätzen.

Am besten geeignet für: Produkte, bei denen Sie wissen, in welchem Karton sie versendet werden, oder Bundles, die immer im selben Karton versendet werden.

Auto-box

Der Händler gruppiert Artikel zu einem Bundle, ohne Kartons anzugeben. Zum Bestellzeitpunkt verwendet Zonos seinen Cartonization-Algorithmus, um die optimale Kartonverpackung anhand der Artikelabmessungen und verfügbaren Verpackungsoptionen zu bestimmen.

Am besten geeignet für: Bundles, bei denen die Verpackung variiert, Produkte mit flexibler Verpackung, oder wenn Zonos die Kartonauswahl automatisch optimieren soll.

Beide Modi schlüsseln das Bundle in einzelne Komponenten mit artikelspezifischen HS-Codes, Ursprungsland und reduzierten Preisen auf. Der Unterschied liegt nur darin, wie die Kartons bestimmt werden.

Funktionsweise von Bundles 

Wenn Sie ein Bundle in Catalog erstellen, definieren Sie:

  • Bundle-SKU oder Produkt-ID — die Produktkennung, die Ihrem Shop entspricht
  • Bundle-Preis — der Gesamtpreis, wie er in Ihrem Shop erscheint
  • Verpackungsmodus — Assigned box oder Auto-box
  • Komponentenartikel — jedes einzelne Produkt im Bundle, referenziert über seine Catalog-Artikel-ID. Komponenten müssen bereits als Catalog-Artikel existieren, bevor Sie sie einem Bundle hinzufügen können.
  • Kartonzuweisungen (nur bei Assigned box) — welche Komponenten in welchem Karton versendet werden, mit realen Abmessungen und Gewichten

Wenn eine Bestellung mit einem Bundle aufgegeben wird, führt Zonos automatisch Folgendes aus:

  1. Schlüsselt das Bundle in seine einzelnen Komponenten auf
  2. Reduziert den Preis jeder Komponente anhand berechneter Preisverhältnisse, sodass die Einzelpreise dem Bündelpreis entsprechen
  3. Berechnet den Landed Cost anhand des HS-Codes, des Ursprungslands und der Kartonabmessungen jeder Komponente — mit präziser Summe aus Zöllen, Steuern und Versand
  4. Erstellt Etiketten — Bundles mit Assigned box erhalten ein Etikett pro definiertem Karton; Bundles mit Auto-box erhalten Etiketten anhand der Cartonization-Ergebnisse

Voraussetzungen 

Bevor Sie ein Bundle erstellen, stellen Sie sicher, dass:

  • Alle Komponentenartikel als Catalog-Artikel in Ihrem Zonos Catalog existieren. Das Bundle referenziert Komponenten über ihre Catalog-Artikel-ID — Sie können keine Artikel hinzufügen, die noch nicht existieren. Komponenten müssen nicht einzeln in Ihrem Shop verkauft werden — sie können ausschließlich als Bundle-Teile in Ihrem Catalog existieren.
  • Jede Komponente präzise HS-Codes, Ursprungsland und Maße (Gewicht und Abmessungen) hat. Diese werden für Landed-Cost-Berechnungen verwendet, wenn das Bundle aufgeschlüsselt wird.
  • Die SKU oder Produkt-ID des Bundles mit der Kennung übereinstimmt, die Ihre E-Commerce-Plattform an Zonos sendet, und mit der Item-Key-Präferenz in Ihrem Zonos Dashboard. Für Shopify-Shops muss die Produkt-ID des Bundles der Shopify-Varianten-ID des Bundle-Produkts entsprechen.

Jedes Bundle muss mindestens 2 Komponentenartikel enthalten. Ein Bundle mit nur einem Artikel sollte stattdessen ein eigenständiger Catalog-Artikel sein.

  1. Gehen Sie zu Dashboard > Products > Bundles.
  2. Klicken Sie oben rechts auf Add Bundle.
  3. Geben Sie die Bundle-SKU oder Product ID ein — diese muss mit der Kennung übereinstimmen, die Ihr Shop an Zonos sendet. Die Item-Key-Präferenz in Ihrem Zonos Dashboard muss ebenfalls auf die richtige Kennung eingestellt sein.
  4. Geben Sie Name, Preis und Währung des Bundles ein.
  5. Wählen Sie Assigned box als Verpackungsmodus.
  6. Fügen Sie Kartons mit spezifischen Abmessungen hinzu (Länge, Breite, Höhe und Gewichtskapazität).
  7. Fügen Sie Komponentenartikel hinzu, indem Sie Ihren Catalog durchsuchen, und weisen Sie jeden einem Karton zu. Geben Sie für jede Komponente an:
    • Quantity — wie viele Einheiten dieser Komponente im Bundle enthalten sind
    • Box — in welchem Karton diese Komponente versendet wird
    • Price ratio — der Anteil des Bundle-Preises, den diese Komponente repräsentiert (automatisch berechnet, wenn leer gelassen)
  8. Klicken Sie auf Save.

Im Menü Manage > Import stehen zwei Importoptionen zur Verfügung:

Bundles importieren 

Erstellt Bundles, die auf vorhandene Catalog-Artikel verweisen. Komponentenartikel müssen vor dem Import bereits in Ihrem Catalog existieren.

  1. Gehen Sie zu Dashboard > Products > Bundles.
  2. Klicken Sie auf Manage > Import bundles.
  3. Laden Sie eine Beispiel-CSV-Vorlage herunter — wählen Sie das Format Assigned box oder Auto-box.
  4. Füllen Sie eine Zeile pro Komponentenartikel aus. Felder auf Bundle-Ebene (SKU, Name, Preis) wiederholen sich in jeder Zeile für dasselbe Bundle.
  5. Laden Sie Ihre ausgefüllte CSV hoch und klicken Sie auf Import.

Bundle-CSV-Felder 

ColumnDescription
Bundle SKUDie SKU des Bundles, wie sie in Ihrem Shop erscheint.
Bundle Product IDDie Produkt-ID des Bundles, wie sie in Ihrem Shop erscheint.
Bundle NameDer Name des Bundles.
Bundle DescriptionEine Beschreibung des Bundles.
Bundle Image URLBild-URL für das Bundle.
Bundle AmountDer Gesamtpreis des Bundles.
Bundle CurrencyDie Währung des Bundle-Preises, z. B. USD.
Box NumberDie Kartonnummer, in der die Komponente dieser Zeile versendet wird, z. B. 1 oder 2. Verwenden Sie dieselbe Nummer für alle Komponenten im selben Karton.
Box LengthLänge des Kartons für diese Zeile.
Box WidthBreite des Kartons für diese Zeile.
Box HeightHöhe des Kartons für diese Zeile.
Box Dimensional UnitMaßeinheit für den Karton, z. B. INCH.
Box Weight CapacityMaximale Gewichtskapazität des Kartons.
Box Weight UnitGewichtseinheit für die Kartonkapazität, z. B. POUND.
Item SKUDie SKU dieses Komponentenartikels. Muss einem vorhandenen Catalog-Artikel entsprechen.
Item Product IDDie Produkt-ID dieses Komponentenartikels. Muss einem vorhandenen Catalog-Artikel entsprechen.
Item QuantityWie viele Einheiten dieser Komponente im Bundle enthalten sind.

Hinweis: Sowohl "Bundle" als auch "Kit" werden als Spaltenpräfix akzeptiert, aus Gründen der Abwärtskompatibilität (z. B. funktioniert "Kit SKU" genauso wie "Bundle SKU").

CSV-Import-Validierungsregeln 

Für alle Bundle-CSV-Importe gelten die folgenden Validierungsregeln:

  • Mindestens 2 Artikel — Jedes Bundle muss mindestens 2 Komponentenartikel enthalten. Ein Bundle mit nur einem Artikel sollte stattdessen ein eigenständiger Catalog-Artikel sein.
  • Alles-oder-nichts bei Kartonfeldern — Bei Assigned-box-Bundles müssen alle 6 Kartonfelder in jeder Zeile vorhanden sein: Box Length, Box Width, Box Height, Box Dimensional Unit, Box Weight Capacity und Box Weight Unit. Wenn ein Kartonfeld gesetzt ist, sind alle 6 erforderlich. Wenn alle Kartonfelder leer sind, wird das Bundle als Auto-box behandelt.
  • Keine Vermischung von Verpackungsmodi — Ein einzelnes Bundle kann nicht Assigned-box-Zeilen (mit Kartonabmessungen) und Auto-box-Zeilen (ohne Kartonabmessungen) mischen. Alle Zeilen für ein Bundle müssen denselben Modus verwenden.
  • HS-Code-Normalisierung — HS-Codes werden beim Import automatisch formatiert. Nicht-alphanumerische Zeichen (Punkte, Bindestriche, Leerzeichen) werden entfernt und der Code wird auf ein Format mit gerader Ziffernanzahl normalisiert.

Bundles + Catalog-Artikel importieren 

Erstellt sowohl Catalog-Artikel als auch Bundles in einem einzigen Upload. Verwenden Sie dies, wenn Ihre Komponentenartikel noch nicht im Catalog existieren — sie werden automatisch erstellt oder aktualisiert.

  1. Gehen Sie zu Dashboard > Products > Bundles.
  2. Klicken Sie auf Manage > Import bundles + catalog items.
  3. Laden Sie eine Beispiel-CSV-Vorlage herunter — wählen Sie das Format Assigned box oder Auto-box.
  4. Füllen Sie eine Zeile pro Komponentenartikel aus, einschließlich der Artikeldetailspalten (Name, HS-Code, Ursprungsland, Maße).
  5. Laden Sie Ihre ausgefüllte CSV hoch und klicken Sie auf Import.

Der Import erstellt oder aktualisiert zunächst die untergeordneten Catalog-Artikel und erstellt anschließend die Bundles, die auf sie verweisen. Wenn bereits ein Artikel mit derselben SKU oder Produkt-ID existiert, werden seine Details mit den Werten aus der CSV aktualisiert. HS-Codes werden beim Import automatisch normalisiert (nicht-alphanumerische Zeichen werden entfernt und der Code wird auf das Standardformat mit gerader Ziffernanzahl gebracht).

Kombinierte CSV-Felder 

Enthält alle Bundle-CSV-Felder plus Artikeldetailspalten:

ColumnDescription
Bundle SKUDie SKU des Bundles.
Bundle Product IDDie Produkt-ID des Bundles.
Bundle NameDer Name des Bundles.
Bundle DescriptionEine Beschreibung des Bundles.
Bundle Image URLBild-URL für das Bundle.
Bundle AmountDer Gesamtpreis des Bundles.
Bundle CurrencyDie Währung des Bundle-Preises, z. B. USD.
Box NumberIn welchem Karton diese Komponente versendet wird.
Box LengthLänge des Kartons.
Box WidthBreite des Kartons.
Box HeightHöhe des Kartons.
Box Dimensional UnitMaßeinheit, z. B. INCH.
Box Weight CapacityGewichtskapazität des Kartons.
Box Weight UnitGewichtseinheit, z. B. POUND.
Item SKUDie SKU des Komponentenartikels.
Item Product IDDie Produkt-ID des Komponentenartikels.
Item NameAnzeigename für den Catalog-Artikel.
Item DescriptionBeschreibung des Artikels.
Item HS CodeHarmonisierter Systemcode für die Zollklassifizierung.
Item Country of OriginZweistelliger Ländercode, in dem der Artikel hergestellt wird, z. B. CN.
Item WeightGewicht des Artikels.
Item Weight UnitGewichtseinheit, z. B. POUND.
Item LengthLänge des Artikels.
Item WidthBreite des Artikels.
Item HeightHöhe des Artikels.
Item Dimensional UnitMaßeinheit für die Artikelmaße, z. B. INCH.
Item QuantityWie viele Einheiten dieser Komponente im Bundle enthalten sind.
Item AmountDer Preis des einzelnen Komponentenartikels. Wird beim Erstellen oder Aktualisieren des Catalog-Artikels verwendet.
Item CurrencyDie Währung des Artikelpreises, z. B. USD.
Item Packing PreferenceWie dieser Artikel verpackt werden soll. Verwenden Sie ASSIGNED_BOX für Artikel, die im angegebenen Karton verpackt werden, CONSOLIDATED für Cartonization, oder SHIPS_ALONE für Artikel, die separat versendet werden müssen. Optional — Standard ist ASSIGNED_BOX, wenn Kartonspalten vorhanden sind.
  1. Gehen Sie zu Dashboard > Products > Bundles.
  2. Klicken Sie auf Manage > Export.
  3. Wählen Sie eine Exportoption:
    • Export all bundles — exportiert alle Bundles
    • Export assigned box bundles — exportiert nur Bundles mit vorab zugewiesenen Kartons
    • Export auto bundles — exportiert nur Auto-box-Bundles
  4. Klicken Sie auf Export. Die CSV wird Ihnen per E-Mail zugesendet, sobald sie bereit ist.

Hinweis: Änderungen an einem Bundle wirken sich nur auf zukünftige Bestellungen aus. Bereits aufgegebene und abgewickelte Bestellungen sind nicht betroffen.

  1. Gehen Sie zu Dashboard > Products > Bundles.
  2. Klicken Sie auf das Bundle, das Sie bearbeiten möchten.
  3. Aktualisieren Sie die Felder und klicken Sie auf Save.

Sie können den Verpackungsmodus ändern, Komponenten hinzufügen oder entfernen, Kartonzuweisungen aktualisieren und den Bundle-Preis anpassen.

Um ein einzelnes Bundle zu löschen, öffnen Sie das Bundle und klicken Sie auf Delete.

So löschen Sie mehrere Bundles gleichzeitig:

  1. Wählen Sie die zu löschenden Bundles über die Kontrollkästchen aus.
  2. Klicken Sie auf Delete selected.
  3. Bestätigen Sie die Löschung.

Um alle Bundles auf der aktuellen Seite zu löschen, klicken Sie auf Manage > Delete page.

Sie können Bundles direkt im Quoter zu einem Angebot hinzufügen, um den Landed Cost vor der Bestellung zu prüfen.

  1. Wechseln Sie im Quoter im Bereich „Items“ zur Registerkarte Search bundles.
  2. Suchen Sie nach einem Bundle anhand von Name, SKU oder Produkt-ID.
  3. Wählen Sie ein Bundle aus. Zonos führt automatisch Folgendes aus:
    • Schlüsselt das Bundle auf in einzelne Komponentenartikel in der Artikelliste, jeweils mit eigenem HS-Code, Ursprungsland und reduziertem Preis.
    • Befüllt Kartons (nur bei Assigned-box-Bundles) — die vordefinierten Kartons des Bundles werden mit ihren Abmessungen im Bereich „Boxes“ vorausgefüllt hinzugefügt.
    • Überspringt die Kartonbefüllung (bei Auto-box-Bundles) — Cartonization bestimmt die Kartons bei der Berechnung des Angebots.
  4. Komponentenartikel erscheinen in der Artikelliste unter dem Bundle-Namen gruppiert.
  5. Berechnen Sie das Angebot. Der Landed Cost spiegelt die tatsächliche Bundle-Struktur wider — Zölle, Steuern und Versand pro Komponente, basierend auf realen oder automatisch bestimmten Kartonabmessungen.

Sie können mehrere Bundles und eigenständige Artikel demselben Angebot hinzufügen. Jedes Bundle wird unabhängig aufgeschlüsselt.

Warum Bundles für Landed Cost wichtig sind 

Ohne Bundles sieht Zonos nur eine einzelne Position (z. B. „Truck Tire 4-Pack — 1.000 $“) ohne Einblick in den Inhalt. Das führt zu Problemen:

  • Keine HS-Codes pro Artikel — Zonos kann die Komponenten nicht für präzise Zollsätze klassifizieren
  • Keine realen Kartonabmessungen — Versandkosten werden mit dem Auto-Packing-Algorithmus geschätzt statt anhand der tatsächlichen Kartons des Händlers
  • Keine Preise pro Artikel — der volle Bündelpreis wird für Zollberechnungen verwendet statt des reduzierten Preises pro Komponente

Bundles lösen alle drei Punkte, indem sie Zonos die Komponentenaufschlüsselung, Kartonzuweisungen (oder Auto-box-Gruppierung) und Preiszuordnung im Voraus liefern. Das Ergebnis ist ein Landed-Cost-Angebot, das widerspiegelt, was der Kunde tatsächlich an der Grenze zahlen wird.

Preisverhältnisse und Komponentenpreise 

Wenn ein Bundle verkauft wird, muss Zonos wissen, wie viel jede Komponente einzeln wert ist. Das liegt daran, dass internationale Sendungen einen deklarierten Wert pro Artikel auf der Handelsrechnung erfordern und Zoll/Steuern für jeden Artikel separat berechnet werden.

Das priceRatio steuert, wie der Gesamtpreis des Bundles auf seine Komponenten aufgeteilt wird. Sie müssen dies nicht selbst festlegen — wenn Sie es leer lassen, teilt Zonos den Preis automatisch gleichmäßig auf alle Komponenten auf.

Beispiel: Bei einem 1.000-$-Bundle mit 4 Reifen und ohne gesetzte Preisverhältnisse würde jeder Reifen automatisch mit 250 $ (0,25 je Reifen) deklariert. Wenn Ihre Komponenten unterschiedliche Werte haben — etwa 2 Premium- und 2 Standardreifen — können Sie manuell Verhältnisse wie 0,35 und 0,15 setzen, um den tatsächlichen Wertunterschied abzubilden.

Zonos normalisiert die Verhältnisse automatisch, sodass Sie sich um die Berechnung keine Gedanken machen müssen:

  • Wenn Sie einige Verhältnisse leer lassen, wird der verbleibende Wert gleichmäßig auf diese Komponenten aufgeteilt
  • Wenn die Verhältnisse nicht genau 1,0 ergeben, skaliert Zonos sie proportional
  • Die endgültigen Verhältnisse ergeben immer genau 1,0

Cartonization und Etiketten 

Assigned-box-Bundle-Komponenten verwenden händlerdefinierte Kartons anstelle des standardmäßigen Bin-Packing-Algorithmus. Die packingPreference jeder Komponente ist auf ASSIGNED_BOX gesetzt, wodurch Cartonization angewiesen wird, sie in den durch packageOptionId und packageOptionIdIndex angegebenen Karton zu legen.

Das ist der zentrale Vorteil von Assigned-box-Bundles — der Händler weiß genau, wie sein Produkt versendet wird, sodass die für die Landed-Cost-Berechnung verwendeten Kartonabmessungen und -gewichte präzise und nicht geschätzt sind.

Jeder Karton in einem Bundle erzeugt ein eigenes Versandetikett mit eigener Sendungsverfolgungsnummer. Ein Bundle mit zwei Kartons erzeugt zwei Etiketten.

Gemischte Bestellungen

Nicht-Bundle-Artikel in derselben Bestellung werden unabhängig vom verwendeten Verpackungsmodus des Bundles separat mit dem standardmäßigen Cartonization-Algorithmus verpackt.

Gemischte Bundle-Bestellungen 

Eine einzelne Bestellung kann gleichzeitig mehrere Bundles und eigenständige Artikel enthalten. Beispiel für eine Bestellung mit:

  • 1× 4er-Bundle mit Assigned box (Versand in 2 Kartons)
  • 1× 3-Artikel-Bundle mit Auto-box (Cartonization bestimmt die Verpackung)
  • 1× einzelner eigenständiger Artikel

Zonos schlüsselt jedes Bundle unabhängig auf. Die Landed-Cost-Berechnung deckt alle Kartons mit präzisen Abmessungen und alle einzelnen Komponentenpreise ab. Jeder Karton erhält ein eigenes Etikett.

Shopify-Integration 

Bundles haben spezifisches Verhalten in Shopify-Shops.

Einrichtung

Die Produkt-ID des Bundles in Zonos Catalog muss der Shopify-Varianten-ID des Bundle-Produkts entsprechen. So ordnet Zonos die Shopify-Position dem Bundle zu. Die Varianten-ID finden Sie in der Shopify-Admin-URL beim Anzeigen der Produktvariante.

Bestellablauf

Wenn ein Kunde ein Bundle in einem Shopify-Shop bestellt:

  1. Shopify sendet eine einzelne Position für das Bundle-Parent (z. B. „Truck Tire 4-Pack × 1“).
  2. Zonos ordnet die Varianten-ID der Position der Produkt-ID des Bundles in Ihrem Catalog zu.
  3. Zonos schlüsselt das Bundle für die Landed-Cost-Berechnung in seine einzelnen Komponenten auf — HS-Code, Ursprungsland und reduzierter Preis jeder Komponente werden für präzise Zölle und Steuern verwendet.
  4. Die Shopify-Bestellung zeigt weiterhin die einzelne Bundle-Position — die Komponentenaufschlüsselung erfolgt vollständig über Zonos.

Fulfillment

Beim Erstellen von Fulfillments ordnet Zonos die aufgeschlüsselten Bundle-Komponenten wieder der ursprünglichen Shopify-Bundle-Position zu. Der Händler sieht in Shopify das erfüllte Bundle-Parent (z. B. „Truck Tire 4-Pack × 1 fulfilled“), während Handelsrechnung und Zolldokumente jede Komponente separat auflisten.

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

War diese Seite hilfreich?