Merchant Order fulfilment API

Merchant Order fulfilment API
M2.4 - v2.0.0

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://merchant-order-fulfilment.doc.winkelstraat.nl/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Merchant Order fulfilment API MCP server": {
    "url": "https://merchant-order-fulfilment.doc.winkelstraat.nl/mcp"
  }
}
Close
Base URL 
https://m2.winkelstraat.nl/rest/all

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.

This is version M2.4 - v2.0.0 of this API documentation. Last update on Aug 5, 2026.