'/**
 * 电子签约相关接口
 * Class ApiEsignController
 * @package frontend\\controllers
 */'

1.seach-company 便利查询
( companyName )

'/**
     * 便利查询
     * @param $companyName
     * @return array|string
     */'

2.send-verify-code 发送短信验证码(CPA/移动端)
( phone )

'/**
     * 发送短信验证码(CPA/移动端)
     * @param string $phone 手机号
     * @return array
     */'

3.code-type-list 获取证件类型列表(CPA/移动端)

'/**
     * 获取证件类型列表(CPA/移动端)
     * @return array
     */'

4.check-verify-code 手机验证
( sign_phone , verify_code )

'/**
     * 手机验证
     * @param string $sign_phone 手机号
     * @param string $verify_code 验证码
     * @return array|string
     */'

5.make-company-seal 企业人工审核后主动创建印章
( account_id , company_name )

'/**
     * 企业人工审核后主动创建印章
     * @param string $account_id
     * @param string $company_name 签约企业名字
     * @return array
     */'

6.auth-company 企业信息E签宝认证及验证码验证(CPA)
( token , company_name , code_idno , code_type , legal_name , legal_idno , sign_name , sign_phone , verify_code )

'/**
     * 企业信息E签宝认证及验证码验证(CPA)
     * @param string $token 用户标识
     * @param string $company_name 企业名称
     * @param int $code_idno 证件编号
     * @param string $code_type 证件类型,0组织机构代码证,1统一社会信用代码,2营业执照
     * @param string $legal_name 法人姓名
     * @param string $legal_idno 法人身份证号
     * @param string $sign_name 签署人姓名
     * @param string $sign_phone 签署人手机号
     * @param string $verify_code 手机验证码
     * @return array|string  成功返回E签宝账户ID
     * @throws
     */'

7.get-chance-info 业务机会签约 展示业务模板附件供下载 (CRM)
( token , business_chance_rec )

'/**
     * 业务机会签约 展示业务模板附件供下载 (CRM)
     * @param string $token token
     * @param string $business_chance_rec 业务机会rec
     * @return array|string
     * @throws \\Exception
     */'

8.chang-xie-callback 畅写OFFICE回调接口

'/**
     * 畅写OFFICE回调接口
     * @return array
     */'

9.get-saved-docx 尝试获取已保存的文档
( token , office_key )

'/**
     * 尝试获取已保存的文档
     * @param string $token
     * @param string $office_key
     * @return array|string
     */'

10.create-contract 业务机会签约 创建合同 (CRM)
( token , business_chance_rec , office_key='' )

'/**
     * 业务机会签约 创建合同 (CRM)
     * @param string $token token
     * @param string $business_chance_rec 业务机会REC
     * @param string $office_key 在线编辑Key
     * @return array|string
     * @throws \\Exception
     */'

11.update-contract 业务机会签约 更新合同 (CRM)
( token , contract_id , office_key )

'/**
     * 业务机会签约 更新合同 (CRM)
     * @param string $token token
     * @param string $contract_id 合同ID
     * @param string $office_key 在线编辑Key
     * @return array|string
     * @throws \\Exception
     */'

12.create-receivables 创建(或重新创建)收款计划 (CRM)
( token , contract_id , plan_name , plan_reason , payment_method , contract_total_amount , plan_list )

'/**
     * 创建(或重新创建)收款计划 (CRM)
     * @param string $token token
     * @param string $contract_id 合同ID
     * @param string $plan_name 计划名称
     * @param string $plan_reason 申请原因
     * @param string $contract_total_amount 合同总金额
     * @param array $plan_list 计划列表 [[date]=>当次收款日期, [amount]=>当次收款金额, [explain]=>当次收款说明], ...
     * @return array|string
     * @throws Exception
     * @throws \\Throwable
     */'

13.is-go-signed 检查是否已经发起签约
( token , contract_id )

'/**
     * 检查是否已经发起签约
     * @param string $token
     * @param string $contract_id
     * @return array|string
     */'

14.get-receivables 获取收款计划信息 (CRM)
( token , business_chance_rec )

'/**
     * 获取收款计划信息 (CRM)
     * @param $token
     * @param $business_chance_rec
     * @return array|string
     */'

15.go-sign-page 业务机会签约 拖放印章页面接口 (CRM)
( token , business_chance_rec )

'/**
     * 业务机会签约 拖放印章页面接口 (CRM)
     * @param string $token token
     * @param string $business_chance_rec 业务机会id
     */'

