3PL Integrationshandbuch

BundlesIQ enthält einen integrierten Schutz, um zu verhindern, dass Drittanbieter-Logistikdienstleister (3PLs) und Lagerverwaltungssysteme (WMS) Bestellungen importieren, bevor die Bündelverarbeitung abgeschlossen ist. Dieses Handbuch erklärt, wie Sie diese Funktionen konfigurieren und nutzen.

Was Sie Erreichen Werden

Sie werden den 3PL-Schutz einrichten, damit Ihr Fulfillment-Partner niemals auf eine Bestellung handelt, bevor BundlesIQ sie nicht vollständig transformiert hat.

Wann Sie Dieses Handbuch Verwenden Sollten

Sie verwenden einen 3PL oder WMS, der automatisch Bestellungen von Shopify importiert
Sie möchten verhindern, dass Ihr Lager die Geister-SKU anstelle der echten Komponenten auswählt
Sie müssen die tagbasierte Filterung in Ihrem 3PL-System konfigurieren

Das Problem der Rennbedingungen

Ohne Schutz kann dieser Fehlermodus auftreten:

Der Kunde gibt eine Bestellung mit der Bündel-Geister-SKU auf
Ihr 3PL importiert die Bestellung sofort (oder innerhalb von Sekunden)
Das Lagerpersonal beginnt mit dem Picking basierend auf der Geister-SKU (falscher Artikel)
BundlesIQ schließt die Transformation ab, aber es ist zu spät — die falschen Artikel werden bereits verpackt

BundlesIQ verhindert dies mit einem "default deny" Ansatz: Bestellungen sind nicht für die Erfüllung berechtigt, bis BundlesIQ sie ausdrücklich als bereit markiert.

Schutzmechanismen

BundlesIQ verwendet einen "Gürtel und Hosenträger"-Ansatz mit zwei Schutzschichten:

Schicht 1: Tag-basierte Sperrung (Primär)

BundlesIQ wendet Tags auf Bestellungen in jeder Verarbeitungsstufe an:

Tag	Wann angewendet	Bedeutung
`BIQ_PROCESSING`	Sofort, wenn BundlesIQ mit der Verarbeitung beginnt	Bestellung wird transformiert — nicht importieren
`BIQ_READY`	Nach erfolgreicher Transformation	Bestellung ist sicher zu importieren und zu erfüllen
`BIQ_ERROR`	Wenn die Verarbeitung fehlschlägt	Bestellung hat ein Problem — nicht importieren, bis es gelöst ist
`BIQ_REVERTED`	Nach einer Rückgängigmachung der Entwurfsbestellung	Entwurfsbestellung wurde in den Zustand vor der Transformation zurückversetzt (nur Entwurfsbestellungen)

Empfohlene 3PL-Konfiguration: Konfigurieren Sie Ihren 3PL so, dass er nur Bestellungen mit dem BIQ_READY Tag importiert. Dies ist der zuverlässigste Ansatz, da Bestellungen ohne das Tag für den 3PL einfach unsichtbar sind.

Schicht 2: Shopify Fulfillment-Holds (Absicherung)

BundlesIQ platziert optional einen Shopify-nativen Fulfillment-Hold auf Bestellungen während der Verarbeitung. Dies ist ein systemweiter Halt, der im Shopify-Admin als "In Wartestellung" erscheint und von vielen Fulfillment-Integrationen respektiert wird.

Der Halt wird nach der Erstellung der Bestellung platziert (Hinweis: Es kann eine kurze Verzögerung geben, während Shopify Fulfillment-Bestellungen erstellt)
Der Halt wird aufgehoben, nachdem BundlesIQ die Transformation erfolgreich abgeschlossen hat
Wenn die Verarbeitung fehlschlägt, bleibt der Halt bestehen

Optional: Alias-Tags

Wenn Ihr 3PL spezifische Tag-Namen erwartet, können Sie Alias-Tags konfigurieren:

