餐饮团购-创建/更新商品

更新时间 2024-07-24 02:58:49

我的收藏

用于创建和修改商品。

使用限制

无

接口说明

创建或更新商品，限制商品发布范围

限制为美食类目

限制为团购、代金券、次卡

对于同一服务商，相同的out_id会被认为是同一商品，重复创建会被覆盖(相当于修改)。

商品Product和Sku属性字段(attr_key_value_map)，需要通过商品模板接口获取

创建商品时设置金额与前端用户侧展示关系，见下图。

基本信息

HTTP URL	https://open.douyin.com/goodlife/v1/akte/goods/product/save/
HTTP Method	POST
申请权限	商品发布
权限要求	•需要申请权限，路径：抖音开放平台-开发者平台/服务商平台>控制台>应用详情>解决方案 •需要商家授权，路径：抖音来客>店铺管理>第三方应用授权

请求头

参数	描述	必须
Content-Type	application/json	是
access-token	根据这个地址获取的 token	是

请求参数

Body 请求

参数名称	参数类型	是否必传	参数描述
•product	ProductStruct	TRUE	商品
◦product_id	string	TRUE	商品 ID，创建时不必填写，更新时如有 out_id 可不填写
◦out_id	string	TRUE	外部商品 ID
◦product_name	string	TRUE	商品名
◦category_full_name	string	TRUE	品类全名，保存时不必填写
◦category_id	int	TRUE	三级品类id
◦product_type	int	TRUE	团购类型：（更新商品时不可修改） •1：团购套餐 •11：代金券 •15：次卡
◦biz_line	int	TRUE	业务线（更新商品时不可修改） •1：闭环开发者 •5：小程序
◦account_name	string	TRUE	商家名
◦sold_start_time	int64	FALSE	售卖开始时间(团购商品必填）
◦sold_end_time	int64	FALSE	售卖结束时间(团购商品必填）(到期自动下架)
◦out_url	string	FALSE	第三方跳转链接，小程序商品必填
◦pois	list	TRUE	店铺列表
▪poi_id	string	FALSE	poiID，技术服务商保存商品填写该字段(在来客的门店管理列表中)
▪supplier_ext_id	string	FALSE	接入方店铺id，代运营服务商保存商品选择poi_id或者supplier_ext_id其中一个字段填写
◦attr_key_value_map	map < string,string >	TRUE	商品属性 KV，填写时参考商品发布和查询能力。填写时查询“查询商品模板”接口，map的value中数据最后要改成json串
◦product_ext	struct	FALSE	商品额外信息
▪auto_online	bool	FALSE	true / null - 审核通过自动上架 false - 审核通过不自动上架
▪test_extra	struct	FALSE	测试商品信息
•uids	list<string>	FALSE	商品可见的用户UID列表，["123456"]，最多10个
•test_flag	bool	FALSE	标记商品是否为测试商品，当test_flag=true时， 1、uids数量需要大于0 2、小程序商品必须传trade_url 3、库存数不能大于50 若要取消测试标记：须指定test_flag=false
•sku	SkuStruct	TRUE	售卖单元
◦sku_id	string	TRUE	SKU ID，创建时不必填写
◦sku_name	string	TRUE	SKU 名
◦origin_amount	int	TRUE	原价，团购创建时如有 commodity 属性可不填，会根据菜品搭配计算原价，单位分。计算方式：菜品搭配x选n，菜品组价格从大到小排序，累加n个菜品组价格得出原价
◦actual_amount	int	TRUE	实际支付价格，单位分
◦stock	StockStruct	TRUE	库存信息
▪limit_type	int	TRUE	库存上限类型。 •1：有限库存 •2：无限库存，2 时 stock_qty字段无意义
▪stock_qty	int	TRUE	总库存，`limit_type=2` 时无意义
◦out_sku_id	string	FALSE	第三方 ID
◦status	int	TRUE	状态，1 为在线；默认传1
◦attr_key_value_map	map < string,string >	FALSE	商品属性 KV，填写时参考商品发布和查询能力。
•account_id	string	TRUE	商家 ID，传入时服务商须与该商家满足授权关系

请求示例

json复制
{
  "account_id": "7113893944009705516",
  "product": {
    "account_name": "lh测试商家",
    "attr_key_value_map": {
      "appointment": "{\"need_appointment\":true, \"ahead_time_type\":2, \"ahead_hour_num\":5,\"external_link\":\"urlxxx\", \"order_appointment_time_url\":\"urlxxx\"}",
      "auto_renew": "true",
      "bring_out_meal": "false",
      "can_no_use_date": "{\"enable\": true,\"days_of_week\": [7, 1, 2, 3, 4],\"holidays\": [1, 2, 3, 4, 5],\"date_list\": [\"2022-03-08\", \"2022-03-09\"],\"holiday_dates\": {\"1\": \"2022.01.01-2022.01.03\"}}",
      "customer_reserved_info": "{\"allow\":false}",
      "description_rich_text": "[{\"note_type\":1,\"content\":\"其他说明信息-美食团购\"}]",
      "detail_image_list": "[{\"url\":\"https://aweme-upload-image/7038504987084734508..png\"}]",
      "dishes_image_list": "[{\"url\":\"https://aweme-upload-image/7038504987084734508.png\"}]",
      "environment_image_list": "[{\"url\":\"https://aweme-upload-image/7038504987084734508.png\"}]",
      "free_pack": "true",
      "FrontCategoryTag": "[\"美食套餐\"]",
      "image_list": "[{\"url\":\"https://aweme-upload-image/7038505021658382380.png\"},{\"url\":\"https://aweme-upload-image/7038505050439696428.png\"}]",
      "IndustryType": "其他",
      "IsConfirmImme": "true",
      "Notification": "[{\"title\":\"标题\",\"content\":\"内容美食1.1\"}]",
      "private_room": "true",
      "real_name_info": "{\"enable\":false,\"scene\":0}",
      "RecommendWord": "推荐语",
      "rec_person_num": "99",
      "rec_person_num_max": "999",
      "RefundPolicy": "2",
      "refund_need_merchant_confirm": "true",
      "show_channel": "2",
      "SortWeight": "0",
      "superimposed_discounts": "true",
      "TagList": "标签列表-待填写",
      "use_date": "{\"use_date_type\":1,\"use_start_date\":\"2021-12-06\",\"use_end_date\":\"2033-03-03\"}",
      "use_time": "{\"use_time_type\":1}",
      "account_name": "lh测试商家",
      "poi_list": "[{\"poi_id\": \"123123123123\"}]",
      "product_name": "migrate_openapi_0711_01",
      "sold_start_time": "1646724999",
      "sold_end_time": "1745607528"
    },
    "biz_line": 1,
    "category_id": 1001001,
    "out_id": "migrate_openapi_0711_03",
    "pois": [
      {
        "poi_id": "123123123123"
      }
    ],
    "product_name": "migrate_openapi_0711_03",
    "product_type": 1,
    "sold_end_time": 1745607528,
    "sold_start_time": 1646724999,
    "telephone": ["1234-4321"]
  },
  "sku": {
    "actual_amount": 996,
    "attr_key_value_map": {
      "code_source_type": "1",
      "commodity": "[{\"group_name\":\"测试0001\",\"total_count\":1,\"option_count\":1,\"item_list\":[{\"name\":\"可乐\",\"price\":1998,\"count\":1,\"unit\":\"份\"}]}]",
      "limit_rule": "{\"is_limit\":true,\"total_buy_num\":9}",
      "market_price": "900",
      "settle_type": "1",
      "use_type": "1",
      "stock_info": "{\"limit_type\": 1,\"stock_qty\": 500}"
    },
    "origin_amount": 1399,
    "sku_name": "测试",
    "status": 1,
    "stock": {
      "limit_type": 1,
      "stock_qty": 500
    }
  }
}

响应参数

参数名称	参数类型	是否必传	参数描述
•base	struct	TRUE	公共参数
◦logid	string	TRUE	请求日志ID
◦gateway_code	i32	TRUE	网关状态码
◦gateway_msg	string	TRUE	网关状态信息
◦biz_code	i32	TRUE	业务状态码
◦biz_msg	string	TRUE	业务状态信息
•data	struct	TRUE	响应信息
◦error_code	int	TRUE	错误码
◦description	string	TRUE	错误描述
◦product_id	string	TRUE	创建/更新商品成功后产生，与老接口spu_id一致预售绑定bind_sku取此字段
•extra	struct	TRUE	响应额外信息
◦error_code	int	TRUE	错误码
◦description	string	TRUE	错误描述
◦sub_error_code	int	TRUE	（弃用）子错误码
◦sub_description	string	TRUE	（弃用）子错误描述
◦now	int	TRUE	（弃用）时间戳
◦logid	string	TRUE	请求日志ID

响应示例

正常示例

json复制
{
  "data": {
    "error_code": 0,
    "description": "success",
    "product_id": "xxxxxxxxxx"
  },
  "extra": {
    "error_code": 0,
    "description": "success",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "xxx",
    "now": 1651113600
  }
}

错误码

HTTP 状态码	错误码	错误消息	排查建议
200	2190002	access_token 无效	调用接口重新生成access_token
200	2190004	应用未获得该能力, 请去 https://open.douyin.com/ 申请	应用申请接口权限
200	2190008	access_token 过期,请刷新或重新授权	规范 token 刷新机制，检查是否有测试环境在同步刷新 token
200	2119001	参数不合法	更换参数
200	2119002	系统繁忙，请稍候再试	重试
200	2119003	请求太过频繁，请稍后再试	重试
200	2119005	应用未获商家授权	联系合作商家在商家后台发起授权，并在服务商后台同意授权
200	3000001	根据实际业务错误返回	对照接口文档规范参数并重试
200	4000001		补充参数
200	4000002		对照接口文档规范参数并重试
200	5000001		联系抖音处理