1. 主要涉及中台的分销员规则管理、分销员管理模块、分销员业绩管理、特殊商品分佣管理。小程序端涉及的主要有佣金信息的查询，提现信息的查询、申请功能，客户明细信息列表。

涉及PDD接口

无

数据库设计

image.png

中台分销规则管理

分销规则的新增-POST /distributionsetting/savesetting

这块接口表和代码可以用原有的，区分不同商户校验规则 参考接口：distributionsetting/savesetting 改动点： 互联网商户的设置规则条件放宽

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    body：

    ```json { ….. “distributionrecruitsetting”:{
    1.   [新增]"recruitenable":"false/true"
    }, “distributionrulesetting:”:{
    1. .....
    [新增]”adaptivechannel”:”适配渠道：pdd-拼多多 selfsupport-自营” …. } …..

}

  1. <a name="lc7Qt"></a>
  2. ### response:
  3. <a name="zGi1j"></a>
  4. #### body：
  6. ---
  8. <a name="QoBk3"></a>
  9. ## 分销规则的更新-`POST distributionsetting/updatesetting`
  10. > 这块接口表和代码可以用原有的，改动点同上
  11. > 参考接口：distributionsetting/updatesetting
  13. <a name="eGZlC"></a>
  14. ### request:
  15. <a name="lxJtI"></a>
  16. #### header：
  18. - `content-type=appliation/json` 
  19. - `token=登录令牌token`
  20. <a name="xn8ps"></a>
  21. #### body：
  22. ```json
  23. {
  24.     .....
  25.   "distributionrecruitsetting":{
  26.         [新增]"recruitenable":"false/true"    
  27.     },
  28.   "distributionrulesetting:":{
  29.       .....
  30.      [新增]"adaptivechannel":"适配渠道：pdd-拼多多 selfsupport-自营"
  31.     ....
  33.   }
  34.   .....
  36. }

response:

body：

分销规则详情查询-GET /distributionsetting/detail

这块接口表和代码可以尝试用原有的，需要添加一下新的参数 参考接口：/distributionsetting/detail

request:

header：

  • content-type=appliation/json

  • token=登录令牌token

    param：

    1. 无

    response:

    body：

    1. {
    3. ........
    4. "distributionrecruitsetting":{
    5.       [新增]"recruitenable":"false/true"    
    6.   },
    7.   "distributionrulesetting":{
    8.         .....
    9.       [新增]"adaptivechannel":"适配渠道：pdd-拼多多 selfsupport-自营"
    10.          .....
    11.   }
    12.   .......
    13. }

中台分销人员管理

分销人员列表分页查询（4个接口）-POST

这块接口表和代码可以用原有的 这块源码对应了4个接口， 参考接口：

  • distributorinfo/getnormaldistributors
  • distributorinfo/getauditdistributor
  • distributorinfo/getrejectdistributor
  • distributorinfo/getlockdistributor

分销人员信息详情-POST /distributorinfo/detail

这块接口复用原有 参考接口：/distributorinfo/detail 后端改动：修改了自动可提现、手动可提现金额sql

分销人员下级分销员信息列表-POST /distributorinfo/getsubdistributor

这块接口表和代码可以用原有的 参考接口：/distributorinfo/getsubdistributor

分销人员信息中台管理员注册（保存）-POST distributorinfo/registerbyadmin

这块接口表和代码可以用原有的 参考接口：distributorinfo/registerbyadmin

分销人员信息编辑-POST distributorinfo/update

这块接口表和代码可以用原有的 参考接口：distributorinfo/update

分销人员清退-POST distributorinfo/fire

这块接口表和代码可以用原有的 参考接口：distributorinfo/fire

分销人员信息冻结-POST distributorinfo/lock

这块接口表和代码可以尝试用原有的 参考接口：distributorinfo/lock

分销人员信息审核通过-POST distributorinfo/normal

这块接口表和代码可以尝试用原有的-注意会发一个wx通知，这块不知道要不要改 参考接口：distributorinfo/normal

分销人员信息审核不通过-POST distributorinfo/reject

这块接口表和代码可以用原有的 参考接口：distributorinfo/reject

解除上下级分佣绑定-POST distributorinfo/unbind

这块接口表和代码可以尝试用原有的 参考接口：distributorinfo/unbind

中台分销员业绩管理

分销员业绩列表查询-POST /distributorinfo/getdisperformpage

只查询了分销员信息列表的信息 参考接口：distributorinfo/getdisperformpage

分销员业绩详情-POST /distributorinfo/detail

分销员详情：总佣金、交易佣金、下级分佣、待提现金额 参考接口：distributorinfo/detail

交易分佣订单-POST /commissionorder/getbyb2b

