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.

API-Referenz · OpenAPI-Spec · llms.txt

In 10 Minuten zur ersten Abfrage

  1. Schlüssel besorgen. Sandbox-Schlüssel (Demo-Daten) gibt es sofort in Selbstbedienung: Formular ausfüllen, Link aus der Bestätigungs-E-Mail anklicken, Schlüssel kopieren. Für die Freigabe als Kunde (kundenindividuelle Preise): E-Mail an it@so-handel.de mit Firma, Kundennummer und eingesetzter Software. Ein Schlüssel steht nie in einer E-Mail.
  2. Verbindung prüfen — bash/Linux/macOS: 
    curl -H "X-API-Key: $KEY" "https://b2b-api.so-cloud.de/v1/ping"
    Windows PowerShell (ausdrücklich curl.exe — der PowerShell-Alias curl ist Invoke-WebRequest): 
    curl.exe -H "X-API-Key: $env:KEY" "https://b2b-api.so-cloud.de/v1/ping"
  3. Katalog lesen (seitenweise; delta-fähig über changedSince — Delta-Antworten melden auch Abgänge: aus dem Sortiment gefallene Artikel kommen mit discontinued: true): 
    curl -H "X-API-Key: $KEY" "https://b2b-api.so-cloud.de/v1/catalog/items?limit=100"
    curl.exe -H "X-API-Key: $env:KEY" "https://b2b-api.so-cloud.de/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" "https://b2b-api.so-cloud.de/v1/prices?items=SBX-100101,4012345000024&quantity=50"
curl -H "X-API-Key: $KEY" "https://b2b-api.so-cloud.de/v1/availability?items=SBX-100101"
    curl.exe -H "X-API-Key: $env:KEY" "https://b2b-api.so-cloud.de/v1/prices?items=SBX-100101,4012345000024&quantity=50"
curl.exe -H "X-API-Key: $env:KEY" "https://b2b-api.so-cloud.de/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