# Stock Hub Order Webhooks

OpenAPI file: https://stock-hub.doc.winkelstraat.nl/source.json

## Description

This is version `1.0.0` of this API documentation. Last update on Apr 20, 2026.

# Introduction

Winkelstraat.nl has created a set of webhooks to monitor order fullfilment for resellers. Developers can use these webhooks to update orderfullment information within the e-commerce system of the reseller.
The webhooks provide real-time insights for:
 * order creation
 * shipment creation,
 * RMA processing, and
 * refunds.

## Activation

To activate the Winkelstraat.nl Stock Hub Order webhooks please send the URL of the endpoint(s) to <partnersupport@winkelstraat.nl>.

## Security

To prevent unauthorised updates to the endpoints, we can add an additional x-api-key header.
The value of this header acts as a shared secret between sender and receiver.
The value can be any list of characters. To check the value's validity must be checked by the receiving server.

# Terminology

This document uses the following concepts:
- Order: An order represents a purchase request initiated by a user, comprising various order items with differing quantities. Throughout its entire life cycle, an order may transition through multiple statuses.
- Shipment: A shipment is a package that consolidates a selection of order items that have to be shipped together.
- Track: A (shipment) track is used to to monitor and tracing the movement of a shipment.
- RMA: An RMA or a return is a package that consolidates a selection of ordered items (RMA items) that need to be shipped from a customer to a merchant.
- RMA item: An RMA item specifies a.o. the reason for return, the desired resolution by a customer, and the merchant resolution.
- Credit memo: A credit memo is a correctional specification issued by a seller to a buyer to denote the amount returned.

# Deliverability

Webhooks events are fired in real-time; when the system registers a change, the corresponding webhook event is triggered
immediately after. If a webhook is not accepted by the receiving server (e.g., the HTTP response code is not successful or the delivery fails),
the retry mechanism will retry delivery up to 5 times at approximately 15-minute intervals. After 5 failed attempts, the event is
no longer retried.


## Servers

- http://api.example.com: http://api.example.com ()


## Topics


## Webhooks

### [Winkelstraat/stock hub/v1/creditmemo](https://stock-hub.doc.winkelstraat.nl/group/webhook-winkelstraat-stock-hub-v1-creditmemo.md)

- [Winkelstraat/stock hub/v1/creditmemo](https://stock-hub.doc.winkelstraat.nl/operation/operation-winkelstraat-stock-hub-v1-creditmemo.md)


### [Winkelstraat/stock hub/v1/invoice](https://stock-hub.doc.winkelstraat.nl/group/webhook-winkelstraat-stock-hub-v1-invoice.md)

- [Winkelstraat/stock hub/v1/invoice](https://stock-hub.doc.winkelstraat.nl/operation/operation-winkelstraat-stock-hub-v1-invoice.md)


### [Winkelstraat/stock hub/v1/order](https://stock-hub.doc.winkelstraat.nl/group/webhook-winkelstraat-stock-hub-v1-order.md)

- [Winkelstraat/stock hub/v1/order](https://stock-hub.doc.winkelstraat.nl/operation/operation-winkelstraat-stock-hub-v1-order.md)


### [Winkelstraat/stock hub/v1/rma](https://stock-hub.doc.winkelstraat.nl/group/webhook-winkelstraat-stock-hub-v1-rma.md)

- [Winkelstraat/stock hub/v1/rma](https://stock-hub.doc.winkelstraat.nl/operation/operation-winkelstraat-stock-hub-v1-rma.md)


### [Winkelstraat/stock hub/v1/shipment](https://stock-hub.doc.winkelstraat.nl/group/webhook-winkelstraat-stock-hub-v1-shipment.md)

- [Winkelstraat/stock hub/v1/shipment](https://stock-hub.doc.winkelstraat.nl/operation/operation-winkelstraat-stock-hub-v1-shipment.md)


### [Winkelstraat/stock hub/v2/order payment request](https://stock-hub.doc.winkelstraat.nl/group/webhook-winkelstraat-stock-hub-v2-order-payment-request.md)

- [Winkelstraat/stock hub/v2/order payment request](https://stock-hub.doc.winkelstraat.nl/operation/operation-winkelstraat-stock-hub-v2-order-payment-request.md)




[Powered by Bump.sh](https://bump.sh)