Um B2B-Preise aus einem ERP mit Shopify zu synchronisieren, nutzen Sie die Public API in BSS B2B Solution: Erzeugen Sie im Platinum-Plan einen API-Schlüssel. Ihr Entwickler oder Integrationspartner legt Regeln für Kundenpreise (Custom Pricing), Price Lists (Price List) und Staffelpreise (Volume Pricing) aus Ihrem führenden System an, ändert sie oder löscht sie und ruft den Upload-Endpunkt auf, damit die aktiven Regeln das aktive Theme erreichen. Ihr Team tippt Preise nicht mehr in einen Admin-Bildschirm ab.
Dieser Leitfaden richtet sich an Distributoren und Hersteller, deren Preise, Preisklassen oder Kundengruppen bereits in einem ERP, einem PIM oder einer Datenpipeline liegen. Er erklärt, wer profitiert, was die API abdeckt und was nicht, außerdem einen Integrationsplan in fünf Schritten, ein Beispiel und die Grenzen, die Sie einplanen sollten, darunter die Tatsache, dass es keinen Endpunkt für Bestellungen gibt. Er richtet sich an die Person, die entscheidet, ob die Integration gebaut wird, und verweist für die genauen Payloads auf die Entwicklerdokumentation.
Für wen es gedacht ist
Die Public API passt, wenn die meisten dieser Aussagen auf Ihren Shop zutreffen:
- Ihre Preise werden in einem ERP, einem PIM oder einer Stammdatentabelle gepflegt, und der Shopify-Shop ist eine zweite Kopie.
- Sie haben mehrere Preisklassen oder Kundengruppen, und eine Preisänderung betrifft Hunderte oder Tausende Varianten.
- Preise ändern sich wöchentlich oder täglich, sodass eine manuelle Aktualisierung zwischen den Läufen zurückbleibt.
- Sie haben einen Entwickler, eine Agentur oder einen Integrationspartner, der einen geplanten Job schreiben kann.
- Sie exportieren Preisdaten bereits als CSV und möchten, dass dieselben Daten ohne Öffnen der App übertragen werden.
Wenn sich Ihre Preisliste nur wenige Male im Jahr ändert, ist ein CSV-Import einfacher. Siehe Großhandelspreise per CSV importieren.
Warum das wichtig ist
Zwei Kopien einer Preisliste laufen auseinander. Jemand aktualisiert das ERP am Montag, vergisst den Shop, und ein Käufer sieht am Dienstag den Preis des letzten Quartals. Der Käufer bestellt entweder zum falschen Preis, und Sie tragen die Differenz oder stornieren die Bestellung, oder er verliert das Vertrauen in das Portal und ruft den Vertrieb an. Je größer der Katalog und je mehr Preisklassen Sie führen, desto häufiger passiert das.
Eine Datenpipeline beseitigt die Ursache statt des Symptoms. Das ERP bleibt das führende System, ein geplanter Job schreibt die Änderungen in BSS B2B Solution, und der Shop zieht nach. Echte Shops wollen diese Flexibilität. Alpha Coffee, eine Kaffeerösterei, berichtet, dass sie mit API-Zugang Shopify als zentrale Commerce-Ebene behalten und gleichzeitig an ERP-, CRM- oder Finanzsysteme anbinden kann. DermaplanePro meldet weniger manuelle Arbeit durch öffentliche API-Verbindungen mit externen Systemen. Siehe die Fallstudien zu Alpha Coffee und DermaplanePro.
So richten Sie es mit BSS B2B Solution ein
Dieser Abschnitt beschreibt die Integration aus Sicht des Händlers. Ihr Entwickler braucht den Public-API-Leitfaden für Endpunkte und Payloads.
Schritt 1: Plan prüfen
Die Public API gehört zum Platinum-Plan. Ein Shop kann jeweils einen API-Schlüssel haben, und der Plan schaltet außerdem Price Lists frei, die viele ERP-Integrationen für kundenspezifische Preise nutzen. Prüfen Sie den Plan, bevor Sie den Umfang der Integration festlegen.
Schritt 2: API-Schlüssel erzeugen
Öffnen Sie in der App Integrations, suchen Sie die Karte Public API und wählen Sie Get API key. Der Schlüssel wird nur einmal angezeigt. Kopieren oder laden Sie ihn daher sofort herunter und legen Sie ihn in einem Passwort-Manager oder einer Umgebungsvariablen auf dem Server ab. Falls er in falsche Hände gerät, löschen Sie ihn auf derselben Karte. Dadurch stoppt jeder Client, der ihn nutzt. Danach erzeugen Sie einen neuen.
Schritt 3: Erste Anfrage authentifizieren
Endpunkte der Version 1 nehmen Ihre `myshopify.com`-Domain und den Schlüssel entweder als `accessKey` im Request-Body oder im Header `x-bss-b2b-api-key` entgegen. Der Volume-Pricing-Endpunkt der Version 2 nutzt den Header `x-api-key`. Ein Bearer-Token wird nicht unterstützt und führt zu 401. Bauen Sie den Client daher nicht um den Header `Authorization` herum.
Schritt 4: Regeln aus Ihren ERP-Daten schreiben
Ordnen Sie jede ERP-Preisklasse einem Regelziel zu, etwa einem Kunden-Tag, und rufen Sie die Endpunktgruppe für das Modul auf, das Sie nutzen. Die API verwaltet Regeln für Kundenpreise, Price Lists und Staffelpreise, Rabattcode-Regeln, Datensätze aus Registrierungsformularen und Bestellmengenregeln, mit Anlegen, Ändern, Löschen und Massenoperationen, soweit der Endpunkt sie erlaubt. Kunden- und Produkt-Endpunkte sind nur lesende Abfragen und helfen beim Aufbau der Regel-Payloads, etwa um Kunden nach Tag zu finden oder Produkte und Kollektionen aufzulisten. Anfragen werden nacheinander verarbeitet, daher sollte ein Client seine Aufrufe in eine Warteschlange stellen.
Schritt 5: Einmal hochladen, dann prüfen
Nach einer Reihe von Änderungen rufen Sie den Upload-Endpunkt für das Modul auf, damit alle aktivierten Regeln in Ihr aktives Theme geschrieben werden. Upload-Endpunkte erlauben pro Modul eine Anfrage alle fünf Minuten. Laden Sie daher am Ende eines Sync-Laufs einmal hoch, nicht nach jeder Zeile. Eine Anfrage über dem Limit gibt `429` zurück, und es werden nur aktivierte Regeln hochgeladen. Übersteigen Ihre Regeln die Kapazität der Metafelder, speichert die API, was hineinpasst, und gibt einen Bericht `partial_success` mit HTTP 200 zurück. Lesen Sie deshalb den Antwortkörper und nicht nur den Statuscode. Prüfen Sie danach das Ergebnis in der Karte Logs and usage unter Advanced Settings > Public API. Sie listet die letzten Anfragen mit Zeit, Methode, Pfad und Status auf und zeigt bei Fehlern die vollständige Anfrage und Antwort. Die API kann außerdem den Preis zurückgeben, den ein bestimmter Kunde für bestimmte Produkte erhält. Das ist nützlich, um die App mit dem ERP zu vergleichen.
Beispiel: ein Distributor mit drei Preisklassen
Dieses Beispiel nutzt veranschaulichende Zahlen, keine Ergebnisse aus einem echten Shop. Ein Distributor führt drei Preisklassen in seinem ERP: Retail-Partner, Trade und Key Account. In BSS B2B Solution ist jede Klasse eine Price-List-Regel, die auf einen Kunden-Tag zielt. Ein nächtlicher Job exportiert die geänderten Preiszeilen, gruppiert sie nach Klasse und ruft für jede Price List den Endpunkt zum Massenspeichern auf. Wenn alle drei fertig sind, ruft der Job den Upload-Endpunkt der Price Lists einmal auf.
Am Montag zeigt das ERP 3.200 geänderte Preise. Statt dass jemand sie von Hand neu eingibt, läuft der Job um 02:00 Uhr, lädt einmal hoch und prüft die Karte Logs and usage auf fehlgeschlagene Anfragen. Am Morgen sieht ein Trade-Kunde, der sich anmeldet, die Montagspreise auf Produkt- und Kollektionsseiten. Eine fehlgeschlagene Anfrage hinterlässt einen Eintrag im Protokoll mit Status und Inhalt, und der Job wiederholt sie nach kurzer Wartezeit.
Passt gut dazu
Die API ist ein Eingangsweg für die Preis-Engine. Andere Seiten erklären, was mit diesen Regeln geschieht, sobald sie existieren:
- CSV statt Code: Großhandelspreise per CSV importieren behandelt das Importfenster für kleinere Kataloge.
- Preislisten je Kundengruppe: B2B-Preisliste je Kundengruppe zeigt den Regeltyp, den die meisten ERP-Synchronisationen schreiben.
- Mengenstaffeln: Staffelpreise nach Menge erklärt die Volume-Pricing-Regeln, die die API ebenfalls verwalten kann.
- Reihenfolge der Regeln: Welche B2B-Regel gewinnt erklärt die Priorität, damit eine synchronisierte Regel nicht mit einer von Hand angelegten kollidiert.
Der Hub Großhandelspreise fasst die Leitfäden zur Preisgestaltung zusammen. Nützliche Glossar-Einträge sind Price List, Großhandelspreis und Kunden-Tag.
Grenzen und häufige Fehler
- Es gibt keinen Endpunkt für Bestellungen. Die API verwaltet Preis- und Rabattregeln, Registrierungsdatensätze und Bestellmengenregeln sowie nur lesende Abfragen für Kunden, Produkte und Kollektionen. Die Bestellsynchronisation behalten Sie für Shopify in Ihrem ERP-Connector, und diese API nutzen Sie für Preise und Kundengruppen.
- Ein Schlüssel pro Shop. Wenn Sie den Schlüssel löschen, stoppt jeder Client, der ihn nutzt. Tauschen Sie ihn deshalb planmäßig aus und aktualisieren Sie die Integration sofort.
- Upload ist begrenzt. Upload-Endpunkte erlauben pro Modul eine Anfrage alle fünf Minuten. Der Volume-Pricing-Endpunkt der Version 2 erlaubt 60 Anfragen in 60 Sekunden für jeden Shop.
- Die Preisdaten haben Obergrenzen. Regeln werden in Shopify-Metafeldern mit höchstens 10 Schlüsseln und 2.000.000 Zeichen pro Schlüssel gespeichert. Inhalte über den Obergrenzen werden übersprungen und als `partial_success` gemeldet. Entfernen Sie deshalb inaktive Regeln oder teilen Sie eine sehr große Regelmenge, bevor Sie erneut hochladen.
- Wiederholungen brauchen eine Pause. Anfragen werden nacheinander verarbeitet. Nach einem Serverfehler rät der Leitfaden, bis zu drei Minuten zu warten, bevor Sie es erneut versuchen.
- Die API ersetzt das Regeldesign nicht. Zielgruppe, Priorität und Ausnahmen folgen weiterhin denselben Regeln wie bei von Hand angelegten Regeln. Testen Sie deshalb zuerst eine Regel im Admin.
- Die API speist einen Theme-Shop. Preise erscheinen über die App-Einbettung von BSS B2B Solution in Ihrem Shopify-Theme. Prüfen Sie nach jeder Theme-Änderung, ob die Einbettung aktiv ist.
Checkliste für die Einrichtung
- Prüfen Sie, ob der Shop im Platinum-Plan ist.
- Legen Sie für jede Preisklasse das führende System fest und welchem Kunden-Tag jede Klasse zugeordnet wird.
- Erzeugen Sie den API-Schlüssel und speichern Sie ihn in einem Passwort-Manager oder einer Umgebungsvariablen.
- Bauen Sie den Client mit `accessKey` oder dem Header `x-bss-b2b-api-key` und stellen Sie Anfragen in eine Warteschlange.
- Testen Sie eine Regel von Anfang bis Ende in einem Entwicklungsstore und prüfen Sie sie danach im Admin.
- Planen Sie pro Modul einen Upload-Aufruf am Ende jedes Sync-Laufs.
- Richten Sie Alarme für `429` und Serverfehler ein und lesen Sie nach den ersten Läufen die Karte Logs and usage.
- Halten Sie die Bestellsynchronisation in einem eigenen Connector.
Pläne und Voraussetzungen
Die Public API braucht den Platinum-Plan von BSS B2B Solution, einen Schlüssel pro Shop und die App-Einbettung im Theme. Die übrigen Pläne und die 14-tägige kostenlose Testphase bei kostenpflichtigen Plänen finden Sie auf der Preisseite von BSS B2B. Die genauen Payloads stehen im Public-API-Leitfaden, im Leitfaden zum Upload per API und im Leitfaden zur Custom-Pricing-API. BSS B2B Solution im Shopify App Store installieren und lassen Sie Ihren Entwickler mit einer Price List beginnen.
