Add tracking to a shipment

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 /V2/external_fulfillment/shipment/track

What it does. Registers a carrier tracking number on an externally-fulfilled shipment.

When to use. Call this once the logistics service provider has a tracking number for the parcel.

Version. Tracking V2 — recommended.

Body

track object Required
Hide track attributes Show track attributes object
- increment_id string Required
  
  Increment id of the shipment.
- track_number string Required
  
  Carrier tracking number.
- carrier_code string Required
  
  Carrier code (e.g. postnl, ups).
- carrier_method string Required
  
  Carrier method/service code.
- shipment_token string Required
  
  Shipment token authorizing the request (provided via the Shipment Push API).
- logistics_service_provider_code string Required
  
  Code of the logistics service provider fulfilling the shipment.

Body

track object Required
Hide track attributes Show track attributes object
- increment_id string Required
  
  Increment id of the shipment.
- track_number string Required
  
  Carrier tracking number.
- carrier_code string Required
  
  Carrier code (e.g. postnl, ups).
- carrier_method string Required
  
  Carrier method/service code.
- shipment_token string Required
  
  Shipment token authorizing the request (provided via the Shipment Push API).
- logistics_service_provider_code string Required
  
  Code of the logistics service provider fulfilling the shipment.

Responses

500

application/json

application/json application/xml

Internal Server 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
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 /V2/external_fulfillment/shipment/track

curl \
 --request POST 'https://m2.winkelstraat.nl/rest/all/V2/external_fulfillment/shipment/track' \
 --header "Content-Type: application/json" \
 --data '{"track":{"increment_id":"100000123","track_number":"3SABCD1234567","carrier_code":"postnl","carrier_method":"standard","logistics_service_provider_code":"lsp_partner","shipment_token":"eyJ0eXAiOiJKV1QiLCJhbGciOiJI..."}}'

curl \
 --request POST 'https://m2.winkelstraat.nl/rest/all/V2/external_fulfillment/shipment/track' \
 --header "Content-Type: application/xml"

Request examples

{
  "track": {
    "increment_id": "100000123",
    "track_number": "3SABCD1234567",
    "carrier_code": "postnl",
    "carrier_method": "standard",
    "logistics_service_provider_code": "lsp_partner",
    "shipment_token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJI..."
  }
}

Request examples

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <track>
    <increment-id>100000123</increment-id>
    <track-number>3SABCD1234567</track-number>
    <carrier-code>postnl</carrier-code>
    <carrier-method>standard</carrier-method>
    <logistics-service-provider-code>lsp_partner</logistics-service-provider-code>
    <shipment-token>eyJ0eXAiOiJKV1QiLCJhbGciOiJI...</shipment-token>
  </track>
</root>

Response examples (500)

{
  "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 (500)

<?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>

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>