Nur Platinum
Der Zugang zur Public API braucht den Platinum-Plan im Live-Shop oder Enterprise bei einem Altplan. Ein Schlüssel pro Store.
BSS B2B Solution: Public API
ERP-Integration mit der Public API von BSS B2B Solution: Schlüssel, Endpunkte und Grenzen
Die Public API in BSS B2B Solution erlaubt Ihrem ERP, PIM oder eigenen Tool, Regeln für Custom Pricing, Volume Pricing, Price List und Discount Code anzulegen, zu ändern und zu löschen, Registrierungsformulare zu verarbeiten und Kunden, Produkte und Kollektionen nachzuschlagen. Sie braucht den Platinum-Plan im Live-Shop und einen API-Schlüssel pro Store. Es gibt keinen Endpunkt für Bestellungen.
BSS B2B Solution installieren Zurück zu BSS B2B Solution Erfordert: Platinum-Plan. BSS B2B Solution bietet eine 14-tägige kostenlose Testphase (bezahlte Pläne). 4,9 von 5 aus 1.190 Bewertungen im Shopify App Store (Stand: 19. Oktober 2026).
Wie bekomme ich einen API-Schlüssel und stelle den ersten Aufruf?
Den Schlüssel richten Sie in der App ein. Die Aufrufe selbst macht Ihre Entwicklerin, Ihr Entwickler oder Ihr Integrationspartner anhand der Endpunkt-Seiten im Benutzerleitfaden.
-
Plan prüfen
Die Public API braucht den Platinum-Plan oder den Enterprise-Plan bei einem Altplan. Auf anderen Plänen lässt sich der Schlüssel nicht erstellen.
-
Karte Public API öffnen
Klicken Sie im App-Menü auf Integrations und suchen Sie die Karte Public API. Klicken Sie auf Get API key.
-
Schlüssel erzeugen und sichern
Erzeugen Sie den Schlüssel und klicken Sie sofort auf Copy oder Download. Die App zeigt ihn nur einmal. Behandeln Sie ihn wie ein Passwort: Wer ihn hat, kann Ihre B2B-Daten lesen und die Schreib-Endpunkte aufrufen.
-
Public-API-Funktion einschalten
Auf der Seite mit dem Schlüssel gibt es die Steuerung Public API function mit dem Button Enable. Anfragen, Version 1 und Version 2, werden nur angenommen, solange die Funktion eingeschaltet ist.
-
Schlüssel mit jeder Anfrage senden
Bei Version 1 übergeben Sie `accessKey` im Request-Body oder den Header `x-bss-b2b-api-key`, zusammen mit Ihrer Shop-`domain`. Version 2 nutzt den Header `x-api-key`. Einige Endpunkte der Version 1 lesen den Schlüssel nur aus dem Body: die Upload-Endpunkte für Custom Pricing, Volume Pricing und Price List, `PUT /rule/delete-items`, `PUT /pl/delete-items` und `PUT /pl/update-items`. Der Upload-Endpunkt für Discount Code liest den Schlüssel nur aus dem Header `x-bss-b2b-api-key`.
-
Regeln schreiben, dann hochladen
Legen Sie Regeln mit den Endpunkten für Custom Pricing, Volume Pricing oder Price List an oder ändern Sie sie. Rufen Sie dann den Upload-Endpunkt des Moduls auf, damit die aktiven Regeln im Live-Theme ankommen.
-
Logs und Nutzung prüfen
Klicken Sie auf der Karte Public API auf Logs and usage. Dort stehen die letzten Anfragen mit Status, Methode und Pfad. Öffnen Sie eine Zeile, um Anfrage und Antwort vollständig zu sehen.
Erzeugen Sie einen API-Schlüssel und stellen Sie Ihren ersten Aufruf im Platinum-Plan. Der Eintrag zeigt eine 14-tägige kostenlose Testphase (bezahlte Pläne).
Was die Public API abdeckt
Das steht im Benutzerleitfaden und im App-Code, gruppiert nach Modul. Der Benutzerleitfaden hat eine Seite mit Payloads für die Gruppen Custom Pricing, Volume Pricing, Price List, Registrierungsformular und Upload.
| Modul | Was Sie tun können | Hinweise |
|---|---|---|
| Custom Pricing | Regeln abrufen nach Domain oder ID, speichern, massenhaft speichern, löschen, Massenlöschung, hochladen sowie Regeln nach Produkten oder nach Kunden suchen. | Version 1, Pfad /rule/*. |
| Volume Pricing | Derselbe Umfang wie bei Custom Pricing, ohne die Suche nach Produkten und Kunden und ohne delete-items. Version 2 ergänzt GET /vp/rules. | Version 1, Pfad /qb/*. |
| Price List | Der Umfang von Custom Pricing plus Status aktualisieren, aktualisieren, Artikel löschen und Artikel aktualisieren. | Version 1, Pfad /pl/*. |
| Discount Code | Regeln abrufen, anlegen und löschen, dazu ein Upload-Endpunkt. | Version 1, Pfad /dc/*. |
| Registration Form | Schema eines Formulars abrufen, eine Großhandelsregistrierung einreichen, Anträge filtern und den Status offener Anträge ändern. | Statusänderungen wirken nur bei offenen Konten. Mehrstufige Formulare brauchen immer eine E-Mail. |
| Order Limit | Regeln lesen und eine Regel aktualisieren. | Version 1, Pfad /ol/*. |
| Kunden, Produkte, Kollektionen | Kunden-Tags nachschlagen, Kunden suchen, Kunden nach IDs oder Tags abrufen, Produkte und Kollektionen auflisten. | Nur lesbar. Kunden oder Produkte können Sie über die API nicht anlegen oder ändern. |
| Bestellungen | Nicht verfügbar. | Es gibt keinen Endpunkt für Bestellungen. |
Quelle: der Code der Public API von BSS B2B Solution und der BSS-Benutzerleitfaden zur Public API, geprüft am 9. Oktober 2026.
Schlüssel, Header und API-Versionen
Jeder Store hat einen API-Schlüssel. Existiert schon einer, legt die App keinen zweiten an. Zum Austauschen löschen Sie den Schlüssel auf der Karte Public API. Dadurch stoppt jeder Client, der ihn nutzt, sofort. Erzeugen Sie danach einen neuen.
Die beiden API-Versionen nutzen verschiedene Header-Namen. Version 1 (`/api/v1/...`) liest `x-bss-b2b-api-key` oder `accessKey` im Body. Version 2 (`/api/v2/...`) liest `x-api-key`. Wenn Sie mehrere Gruppen anbinden, prüfen Sie den Header pro Endpunkt. Senden Sie den Schlüssel nicht als `Authorization: Bearer`. Version 2 antwortet darauf mit `401 ACCESS_KEY_MISSING`. Version 1 antwortet mit HTTP 200 und `success: false`. Lesen Sie daher das Feld `success` und nicht nur den HTTP-Status.
- Version 1: Custom Pricing, Volume Pricing, Price List, Discount Code, Registrierungsformular, Order Limit, Suchen.
- Version 2: GET /vp/rules für Volume Pricing (der dokumentierte Endpunkt).
- Teilergebnisse von Uploads kommen ebenfalls mit HTTP 200: prüfen Sie `status` oder `success`.
Welche Grenzen hat die Public API?
Ratenlimit Version 2
60 Anfragen in 60 Sekunden pro Store, mit X-RateLimit-Headern. Bei Überschreitung kommt 429 zurück.
Upload: einmal alle 5 Minuten
Jeder Upload-Endpunkt erlaubt pro Modul eine Anfrage alle 5 Minuten. Sammeln Sie Ihre Änderungen und laden Sie dann einmal hoch.
Massenschreibvorgänge laufen nacheinander
Solange ein Massen-Speichern, eine Massenlöschung, ein Bulk-Delete, ein delete-items- oder ein update-items-Aufruf für einen Store läuft, antworten andere Massenschreibvorgänge in Custom Pricing, Price List und Volume Pricing mit 429 und der Meldung, dass die Domain einen anderen Prozess ausführt. Nach einem Serverfehler warten Sie bis zu 3 Minuten.
Speichergrenze im Theme
Hochgeladene Regeln liegen in Shopify-Metafields: 10 Schlüssel, 2.000.000 Zeichen pro Schlüssel, insgesamt etwa 20.000.000. Regeln über der Grenze werden übersprungen und im Bericht partial_success aufgeführt. Nur aktive Regeln werden hochgeladen.
Kein Endpunkt für Bestellungen
Die API verwaltet Regeln, Registrierungen und Suchen. Bestellungen kann sie nicht anlegen, lesen oder ändern.
Kunden und Produkte nur lesbar
Sie können sie suchen und lesen. Um einen Kunden-Tag nach Ereignis zu ändern, nutzen Sie Auto Tag in der App.
Antwort-Body prüfen
Version 1 gibt bei manchen Fehlern HTTP 200 zurück, und Teil-Uploads liefern ebenfalls 200. Prüfen Sie das Feld success in Ihrem Job.
Wie es zum Rest der App passt
Die API schreibt dieselben Regeltypen, die Sie im Admin anlegen. Custom-Pricing-, Volume-Pricing- und Price-List-Regeln folgen daher der üblichen Reihenfolge im Warenkorb. Price-List-Regeln werden zuerst geprüft, dann Custom Pricing, mit Volume Pricing obendrauf. Regeln, die über die API entstehen, erscheinen in den Listen der App neben den von Hand angelegten.
Regeln für markierte Käufer passen gut zu Auto Tag, das die Kunden-Tags setzt, auf die diese Regeln zielen. Ändert sich Ihre Preisliste nur ein paar Mal im Jahr, ist ein CSV-Import einfacher als eine Integration.
Wer sollte sie nutzen
Distributoren und Hersteller, deren Preise, Preisklassen oder Kundengruppen bereits in einem ERP, PIM oder einer Datenpipeline liegen und die eine Entwicklerin, einen Entwickler oder einen Integrationspartner für einen geplanten Job haben. Die API passt zu großen Katalogen, bei denen Regeln von Hand zu lange dauern.
Wenn bei Ihnen niemand Code schreibt, nutzen Sie stattdessen die Admin-Seiten oder den CSV-Import. Der Benutzerleitfaden beschreibt die API als Werkzeugkasten für Entwickler und Integrationspartner, nicht als Connector für ein bestimmtes ERP-Produkt.
Welcher Plan enthält die Public API?
Die Public API gehört zum Platinum-Plan. Im Shopify-App-Store-Eintrag (Stand 9. Oktober 2026) kostet der Platinum-Plan US$99 pro Monat oder US$1.069,20 pro Jahr mit 10 % Rabatt bei Jahresabrechnung. Der Eintrag zeigt eine 14-tägige kostenlose Testphase für bezahlte Pläne.
Anwendungsfälle für die Public API
Jeder Anwendungsfall zeigt eine Einrichtung mit Screenshots. Alle Anwendungsfälle ansehen (Englisch).
B2B-Regeln und Kunden per API mit Ihrem ERP synchronisieren
Mit der Public API in BSS B2B Solution legen Sie Regeln für Kundenpreise, Price Lists, Staffelpreise und Registrierungsdaten aus Ihrem ERP oder PIM an und aktualisieren sie per API-Schlüssel, statt Regeln von Hand zu bearbeiten.
Anwendungsfall ansehen: B2B-Regeln und Kunden per API mit Ihrem ERP synchronisieren
Großhandelspreise per CSV importieren
Exportieren Sie Ihre Preisregeln, bearbeiten Sie die Preise in einer Tabellenkalkulation und importieren Sie die Datei wieder. Derselbe CSV-Ablauf funktioniert für Custom Pricing, Price Lists und Volume Pricing, sodass große Kataloge und viele Kundengruppen überschaubar bleiben.
Anwendungsfall ansehen: Großhandelspreise per CSV importierenAnleitungen und Glossar
Lesen Sie als Nächstes diese Seiten für alle Details.
Auto Tag
Käufer nach Ereignis taggen, damit tagbasierte Regeln greifen.
Manual Orders
Bestellungen werden im Admin aufgenommen, nicht über die API.
Großhandelspreise
Zeigen Sie Geschäftskunden ihre eigenen Preise mit Preislisten, Kundenpreisen und Staffelpreisen.
Kunden-Onboarding
Verwandeln Sie Interessenten mit Registrierungsformular, Freigabe und Kunden-Tags in freigegebene Großhandelskunden.
Glossar
ERP-AnbindungPreislisteKunden-Tag
Benutzerleitfäden auf docs.bss-b2b.solutions
Weitere Funktionen von BSS B2B Solution
Jede Funktion hat eine eigene Seite. Siehe auch alle Funktionen von BSS B2B Solution.
Auto Tag
Kunden- und Bestell-Tags hinzufügen oder entfernen, sobald ein Shopify-Ereignis zu Ihren Regeln passt, damit tagbasierte Preise und Zugänge dem Käufer folgen.
Discount Code
Geben Sie Großhandelskunden einen privaten Code, den sie im Warenkorb eingeben, mit Regeln dazu, wer ihn nutzen darf, was er abdeckt und wie oft.
Bearbeitungsgebühren und Versandtarife
Eine Bearbeitungsgebühr nach Menge oder Betrag hinzufügen und Großhandels-Versandtarife nach Kunde, Produkt, Markt und Gewicht festlegen.
Manual Orders
Erstellen Sie für einen Kunden im Admin einen Shopify-Bestellentwurf, in dem die Großhandelspreise bereits angewendet sind.
Mehrwährungsanzeige
Zeigen Sie Großhandelspreise in der Währung des Käufers mit einem Umschalter. Der Checkout bleibt in der Währung Ihres Shops oder Markets.
Preise für Shopify POS
Die Kachel B2B Price in Shopify POS zeigt den Großhandelsrabatt für den Warenkorb. Das Personal wendet die Preise an oder entfernt sie über die Kachel.
Verbinden Sie Ihr ERP mit Ihren Großhandelspreisen
Installieren Sie BSS B2B Solution aus dem Shopify App Store, mit einer 14-tägigen kostenlosen Testphase (bezahlte Pläne).
Außerdem: BSS B2B Lock für versteckte Preise für Gäste und BSS B2B Quote für Angebote und Quick Order.
Häufig gestellte Fragen
Welcher Plan enthält die Public API von BSS B2B Solution?
Den Platinum-Plan oder Enterprise bei einem Altplan. Laut App-Store-Eintrag vom 9. Oktober 2026 kostet der Platinum-Plan US$99 pro Monat. Ein Store bekommt einen API-Schlüssel, den die App nur einmal anzeigt.
Was kann ich an die Public API senden?
Regeln für Custom Pricing, Volume Pricing, Price List und Discount Code, Einsendungen von Registrierungsformularen und Statusänderungen sowie Aktualisierungen von Order Limit. Kunden, Produkte und Kollektionen lassen sich lesen und suchen, aber nicht ändern.
Kann die Public API Bestellungen anlegen oder lesen?
Nein. Es gibt keinen Endpunkt für Bestellungen. Die API verwaltet Preisregeln, Registrierungen und Suchen. Um eine Bestellung für einen Käufer aufzugeben, nutzen Sie Manual Orders im App-Admin. Dort entsteht ein Shopify-Bestellentwurf mit den Preisen des Käufers.
Wie hoch sind die Ratenlimits?
Version 2 erlaubt 60 Anfragen in 60 Sekunden pro Store. Jeder Upload-Endpunkt erlaubt pro Modul eine Anfrage alle 5 Minuten. Massenschreibvorgänge für einen Store laufen einer nach dem anderen, zusätzliche Aufrufe bekommen eine 429-Antwort.
Wie authentifiziere ich mich, und kann ich ein Bearer-Token nutzen?
Senden Sie den Schlüssel als `accessKey` im Body oder im Header: x-bss-b2b-api-key für Version 1, x-api-key für Version 2. Bearer-Token werden nicht unterstützt. Authorization: Bearer scheitert bei Version 2 mit 401.
Was passiert, wenn der API-Schlüssel verloren geht oder offenliegt?
Löschen Sie den Schlüssel auf der Karte Public API. Clients, die ihn nutzen, funktionieren sofort nicht mehr. Erzeugen Sie dann einen neuen Schlüssel und kopieren Sie ihn sofort, denn er wird nur einmal angezeigt.
Quellen, Methode und Änderungsprotokoll
Das Verhalten der Funktionen beruht auf unserer Prüfung des Codes der BSS B2B Solution App vom 3. Oktober 2026 und auf den BSS-Benutzerleitfäden. Preise und Bewertungen stammen aus dem App-Store-Eintrag am angegebenen Datum. Wir entwickeln BSS B2B Solution, BSS B2B Lock und BSS B2B Quote.
Quellen
- BSS-Benutzerleitfaden: Public APIs, gelesen am . Plan, wichtigste Schritte, Header, Ratenlimits, Logs, Metafield-Grenzen.
- BSS-Benutzerleitfaden: Public APIs für Uploads, gelesen am . Upload-Endpunkte, Kapazität und Teilbericht.
- BSS-Benutzerleitfaden: Public APIs für das Registrierungsformular, gelesen am . Formular- und Händler-Endpunkte, Statusänderungen nur bei offenen Konten.
- Shopify-App-Store-Eintrag: BSS B2B Wholesale Pricing, gelesen am . Planpreise und Testphase.
Änderungsprotokoll
- : Erste Fassung.
- : Installationsbutton mitten auf der Seite ergänzt.
BSS B2B Solution installieren 14-tägige kostenlose Testphase (bezahlte Pläne)