# 添加团购优惠
通过本接口可以创建本地团购优惠。创接口不支持直接设置库存,请在创建完成后调用库存管理接口进行设置。
# 接口调用请求说明
http请求方式:POST
https://api.weixin.qq.com/channels/ec/product/locallife/add?access_token=ACCESS_TOKEN
# 请求参数示例
{
"out_product_id": "test_120719261",
"product_type": 1,
"product_name": "测试商品",
"category_id": "545201",
"brand_id": "10010719",
"head_imgs":[
"https://mmecimage.cn/p/wx2b255582a7b4bfd0/HPfcDsYrzbTlVSFQI9Qar0uzDhKI-EB7Efryf-dxlUE",
"https://mmecimage.cn/p/wx2b255582a7b4bfd0/HAOY-e61JPVNI5fsTlOcy-1r_rSxqnAsIUWqXXWNJSE",
"https://mmecimage.cn/p/wx2b255582a7b4bfd0/HLD6dz9RbUkPzBQGHnpb9Z7BcK9kF1HYeLkwxiK9RtI"
],
"verify_page": {
"appid":"wxca8d4b8e8feedc2a",
"path": "main/channels/buy/buy.html?productId=123"
},
"code_source_type": 1,
"attr_kv_map": {
"use_date_rule": "{\"validate_type\":1,\"use_date\":{\"use_start_date\":\"2023-11-29\",\"use_end_date\":\"2023-12-31\"}\}",
"use_time":"{\"use_time_type\":2,\"time_periods\":[{\"use_start_time\":\"10:00:00\",\"use_end_time\":\"20:00:00\"}]}",
"detail_imgs":"[\"https://mmecimage.cn/xxxxxxxxxx\",\"https://mmecimage.cn/yyyyyyyyyy\",\"https://mmecimage.cn/zzzzzzzzzz\"]",
"set_meals":"[{\"group_name\": \"套餐名称\", \"items\": [{\"item_count\": 1, \"item_name\": \"项目名称\",\"item_price\": 28800}],\"option_count\": 1}]",
"exclusive_date": "{\"enable\": 0}",
"voucher_amount": "100",
"bring_out_type": "1",
"appointment": "{\"need_appointment\":0}",
"need_phone_num": "0",
"additional_rule": "\"附加规则\"",
"available_store_desc": "\"可用门店描述\"",
"settle_type": "1",
"refund_policy": "1"
},
"skus": [
{
"sale_price": 100
}
]
}
# 回包示例
{
"errcode": 0,
"errmsg": "ok",
"data": {
"product_id": "15000000000000",
"sku_ids": [
"1234567890"
]
}
}
# 请求参数说明
参数名 | 类型 | 是否必填 | 参数描述 |
---|---|---|---|
out_product_id | string | 否 | 外部系统id,只作为商品字段存储,不用做索引。通常为商家侧的商品id,商家需自动维护好out_product_id和平台侧生成的product_id之间对应关系。 |
product_type | number | 是 | 券类型。1. 代金券;2. 兑换券;3. 次卡。创建后不支持修改。 |
product_name | string | 是 | 名称(最少3字符,最多60字符) |
category_id | string(uint64) | 是 | 三级类目id,通过接口[获取所有的类目 |
brand_id | string(uint64) | 是 | 品牌id,店铺可用接口通过[[获取生效中的品牌资质列表 |
head_imgs | array<string> | 是 | 主图。必使用接口[上传图片 |
product_qua_infos | array<ProductQuaInfos> | 否 | 商品资质列表,所创建的商品需核验其他资质时填入(如酒店房间含早餐);资质列表可参考[获取类目信息 |
verify_page | WxAppPath | 否 | 核销跳转出口。订单详情用户可前往小程序核销。如小程序核销流程无法满足体验规范的商家,将予以断播处罚。 |
verify_at_store | number | 否 | 是否支持到店核销。1. 支持;0. 不支持。不填则默认1.支持。当选择0.不支持时,订单页面将不展示核销二维码,且必须填写verify_page参数。 |
code_source_type | number | 是 | 1. 平台生成;2. 商家预存code,用户支付成功后平台发放。创建后不支持修改。 |
attr_kv_map | map<string, string> | 是 | 商品属性kv,具体字段参照团购商品结构体定义【代金券属性KV】或者【兑换券属性KV】小节 |
skus | array<SkuInfo> | 是 | 售卖单元,本接口不支持直接设置库存,请调用修改团购优惠库存的接口设置库存。 |
# 回包参数说明
参数 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
data.product_id | string(uint64) | 平台生成的商品id |
data.sku_ids | array<string(uint64)> | 和请求参数中的 sku列表顺序保持一致 |