'/**
 * 推广专员接口
 * @author zhaoben
 * Class ApiCustomerController
 * @package frontend\\controllers
 */'

1.customer-lists 推广专员客户列表
( token , status_id='' , remove_reason_id='' , distribution_status_id='' , source_id='' , begin_time='' , end_time='' , keyword='' , time_order='' , time_order_sort='desc' , page=1 , page_size=10 , label_ids='' )

'/**
     * 推广专员客户列表
     * @author zhaoben
     * @param string $token 用户token
     * @param string $status_id 客户状态id
     * @param string $remove_reason_id 移除原因id
     * @param string $source_id 来源id
     * @param string $distribution_status_id 分配状态id
     * @param string $begin_time 开始时间
     * @param string $end_time 结束时间
     * @param string $keyword 搜索关键词
     * @param string $time_order 时间排序字段 created_at:录入时间|follow_up_next_time:下次跟进时间|follow_up_last_time:最后跟进时间|distribution_last_time:分配时间|protect_end_time:保护到期时间
     * @param string $time_order_sort 正序:asc 倒序(默认):desc
     * @param int $page 页数
     * @param int $page_size 每页数量
     * @param string $label_ids 标签ids 可单,多选,隔开
     * @return array|string
     * @throws Exception
     */'

2.customer-detail 录入客户信息详情
( token , customer_rec )

'/**
     * 录入客户信息详情
     * @author zhaoben
     * @param string $token 用户token
     * @param string $customer_rec 客户id rec
     * @return array|string
     * @throws Exception
     */'

3.customer-delete 录入详情页删除
( token , customer_rec )

'/**
     * 录入详情页删除
     * @author zhaoben
     * @param string $token 用户token
     * @param string $customer_rec 客户id_rec
     * @return array|string
     * @throws Exception
     */'

4.customer-distribution 录入详情页分配状态
( token , customer_rec , state )

'/**
     * 录入详情页分配状态
     * @author zhaoben
     * @param string $token 用户token
     * @param string $customer_rec 客户id rec
     * @param int $state 状态启用禁止(1禁止2启用)
     * @return array|string
     * @throws Exception
     */'

5.add-customer 推广人员录入
( token , contactName , source_id , consulting_business_id=0 , city_id='' , county_id='' , contactMobile='' , qq='' , wechat='' , telphone='' , qrcode='' , email='' , remark='' , info_category=0 , company_name='' , introducer_name='' , dept_id='' , distribution_last_user_id='' )

'/**
     * 推广人员录入
     * @param string $token 用户token
     * @param string $contactName 联系人姓名
     * @param string $contactMobile 联系人电话
     * @param string $city_id 城市id
     * @param string $county_id 区县id
     * @param string $qq QQ
     * @param string $wechat 微信
     * @param string $telphone 固话
     * @param string $qrcode 二维码
     * @param string $email 邮箱
     * @param int $consulting_business_id 咨询业务
     * @param string $remark 备注
     * @param int $source_id 信息来源
     * @param int $info_category 录入类别(0:优质客户,2:私有客户 默认0)
     * @param string $company_name 公司名称; 当录入人类别为0(优质客户)时可选,当录入类别为2(私有客户)时必填
     * @param string $introducer_name 介绍人姓名
     * @param string $dept_id 分配商务人员的部门ID,单独选择部门且不选择分配人员时,在部门内部分配
     * @param string $distribution_last_user_id 分配商务人员id(当source_id 信息来源id转介绍.必须录入分配商务人员id)
     * @return array|string
     * @throws \\yii\\db\\Exception|Exception
     * @author zhaoben
     */'

6.customer-list 推广管理者客户列表
( token , category , status_id='' , remove_reason_id='' , source_id='' , distribution_status_id='' , inputer_id='' , consulting_business_id='' , begin_time='' , end_time='' , allocation_begin_time='' , allocation_end_time='' , keyword='' , province_id='' , city_id='' , area_id='' , time_order='' , time_order_sort='desc' , page=1 , page_size=10 , label_ids='' )

'/**
     * 推广管理者客户列表
     * @author zhaoben
     * @param string $token 用户token
     * @param int $category (0推广录入,1木牛录入,2私有 ,3精准)
     * @param string $status_id 客户状态id
     * @param string $remove_reason_id 移除原因id
     * @param string $source_id 来源id
     * @param string $distribution_status_id 分配状态id
     * @param string $inputer_id 录入人ID
     * @param string $consulting_business_id 咨询业务ID
     * @param string $begin_time 录入开始时间
     * @param string $end_time 录入结束时间
     * @param string $allocation_begin_time 分配开始时间
     * @param string $allocation_end_time 分配结束时间
     * @param string $keyword 搜索关键词
     * @param string $province_id 省ID
     * @param string $city_id 城市ID
     * @param string $area_id 地区ID
     * @param string $time_order 时间排序字段 created_at:录入时间|follow_up_next_time:下次跟进时间|follow_up_last_time:最后跟进时间|distribution_last_time:分配时间|protect_end_time:保护到期时间
     * @param string $time_order_sort 正序:asc 倒序(默认):desc
     * @param int $page 页数
     * @param int $page_size 每页数量
     * @param string $label_ids 标签ids 可单,多选,隔开
     * @return array|string
     * @throws Exception
     */'

7.edit-customer-base-info 修改客户基础信息
( token , customer_rec , introducer_name='' , source_id='' , consulting_business_id='' , area_city_id='' , area_county_id='' , remark='' )

'/**
     * 修改客户基础信息
     * @param $token
     * @param string $customer_rec 客户REC
     * @param string $introducer_name 介绍人姓名
     * @param string $source_id 来源ID
     * @param string $consulting_business_id 咨询业务ID
     * @param string $area_city_id 城市ID
     * @param string $area_county_id 地区ID
     * @param string $remark
     * @return string
     */'

8.form 上传
( token , formData='' , info_category='0' )

'/**
     * 上传
     * @author zhaoben
     * @param string $token 用户token
     * @param string $formData 文件(联系人、手机号码、QQ号,微信、[三种联系信息必选其一]
     * 来源[1.400电话,2.百度推广,3.微信群,4.转介绍,5.商务挖掘]、
     * 咨询业务[1.代理记账,2.知识产权],备注)
     * @param string $info_category 录入类别(0:优质客户,2:私有客户 默认0)
     * @return array|string
     * @throws
     */'

9.async-upload 上传导入 异步分配
( token , excel='' , info_category='0' )

'/**
     * 上传导入 异步分配
     * @param string $token token
     * @param string $excel form-data上传文件(键值为excel)
     * @param string $info_category
     * @return array|string
     * @throws Exception
     */'

10.import 导入
( token , path , info_category='0' )

'/**
     * 导入
     * @author zhaoben
     * @param string $token 用户token
     * @param string $path 文件
     * @param string $info_category 录入类别(0:优质客户,1:公海客户,2:私有客户 默认0)
     * @return array|string
     * @throws
     */'

11.customer-distribution-switch 开启活关闭某个客户分配
( token , customer_rec , distribution_status_id='2' )

'/**
     * 开启活关闭某个客户分配
     * @author zhangzhi
     * @param string $token 用户Token
     * @param string $user_rec 客户rec
     * @param string $distribution_status_id 状态ID 1暂停分配 2正常分配
     * @return array|string:json
     */'

12.input-tips ims推广录入手机号判断提示
( token , mobile )

'/**
     * ims推广录入手机号判断提示
     * @param string $token Token
     * @param string $mobile 手机号
     * @return array|string
     * @throws Exception
     */'