Wie BundlesIQ Funktioniert

BundlesIQ erweitert Bundle-Varianten in ihre Komponenten-Varianten (je nach Ihrem konfigurierten Handhabungsmodus), sodass Ihr Shop einen einzelnen „Bundle-Artikel“ verkaufen kann, während Ihre Abläufe und Berichterstattung die zugrunde liegenden Artikel widerspiegeln.

Terminologie (wichtig)

BundlesIQ funktioniert variant-to-variant:

• Produkt: Ein Shopify-Produktcontainer (in dem Händler oft im Admin navigieren)
• Variante: Der kaufbare Artikel auf SKU-Ebene (das ist es, was BundlesIQ abbildet und erkennt)
• Ghost SKU-Variante: Die Bundle-Variante, die Kunden kaufen (der „Eltern“-Position)
• Komponenten-Varianten: Die Variante(n), die im Bundle enthalten sind, jeweils mit einer Menge

Wenn in diesem Dokument „Produkt“ gesagt wird, bezieht es sich darauf, wie der Shopify-Admin organisiert ist. Die tatsächliche Erkennung und Abbildung erfolgt immer anhand von Variant IDs.

Das Ghost SKU-Modell

BundlesIQ verwendet einen Ansatz mit Ghost SKU-Varianten für das Bundling:

1. Sie wählen die Variante, die Kunden als Bundle kaufen werden:
   • Wählen Sie eine vorhandene Shopify-Variante, oder
   • Erstellen Sie den Bundle-Artikel in BundlesIQ (schneller, aber eingeschränkter als Shopify Admin)
2. In BundlesIQ definieren Sie das Bundle, indem Sie diese Ghost SKU-Variante mit einer oder mehreren Komponenten-Varianten (plus Mengen) verknüpfen
3. Wenn ein Kunde die Ghost SKU-Variante kauft, erkennt BundlesIQ dies und verarbeitet die Bestellung basierend auf Ihrem Handhabungsmodus (Operational, Hybrid, Reporting oder Parent-Only/BOM)

Konkretes Beispiel (variant-to-variant)

Produkt A: „Apfel“

• Variante A (Standard): „Einzel“
• Variante B (Bundle): „Zwei-Pack“ → Komponenten: Variante A × 2
• Variante C (Bundle): „Drei-Pack“ → Komponenten: Variante A × 3
• Variante D (Bundle): „Vier-Pack“ → Komponenten: Variante A × 4
• Variante E (Bundle): „Fünf-Pack“ → Komponenten: Variante A × 5

Das Bundle sieht in Shopify Admin wie ein „Produkt“ aus, aber BundlesIQ bildet und verarbeitet diese als Varianten.

Warum Ghost SKU-Varianten

Ghost SKU-Varianten halten den Shop einfach, während das Backoffice präzise bleibt:

• Kunden sehen einen Artikel mit einem Preis
• Ops/Lager können mit den tatsächlichen Pick-/Pack-Artikeln arbeiten (wenn Ihr Modus Komponenten zur Bestellung hinzufügt)
• Buchhaltung/Berichterstattung kann Einnahmen auf der Ebene verfolgen, die Sie wählen (Bundle-Ebene, Komponenten-Ebene oder beides)
• Bestandskontrolle hängt vom Handhabungsmodus ab:
  • In Modi, in denen Komponenten in der Bestellung enthalten sind, gilt der normale Bestandsfluss von Shopify für Komponenten-Varianten
  • Im Parent-Only (BOM)-Modus kann BundlesIQ optional die Komponentenbestände über Bestandszustände verwalten (mehr dazu unten)

Handhabungsmodi (Was sich bei der Bestellung ändert)

BundlesIQ unterstützt mehrere Handhabungsmodi. Der Modus bestimmt, was auf der endgültigen Bestellung erscheint:

Die Transformationspipeline

Wenn eine Bestellung (oder Entwurfsbestellung) erstellt wird, führt BundlesIQ diese Pipeline aus:

1) Erkennung

Shopify sendet einen Webhook (zum Beispiel orders/create oder draft_orders/create). BundlesIQ überprüft die Variant ID jeder Position gegen sein Bundle-Index.

• SKUs sind optional — BundlesIQ benötigt keine SKU zur Erkennung von Bundles
• Die Erkennung basiert auf der Identität der Variante, nicht auf dem Produkttitel/Handle

2) 3PL-Gating (Optional)

Wenn der 3PL-Schutz aktiviert ist, kann BundlesIQ:

• Die Bestellung als verarbeitet kennzeichnen (Beispiel: BIQ_PROCESSING)
• Optional eine Erfüllungssperre setzen, damit Ihr 3PL/Lager die Bestellung nicht vorzeitig importiert

3) Konfigurationsladen

BundlesIQ lädt:

• Bundle-Definition (Ghost SKU-Variante + Komponenten-Varianten + Mengen)
• Preisgestaltungskonfiguration (Bundle-Ebene Überschreibung oder Shop-Standards)
• Handhabungsmodus (Bundle-Überschreibung oder Shop-Standard)
• Alle Sicherheitsvorkehrungen (Grenzen, Validierungsregeln, 3PL-Einstellungen usw.)

