logan

Appearance

1. 我的上级列表 ​

接口地址： /merchantapi/distribution/agentrelation/myParentList

请求方式： POST

请求参数：

参数名类型必填说明
statusint是0=待审核，1=已通过，-1=已拒绝， -2 全部 2026-2-5 新增
keywordsstr否名称关键词：搜索上级货源所有者用户 ID 或上级货源店铺名称 2026-2-5 新增
sourceint否来源：0/不传=全部，1=上级货源（对接码），2=大厅货源 2026-2-5 新增
pageint否页码
limitint否每页数量
  • 变更：2026-2-4 结果新增 contact 联系方式
  • 变更：2026-2-5 参数新增 status 状态 ：0=待审核，1=已通过，-1=已拒绝， -2 全部
  • 变更：2026-2-5 参数新增 keywords 名称关键词：搜索上级货源所有者用户 ID 或上级货源店铺名称
  • 变更：2026-2-5 参数新增 source 来源：0/不传=全部，1=上级货源（对接码），2=大厅货源
  • 变更：2026-8-1 结果新增 is_blacklist，表示当前商户是否已被该上级封禁

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 1,
        "user_id": 100, // 当前商户ID
        "parent_id": 50, // 上级商户ID
        "parent_username": "上级商户A", // 上级商户用户名
        "parent_shop_name": "上级商户A的店铺", // 上级商户店铺名称
        "source": 1, // 1=对接码代理，2=货源大厅代理
        "status": 1, // 0=待审核，1=已通过，-1=已拒绝
        "create_time": "2025-11-19 15:57:15", // 创建时间
        "agent_level_id": 1, // 代理级别标识，为2时为非直属代理，无法对此等级代理进行管控，除了能加分销黑名单
        "is_blacklist": 0 // 是否已被该上级封禁：0=否，1=是
      }
    ],
    "total": 3
  }
}

说明： 查看当前商户的所有上级代理关系。封禁不会删除原代理关系；当 is_blacklist=1 时，前端应优先展示“已封禁”，不能继续按 status=1 展示“已通过”。

2. 查看上级可代理商品 ​

接口地址： /merchantapi/distribution/agentrelation/goodsListByParentId

请求方式： POST

请求参数：

参数名类型必填说明
parent_idint是上级商户 ID
goods_idint否指定上级商品 ID；进入单个商品对接配置页时使用
pageint否页码
limitint否每页数量

变更 ：

2026-2-4 新增字段 goods_id、content、cate_name。对接商品时使用 goods_id

响应示例：

json
{
  "code": 1,
  "msg": "获取成功",
  "data": {
    "list": [
      {
        "id": 1,
        "goods_id": 1, // 2026-2-4新增
        "content": "", // 2026-2-4新增 商品详情介绍
        "remark": "", // 商品使用说明
        "cate_id": 12, // 上级商品分类 ID
        "goods_user_id": 1002, // 对接码货源商品所属商户 ID；大厅货源使用 user_id
        "cate_name": "", // 2026-2-4新增 商品分类名
        "name": "QQ币100元", // 商品名称
        "agent_price": "92.00", // 代理价格
        "stock": 1000, // 库存
        "is_docked": 0, // 是否已对接：0=未对接，1=已对接
        "is_blacklist": 0 // 是否被拉黑 0=否，1=是
        // ... 其他不重要信息可不在前端显示
      }
    ],
    "total": 50
  }
}

业务规则：

  • 必须存在代理关系才能查看
  • 对接码代理显示对应等级的商品
  • 货源大厅代理显示货源大厅开放的商品
  • 传入 goods_id 时仅返回该上级商品，供前端加载名称、成本、分类、描述和使用说明后进入对接配置
  • 被拉黑的商品无法对接，可提示为无权限[分销黑名单]
  • 当 is_docked=1 且 is_blacklist=1 同时存在时，应优先展示“无权限”；对接关系仅保留用于解除封禁后的状态恢复

3. 解除代理关系 ​

接口地址： /merchantapi/distribution/agentrelation/removeRelation

请求方式： POST

请求参数：

参数名类型必填说明
parent_user_idint是上级商户 ID

响应示例：

json
{
  "code": 1,
  "msg": "解除关系成功",
  "data": null
}

业务规则：

  • 解除关系前需满足以下条件：
    • 无未支付的订单
    • 无待处理的售后投诉（状态为 0 待商户处理、1 等待买家申请平台介入、2 平台介入中）
    • 无冻结中的资金
  • 解除关系后：
    • 删除代理关系记录
    • 已对接的商品统一软删除（移入回收站）
    • 递归处理所有下级代理商品（如果 C 对接了 B 的商品中关于 A 的商品，B 解除与 A 的关系时，C 的商品也会下架）
    • 通知上级商户
  • 软删除的商品在订单中仍能正常显示
  • 解除后可以立即重新对接
  • 商品处理通过队列异步执行，不会阻塞接口响应

错误文案（code=0）：

  • 存在未支付的订单，无法解除关系
  • 存在待处理的售后投诉，无法解除关系
  • 存在冻结中的资金，无法解除关系
  • 代理关系不存在