接口说明

小程序商品：

通过/poi/v2/spu/sync接口同步 SPU 时，entry_info.entry_type为 2 且填充了entry_info.entry_miniApp参数的商品为小程序商品。其中entry_info.entry_miniApp.app_id为商品所属的小程序；
通过/life/goods/product/save/接口发布/创建团购商品时，product.biz_line传入值为 5 时的商品。
通过/goodlife/v1/goods/product/save/接口创建/修改团购活动，product.biz_line传入值为 5 时的商品。

抖音来客商品：商家（或该商家对应的代运营服务商）通过抖音来客创建的商品。
计划状态：一个定向佣金计划有以下三种状态：

状态	说明
进行中(1)	短视频定向计划：该计划发布成功，未到视频发布deedline时间，有待履约的指定达人该计划发布成功，已过视频发布deedline时间，有已发布视频的指定达人，且分佣时间未结束直播间定向计划：该计划发布成功，有待履约的指定达人（没有取消全部达人），且未被关停该计划发布成功，有已发布直播的指定达人，且未被关停
已完成(2)	短视频定向计划：该计划发布成功，已过视频发布deedline时间，有已发布视频的指定达人，且全部达人分佣时间已结束直播间定向计划：该计划发布成功，有已发布直播的指定达人，且商家关停了该计划
已取消(3)	短视频定向计划：商家手动操作取消指定达人合作已过视频发布时间，计划所有达人均未发布视频直播间定向计划：商家手动操作取消指定达人合作商家关停了该计划，计划所有达人均未发布直播

使用限制

没有代运营关系的商品使用条件如下：

商品所属的小程序须签署《撮合平台用户服务协议》
当调用接口的应用与商品存在以下任一关系时允许应用发布/修改该商品的通用佣金计划

开发者是商品所属的小程序
开发者是商品的创建者

具有代运营关系的商品使用条件如下：

开发者与商品归属的抖音来客商家建立代运营商服合作关系
开发者通过/goodlife/v1/partner/product_commission/save/接口设置商品的佣金，商家在抖音来客App确认该佣金比例

基本信息

名称	描述
HTTP URL	https://open.douyin.com/api/match/v2/poi/oriented_plan_list/
HTTP Method	POST
Scope	poi.cps.common
权限要求	需要申请权限移动/网站应用路径：抖音开放平台 > 控制台 > 移动应用/网站应用 > 应用详情 > 权限管理 > 特殊权限小程序路径：抖音开放平台 > 控制台 > 小程序 > 能力 > 授权 > 特殊权限不需要用户授权

请求参数

请求头

access-token必填String

示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

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

content-type必填String

示例：application/json

固定值"application/json"

Body展开全部子属性

spu_id_list必填List

示例：[7089334664648722476,7088277603718563884]

小程序商品 ID 列表，长度限制不超过 50 个

展开子属性

请求示例
curl --location --request POST 'https://open.douyin.com/api/match/v2/poi/oriented_plan_list/' \
--header 'access-token: clt.6f3d96edd825ef65463706f18***********************' \
--header 'Content-Type: application/json' \
--data-raw '{
    "spu_id_list": [
        7088277603718563884
    ]
}'

响应参数

Body展开全部子属性

data必填Struct

展开子属性

err_msg必填String

示例：系统内部错误，请重试

错误信息

err_no必填Int32

示例：0

错误码

log_id必填String

示例：20230712165544FF934AF2108A6BDA927F

请求关联日志ID

响应示例
正常响应示例异常响应示例
{
  "data": {
    "data": [
      {
        "plan_name": "哈哈哈",
        "product_list": [
          {
            "product_id": 7088277603718564000,
            "commission_rate": 2666
          }
        ],
        "status": 3,
        "talent_status_map": {
          "38377163415": 3
        },
        "commission_duration": 1000,
        "create_time": "2022-08-15",
        "plan_id": 7132086024917764000,
        "start_time": 1661135340,
        "update_time": "2022-08-15",
        "content_type": 1,
        "douyin_id_list": [
          "38377163415"
        ],
        "end_time": 1661937164,
        "create_time_unix": 1696949518,
        "update_time_unix": 1696949518
      },
      {
        "start_time": 0,
        "status": 3,
        "talent_status_map": {
          "67426157743": 3,
          "38377163415": 3
        },
        "commission_duration": 1,
        "content_type": 2,
        "douyin_id_list": [
          "38377163415",
          "67426157743"
        ],
        "plan_id": 7130537699240659000,
        "plan_name": "哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈哈",
        "product_list": [
          {
            "product_id": 7088277603718564000,
            "commission_rate": 2666
          }
        ],
        "update_time": "2022-08-11",
        "create_time": "2022-08-11",
        "create_time_unix": 1696949518,
        "update_time_unix": 1696949518,
        "end_time": 0
      }
    ],
    "page_count": 1,
    "total_count": 57
  },
  "err_msg": "",
  "err_no": 0,
  "log_id": "20230712165544FF934AF2108A6BDA927F"
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	28001005	系统内部错误，请重试	发起抖音开放平台Oncall工单，务必提供如下信息：开发者所请求的Http路径、请求体信息、Http响应体信息中返回的log_id字段
200	28001007	参数不合法	自检请求参数是否符合接口文档的要求
200	28013011	暂无调用佣金计划相关接口的权限	自检小程序服务商的”生活服务代运营服务商“的行业身份是否认证成功
200	28013020	暂无操作该商品的权限	自检商品或计划绑定的商品与小程序对应的生活服务代运营服务商是否已建立商服合作关系

开发者文档

通过商品 ID 查询定向佣金计划

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

通过商品 ID 查询定向佣金计划在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

通过商品 ID 查询定向佣金计划