后端改造：重写查询sql，联pdd订单表查询订单状态 参考接口：commissionorder/getbyb2b

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    body：

    1. {
    2.   【新增】"orderstatus":"订单状态: 下拉列表从订单状态枚举接口中获取"
    3. }

    response:

    body：

    1. {
    2. //......
    3. [新增]"originalorderstatus":"pdd订单状态 0-已支付；1-已成团；2-确认收货；3-审核成功；4-审核失败（不可提现）；5-已经结算 ;10-已处罚"
    4.   //......
    5. }

下级分佣订单-POST /commissionorder/getsuperiorbyb2b

后端改造：重写查询sql，联pdd订单表查询订单状态 参考接口：commissionorder/getsuperiorbyb2b

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    body：

    1. {
    2.   【新增】"orderstatus":"订单状态: 下拉列表从订单状态枚举接口中获取"
    3. }

    response:

    body：

    1. {
    2. //......
    3. [新增]"originalorderstatus":"pdd订单状态 0-已支付；1-已成团；2-确认收货；3-审核成功；4-审核失败（不可提现）；5-已经结算 ;10-已处罚"
    4.   //......
    5. }

中台分佣特殊商品

特殊分佣商品列表信息查询-POST /commissionsku/list

列表中的商品名称字段需要通过从pdd数据库中获取 改造方式：接口使用原接口，通过添加if-else方式更改商品查询方式 参考接口：/commissionsku/list

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    body：

    response:

    body：

    1. {
    2. //......
    3. [新增]"status":"商品状态字段"
    4.   //......
    5. }

特殊分佣商品列表信息导出-POST

原系统的导出仅仅是前端页面的导出 参考接口：

特殊分佣商品详情（等级分佣设置）-POST /commissionsku/getgradesetting

原系统接口无需改动 参考接口：/commissionsku/getgradesetting

特殊分佣商品新增-POST /commissionsku/save

使用原系统接口 后端改造点：新增特殊分佣商品时对商品的校验逻辑修改-自营走自营判断，pdd走pdd商品库校验 参考接口：/commissionsku/save

distribution/commissionsku/getgradesetting

特殊分佣商品删除-POST /commissionsku/delete

原系统接口无需改动 参考接口：/commissionsku/delete

可选作特殊分佣商品的商品列表查询-POST

新增接口-可以使用pdd商品列表接口查询-@洪雷

特殊分佣商品等级分佣比例修改-POST commissionsku/update

原接口无需修改 参考接口：commissionsku/update

中台分佣提现管理

*提现申请记录列表-POST /withdraw/listbypage

可能需要改，用户成为分销员->店铺（源码没有创建逻辑） 参考接口：/withdraw/listbypage

完成提现-POST /withdraw/completewithdraw

需要后端修改：完成提现相应的分佣订单状态修改的sql 参考接口：/withdraw/completewithdraw

取消提现-POST withdraw/cancelwithdraw

需要后端修改：取消提现分佣 的SQL判断修改 参考接口：/withdraw/cancelwithdraw

小程序端分销员注册邀请模块

小程序招募功能状态查询-GET /distributionsetting/getrecruitenable

新增小程序招募开关 参考接口：无

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    param：

    1. 无

    response:

    body：

    1. true/false

邀请分销员太阳码获取-POST distributorinfo/getinvitationinfo

邀请其他用户成为分销员的太阳码获取 后端改动极大， 由于切换了小程序，appSecret都不一样

参考接口：distributorinfo/getinvitationinfo

获取分销员必填信息-GET /distributionsetting/getinfosettings

无需修改 参考接口：/distributionsetting/getinfosettings 这个接口是扫码后调用的——-getscenebyid

小程序注册分销员-POST distributorinfo/registerbyminiapp

后端修改：前端不会发送短信，校验移除短信校验 参考接口：distributorinfo/registerbyminiapp

小程序端分销员基本信息模块

分销员状态信息获取-GET distributorinfo/status

不用修改 参考接口：distributorinfo/status

分销员详细信息获取-GET distributorinfo/detailinfo

不用修改 参考接口：distributorinfo/detailinfo

小程序端提现模块

申请提现-POST /distribution/withdraw/apply

锁定可提现的订单sql修改 参考接口：/distribution/withdraw/apply

提现记录列表-POST /distribution/withdraw/listbyvernier

不用修改 参考接口：/distribution/withdraw/listbyvernier

小程序端客户模块

客户信息列表-POST /distributorinfo/getcommissionmemberbycursor

