## 背景 商家有自己的销售员工管理系统或者推广员管理系统，并且想要使用小鹅通的推广员功能，可以通过小鹅云的开放的API接口对接实现双方系统数据打通。 备注：请在小鹅云-控制台申请推广员相关权限集 ## 业务场景 **名词解释** |名词|解释| |:-----|----- | |推广员 |商家可招募店铺用户成为推广员，推广员可分享商品绑定客户，对客户进行维系并促进客户成交，客户成交后，推广员可获得相应的奖励。| |下级推广员 |推广员可帮助商家邀请更多的推广员加入，受邀请的推广员为其下级推广员| |推广订单 |客户通过推广员分享的商品链接进入并进行购买后生成的订单，为该推广员的推广订单| |客户绑定关系 |客户绑定关系指推广员与小鹅通用户绑定的客户关系，如用户A是推广员的客户，即称用户A与推广员绑定了客户关系| **对接场景** 当前支持实现小鹅通系统与商家自有系统的推广员信息双向同步，并且支持商家自有系统同步获取小鹅通系统推广订单数据  ### 场景一、获取小鹅通推广员数据 自有系统可以通过接口获取到小鹅通的全部推广员数据，包括推广员的列表信息、推广员的客户信息、推广员的下级推广员信息等 #### 调用接口流程 #### 涉及接口汇总 | 接口 | 接口描述 | | --- | --- | | [xe.distributor.list.get/1.0.0](https://api-doc.xiaoe-tech.com/api_list/promoter/xe_distributor_list_get.html) | 查询推广员列表 | | [xe.distributor.member.sub\_customer/1.0.0](https://api-doc.xiaoe-tech.com/api_list/promoter/xe_distributor_sub_customer.html) | 查询推广员的客户列表 | | [xe.distributor.sub.list.get/1.0.0](https://api-doc.xiaoe-tech.com/api_list/promoter/xe_distributor_sub_list_get.html) | 查询推广员的下级推广员列表 | | [xe.distributor.info.get/1.0.0](https://api-doc.xiaoe-tech.com/api_list/promoter/xe_distributor_info_get.html) | 查询指定推广员的信息 | ### 场景二、自有销售体系数据同步至小鹅通 可通过接口将自有系统的销售推广体系数据导入至小鹅通推广员中，包括导入推广员数据、导入推广员下级数据、绑定客户数据等 #### 调用接口流程 #### 涉及接口汇总 | 接口 | 接口描述 | | --- | --- | | [xe.user.register/1.0.0](https://api-doc.xiaoe-tech.com/api_list/user/register.html) | 注册新用户 | | [xe.distributor.member.add/1.0.0](https://api-doc.xiaoe-tech.com/api_list/promoter/xe_distributor_member_add.html) | 新增推广员 | | [xe.distributor.member.bind/1.0.0](https://api-doc.xiaoe-tech.com/api_list/promoter/xe_distributor_member_bind.html) | 推广员绑定客户 | | [xe.distributor.superior.set/1.0.0](https://api-doc.xiaoe-tech.com/api_list/promoter/xe_distributor_superior_set.html) | 设置推广员下级 | ### 场景三、推广订单数据同步至自有系统 可通过接口在用户下单后接收订单推送和获取推广订单数据，同步至自有系统中进行结算 #### 调用接口流程 #### 涉及接口汇总 | 接口 | 接口描述 | | --- | --- | | [订单消息推送](https://api-doc.xiaoe-tech.com/api_list/news_push/order_push.html) | 订单消息推送 | | [xe.distributor.order.get/1.0.0](https://api-doc.xiaoe-tech.com/api_list/promoter/xe_distributor_order_get.html) | 推广订单详情 |