抖音开放平台Logo
控制台

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

更新时间 2024-07-24 02:58:49
收藏
我的收藏
用于创建和修改商品。​

使用限制

无​

接口说明

    1.创建或更新商品,限制商品发布范围​
    a.限制为美食类目​
    b.限制为团购、代金券、次卡​
    2.对于同一服务商,相同的out_id会被认为是同一商品,重复创建会被覆盖(相当于修改)。​
    3.商品Product和Sku属性字段(attr_key_value_map),需要通过商品模板接口获取​
    4.创建商品时设置金额与前端用户侧展示关系,见下图。​

基本信息

HTTP URL​
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​
联系抖音处理​