# Update the volatile information for multiple products.

Update the volatile information (stock count, price, etc.) for multiple main products and product variants in one step. The products are identified by their stock keeping unit (article number), language and country.

Endpoint: PATCH /shops/products
Version: 2025-07-09

## Request fields (application/json):

  - `lang` (string)
    The ISO 639 2-letter language code specifying the product language (e.g. "en", "de").
    Example: "de"

  - `country` (string)
    The ISO 3166 2-letter country code specifying the country the product is for (e.g. "DE", "SA").
    Example: "DE"

  - `currency` (string)
    A 1-character currency symbol ($, €, £, ¥, ₹, ₽, ₩, ₺, ₪, ₫, ₴, ₦, ₱, ₲, ₡, ₸, ₮, ؋, ֏, ৳, zł, Kč, kr, Ft, CHF, R, L, lei, ден, د.إ, ر.س, ر.ق, ر.ع., د.ب, د.ك, د.ج, د.ت, ج.م, ل.ل, ل.د, ج.س., MT, MK, ZK, TT$, BZ$, C$, A$, NZ$, HK$, SG$, MX$, R$) or ISO 4217 3-letter currency code used for payment
    Example: "EUR"

  - `shippingModel` (object)
    The shipping model to use for this product or product variant.

  - `shippingModel.shippingFlatRate` (integer)
    The flat-rate shipping cost (including tax) (default is 0).Flat-rate shipping costs are independent from the number of items ordered.The value is given in minor units (e.g. 499 for 4,99 EUR).
    Example: 499

  - `shippingModel.shippingPerItem` (integer)
    The shipping cost (including tax) to ship one item (default is 0).The value is given in minor units (e.g. 499 for 4,99 EUR).

  - `shippingModel.shippingScale` (array)
    With the shipping scale you can implement shipping costs for different order count thresholds.If the list contains multiple entries with the same start value the first one is taken.Example: The standard shipping is 4.99 EUR (at least 1 product ordered), Starting from 5 products ordered shipping is 6.99 EUR and so on.

  - `shippingModel.shippingScale.start` (integer)
    The minimum number of product items to order to use the specified shipping cost (default 0).

  - `shippingModel.shippingScale.price` (integer)
    The shipping cost (including tax) starting with the specified number of product items ordered.The value is given in minor units (e.g. 499 for 4,99 EUR) and defaults to 0.
    Example: 399

  - `shippingModel.orderLimit` (integer)
    The order limit for this product. If None there is no limit. If zero the product cannot be ordered at all.

  - `vat` (number)
    The VAT (value added tax) in percent (e.g. 19.0%).
    Example: 19

  - `products` (array)
    The product information to update.
The number of products to update in one call is limited to 50.

  - `products.sku` (string, required)
    The stock keeping unit (article number) of the main product or product variant (e.g. size)

  - `products.stockCount` (integer)
    The number of products currently in stock.
- A stock count > 0 means there are n products available.
- A stock count = 0 means the product is temporary out-of-stock.
- A stock count < 0 means the product is not any longer available in the shop at all.
- If not specified the stock count is not set.

  - `products.price` (integer)
    The current price of the product including discounts (including tax) (excluding shipping, etc.).
The price is given in minor units (e.g. 2799 for 27,99 EUR).
That is the price a customer really has to pay when ordering the product.
If not specified the price is not set.
    Example: 2799

  - `products.orgPrice` (integer)
    The original price of the product (including tax) (excluding shipping, etc.).
The price is given in minor units (e.g. 3599 for 35,99 EUR).
If not specified the original and current prices are identical.
    Example: 3599

## Response 200 fields (application/json):

  - `data` (any)
    The response data.

  - `nextToken` (string)
    The token, which can be used to retrieve the next page of data.

  - `error` (object)
    Details of the error that occurred during the API request, including error code and message. This field is only present when the request results in an error.

  - `error.code` (integer, required)
    The API error code
    Enum: 1001, 1002, 1003, 1004, 1005, 1006, 1007, 1008, 1009, 1010, 1011, 1012, 1013, 1014, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 3000, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 4001, 4002, 5001, 5002, 5003, 5004, 200, 201, 202, 204, 400, 401, 403, 404, 405, 406, 422, 423, 501, 503

  - `error.message` (string, required)
    The API error message.

  - `error.details` (any)
    The HTTP error details.

## Response 401 fields (application/json):

  - `data` (any)
    The response data.

  - `nextToken` (string)
    The token, which can be used to retrieve the next page of data.

  - `error` (object)
    Details of the error that occurred during the API request, including error code and message. This field is only present when the request results in an error.

  - `error.code` (integer, required)
    The API error code
    Enum: 1001, 1002, 1003, 1004, 1005, 1006, 1007, 1008, 1009, 1010, 1011, 1012, 1013, 1014, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 3000, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 4001, 4002, 5001, 5002, 5003, 5004, 200, 201, 202, 204, 400, 401, 403, 404, 405, 406, 422, 423, 501, 503

  - `error.message` (string, required)
    The API error message.

  - `error.details` (any)
    The HTTP error details.

## Response 422 fields (application/json):

  - `data` (any)
    The response data.

  - `nextToken` (string)
    The token, which can be used to retrieve the next page of data.

  - `error` (object)
    Details of the error that occurred during the API request, including error code and message. This field is only present when the request results in an error.

  - `error.code` (integer, required)
    The API error code
    Enum: 1001, 1002, 1003, 1004, 1005, 1006, 1007, 1008, 1009, 1010, 1011, 1012, 1013, 1014, 2001, 2002, 2003, 2004, 2005, 2006, 2008, 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019, 2020, 2021, 2022, 2023, 2024, 2025, 3000, 3001, 3002, 3003, 3004, 3005, 3006, 3007, 4001, 4002, 5001, 5002, 5003, 5004, 200, 201, 202, 204, 400, 401, 403, 404, 405, 406, 422, 423, 501, 503

  - `error.message` (string, required)
    The API error message.

  - `error.details` (any)
    The HTTP error details.