# Merchant Order fulfilment API

> This is version `M2.4 - v2.0.0` of this API documentation. Last update on Aug 5, 2026.
> Order and shipment fulfilment endpoints for merchants: process returns (RMAs), mark shipments as packed, register tracking numbers and report deficient orders.
> 
> ## Authentication
> 
> Requests are authenticated with a Magento API key (`api_key` header). Return, packed and tracking operations additionally require the per-shipment **shipment token**, which is delivered to your endpoint through the Shipment Push API and passed on the request.
> 
> ## Values you must copy from the webhooks
> 
> Several request fields must be **copied verbatim** from the values Winkelstraat delivers to your endpoint through the Push API order/shipment webhooks. Do not translate, re-map or normalize them — send back the exact string you received:
> 
> - `increment_id` / `{incrementId}` — the shipment webhook `shipment_id`.
> - `shipment_token` — the shipment webhook `shipment_token`.
> - `carrier_code` / `carrier_method` — the matching shipment webhook `available_delivery_methods[]` entry.
> - `logistics_service_provider_code` — the shipment webhook `logistics_service_provider_code`.
> - `sku` — the order webhook `order_item.sku` (or the shipment webhook `items[].sku`).
> 
> ## Versioning
> 
> Endpoints are versioned in the path (`/V1`, `/V2`, `/V3`). Newer versions are listed first and older versions are marked deprecated.
> 
> - **V3** (recommended) — full return lifecycle: create, search, update and add tracking to returns.
> 
> - **V2** — the current shipment-packed, external-fulfilment tracking and deficient-order endpoints, plus the older single-step return processing.
> 
> - **V1** (deprecated) — kept only for existing integrations. Migrate to V2/V3.

OpenAPI file: https://merchant-order-fulfilment.doc.winkelstraat.nl/source.json

## Servers

- https://m2.winkelstraat.nl/rest/all: https://m2.winkelstraat.nl/rest/all ()


## Topics


## Endpoints

### [RMA](https://merchant-order-fulfilment.doc.winkelstraat.nl/group/endpoint-rma.md)

- [Create a return](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-postv3winkelstraatrma_apishipmentincrementid.md)

- [Update a return](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-putv3winkelstraatrma_apirmaincrementid.md)

- [Add tracking to a return](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-postv3winkelstraatrma_apirmaincrementidtrack.md)

- [Get return attribute options](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-getv3winkelstraatrma_apiattributeattributecode.md)

- [Process returned items](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-postv2winkelstraatrma_apishipmentincrementid.md)

- [Get return attribute options](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-getv2winkelstraatrma_apiattributeattributecode.md)

- [Process returned items (deprecated)](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-postv1winkelstraatrma_apishipmentincrementid.md)

- [Get return attribute options (deprecated)](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-getv1winkelstraatrma_apiattributeattributecode.md)


### [Shipment](https://merchant-order-fulfilment.doc.winkelstraat.nl/group/endpoint-shipment.md)

- [Mark shipment as packed](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-postv2shipmentincrementidmerchantpacked.md)

- [Reset packed marker](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-postv2shipmentincrementidmerchantpackedreset.md)


### [Tracking](https://merchant-order-fulfilment.doc.winkelstraat.nl/group/endpoint-tracking.md)

- [Add tracking to a shipment](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-postv2external_fulfillmentshipmenttrack.md)

- [Add tracking to a shipment (deprecated)](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-postv1external_fulfillmentshipmenttrack.md)


### [Creditmemo](https://merchant-order-fulfilment.doc.winkelstraat.nl/group/endpoint-creditmemo.md)

- [Report a deficient order](https://merchant-order-fulfilment.doc.winkelstraat.nl/operation/operation-postv2winkelstraatcreditmemo_apishipmentincrementiddeficiency.md)




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