客户是指，通过我分享的商品链接下单的用户。 接口地址：getcommissionmemberbycursor

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    body：

    response:

    body：

    1. {
    2.   .........
    3. [新增]"status":"锁粉状态:expired-已失效 locking-锁粉中 "
    4. [新增]"commissionnum":"有效订单数"
    5.   [新增]"commissionamount":"佣金"
    6.    .........
    7. }

客户订单明细列表-POST /commissionorder/getmemberbycursor

客户订单明细列表-会员分佣订单接口复用 接口： /commissionorder/getmemberbycursor

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    body：

    response:

    body：

    1. {
    2. //......
    3. [新增]"ordersource":"订单渠道：pdd"
    4. //......
    5. }

客户绑粉-GET /distributorinfo/bindfansrelation

非分销员点击分享的商品链接，自动为客户和分销员记录关联关系 参考接口：无 如果分销员被清退，无法绑粉成功

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    param：

    1. dismemberid="分销员id"

    response:

    body：

    1. true/false

获取用户当前绑定的分销员id-GET /distributorinfo/getbindingdistributorid

用户直接进入我们的小程序情况，前端需要调用此接口获取单前绑定的分销员id 参考接口：无

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    param：

    1. 无

    response:

    body：

    1. "分销员id" 或 ""

小程序端分销订单模块

交易分佣订单明细列表-POST /commissionorder/getbycursor

小程序端查询 交易分佣订单明细列表，自己买的和通过自己分享的链接购买的两种订单 后端改造：修改sql联表查询pdd订单表，添加原始订单状态字段、订单渠道字段 接口：commissionorder/getbycursor

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    body：

  1. {
  2.       [非必]"ordersource":"订单来源 pdd-拼多多 selfsupport-自营"
  3.     [必]  "lastqueryid":"上次查询id 首次查询传0";
  4.     [必]  "size":"本次查询条数"
  5. }

response:

body：

  1. {
  2.   //......
  3.   [新增]"originalorderstatus":"pdd订单状态 0-已支付；1-已成团；2-确认收货；3-审核成功；4-审核失败（不可提现）；5-已经结算 ;10-已处罚",
  4.     [新增]"ordersource":"订单渠道：pdd"
  5.   //......
  6. }

下级分佣订单明细列表-POST /commissionorder/getsubbycursor

小程序端查询 下级分佣订单明细列表 改动点：后端联表查询原订单状态，新增订单来源字段 接口：commissionorder/getsubbycursor

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    body：

    response:

    body：

    1. {
    2. //......
    3. [新增]"originalorderstatus":"pdd订单状态 0-已支付；1-已成团；2-确认收货；3-审核成功；4-审核失败（不可提现）；5-已经结算 ;10-已处罚",
    4.   [新增]"ordersource":"订单渠道：pdd",
    5. [新增]"dismembername":"下级人员名称"
    6. //......
    7. }

累计订单明细列表-POST /commissionorder/getbycursor

小程序端 查询通过该分销员的交易分佣订单列表 此接口只关注页面中订单列表 复用原有的小程序端分佣订单接口并添加订单来源字段 接口名称：commissionorder/getbycursor

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    body：

    1. {
    2.     "ordersource":"订单来源(不填默认查询全部)：selfsupport-自营 pdd-拼多多"
    3. }

    response:

    body：

    1. {
    2. //......
    3. [新增]"originalorderstatus":"pdd订单状态 0-已支付；1-已成团；2-确认收货；3-审核成功；4-审核失败（不可提现）；5-已经结算 ;10-已处罚",
    4.   [新增]"ordersource":"订单渠道：pdd"
    5. //......
    6. }

累计订单推广业绩信息-GET /commissionorder/getspreadinfo

此接口用于查询累计订单明细页面中，订单金额和我的收入展示 由于这个页面分了两个tab页（自营渠道、第三方渠道），因此我这边需要提供接口手动计算各个渠道的 交易分佣金额

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    param：

    1. "ordersource"="订单来源：selfsupport-自营 pdd-拼多多"

    response:

    body：

    1. {
    2. "orderamount":"订单金额",
    3.   "myincome":"我的收入"
    4. }

    小程序端商品模块

    跳转PDD小程序链接生成-POST /distributorinfo/getpddspreadurl

    用户点击立即购买时，生成跳转pdd的链接

request:

header：

  • content-type=appliation/json
  • token=登录令牌token

    body：

    1. {
    2.   "dismemberid":"分销员id",
    3. "goodssign":"pdd商品标识"
    4. }

    response:

    body：

    1. {
    2.   "mobileurl":"推广链接，官方解释默认拉起小程序，但是实测是拉起APP",
    3. "mobileshorturl":"mobileurl的短链接",
    4. "url":"普通推广长链接 , 官方解释：唤起H5页面，但是实测这个链接拉起小程序",
    5. "shorturl":"url的短链"
    6. }