Einstellung	Standard	Zweck
Halt-Alias-Tag	`ON-HOLD`	Wird während der Verarbeitung angewendet (gleiche Zeit wie `BIQ_PROCESSING`)
Bereit-Alias-Tag	`READY_TO_SHIP`	Wird nach erfolgreicher Verarbeitung angewendet (gleiche Zeit wie `BIQ_READY`)

Alias-Tags werden zusätzlich zu den Standard-BIQ-Tags angewendet, nicht anstelle von ihnen.

Einrichtung des 3PL-Schutzes

Schritt 1: Schutz in BundlesIQ Aktivieren

Navigieren Sie zu BundlesIQ > Einstellungen
Stellen Sie sicher, dass der Hauptschalter unter 3PL-Schutz Aktiviert ist
Konfigurieren Sie Tag-Namen, wenn Sie benutzerdefinierte Werte benötigen (die Standardwerte funktionieren für die meisten Setups)
Aktivieren Sie Alias-Tags, wenn Ihr 3PL spezifische Tag-Namen wie ON-HOLD oder READY_TO_SHIP erwartet
Aktivieren Sie Fulfillment-Holds, wenn Sie den Shopify-nativen Halt als Absicherung wünschen
Klicken Sie auf Speichern

Schritt 2: Konfigurieren Sie Ihren 3PL

Konfigurieren Sie Ihren 3PL oder WMS, um Bestellungen basierend auf BundlesIQ-Tags zu filtern. Die genauen Schritte hängen von Ihrem System ab. Wählen Sie eines der drei Integrationsmuster unten:

Muster A (Empfohlen): Allowlist auf `BIQ_READY`

Konfigurieren Sie Ihr OMS/WMS/3PL so, dass es nur Bestellungen importiert, die BIQ_READY enthalten (oder Ihr bereit-Alias-Tag).

Vorteile: Kein Rennfenster — es ist sehr schwer, eine nicht verarbeitete Bestellung zu versenden
Nachteile: Nicht-Bündelbestellungen benötigen möglicherweise eine separate Regel, um das bereit-Tag hinzuzufügen (siehe Bestellungen ohne Bündel)

Muster B: Denylist auf Verarbeitungs-/Fehler-Tags

Konfigurieren Sie Ihr OMS/WMS/3PL so, dass es Bestellungen mit BIQ_PROCESSING oder BIQ_ERROR überspringt.

Vorteile: Nicht-Bündelbestellungen fließen normal ohne zusätzlichen Aufwand
Nachteile: Ein kleines Rennfenster besteht in Systemen, die sofort importieren, bevor die Tags erscheinen. Die Aktivierung von Fulfillment-Holds verringert die Auswirkungen

Muster C (Nur Absicherung): Verlassen Sie sich auf Fulfillment-Holds

Verwenden Sie dies nur, wenn das externe System nicht nach Tags filtern kann.

Vorteile: Minimale Konfiguration im nachgelagerten System
Nachteile: Stoppt nicht immer die Erstellung von Etiketten in jedem Tool — besser als Sicherheitsnetz, nicht als primäre Kontrolle

Häufige 3PL-Konfigurationsbeispiele

ShipStation:

Ordnen Sie Shopify-Bestelltags einem benutzerdefinierten Feld in ShipStation zu
Erstellen Sie eine "BundlesIQ Ready"-gespeicherte Ansicht, die nur Bestellungen anzeigt, bei denen das benutzerdefinierte Feld BIQ_READY enthält
Schulen Sie das Personal, ausschließlich aus der "BundlesIQ Ready"-Ansicht zu arbeiten
Siehe das spezielle ShipStation Setup Handbuch für detaillierte Schritt-für-Schritt-Anleitungen

Easyship:

Verwenden Sie "Bestellungen nach Tag ausschließen", um BIQ_PROCESSING und BIQ_ERROR auszuschließen
Bestellungen werden für Easyship sichtbar, nachdem BundlesIQ sie auf BIQ_READY umschaltet

