# 更新团购优惠

接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

接口英文名：updatelocalproduct

更新成功后，将通过「团购优惠更新回调」接口通知商家

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/product/locallife/update?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用

# 第三方调用

本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：129
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token、authorizer_access_token

# 请求体 `Request Payload`

参数名	类型	必填	示例	说明
product_id	string(uint64)	是		平台生成的id
product_type	number	是		券类型。1. 代金券；2. 兑换券；3. 次卡。创建后不支持修改。
product_name	string	是		名称（最少3字符，最多60字符），中文文字/英文字母/数字，都各算1个有效字符数，且不得仅为数字或英文，不得含非法字符，允许的特殊字符集为：·~～!@#$%^&()！@#￥%……&（）\-_——=+[\]\\【】、{}\|｜;'；’:"：‘“”,./，。、<>?《》？°C\u00A0\u0020\u3000\u03B2\u2764\u3010\u3011\u300E\u300F\u25C6，最多60字符。合规商品标题举例： 1.糖醋排骨【预订价10元】； 2.CheddarCheese切达干酪； 3.百岁山天然矿泉水1L15瓶。不合规商品标题举例： 1.正宗五指毛桃根√； 2.Classic Whole Wheat； 3.便携式折叠扇第Ⅲ代； 4.iPhone 13； 5.Mac999
category_id	string(uint64)	是		三级类目id，通过接口[获取所有的类目
brand_id	string(uint64)	是		品牌id，店铺可用接口通过[获取生效中的品牌资质列表
head_imgs	array	是		主图。必使用接口[上传图片
product_qua_infos	object	否		商品资质列表，所创建的商品需核验其他资质时填入（如酒店房间含早餐）；资质列表可参考获取类目信息中的参数product_qua_list
verify_page	WxAppPath	否		核销跳转出口，订单详情页可跳转至商家小程序核销
verify_at_store	number	否	1	是否支持到店核销。1. 支持，0. 不支持。默认1.支持。当选择0.不支持时，订单页面将不展示核销二维码，且必须填写verify_page参数。
code_source_type	number	是		1. 平台生成；2. 商家自定义；3. 发券实时传code （实时发券模式暂不开放）。创建后不支持修改。
attr_kv_map	-	是		商品属性kv，具体字段参照结构体定义【代金券属性KV】或者【兑换券属性KV】小节
skus	array	是		售卖单元，更新时sku_id为必填项。本接口不支持直接设置库存数量，请调用修改团购优惠库存的接口设置库存数量。

# Body.product_qua_infos `Object Payload`

商品资质列表，所创建的商品需核验其他资质时填入（如酒店房间含早餐）；资质列表可参考获取类目信息中的参数product_qua_list

参数名	类型	必填	说明
qua_id	string	否	商品资质id，可参考获取类目信息接口中的product_qua_list[].qua_id字段
qua_url	array	否	商品资质图片列表（单个商品资质id下，最多10张）；必使用接口上传图片上传图片（参数resp_type=1），并将返回的img_url填入此处，不接受其他任何格式的图片url。若url曾经做过转换（ url前缀为mmecimage.cn/p/），则可以直接提交。

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	说明
errcode	number	错误码
errmsg	string	错误信息

# 4. 注意事项

本接口无特殊注意事项

# 5. 代码示例

请求示例

{
    "product_id": "15000000134007",
    "out_product_id": "test-out_id",
    "product_type": 1,
    "product_name": "测试商品改",
    "category_id": "1452",
    "brand_id": "2100000000",
    "head_imgs": [
        "https://mmecimage.cn/p/wx2b255582a7b4bfd0/HA7ukhipcfggnDP8l5EqCwX1YsvxMZwAFvoPNqG-IbU",
        "https://mmecimage.cn/p/wx2b255582a7b4bfd0/HO7eONXc8Y9uLHr0q0Rs6UvJ0iC0oAuQD3whJEA5Sc4",
        "https://mmecimage.cn/p/wx2b255582a7b4bfd0/HKBXBm8pze5WcayaDacjfSveBYQIQzKrVaR3zi2tja4"
    ],
    "verify_page": {
        "appid": "wxca8d4b8e8feedc2a",
        "path": "main/channels/buy/buy.html?productId=123"
    },
    "code_source_type": 1,
    "attr_kv_map": {
        "voucher_amount": "222",
        "use_date_rule": "{\"validate_type\":1,\"use_date\":{\"use_start_date\":\"2023-11-29\",\"use_end_date\":\"2023-12-15\"}}",
        "exclusive_date": "{\"days_of_week\":[]}",
        "settle_type": "2",
        "need_phone_num": "0",
        "bring_out_type": "1",
        "refund_policy": "0",
        "use_time": "{\"use_time_type\":1,\"time_periods\":[]}"
    },
    "skus": [
        {
            "sku_id": "1930992007",
            "sale_price": 111
        }
    ]
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok"
}

# 6. 错误码

此接口没有特殊错误码，可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

# 7. 适用范围

本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。