接入前准备

通用能力

门店相关接口

团购核销

团购对账

会员接入

订单查询

三方码

商品发布

代运营

团购退款

商品查询

KA核销对账

餐饮

大交通

酒旅

综合

历史版本文档（不推荐）

创建/更新多SKU商品的SKU列表

我的收藏

用于创建多 SKU 商品。

使用限制

无

接口说明

1、创建团购活动列表。

2、团购/代金券不用对接这个接口。

基本信息

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

请求头

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

请求参数

Body 请求

参数名称	参数类型	是否必传	参数描述
product_id	string	FALSE	商品id
out_id	string	FALSE	商品外部id
skus	list < SkuStruct >	FALSE	SKU列表
- sku_id	string	TRUE	sku id，创建时不必填写
- sku_name	string	TRUE	sku名
- origin_amount	int	TRUE	原价，团购创建时可不填，会根据商品搭配计算原价，单位分
- actual_amount	int	TRUE	实际支付价格，单位分
- stock	StockStruct	TRUE	库存信息
-- limit_type	int	TRUE	库存上限类型，为2时stock_qty和avail_qty字段无意义 1-有限库存 2-无限库存
-- stock_qty	int	TRUE	总库存，limit_type=2时无意义
- out_sku_id	string	TRUE	第三方id
- status	int	TRUE	状态 1-在线 -1-删除
- attr_key_value_map	map < string,string >	FALSE	sku属性KV

请求示例

{
  "out_id": "hch-life-0314-rl03",
  "sku_list": [
    {
      "actual_amount": 1,
      "attr_key_value_map": {
        "Date": "20220423"
      },
      "origin_amount": 100,
      "sku_name": "20220423",
      "status": 1,
      "stock": {
        "limit_type": 0,
        "stock_qty": 500
      }
    },
    {
      "actual_amount": 1,
      "attr_key_value_map": {
        "Date": "20220524"
      },
      "origin_amount": 100,
      "sku_name": "20220524",
      "status": 1,
      "stock": {
        "limit_type": 0,
        "stock_qty": 500
      }
    }
  ]
}

响应参数

参数名称	参数类型	是否必传	参数描述
data	struct	TRUE	响应信息
- error_code	int	TRUE	错误码
- description	string	TRUE	错误描述
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

响应示例

正常示例

{
  "data": {
    "error_code": 0,
    "description": "success"
  },
  "extra": {
    "error_code": 0,
    "description": "success",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "xxx",
    "now": 1651113600
  }
}

异常示例

{
  "data": {
    "error_code": 2190002,
    "description": "access_token无效"
  },
  "extra": {
    "error_code": 2190002,
    "description": "access_token无效"
    "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		联系抖音处理

创建/更新多SKU商品的SKU列表在线调试

使用限制

接口说明

基本信息

请求头

请求参数

Body 请求

请求示例

响应参数

响应示例

正常示例

异常示例

错误码

创建/更新多SKU商品的SKU列表