# Update the general configuration of a retailer/e-commerce platform (merchant).

Update the general configuration of a retailer/e-commerce platform (merchant). Each field can be updated individually.

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

## Request fields (application/json):

  - `shippingModel` (object)
    The shipping model to use for the retailer/e-commerce platform.

  - `shippingModel.productShippingCalculationStrategy` (string)
    The strategy used to calculate the shipping cost from multiple products of an order (default=ProductShippingCalculationStrategy.MAX).Only relevant if product shipping costs were specified.
    Enum: "SUM", "MAX"

  - `shippingModel.merchantShippingScale` (array)
    With the shipping scale you can implement shipping costs for different order price thresholds.If the list contains multiple entries with the same order price start value the first one is taken.Example: The standard shipping is 4.99 EUR (order price start 0,00 EUR), Starting with an order volume of 20,00 EUR shipping is free.

  - `shippingModel.merchantShippingScale.orderPriceStart` (integer)
    The minimum order price (including tax) (default 0).The value is given in minor units (e.g. 3999 for 39,99 EUR) and defaults to 0.

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

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

## Response 200 fields (application/json):

  - `data` (any)
    The response 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 error code
    Enum: 1001, 1002, 1003, 1004, 1005, 1006, 1007, 1008, 1009, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 3001, 3002, 3003, 4001

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

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

## Response 401 fields (application/json):

  - `data` (any)
    The response 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 error code
    Enum: 1001, 1002, 1003, 1004, 1005, 1006, 1007, 1008, 1009, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 3001, 3002, 3003, 4001

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

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

## Response 422 fields (application/json):

  - `data` (any)
    The response 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 error code
    Enum: 1001, 1002, 1003, 1004, 1005, 1006, 1007, 1008, 1009, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 3001, 3002, 3003, 4001

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

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