# Modify a ShopCategory

- To update a ShopCategory information, will keep its original ID
- Please ensure that each parameter is the value you want to update.

 10 QPS by appId dimension.


Endpoint: POST /product/shopcategory/update
Version: v.1.0.0

## Request fields (application/json):

  - `shopId` (integer, required)
    store id in KeeTa
    Example: 25381

  - `shopCategory` (object, required)

  - `shopCategory.id` (integer)
    Keeta's menu category ID. Not required for OpenItemCode-based APIs. Required for updates in Keeta ID-based APIs.
    Example: 12345

  - `shopCategory.name` (string, required)
    Name of the category in a menu
    Example: "Happy Meal"

  - `shopCategory.sourceLanguageType` (string, required)
    Language type of the name field. Supported language enums can be found in Menu Integration Guide
    Example: "en"

  - `shopCategory.nameTranslation` (string)
    Translated text for the name field
    Example: "開心樂園餐"

  - `shopCategory.targetLanguageType` (string)
    Language type of nameTranslation. Required when nameTranslation is provided.
    Example: "zh-HK"

  - `shopCategory.nameTranslateType` (integer)
    Source of name translation. When the value equals 1, it indicates that the name translation was provided by the merchant.
    Example: 1

  - `shopCategory.type` (integer, required)
    Indicates the menu category type:

  - `shopCategory.description` (string)
    Brief description of the category in a menu
    Example: "Happy Meal description"

  - `shopCategory.descSourceLanguageType` (string)
    Language type of description. Required if description exists.
    Example: "en"

  - `shopCategory.descriptionTranslation` (string)
    Translated text for description
    Example: "開心樂園餐描述"

  - `shopCategory.descTargetLanguageType` (string)
    Language type of descriptionTranslation. Required when descriptionTranslation exists.
    Example: "zh-HK"

  - `shopCategory.descriptionTranslateType` (integer)
    Source of description translation. When the value equals 1, it indicates that the description translation was provided by the merchant.
    Example: 1

  - `shopCategory.openItemCode` (string, required)
    Third-party category ID. Mandatory and must be unique in OpenItemCode-based APIs. Optional in Keeta ID-based APIs.
    Example: "SHOP_CATEGORY#10001"

  - `shopCategory.availableTime` (object)
    Selling time slots for this category. Categories are unavailable outside these times.

  - `shopCategory.availableTime.code` (integer, required)
    Selling time type indicator:

  - `shopCategory.availableTime.values` (array)
    Required when code=1. Contains 7 strings representing daily time slots (Sunday to Saturday). Empty string means unavailable.

  - `shopCategory.availableTime.available` (array)
    Defines specific date ranges and time windows. Required when code=2.

  - `shopCategory.availableTime.available.startTimestamp` (integer)
    Beginning timestamp (milliseconds). Required when using absolute date ranges. If set without endTimestamp, indicates perpetual availability after start date. Required when AvailableTime.code = 2
    Example: 1735660800000

  - `shopCategory.availableTime.available.endTimestamp` (integer)
    Ending timestamp (milliseconds). When omitted with startTimestamp, creates open-ended availability.
    Example: 1736956799000

## Response 200 fields (application/json):

  - `code` (integer, required)
    A numeric status identifier indicating the result of the interface call, used to determine whether the operation executed successfully.

  - `message` (string, required)
    Text description corresponding to the status code, explaining the operation result or error cause to users.
    Example: "Success"

  - `data` (object)

  - `data.id` (integer)
    Keeta's menu category ID. Not required for OpenItemCode-based APIs. Required for updates in Keeta ID-based APIs.
    Example: 12345

  - `data.name` (string, required)
    Name of the category in a menu
    Example: "Happy Meal"

  - `data.sourceLanguageType` (string, required)
    Language type of the name field. Supported language enums can be found in Menu Integration Guide
    Example: "en"

  - `data.nameTranslation` (string)
    Translated text for the name field
    Example: "開心樂園餐"

  - `data.targetLanguageType` (string)
    Language type of nameTranslation. Required when nameTranslation is provided.
    Example: "zh-HK"

  - `data.nameTranslateType` (integer)
    Source of name translation. When the value equals 1, it indicates that the name translation was provided by the merchant.
    Example: 1

  - `data.type` (integer, required)
    Indicates the menu category type:

  - `data.description` (string)
    Brief description of the category in a menu
    Example: "Happy Meal description"

  - `data.descSourceLanguageType` (string)
    Language type of description. Required if description exists.
    Example: "en"

  - `data.descriptionTranslation` (string)
    Translated text for description
    Example: "開心樂園餐描述"

  - `data.descTargetLanguageType` (string)
    Language type of descriptionTranslation. Required when descriptionTranslation exists.
    Example: "zh-HK"

  - `data.descriptionTranslateType` (integer)
    Source of description translation. When the value equals 1, it indicates that the description translation was provided by the merchant.
    Example: 1

  - `data.openItemCode` (string, required)
    Third-party category ID. Mandatory and must be unique in OpenItemCode-based APIs. Optional in Keeta ID-based APIs.
    Example: "SHOP_CATEGORY#10001"

  - `data.availableTime` (object)
    Selling time slots for this category. Categories are unavailable outside these times.

  - `data.availableTime.code` (integer, required)
    Selling time type indicator:

  - `data.availableTime.values` (array)
    Required when code=1. Contains 7 strings representing daily time slots (Sunday to Saturday). Empty string means unavailable.

  - `data.availableTime.available` (array)
    Defines specific date ranges and time windows. Required when code=2.

  - `data.availableTime.available.startTimestamp` (integer)
    Beginning timestamp (milliseconds). Required when using absolute date ranges. If set without endTimestamp, indicates perpetual availability after start date. Required when AvailableTime.code = 2
    Example: 1735660800000

  - `data.availableTime.available.endTimestamp` (integer)
    Ending timestamp (milliseconds). When omitted with startTimestamp, creates open-ended availability.
    Example: 1736956799000