Add Store

Last Updated on : 2023-06-15 05:50:38

Add the information about a specified store.

API address

POST: /v1.0/iot-03/retail/shops

Request parameter

Description of body

Parameter name Type IN Required Description
parent_shop_id String false The ID of a specified parent store. The value can be empty if there is no parent store.
shop_name String true The name of a specified store.
province_code Integer false The code of a specified province.
province_name String false The name of a specified province.
city_code Integer false The code of a specified city.
city_name String false The name of a specified city.
district_code Integer false The code of a specified district.
district_name String false The name of a specified district.
address String false The detailed address.
business_hours List false The business hours.
shop_layout_plan String false The layout plan of a specified store.

Description of business_hours

Parameter name Type IN Required Description
opening_time Long false The 10 or 13-bit timestamp of the start time.
closing_time Long false The 10 or 13-bit timestamp of the end time.

Return parameter

Parameter name Type Description
result String The ID of a specified store.

Request example

POST: /v1.0/iot-03/retail/shops
{ "shop_name": "xxx Store" "province_code": 123, "province_name": "xxx Province", "city_code": 456, "city_name": "xxx City", "district_code": 789, "district_name": "xxx District", "address": "xxx Center", }

Return example

{ "result": "140509293102660xxx", "t": 1623835234825, "success": true }

Error code

For more information, see error code.

Description of province_code, city_code, and district_code

For more information about Chinese cities, see [Administrative Division Code of the People’s Republic of China] (http://www.mca.gov.cn/article/sj/xzqh/2020/2020/202101041104.html).