创建门店

功能介绍

本接口用于商家向平台提交门店创建申请。商家通过传入门店信息，请求在平台侧注册新门店。平台接收到请求后，将进行数据校验并启动审核流程。

• 系统将为每个成功提交的门店生成唯一的 平台侧门店标识（venueId），请商家保存venueId与自有门店的关联，便于后续管理。
• 同一元服务或应用下，商家侧门店编码（venueCode）全局唯一，仅允许创建一次。重复提交将被拒绝。
• 门店创建后状态为“审核中”，需等待平台审核通过后，方可用于门店直达等业务场景。
• 审核结果可通过“查询门店”接口获取。

• 所有后续操作（如更新、删除、查询）均需使用返回的venueId。
• 商家侧门店编码（venueCode）请填写为门店跳转链接中对应的门店参数值，确保二者保持一致。

适用场景

• 新门店上线。

  商家在商家系统中新增一家实体门店，需通过本接口将门店信息同步至平台。

• 系统对接初始化。

  商家首次接入平台系统，需批量导入已有门店数据。通过本接口逐条提交门店信息，并建立 venueCode 与平台 venueId 的映射关系。

• 服务商、商家（企业开发者）均可调用此接口。

接口原型

请求参数

[h2]Request Header

[h2]Request Body

BusinessHour

请求示例

POST https://connect-api.cloud.huawei.com/api/ability-platform-connect/hag-developer/v1/venues
Authorization: Bearer eyJr*****OiIx---****.eyJh*****iJodHR--***.QRod*****4Gp---****
Content-Type: application/json;charset=UTF-8
appId: 5981*****5845

{
	"venueName": "venueName",
	"venueCode": "C001",
	"categoryCode": "30000203",
	"latitude": 34.101101,
	"longitude": 108.202202,
	"detailedAddress": "详细地址",
	"remark": "备注",
	"brand": "品牌方",
	"contactPhone": "010-1234567",
	"businessHours": [
		{
			"daysOfWeek": [
				1,
				2,
				3,
				4,
				5
			],
			"timeSlots": [
				{
					"start": "09:00",
					"end": "12:00"
				},
				{
					"start": "13:00",
					"end": "21:00"
				}
			]
		},
		{
			"daysOfWeek": [
				6,
				7
			],
			"timeSlots": [
				{
					"start": "08:00",
					"end": "12:00"
				},
				{
					"start": "13:00",
					"end": "22:00"
				}
			]
		}
	],
	"mercNo": "商户号",
	"launchOptions": {
		"wantParam": "{\"path\":\"page2\", \"venueId\":123}"
	}
}

响应参数

调用成功时，返回如下：

[h2]Response Header

[h2]Response Body

响应示例

HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
{
    "errorCode": 0,
    "errorDesc": "Success",
    "venueId": "1773242566167455872"
}