"api工厂" 使用手册

api接口开箱即用,云后台管理,助力前端,解放后端开发;

不懂编程也能独立开发应用,小步快跑,快速创业!

旨为更懂你!

三级分销插件

前言


三级分销的使用前提是用户之间关系的建立,系统首先要明确某个用户是哪个用户邀请(发展)的,在系统中建立用户与用户的关系网络,才能在后续销售完成后根据关系进行返利。


所谓的三级分销,是指的返利层级最多为3级,当然通过将第二、第三级的返利设置为0 来实现一级分销;将第三级返利设置为0来实现2级分销。


用户的关系是如何建立的呢?请回顾以下章节:


《如何建立用户之间的邀请关系 / 邀请注册机制》


启用插件


  1. 如果你是免费会员户,有点小遗憾,暂时无法使用api工厂的插件功能;
  2. 如果你是专业版会员,那么登录后台,左侧菜单 “工厂设置” --> “插件管理” ,找到 “三级分销” 插件,在线购买开通即可;
  3. 如果你是增值版会员,那么无需做任何操作,你可以免费使用所有的插件功能;


启用模块


左侧菜单 “工厂设置” --> “模块管理” ,找到 “三级分销”  模块,启用模块后刷新页面,你将可以在左侧菜单中看到三级分销相关的菜单


分销设置


image


三级分销支持进行现金 / 积分返佣的形式,你可以根据你自己的实际需要,设置返现金或者返积分


如上图的设置:


  1. 一级返佣: 销售额50%28%
  2. 二级返佣: 销售额50%13%
  3. 三级返佣: 销售额50%9%


这里的设置是全局设置,上图中设置了所有商品销售额拿出 50% 来进行返佣分配,但是实际应用中,会有需求针对不同的商品进行单独的比例设置;

比如利润高的商品可以设置拿出60%来返佣;利润薄的商品只能拿出 30% 来返佣;


针对这种需求,你可以在商品管理,发布/编辑 商品的时候,针对商品单独设计这个比例;

商品设置了比例以商品设置为准;商品未设置比例的以这里的全局设置比例为准


关于分销商的说明


只有分销商才能得到返佣,如果是普通用户,还不是分销商身份,虽然可以正常建立用户关系,但是将拿不到返佣,继而也会影响到其上级分销商的返佣。


在左侧菜单 “用户管理” 中,可查看并设置某个用户的分销商身份


如何成为分销商


用户想成为分销商,有以下几种途径:


管理员手动调整


管理员在“用户管理”中,编辑某个用户,直接将其设置为分销商或者取消某用户的分销商身份;


用户申请后管理员审核


用户在小程序/网页/app中申请成为分销商,管理员在后台审核批准后,该用户成为分销商;


用户注册后自动成为分销商


通过设置下面的系统参数设置,使得新注册用户自动获得分销商身份

开关参数 REGISTER_OPEN_SELLER 设置为 开启状态


邀请指定数量用户自动升级


在分销设置中,可设置邀请n个用户以后,自动获得分销商身份


完成任务自助升级


在系统参数中,增加文本参数:upgrade_fxs_condition


配置如下 Json :

{
    fans: 100,
    fansLevel1: 10,
    orderNumber90Days: 100
}
  • fans 邀请人数(粉丝数)
  • fansLevel1 直属邀请人数(直属粉丝数)
  • orderNumber90Days 最近90天内结算订单数


上面的例子中,只要满足有100个粉丝数、直属粉丝10个,最近90天内建议笔数达到 100笔 即可自助升级成为分销商,而无需通过管理员审核


升级方法:

通过调用接口:/{domain}/saleDistribution/upgrade 自助完成升级


直接付费升级成为分销商


image.png

后台开启付费升级,届时用户即可通过接口直接购买开通分销商了


购买指定的分销商品获得分销商身份


image.png


相关接口


具体的接口及接口说明,请查阅接口文档,这里为了方便大家理解,简单的做了一下汇总:


读取后台分销设置


读取上图后台配置的分销设置信息,通过该接口,即可读取是否支持付费升级以及付费的金额

GET /{domain}/saleDistribution/setting

申请成为分销商


用户自助申请成为分销商

POST /{domain}/saleDistribution/apply/v2

查看申请进度


用户自助申请成为分销商后,可以通过该接口查询审核进度


GET /{domain}/saleDistribution/apply/progress/v2

