抖音开放平台Logo
开发者文档
控制台
  • 接入前准备
  • 通用能力
  • 门店管理
  • 团购核销
  • 团购对账
  • 会员接入
  • 订单查询
  • 三方码
  • 商品发布
  • 创建/更新商品接口
  • 免审修改商品接口
  • 上下架商品
  • 同步库存
  • 创建/更新多SKU商品的SKU列表
  • 创建适用人群
  • 商品状态变更通知
  • 代运营
  • 团购退款
  • 商品查询
  • 餐饮
  • 大交通
  • 酒旅
  • 综合
  • 历史版本文档(不推荐)
  • 创建/更新商品接口

    收藏
    我的收藏
    用于创建和修改商品。​

    接口说明

    1. 创建或更新商品。​
    2. 2.​对于同一服务商,相同的out_id会被认为是同一商品,重复创建会被覆盖(相当于修改)。​
    3. 3.​商品和SKU属性字段(attr_key_value_map ),需要通过【查询商品模板接口】(https://developer.open-douyin.com/docs/resource/zh-CN/local-life/develop/OpenAPI/general-capabilities/product-query/template.get)获取​
    4. 4.​新增商品二级类型参数 product_sub_type (仅小程序酒旅预售应用)​
    5. 5.​创建商品时设置金额与前端用户侧展示关系,见下图。​
    1. 5.​顺序:先上预订商品,再上预售商品,上预售商品时通过 bind_skus 字段关联。​
    1. 6.​注意:如果预售券为多预订商品多门店的通兑券,则需要在 bind_skus 中绑定多门店的预订商品,且在 pois(适用门店)字段中传入对应预订商品所属的 POI_IDs。​

    基本信息

    名称描述
    HTTP URL
    https://open.douyin.com/goodlife/v1/goods/product/save/
    HTTP Method
    POST
    Scope
    life.capacity.goods.found
    权限要求

    商品发布

    请求参数

    请求头
    access-token必填String
    示例:clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ
    content-type必填String
    固定值"application/json"
    Body展开全部子属性
    product必填Struct
    展开子属性
    account_idString
    商家id
    BaseStruct
    展开子属性
    skuStruct
    单sku商品必传;多sku商品不传,需要单独通过sku接口保存
    展开子属性
    skusList
    展开子属性
    请求示例
    { "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 } } }

    响应参数

    Body展开全部子属性
    BaseResp必填Struct
    展开子属性
    dataStruct
    展开子属性
    extraStruct
    展开子属性
    响应示例
    正常响应示例异常响应示例
    { "data": { "error_code": 0, "description": "success", "product_id": "111" }, "extra": { "error_code": 0, "description": "success", "sub_error_code": 0, "sub_description": "", "logid": "xxx", "now": 1651113600 } }

    错误码

    HTTP 状态码错误码错误码描述排查建议
    2002100001
    未知错误
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    2002100004
    系统繁忙,此时请开发者稍候再试
    重试接口,重试3次仍报错联系抖音生活服务技术支持
    2002100005
    参数不合法
    更换参数
    2002190002
    access_token无效
    调用接口重新生成access_token
    2002190004
    应用未获得该能力, 请去https://open.douyin.com/申请
    应用申请接口权限
    2002190008
    access_token过期,请刷新或重新授权
    规范token刷新机制,检查是否有测试环境在同步刷新token
    2002119001
    参数不合法
    更换参数
    2002119002
    系统繁忙,请稍候再试
    重试
    2002119003
    请求太过频繁,请稍后再试
    重试
    2002119005
    应用未获商家授权
    联系合作商家在商家后台发起授权,并在服务商后台同意授权
    2003000001
    根据实际业务错误返回
    对照接口文档规范参数并重试
    2004000001
    根据实际业务错误返回
    补充参数
    2004000002
    根据实际业务错误返回
    对照接口文档规范参数并重试
    2005000001
    根据实际业务错误返回
    联系抖音处理
    2002137000328
    当前商品归属账户-%v,和门店无认领或使用关系,确认入参信息或者绑定账户和门店的关系,添加门店失败数量为:%d, 失败门店ID为:%s
    检查失败门店是否被认领,更换门店相关参数
    2005000001
    服务器打瞌睡了,请稍后再试。
    2003000001
    以实际错误信息为准