ShipHero:

Verwenden Sie die ShipHero-Einstellung, um zu steuern, wie Shopify-Fulfillment-Holds importiert werden
Verwenden Sie optional Shopify-Bestelltags innerhalb von ShipHero für Batch- und Routing-Zwecke

Extensiv (ehemals 3PL Central / Skubana):

Verwenden Sie Shopify "Filterbestellregeln", um nur Bestellungen zu laden, die Ihren bereit-Zustands-Tags entsprechen
Oder verwenden Sie das Muster "Bestellung nach Tags halten" (laden Sie keine Bestellungen, bis das Verarbeitungstag entfernt wird)

Shippo:

Wenn tagbasierte Filterung erforderlich ist, bestätigen Sie, ob Shippo nach Shopify-Bestelltags in Ihrem Setup filtern kann
Andernfalls verlassen Sie sich auf die BIQ_READY Workflow-Disziplin in Kombination mit dem Shopify-Fulfillment-Hold-Backstop

Andere 3PLs:

Überprüfen Sie die Dokumentation Ihres 3PL auf Shopify-Tag-Filterfähigkeiten
Wenn Ihr 3PL die Filterung des Shopify-Fulfillment-Status unterstützt, bietet der Fulfillment-Hold ein zusätzliches Sicherheitsnetz

Schritt 3: Testen Sie den Schutz

Führen Sie diesen schnellen Verifizierungstest durch, bevor Sie live gehen:

Platzieren Sie eine Testbestellung mit einem Bündelprodukt
Überprüfen Sie sofort Ihr 3PL-System — je nach Ihrem Integrationsmuster:
- Allowlist (Muster A): Die Bestellung sollte überhaupt nicht erscheinen (kein BIQ_READY Tag noch)
- Denylist (Muster B): Die Bestellung sollte deutlich als nicht bereit markiert sein
- Absicherung (Muster C): Die Bestellung sollte durch einen Fulfillment-Hold blockiert sein
Warten Sie ein paar Sekunden, damit BundlesIQ die Verarbeitung abschließen kann
Überprüfen Sie erneut — die Bestellung sollte jetzt das BIQ_READY Tag haben und importierbar sein
Überprüfen Sie, ob die importierte Bestellung die richtigen Komponenten-Positionen (Zustand nach der Transformation) anzeigt
Testen Sie ein Fehlerszenario — konfigurieren Sie absichtlich ein Bündel falsch, um einen Verarbeitungsfehler auszulösen und bestätigen Sie:
- BIQ_ERROR erscheint auf der Bestellung
- Der Fulfillment-Hold bleibt bestehen (wenn aktiviert)
- Die Bestellung wird nicht versandbereit in Ihrem nachgelagerten System

Kompatibilitätscheckliste für jedes OMS/WMS/3PL

Bei der Bewertung, ob ein System mit BundlesIQ funktioniert, beantworten Sie diese vier Fragen:

Tag-Filterung: Kann es Shopify-Bestellungen basierend auf Bestelltags beim Import ein- oder ausschließen?
Tag-Sichtbarkeit: Importiert es überhaupt Shopify-Bestelltags?
Haltbehandlung: Verzögert es den Import von Bestellungen, die einen Shopify-Fulfillment-Hold haben?
Fulfillment-Synchronisierung: Erstellt es Fulfillments in Shopify oder schiebt Tracking zurück zu Shopify?

Wenn Sie (1) oder (3) haben, können Sie einen robusten "default deny"-Workflow implementieren. Wenn Sie nur (2) haben, können Sie dennoch einen manuellen Workflow verwenden, bei dem das Personal die Tags vor dem Versand überprüft.

Best Practices für Tag-Namen

