Product status: delete, disable, out of stock

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://content.doc.winkelstraat.nl/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json
{
  "Content API MCP server": {
    "url": "https://content.doc.winkelstraat.nl/mcp"
  }
}

Close

There are two ways to stop selling a product on Winkelstraat.nl. A product cannot be disabled through the API: sending "enabled": false is answered with 422 Products cannot be disabled.

Action How Effect on Winkelstraat.nl How to undo
Out of stock Send quantity 0 with PATCH /products/{code}/attribute/quantity (or in a full update). The product stays in the catalogue but cannot be ordered. The other sizes are not affected. Send a quantity above 0.
Delete DELETE /api/rest/v1/retailer/products/{code} The size is removed from the webshop. When all sizes of a product group are deleted, the whole product disappears from the webshop. The product no longer appears in GET /products. Send the product again with POST or PATCH; it is restored.

When changes become visible

  • Stock changes are passed on to the webshop directly after the API call.
  • Other changes (new products, product information, prices, images and deletions) appear on the webshop after the next scheduled catalogue update, not immediately.
  • New images first go through Winkelstraat's image review (see Images).

Delete one size or the whole product

DELETE removes a single product (one size). To remove an article completely, delete every size of its product group.

Creating a product with stock 0

A new product that you send with quantity 0 is not created: the API answers 202 Accepted and nothing is stored. Send the product again once it is in stock.