# 添加团购优惠

通过本接口可以创建本地团购优惠。创接口不支持直接设置库存,请在创建完成后调用库存管理接口进行设置。

# 接口调用请求说明

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列表顺序保持一致