Bestands-API

Mit der Bestands-API lesen Sie die aktuellen Bestandsinformationen eines Produkts und seinen vollständigen Verlauf der Bestandsbewegungen. Außerdem erhalten Sie eine Übersicht der letzten Änderungen in Ihrem gesamten Katalog.

Alle Endpunkte sind schreibgeschützt und erfordern den Scope stock:read. Authentifizieren Sie jede Anfrage wie unter Authentifizierung beschrieben.

Basis-URL: https://api.storelinkr.com

Bestandsinformationen eines Produkts abrufen

Liefert den aktuellen Bestand eines einzelnen Produkts, einschließlich der Aufschlüsselung pro Lagerort und der Angabe, welche Quellen den Bestand geliefert haben. Das Produkt können Sie per UUID, EAN oder SKU abfragen.

GET /api/public/v2/catalog/products/{uuid}/stock
GET /api/public/v2/catalog/products/ean/{ean}/stock
GET /api/public/v2/catalog/products/sku/{sku}/stock

Beispiel

curl -X GET "https://api.storelinkr.com/api/public/v2/catalog/products/ean/8712345678901/stock" \
     -H "X-StoreLinkr-Api-Key: your_api_token_here" \
     -H "X-StoreLinkr-Api-Secret: your_api_secret_here" \
     -H "Accept: application/json"

Antwort

{
  "status": "success",
  "product": {
    "uuid": "01234567-89ab-cdef-0123-456789abcdef",
    "ean": "8712345678901",
    "sku": "SKU-001"
  },
  "stock": {
    "has_stock": true,
    "quantity_available": 18,
    "quantity_supplier": 0,
    "delivery_date": null,
    "stock_locations": [
      { "name": "Warehouse 1", "quantity": 3, "source": "CYCLESOFTWARE" },
      { "name": "Warehouse 2", "quantity": 5, "source": "CYCLESOFTWARE" }
    ],
    "sources": ["CYCLESOFTWARE"]
  }
}

Feld	Beschreibung
has_stock	Ob das Produkt verfügbaren Bestand hat.
quantity_available	Die gesamte verfügbare Menge (Summe aller Lager).
quantity_supplier	Bestand beim Lieferanten (Streckengeschäft/Dropshipping).
delivery_date	Voraussichtliches Lieferdatum, sofern bekannt.
stock_locations	Die Aufschlüsselung pro Lager.
sources	Die Integrationen, die den Bestand geliefert haben.

Wenn kein Produkt gefunden wird, antwortet die API mit 404 Not Found.

Bestandsbewegungen eines Produkts abrufen

Liefert den paginierten Verlauf der Bestandsänderungen eines einzelnen Produkts, die neuesten zuerst. Verfügbar per UUID, EAN oder SKU.

GET /api/public/v2/catalog/products/{uuid}/stock/mutations
GET /api/public/v2/catalog/products/ean/{ean}/stock/mutations
GET /api/public/v2/catalog/products/sku/{sku}/stock/mutations

Abfrageparameter

Parameter	Standard	Beschreibung
limit	100	Ergebnisse pro Seite (maximal 500).
page	0	Seitennummer (nullbasiert).

Antwort

{
  "status": "success",
  "product": {
    "uuid": "01234567-89ab-cdef-0123-456789abcdef",
    "ean": "8712345678901",
    "sku": "SKU-001"
  },
  "pagination": { "pages": 1, "page": 0, "start": 0, "totalRecords": 2, "limit": 100 },
  "mutations": [
    {
      "uuid": "…",
      "ean": "8712345678901",
      "previous_quantity": 5,
      "new_quantity": 3,
      "delta": -2,
      "product_quantity": 18,
      "stock_location_uuid": "…",
      "stock_location_name": "Warehouse 1",
      "source": "ORDER_DEDUCTION",
      "source_label": "Order deduction",
      "changed_by": "CYCLESOFTWARE",
      "reference": "1078",
      "created": "2026-07-19T10:00:00+00:00"
    }
  ]
}

Jede Bewegung beschreibt die Änderung an einem Lager: previous_quantity und new_quantity sind die Bestände dieses Lagers, delta ist die Änderung und product_quantity ist die Gesamtmenge des Produkts nach der Änderung. Wie diese erfasst werden, lesen Sie unter Bestandsverlauf.

Letzte Bestandsbewegungen (gesamter Katalog)

Liefert eine paginierte Übersicht der letzten Bestandsänderungen in Ihrem gesamten Katalog, die neuesten zuerst. Damit können Sie Dashboards aufbauen oder auf Änderungen prüfen (Polling).

GET /api/public/v2/catalog/stock/mutations

Der Endpunkt akzeptiert dieselben Abfrageparameter limit und page und liefert dieselbe Struktur aus pagination und mutations wie oben (ohne das product-Objekt, da sich die Einträge auf viele Produkte beziehen können).

Beispiel

curl -X GET "https://api.storelinkr.com/api/public/v2/catalog/stock/mutations?limit=50" \
     -H "X-StoreLinkr-Api-Key: your_api_token_here" \
     -H "X-StoreLinkr-Api-Secret: your_api_secret_here" \
     -H "Accept: application/json"