De Stockhub API voor je magazijn en je klanten

Kort antwoord: Stockhub heeft twee open REST API's met volledige OpenAPI-documentatie. Met de Warehouse API koppel je als fulfilmentbedrijf je eigen systemen en stuur je orders, voorraad, inslag, retouren en facturen aan voor al je relaties. Met de Relation API koppelen de klanten van je fulfilment hun webshop of eigen software rechtstreeks aan hun voorraad en orders.

  • REST en JSON
  • OpenAPI 3.0
  • Webhooks
  • Bearer-token
ERPWebshopMarktplaatsBI en rapportageEigen softwareWarehouse APIVoor je magazijnRelation APIVoor je klanten

Twee API's, elk voor een eigen rol

Een fulfilmentbedrijf werkt met twee soorten systemen: die van het magazijn zelf en die van de klanten. Daarom heeft Stockhub voor elke kant een eigen API, met eigen rechten en een eigen documentatie.

Warehouse API

Stockhub Fulfilment Open API, 36 endpoints

Voor je magazijn. Koppel je ERP, boekhouding, BI of eigen tools aan Stockhub en werk met de gegevens van al je relaties tegelijk.

  • Orders aanmaken, annuleren en adressen corrigeren, met hoeveelheden per orderregel en backorders
  • Producten, voorraad en magazijnlocaties per relatie
  • Inslagen, retouren, zendingen en track & trace
  • Relaties, webshops, eigen ordervelden en facturen
  • Sleutels met eigen rechten, ook beperkt tot één relatie

Base URL: https://openapi.stockhub.nl/fulfilment

Relation API

Stockhub Open API, 27 endpoints

Voor je relaties. De klanten van je fulfilment koppelen hun webshop, ERP of eigen software rechtstreeks aan Stockhub, zonder tussenkomst van het magazijn.

  • Producten aanmaken en wijzigen
  • Actuele voorraad per SKU of voor alle producten
  • Orders aanmaken, annuleren en het verzendadres corrigeren
  • Zendingen met vervoerdersstatus en scanhistorie
  • Inslagen en retouren aanmelden, wijzigen en afronden

Base URL: https://openapi.stockhub.nl/api

Zo werken de twee API's samen

Stockhub staat in het midden. Het magazijn praat via de Warehouse API, de klant via de Relation API, en beide kijken naar dezelfde voorraad en dezelfde orders. Verandert er iets, dan meldt Stockhub dat zelf met een webhook, zodat niemand hoeft te blijven vragen.

Jouw magazijnFulfilmentbedrijfERP en boekhoudingBI en rapportageEigen scripts en toolsJe klantenRelaties van je fulfilmentWebshopERP van de klantEigen softwareStockhub WMSWarehouse APIRelation APIwebhookswebhooks
Jouw magazijnFulfilmentbedrijfERP en boekhoudingBI en rapportageEigen scripts en toolsWarehouse APIStockhub WMSRelation APIJe klantenRelaties van je fulfilmentWebshopERP van de klantEigen software

Voorbeeld: magazijn

Je fulfilmentbedrijf zet elke nacht de facturen van alle relaties over naar de boekhouding, en je BI-dashboard haalt per klant de orderregels en backorders op.

Voorbeeld: klant

Een klant met een eigen webshopplatform stuurt nieuwe orders direct naar Stockhub en krijgt bij elke voorraadwijziging een stock.changed-webhook terug.

Wat kun je met de Stockhub API?

Alle magazijnprocessen die je in Stockhub ziet, zijn ook via de API bereikbaar. Dit overzicht laat zien welke onderdelen in welke API zitten. De volledige lijst met endpoints, velden en voorbeelden staat in de documentatie.

OnderdeelWarehouse APIRelation API
Producten aanmaken en wijzigenJaJa
Voorraad per SKU opvragenJaJa
Magazijnlocaties van een productJaNee
Orders aanmaken, annuleren en adres corrigerenJaJa
Orderregels, backorders en eigen orderveldenJaNee
Zendingen met track & trace en scanhistorieJaJa
Inslagen aanmelden en annulerenJaJa
Retouren aanmaken en wijzigenJaJa
Relaties en webshopsJaNee
Facturen opvragenJaNee
WebhooksOrdersVoorraad en zendingen

Je eerste API-call in drie stappen

Je hebt alleen een API-sleutel en een terminal nodig. Hieronder zie je de Relation API, maar de Warehouse API werkt op dezelfde manier.

  1. Maak een API-sleutel aan

    Dat doe je in Stockhub. Het stappenplan staat in het helpcentrum.

  2. Test je sleutel

    Stuur hem mee als Bearer-token. GET /api/me laat zien voor welk account de sleutel werkt.

  3. Haal je eerste gegevens op

    Vraag bijvoorbeeld de voorraad van een product op. Daarna kun je orders, inslagen en retouren aanmaken.

