S&O B2B-Partner-API

Katalog, kundenindividuelle Preise und Verfügbarkeit für B2B-Kunden der S&O Handelsgesellschaft mbH und deren Software — Branchen-ERP, Planungsprogramme, Agenten. Dies ist die Testumgebung — Schlüsselpräfix sohd_b2b_test_.

API-Referenz · OpenAPI-Spec · llms.txt

In 10 Minuten zur ersten Abfrage

  1. Schlüssel besorgen. Sandbox-Schlüssel (Demo-Daten, sofort) oder Freigabe als Kunde (kundenindividuelle Preise): E-Mail an it@so-handel.de mit Firma, Kundennummer und eingesetzter Software. Der Schlüssel kommt über einen Einmal-Link — nie per E-Mail.
  2. Verbindung prüfen: 
    curl -H "X-API-Key: $KEY" https://b2b-api-test.so-cloud.de/v1/ping
  3. Katalog lesen (seitenweise, delta-fähig über changedSince): 
    curl -H "X-API-Key: $KEY" ".../v1/catalog/items?limit=100"
  4. Preise und Verfügbarkeit für bis zu 100 Artikel je Anfrage (Artikelnummer oder GTIN): 
    curl -H "X-API-Key: $KEY" ".../v1/prices?items=SBX-100101,4012345000024&quantity=50"
curl -H "X-API-Key: $KEY" ".../v1/availability?items=SBX-100101"
Konventionen. Mengen und Beträge sind Strings mit Punkt als Dezimaltrenner; alle Mengen in Lagerstück (unitsPerSalesUnit liefert die Umrechnung). Fehler kommen als RFC-9457-Problem-Details mit stabilem code. Artikel ohne Preis: price: null, nie 0,00. POST /v1/orders ist über clientOrderId idempotent (Phase 2, antwortet derzeit 501).

Versionierung: /v1 im Pfad; additive Änderungen ohne Versionswechsel, brechende nur als neue Version mit mindestens 12 Monaten Parallelbetrieb.

S&O Handelsgesellschaft mbH — IT · it@so-handel.de