16.go-esign 发起电子签约 (成单前)
( token , contract_id , first_name , first_sign_name , first_sign_phone , first_sign_page , first_sign_coordinate , second_sign_page , second_sign_coordinate , sign_first )

'/**
     * 发起电子签约 (成单前)
     * @param string $token token
     * @param string $contract_id 新建的合同ID
     * @param string $first_name 甲方公司名称/签约人姓名
     * @param string $first_sign_name 甲方签署人姓名
     * @param string $first_sign_phone 甲方签署人手机号
     * @param string $first_sign_page 甲方印章所在页码 格式: 1|2|3
     * @param string $first_sign_coordinate 甲方印章坐标 格式: 150,300|182,332|175,366
     * @param string $second_sign_page 乙方印章页码 格式: 1|2|3
     * @param string $second_sign_coordinate 乙方印章坐标 格式: 150,300|182,332|175,366
     * @param int $sign_first 先签署方 (0:乙方 1:甲方)
     * @return array|string
     * @throws Exception
     */'

17.start-sign 发起签约(OA)
( token , contract_id , contract_title , order_id , master_path , first_name , first_sign_name , first_sign_phone , first_sign_page , first_sign_coordinate , second_sign_page , second_sign_coordinate , sign_first )

'/**
     * 发起签约(OA)
     * @param string $token 用户标识
     * @param string $contract_id 合同ID
     * @param string $contract_title 合同名称
     * @param string $order_id 订单ID
     * @param string $master_path 签约原文件PNG图片地址(json,每页一张图片)
     * @param string $first_name 甲方公司/个人名称
     * @param string $first_sign_name 甲方签署人姓名
     * @param string $first_sign_phone 甲方签署人手机号
     * @param string $first_sign_page 甲方印章签约页码
     * @param string $first_sign_coordinate 甲方签约坐标,(x,y)如  100,80
     * @param string $second_sign_page 乙方印章签约页码
     * @param string $second_sign_coordinate 乙方签约坐标,(x,y)如  100,80
     * @param int $sign_first 先签署方(0乙方先签,1甲方先签)
     * @return array|string
     * @throws
     */'

18.get-sign-info-by-contract-id 获取签约信息
( token , contractId )

'/**
     * 获取签约信息
     * @param string $token token
     * @param string $contractId 合同ID
     * @return array|string
     */'

19.urge-sign 催签提醒(OA)
( token , sign_id )

'/**
     * 催签提醒(OA)
     * @param string $token 用户标识
     * @param string $sign_id 签约标识
     * @return array|string
     * @throws
     */'

20.mobile-index 首页接口(移动端)
( link_code , m_token='' )

'/**
     * 首页接口(移动端)
     * @param string $link_code 短链接编码
     * @param string $m_token 登录令牌
     * @return array|string
     */'

21.mobile-login 登录/注册(移动端)
( link_code , login_phone , verify_code )

'/**
     * 登录/注册(移动端)
     * @param string $link_code 短链接编码
     * @param string $login_phone 手机号
     * @param string $verify_code 验证码
     * @return array
     */'

22.mobile-register 企业/个人信息提交(移动端)
( link_code , m_token , sign_type , sign_name , company_name='' , code_idno='' , code_type='' , legal_name='' , legal_idno='' , sign_idno='' )

'/**
     * 企业/个人信息提交(移动端)
     * @param string $link_code 短链接编码
     * @param string $m_token 登录令牌
     * @param string $sign_type 提交类型,1为企业,2为个人(必填)
     * @param string $sign_name 签署人姓名/个人姓名(必填)
     * @param string $company_name 企业名称,$sign_type=1时必填
     * @param string $code_idno 证件编号,$sign_type=1时必填
     * @param int $code_type 证件类型,0组织机构代码证,1统一社会信用代码,2营业执照,$sign_type=1时必填
     * @param string $legal_name 法人姓名,$sign_type=1时必填
     * @param string $legal_idno 法人身份证号,$sign_type=1时必填
     * @param string $sign_idno 个人身份证号,$sign_type=2时必填
     * @return array
     * @throws Exception
     */'

23.mobile-info 查看合同(移动端)
( link_code , m_token )

'/**
     * 查看合同(移动端)
     * @param string $link_code 短链接编码
     * @param string $m_token 登录令牌
     * @return array
     */'

24.mobile-seal 文件签约(移动端)
( link_code , m_token )

'/**
     * 文件签约(移动端)
     * @param string $link_code 短链接编码
     * @param string $m_token 登录令牌
     * @return array
     */'