Terminal
# 1. Sleutel testencurl https://openapi.stockhub.nl/api/me \ -H "Authorization: Bearer JOUW_API_SLEUTEL"# 2. Voorraad van een productcurl https://openapi.stockhub.nl/api/products/PROD-001/stock \ -H "Authorization: Bearer JOUW_API_SLEUTEL"# Antwoord{ "success": true, "data": { "sku": "PROD-001", "availableStock": 50, "lastChanged": "2025-08-19T10:43:39.068Z" }}

Webhooks: Stockhub meldt het zelf

Met een webhook hoef je niet steeds te vragen of er iets veranderd is. Je geeft één HTTPS-adres op en Stockhub stuurt een POST zodra er iets gebeurt. Elke melding is ondertekend met HMAC-SHA256 en een geheime sleutel, zodat je zeker weet dat hij van Stockhub komt.

Relation API

  • stock.changed
  • shipment.confirmed

Warehouse API

  • order.created
  • order.updated
  • order.status_changed
  • order.cancelled
POSTjouw-server.nl/webhooks/stockhubX-Stockhub-Event:stock.changedX-Stockhub-Signature:sha256=9f2c…{"sku": "PROD-001","availableStock": 50}200 OK

Technische details

Type
REST over HTTPS, met JSON in en uit
Specificatie
OpenAPI 3.0, te downloaden als Warehouse-spec en Relation-spec
Authenticatie
API-sleutel als Bearer-token in de Authorization-header. Sleutels voor de Warehouse API hebben eigen rechten en kunnen beperkt worden tot één relatie.
Base URL's
https://openapi.stockhub.nl/fulfilment (Warehouse API)
https://openapi.stockhub.nl/api (Relation API)
Rate limits
Per sleutel per minuut. Relation API: 100 GET-verzoeken en 10 schrijfverzoeken per minuut. Bij overschrijding volgt 429 met een Retry-After-header.
Webhooks
Ondertekend met HMAC-SHA256 in de header X-Stockhub-Signature

Veelgestelde vragen over de Stockhub API

Heeft Stockhub een API?

Ja. Stockhub heeft twee REST API's met volledige OpenAPI-documentatie. De Warehouse API is voor je magazijn: je beheert orders, voorraad, inslag, retouren en facturen van al je relaties. De Relation API is voor de klanten van een fulfilmentbedrijf: zij koppelen hun webshop of eigen software rechtstreeks aan hun voorraad en orders in Stockhub.

Wat is het verschil tussen de Warehouse API en de Relation API?

De Warehouse API werkt vanuit het magazijn en kan bij alle relaties in je account. Je kiest per sleutel welke rechten hij krijgt en je kunt een sleutel beperken tot één relatie. De Relation API werkt vanuit één relatie en ziet alleen de eigen producten, orders, zendingen, inslagen en retouren.

Hoe kom ik aan een API-sleutel?

Je maakt een API-sleutel aan in Stockhub. Het stappenplan staat in het helpcentrum. Je stuurt de sleutel mee als Bearer-token in de Authorization-header en controleert hem met GET /me (Warehouse API) of GET /api/me (Relation API).

Is er een OpenAPI-specificatie?

Ja, beide API's hebben een OpenAPI 3.0-specificatie: fulfilment/openapi.json voor de Warehouse API en openapi.json voor de Relation API. Die importeer je in Postman of Insomnia, of je genereert er een client mee in je eigen programmeertaal.

Ondersteunt de Stockhub API webhooks?

Ja. Met de Relation API abonneer je je op stock.changed en shipment.confirmed. Met de Warehouse API op order.created, order.updated, order.status_changed en order.cancelled. Elke webhook is ondertekend met HMAC-SHA256, zodat je kunt controleren dat hij van Stockhub komt.

Zijn er rate limits?

Ja, per API-sleutel per minuut. Voor de Relation API zijn dat 100 GET-verzoeken per minuut en 10 schrijfverzoeken per minuut. Wordt de limiet overschreden, dan antwoordt de API met 429 Too Many Requests en een Retry-After-header.

Moet de webshop van mijn klant via de API koppelen?

Nee, dat hoeft niet. Stockhub heeft standaardkoppelingen met onder meer Shopify, WooCommerce, Bol en Amazon. De Relation API is er voor klanten met een eigen systeem of een platform zonder standaardkoppeling.

Een koppeling bespreken?

Vertel ons welk systeem je wilt koppelen. In een online demo laten we zien hoe de API en de standaardkoppelingen werken voor jouw magazijn en je klanten.