Verwenden Sie ASCII, Großbuchstaben, Unterstrich oder Bindestrich Format: BIQ_READY, ON-HOLD
Vermeiden Sie Sonderzeichen, die einige Systeme inkonsistent behandeln: : / @ Emoji
Halten Sie Tags kurz und stabil — 3PL-Regel-Builder erfordern oft exakte Übereinstimmungen
Dokumentieren Sie Ihre Tag-Konventionen und teilen Sie sie mit Ihrem Fulfillment-Team

Was Passiert, Wenn die Verarbeitung Fehlschlägt

Wenn BundlesIQ eine Bestellung nicht verarbeiten kann:

Das BIQ_PROCESSING Tag bleibt bestehen (oder wird durch BIQ_ERROR ersetzt)
Das BIQ_READY Tag wird nicht angewendet
Fulfillment-Holds bleiben bestehen
Die Bestellung ist nicht importierbar durch den 3PL
Der Fehler erscheint im BundlesIQ Health Dashboard
Wenn automatische Wiederholungen aktiviert sind, wird BundlesIQ versuchen, nach der Abkühlzeit erneut zu verarbeiten
Sobald das Problem behoben ist (automatisch oder manuell), wird das BIQ_READY Tag angewendet und die Bestellung wird importierbar

Parent-Only (BOM) Modus und 3PL

Wenn Sie den Parent-Only (BOM) Modus verwenden, sieht Ihr 3PL nur die Bündel-Geister-SKU auf der Bestellung — keine Komponenten-Positionen werden hinzugefügt. Das bedeutet:

Ihr 3PL oder Lager muss die Stückliste (BOM) für jede Bündel-SKU kennen
3PL-Schutz-Tags (BIQ_PROCESSING, BIQ_READY) gelten weiterhin — sie steuern die Verarbeitung der Inventarreservierung, nicht die Bearbeitung von Bestellungen
Fulfillment-Holds werden weiterhin während der Verarbeitung platziert und aufgehoben

Der Parent-Only-Modus wird typischerweise mit internen Lagern oder Montageoperationen verwendet, bei denen das Personal Zugang zur BOM hat, nicht mit externen 3PLs, die individuelle SKUs auf jeder Bestellung erwarten. Wenn Ihr 3PL die Komponenten-Positionen sehen muss, verwenden Sie stattdessen den Hybrid-, Reporting- oder Betriebsmodus.

Bestellungen Ohne Bündel

Wenn eine Bestellung keine Bündelprodukte enthält:

Wendet BundlesIQ keine Tags auf die Bestellung an
Die Bestellung ist sofort über den normalen Importprozess Ihres 3PL verfügbar
Es werden keine Fulfillment-Holds platziert

Wenn Ihr 3PL so konfiguriert ist, dass er nur Bestellungen mit dem BIQ_READY Tag importiert, werden auch Nicht-Bündelbestellungen nicht importiert. In diesem Fall möchten Sie möglicherweise einen Shopify Flow oder ein Skript verwenden, um das BIQ_READY Tag automatisch zu Nicht-Bündelbestellungen hinzuzufügen. Alternativ konfigurieren Sie Ihren 3PL so, dass er Bestellungen importiert, die entweder BIQ_READY oder nicht BIQ_PROCESSING haben.

Häufige Fehler

Nicht die 3PL-Seite konfigurieren — Die Aktivierung des 3PL-Schutzes in BundlesIQ fügt nur Tags hinzu. Sie müssen auch Ihren 3PL so konfigurieren, dass er nach diesen Tags filtert
Denylist anstelle von Allowlist verwenden — Der Denylist-Ansatz hat ein kleines Rennfenster (Bestellung erstellt, bevor das Tag angewendet wird). Der Allowlist-Ansatz (BIQ_READY erforderlich) ist zuverlässiger
Nicht-Bündelbestellungen vergessen — Wenn Ihr 3PL das BIQ_READY Tag benötigt, stellen Sie sicher, dass auch Nicht-Bündelbestellungen getaggt werden oder verwenden Sie eine kombinierte Filterregel