Stock API

Met de Stock API lees je de actuele voorraadinformatie van een product en de volledige voorraadmutatiegeschiedenis, plus een overzicht van recente wijzigingen over je hele catalogus.

Alle endpoints zijn alleen-lezen en vereisen de scope stock:read (zie API-sleutel scopes). Authenticeer elk verzoek zoals beschreven in Authenticatie.

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

Voorraadinformatie van een product ophalen

Geeft de actuele voorraad van één product terug, inclusief de verdeling per locatie en welke bronnen de voorraad leverden. Je zoekt het product op via UUID, EAN of SKU.

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

Voorbeeld

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"

Response

{
  "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": "Magazijn 1", "quantity": 3, "source": "CYCLESOFTWARE" },
      { "name": "Magazijn 2", "quantity": 5, "source": "CYCLESOFTWARE" }
    ],
    "sources": ["CYCLESOFTWARE"]
  }
}

Veld	Omschrijving
has_stock	Of het product beschikbare voorraad heeft.
quantity_available	Het totaal beschikbare aantal (som van alle magazijnen).
quantity_supplier	Voorraad die bij een leverancier ligt (dropshipping).
delivery_date	Verwachte leverdatum, indien bekend.
stock_locations	De verdeling per magazijn.
sources	De integraties die de voorraad aanleverden.

Is er geen product gevonden, dan geeft de API 404 Not Found terug.

Voorraadmutaties van een product ophalen

Geeft de gepagineerde voorraadgeschiedenis van één product terug, nieuwste eerst. Beschikbaar via UUID, EAN of 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

Queryparameters

Parameter	Standaard	Omschrijving
limit	100	Resultaten per pagina (maximaal 500).
page	0	Paginanummer (nul-gebaseerd).

Response

{
  "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": "Magazijn 1",
      "source": "ORDER_DEDUCTION",
      "source_label": "Order deduction",
      "changed_by": "CYCLESOFTWARE",
      "reference": "1078",
      "created": "2026-07-19T10:00:00+00:00"
    }
  ]
}

Elke mutatie beschrijft de wijziging bij één magazijn: previous_quantity en new_quantity zijn de niveaus van dat magazijn, delta is de wijziging en product_quantity is het producttotaal na de wijziging. Zie Voorraadgeschiedenis voor hoe deze worden vastgelegd.

Recente voorraadmutaties (hele catalogus)

Geeft een gepagineerd overzicht van de meest recente voorraadwijzigingen over je hele catalogus, nieuwste eerst. Handig voor dashboards of om te pollen op wijzigingen.

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

Het accepteert dezelfde limit- en page-queryparameters en geeft dezelfde pagination- en mutations-structuur terug als hierboven (zonder het product-object, omdat regels over veel producten kunnen gaan).

Voorbeeld

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"