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
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.
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.
| Onderdeel | Warehouse API | Relation API |
|---|---|---|
| Producten aanmaken en wijzigen | Ja | Ja |
| Voorraad per SKU opvragen | Ja | Ja |
| Magazijnlocaties van een product | Ja | Nee |
| Orders aanmaken, annuleren en adres corrigeren | Ja | Ja |
| Orderregels, backorders en eigen ordervelden | Ja | Nee |
| Zendingen met track & trace en scanhistorie | Ja | Ja |
| Inslagen aanmelden en annuleren | Ja | Ja |
| Retouren aanmaken en wijzigen | Ja | Ja |
| Relaties en webshops | Ja | Nee |
| Facturen opvragen | Ja | Nee |
| Webhooks | Orders | Voorraad 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.
Maak een API-sleutel aan
Dat doe je in Stockhub. Het stappenplan staat in het helpcentrum.
Test je sleutel
Stuur hem mee als Bearer-token.
GET /api/melaat zien voor welk account de sleutel werkt.Haal je eerste gegevens op
Vraag bijvoorbeeld de voorraad van een product op. Daarna kun je orders, inslagen en retouren aanmaken.
# 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.changedshipment.confirmed
Warehouse API
order.createdorder.updatedorder.status_changedorder.cancelled
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
429met eenRetry-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.