4) Preisberechnung & Validierung

BundlesIQ bestimmt, wie die Preisgestaltung auf der Bestellung dargestellt werden soll. Hier leben die meisten Randfälle.

Wichtige Realität:

• BundlesIQ verwendet hauptsächlich Rabatte/Zuweisungen, um die Zielpreise für Komponenten zu erreichen.
• Die Erhöhung des effektiven Preises einer Komponente über den Basispreis der Variante wird nicht in jedem Szenario zuverlässig unterstützt.

Häufige Validierungen:

• Bundle-gesteuerte Preisgestaltung erfordert typischerweise, dass die Einzelhandelssumme der Komponenten (Menge × Preis) >= Bundle-Preis ist, um unmögliche Zuweisungen zu vermeiden
• Festpreis für eine Komponente muss <= dem Einzelhandelspreis der Komponente sein

5) Bestelltransformation (Modusabhängig)

Für die Modi Operational / Hybrid / Reporting bearbeitet BundlesIQ die Bestellung:

• Fügt Komponenten-Positionen (richtige Mengen) hinzu
• Wendet Rabatte/Zuweisungen an, um das konfigurierte Preisresultat zu erreichen
• Modifiziert die Ghost SKU-Position je nach Handhabungsmodus (entfernen, auf $0 setzen oder preislich beibehalten)

Hinweise:

• BundlesIQ vermeidet es, während der Transformation zusätzliche Gebühren einzuführen (zum Beispiel sollten Kunden nicht plötzlich mehr wegen der Erweiterung bezahlen).
• Die endgültige Präsentation von Versand/Steuern hängt von der Konfiguration des Shops und den Berechnungsregeln von Shopify ab, aber die Absicht ist „keine überraschende Erhöhung aufgrund der Transformation selbst.“

Für den Parent-Only (BOM)-Modus fügt BundlesIQ keine Komponenten-Positionen zur Bestellung hinzu:

• Die Ghost SKU-Position bleibt unverändert
• Keine Komponenten-Positionen erscheinen in der Bestellung
• BundlesIQ kann optional die Komponentenbestände verwalten, indem Mengen in einen nicht verkaufsfähigen Bestandszustand (z. B. reserviert/zugewiesen je nach Workflow) überführt werden, dann:
  • bei der Erfüllung verbrauchen oder
  • bei der Stornierung freigeben

6) Nachbearbeitung

Nach erfolgreicher Verarbeitung:

• Das Verarbeitungsetikett wird aktualisiert (Beispiel: BIQ_PROCESSING → BIQ_READY)
• Sperren werden aufgehoben (wenn aktiviert)
• Ein Audit-Metafeld wird zur Bestellung geschrieben (hochmoderne Zusammenfassung dessen, was passiert ist)
• Ein Bundle-Instanzdatensatz wird gespeichert (vollständige Vorher/Nachher-Snapshot + interne Protokolle)

7) Fehlerbehandlung

Wenn die Verarbeitung fehlschlägt:

• BundlesIQ „verpflichtet“ Änderungen nicht „halb“. Es validiert zuerst und verpflichtet die Bestellbearbeitung nur, wenn die Überprüfungen bestanden sind.
• Die Bestellung wird als fehlgeschlagen markiert (Beispiel: BIQ_ERROR)
• Details werden im BundlesIQ-Gesundheitsdashboard protokolliert
• Optionales Wiederholungsverhalten kann die Verarbeitung nach einer Abkühlung erneut versuchen
• Sie können eine Bestellung manuell neu verarbeiten aus dem Shopify Admin über die BundlesIQ-Aktion/menü (führt die Pipeline erneut aus)

Wo Daten gespeichert werden

BundlesIQ speichert Daten sowohl in Shopify als auch in der Cloud-Datenbank von BundlesIQ.

In Ihrem Shopify-Shop

In der Cloud-Datenbank von BundlesIQ

Verarbeitungszeiten (Was zu erwarten ist)

BundlesIQ verarbeitet asynchron, nachdem Shopify den Webhook gesendet hat. Die Verarbeitungszeit hängt ab von:

• Anzahl der Bundles in der Bestellung
• Anzahl der Komponenten pro Bundle
• Shopify API-Durchsatz + Ratenlimits
• Ob die Preiszuweisung zusätzliche Validierungsaufrufe erfordert

Typische Bereiche:

• Kleine Bestellung (einzelnes Bundle, wenige Komponenten): einige Sekunden
• Mehrere Bundles / viele Komponenten: einige Sekunden bis ~zehn Sekunden
• Hochvolumige Warteschlangen: länger

Wenn der 3PL-Schutz aktiviert ist, bleibt die Bestellung gehalten, bis BundlesIQ sie als bereit markiert, sodass zeitliche Schwankungen die Genauigkeit der Erfüllung nicht beeinträchtigen sollten.

Verwandte Seiten

• Glossar
• Handhabungsmodi erklärt
• Preisstrategie
• 3PL-Integrationsleitfaden