接口说明

创建/修改服务商商品佣金配置

1、创建服务商佣金配置，仅佣金属性为「商品自定义分佣」的商服合作才能调用此接口

2、调用此接口前，需先调用「发起商服合作」接口获取商服订单 order_id，及「获取商家团购商品」接口获取商品 product_ids

3、每次最多保存 50 个商品。

4、当待商家确认的商品数超过 100 时，不允许保存。

5、该接口近期会有部分逻辑更新（预计 23 年 1 月初），逻辑不同如下：更新前仅可保存 online_status = 1 的商品更新后可以保存以下状态的商品线上商品 online_status = 1-在线，2-下线草稿商品 draft_status = 10-审核中 20-商家审核中更新前，如果存在商品佣金小于达人佣金，接口会报错，保存失败。更新后，如果存在商品佣金小于达人佣金，接口不再返回错误码，而是 record_id = 0，且 invalid_item_list = 不合法的商品佣金列表，保存失败。

使用限制

SLA：支持的最大QPS:100;

基本信息

名称	描述
HTTP URL	https://open.douyin.com/goodlife/v1/partner/product_commission/save/
HTTP Method	POST
Scope	life.capacity.operation.commission
权限要求	代运营

请求参数

请求头

access-token必填String

示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

调用https://open.douyin.com/oauth/client_token/生成的token

content-type必填String

固定值"application/json"

Body展开全部子属性

order_id必填String

商服合作订单id，在创建商服合作时返回：/goodlife/v1/partner/order/create/

product_itemsList

商品佣金配置明细列表，每次最多50

展开子属性

请求示例
curl --location --request POST 'https://open.douyin.com/goodlife/v1/partner/product_commission/save/' \
--header 'content-type: application/json' \
--header 'access-token: 0801121846735352506a356a6' \
--data '{"order_id":"F5Vrnc1X6M","product_items":[{"alliance_commission_ratio":"cg4YjJRgL3","commission_mode":1,"product_id":"6SW42yCHxM","commission_ratio":"M6PQm46qSc"}]}'

响应参数

Body展开全部子属性

extra必填Struct

展开子属性

dataStruct

非法商品佣金列表

展开子属性

响应示例
正常响应示例异常响应示例
{
  "extra": {
    "error_code": 0,
    "description": "",
    "sub_error_code": 0,
    "sub_description": "",
    "logid": "20241219000201E24C82069E1EE55F6395",
    "now": 1734537721
  },
  "data": {
    "record_id": "FAMWyotoU6",
    "invalid_commission_product_list": [
      {
        "commission_ratio": "ErMTd82hbC",
        "alliance_commission_ratio": "NSilyPa9oY",
        "commission_mode": 1,
        "product_id": "Cd5vk0z6li"
      }
    ],
    "error_code": 0,
    "description": ""
  }
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	2100001	未知错误	重试接口，重试3次仍报错联系抖音生活服务技术支持
200	2100004	系统繁忙，此时请开发者稍候再试	重试接口，重试3次仍报错联系抖音生活服务技术支持
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	根据实际业务错误返回	联系抖音处理
200	2100005	参数不合法	确认order_id是否合法；商品佣金比例是否在（0，80]的范围内
200	5000001	服务器打瞌睡了，请稍后再试。
200	3000001	以实际错误信息为准

开发者文档

创建/修改佣金

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

创建/修改佣金在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

创建/修改佣金