B2B-API: Katalog und Verfügbarkeit für Händler
Geschäftskunden lesen mit eigenem Schlüssel aus dem Händlerportal ihren Katalog mit ihren Preisen und die Verfügbarkeit. Nur lesen, nur ihr Sortiment.
Die B2B-API ist für Geschäftskunden gedacht, die Katalog und Verfügbarkeit in ihr eigenes System übernehmen wollen. Sie ist von der allgemeinen API getrennt: Ein B2B-Schlüssel funktioniert nur hier, ein Schlüssel einer API-Verbindung nur dort.
Schlüssel
Den Schlüssel legt der Händler selbst im Händlerportal unter „API-Zugang“ an. Er gehört zu genau diesem Kunden und sieht:
- nur die Artikel, die im Händlerportal angeboten werden,
- nur die Preise der Preisgruppe dieses Kunden,
- beim Bestand nur den Zustand (auf Lager, wenig, nachbestellt, ausverkauft) und die Lieferzeit, keine Stückzahlen.
Andere Kunden, Bestellungen oder Einkaufspreise sieht ein B2B-Schlüssel nie. Bestellen geht für Händler weiter über das Händlerportal.
Anmeldung
curl https://<adresse-der-api>/v1/b2b/catalog \
-H "Authorization: Bearer tb_live_…"Katalog
GET /v1/b2b/catalog liefert je Artikel sku, productName, variantName, category, images, b2bPriceNet (netto je Stück ab 1 Stück, Preis der eigenen Preisgruppe), quantityPrices (Staffelpreise: Liste aus minQuantity und priceNet, gilt ab dieser Stückzahl je Artikel in einer Bestellung; leer, wenn es keine Staffel gibt), msrp (UVP brutto) und currency.
| Parameter | Bedeutung |
|---|---|
search | Suche in SKU, Produkt- und Variantenname |
limit, offset | Blättern, höchstens 500 je Seite |
Verfügbarkeit
GET /v1/b2b/inventory liefert je Artikel sku, status (IN_STOCK, LOW_STOCK, BACKORDER, OUT_OF_STOCK), inStock, deliveryTime, deliveryTimeLabel und stockUpdatedAt.
| Parameter | Bedeutung |
|---|---|
sku | Nur diese SKUs, mehrfach möglich |
search | Suche in SKU, Produkt- und Variantenname |
updated_since | Nur Artikel, deren Bestand sich seitdem geändert hat |
limit, offset | Blättern, höchstens 500 je Seite |
Fehler und Statuscodes wie bei der allgemeinen API, siehe API: Überblick und Zugang. Ein Schlüssel einer API-Verbindung bekommt hier 403.