Create a return

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

{
  "Merchant Order fulfilment API MCP server": {
    "url": "https://merchant-order-fulfilment.doc.winkelstraat.nl/mcp"
  }
}

POST /V3/winkelstraat/rma_api/shipment/{incrementId}

What it does. Registers a new return (RMA) for a shipment from the shipment items the customer is sending back. Optionally generates a return tracking label.

When to use. Call this when a customer returns one or more items of a shipment you fulfilled.

Version. RMA V3 — recommended.

Path parameters

incrementId string Required

Shipment increment id.

Body

items array[object] Required

Returned items data.
Hide items attributes Show items attributes object
Defines the structure for updating return items
- sku string Required
  
  Product SKU of the order/shipment item.
- qty_requested integer Required
  
  Number of units the customer wants to return.
- reason string
  
  Return reason code. Query the live set via the reason attribute options endpoint.
  
  Values are too_big, too_small, not_as_expected, fabric_not_as_expected, damaged, poor_quality, item_faulty, product_description_not_accurate, product_photo_not_accurate, ordered_accidentally, lower_price_available, delivered_too_late, missing_accessories, more_delivered_than_ordered, not_longer_needed, or no_reason.
shipmentToken string Required

Shipment token. The shipment token is provided through the Shipment Push API.
generateTrack boolean

Generate tracking number while creating return

Body

items array[object] Required

Returned items data.
Hide items attributes Show items attributes object
Defines the structure for updating return items
- sku string Required
  
  Product SKU of the order/shipment item.
- qty_requested integer Required
  
  Number of units the customer wants to return.
- reason string
  
  Return reason code. Query the live set via the reason attribute options endpoint.
  
  Values are too_big, too_small, not_as_expected, fabric_not_as_expected, damaged, poor_quality, item_faulty, product_description_not_accurate, product_photo_not_accurate, ordered_accidentally, lower_price_available, delivered_too_late, missing_accessories, more_delivered_than_ordered, not_longer_needed, or no_reason.
shipmentToken string Required

Shipment token. The shipment token is provided through the Shipment Push API.
generateTrack boolean

Generate tracking number while creating return

Responses

200

application/json

application/json application/xml

200 Success.
default

application/json

application/json application/xml

Unexpected error
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Errors list
  
  Hide errors attributes Show errors attributes object
  
  Error details
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Errors list
  
  Hide errors attributes Show errors attributes object
  
  Error details
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace

POST /V3/winkelstraat/rma_api/shipment/{incrementId}

curl \
 --request POST 'https://m2.winkelstraat.nl/rest/all/V3/winkelstraat/rma_api/shipment/{incrementId}' \
 --header "Content-Type: application/json" \
 --data '{"items":[{"sku":"WSNL123-BLACK-M","qty_requested":1,"reason":"too_small"}],"shipmentToken":"string","generateTrack":true}'

curl \
 --request POST 'https://m2.winkelstraat.nl/rest/all/V3/winkelstraat/rma_api/shipment/{incrementId}' \
 --header "Content-Type: application/xml"

Request examples

{
  "items": [
    {
      "sku": "WSNL123-BLACK-M",
      "qty_requested": 1,
      "reason": "too_small"
    }
  ],
  "shipmentToken": "string",
  "generateTrack": true
}

Request examples

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <items type="array">
    <item>
      <sku>WSNL123-BLACK-M</sku>
      <qty-requested type="integer">1</qty-requested>
      <reason>too_small</reason>
    </item>
  </items>
  <shipmentToken>string</shipmentToken>
  <generateTrack type="boolean">true</generateTrack>
</root>

Response examples (200)

string

Response examples (200)

string

Response examples (default)

{
  "message": "string",
  "errors": [
    {
      "message": "string",
      "parameters": [
        {
          "resources": "string",
          "fieldName": "string",
          "fieldValue": "string"
        }
      ]
    }
  ],
  "code": 42,
  "parameters": [
    {
      "resources": "string",
      "fieldName": "string",
      "fieldValue": "string"
    }
  ],
  "trace": "string"
}

Response examples (default)

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <message>string</message>
  <errors type="array">
    <error>
      <message>string</message>
      <parameters type="array">
        <parameter>
          <resources>string</resources>
          <fieldName>string</fieldName>
          <fieldValue>string</fieldValue>
        </parameter>
      </parameters>
    </error>
  </errors>
  <code type="integer">42</code>
  <parameters type="array">
    <parameter>
      <resources>string</resources>
      <fieldName>string</fieldName>
      <fieldValue>string</fieldValue>
    </parameter>
  </parameters>
  <trace>string</trace>
</root>