完成任务自助升级为分销商

POST /{domain}/saleDistribution/upgrade

付费升级为分销商

POST /{domain}/saleDistribution/buy


查看我的团队

POST /{domain}/saleDistribution/members

查看佣金明细

POST /{domain}/saleDistribution/commision/log

查看订单详情


查看返佣订单详情信息

GET /{domain}/saleDistribution/order-info

获取待结算佣金统计

GET /{domain}/saleDistribution/commission/freeze


接口返回:


  • money 待结算佣金
  • mjtCommission 待返佣 mjt
  • mjtOrder 待赠送 mjt


分销商累计销售额排行榜

GET /{domain}/saleDistribution/sale-room-rank/total

分销商团队销售额排行榜

GET /{domain}/saleDistribution/sale-room-rank/team/total

查询某天的销售额排行榜

GET /{domain}/saleDistribution/sale-room-rank/daily

查询自己N天累计业务汇总

GET /{domain}/saleDistribution/statistics/days


接口返回:


  • number 订单总笔数
  • commisionAmount 佣金累计金额
  • saleroom 累计销售额


团队成员统计

GET /{domain}/saleDistribution/members/statistics



接口返回:


  • totleFans 全部粉丝人数
  • totleChildFxs 全部分销商人数
  • totleChildFxsLevel1 全部直属分销商人数
  • totleChildFxsLevel2 全部间接分销商人数


常见问题


没有产生返佣记录和佣金返现?


请按下面步骤进行排查:


  1. 检查 “三级分销插件” 是否在有效期?


前往 “工厂设置” --> “插件管理”,查看 “三级分销插件”,是否在有效期内;


  1. 检查分销设置是否正确


左侧菜单 --> 分销管理 --> 分销设置,检查返佣开关是处于开启状态,消费订单状态和 “到账类型” 设置的匹配;

计算订单金额 返佣比例,保留2位小数后的返佣金额大于0;*


3.返佣的金额计算方法


订单金额 商品返佣比例 * 能拿的佣金比例

计算结果必须大于0,否则不返佣*


  1. 分销商才可以享受返佣待遇


*A 邀请 B ,B 下单,A 没有拿到返佣,也没有看到返佣记录

那么,建议您此刻立马去 “用户管理” 里面,查看A 是否是分销商,只有分销商才能享受返佣

如果A 还不是分销商,请编辑该用户,把他(她)设置为分销商*


  1. 以上问题都已排查,还是没有返佣怎么办?


*接下来,我觉得我们应该去检查一下 A 到底是不是 B 的上线了:

前往用户管理,搜索框“邀请人编号”处输入A的用户编号,点击搜索,查看B在不在A的邀请人列表中

如果没有记录,说明 B 不是 A 邀请的,那么A自然就得不到返佣了*


  1. 用户关系何时建立?


《如何建立用户之间的邀请关系 / 邀请注册机制》


  1. 后期如何修改用户关系?


左侧菜单 --> 分销管理 --> 用户关系管理

可以将不想存在的用户关系删除,重建用户关系

请注意,用户关系错综复杂,重建用户关系需要有比较清晰的头脑,不建议一般用户手动调整关系而导致不可逆的数据错误!


举个例子, A 发展 B,B 发展 C, C 发展 D, D 发展 E

用户关系如下:

A 邀请 B 1级 关系;

A 邀请 C 2级 关系;

A 邀请 D 3级 关系;

B 邀请 C 1级 关系;

B 邀请 D 2级 关系;

B 邀请 E 3级 关系;

C 邀请 D 1级 关系;

C 邀请 E 2级 关系;

D 邀请 E 1级 关系;


也就是说,每个用户对应的需要建立 3 条关系,分别表示 直接上级、间接上级、间间接上级


如果不是很能理解这个概念的,不建议去调整用户关系!!!


  1. 返佣最多有几级?


最多三级!


D 把商品卖给 E ,那么 D 首先拿到一级返佣比例的返佣;C 拿二级; B拿三级;
虽然B是A发展的,但是返佣不能超过3级,所以A没有返佣


只要1级/2级分销怎么办?


你只要把第三级的返佣比例设置为0,那么相当于就是两级分销;

同理,你只要把 2、3 两级的返佣比例都设置为0,那么相当于就只有1级分销了;

Copyright © 杭州于芯科技有限公司

浙ICP备15041833号