通过模板发起合同
使用模板发起流程
在完成接入准备、子客企业激活之后,且有了子客模板之后,使用模板发起流程。
- 使用DescribeTemplates查询模块列表
- 然后用CreateFlowsByTemplates发起合同。
- 获取到flowid后,放入CreateSignUrls,获取到电子签小程序的url。可以使用此链接跳转到小程序进行签署。
签署方说明
签署方分类
签署方分为下面三类:
参与方类型 | 必传字段 | 说明 |
---|---|---|
个人 | Name、Mobile | 个人参与方,目前签署控件只支持: SIGN_SIGNATURE:手写签名 SIGN_DATE:签署日期 |
企业签署方 | Name、Mobile、OrganizationName | 企业参与方,其中: OrganizationName:为签署方在工商注册的企业名称 支持的签署控件: SIGN_SIGNATURE:手写签名 SIGN_SEAL:签署印章 SIGN_DATE:签署日期 |
企业静默签署方 | \ | 此签署方由系统自动完成签署。 |
模板发起合同签署方参数
参数说明
下面给出了不同类型的合同签署方的参数:
# 个人类型
{
"RecipientId": "xxxxx", // 模板中对应签署人的 RecipientId 信息
"ApproverType": "PERSON",
"Name": "张三",
"Mobile": "13000000000"
}
# 静默签署方
{ // 无需传递签署人信息,内部直接使用发起时Agent中的操作人作为静默签署人
"RecipientId": "xxxxx", // 模板中对应签署人的 RecipientId 信息
"ApproverType": "ORGANIZATION"
}
# 渠道子客员工
{
"OpenId": "employee_open_id",
"RecipientId": "xxxxx", // 模板中对应签署人的 RecipientId 信息
"OrganizationOpenId":"org_open_id",
"OrganizationName": "测试企业",
"ApproverType": "ORGANIZATION"
}
# 渠道外企业签署方
{
"NotChannelOrganization": true, // 声明是渠道外的企业
"OrganizationName": "测试企业",
"RecipientId": "xxxxx", // 模板中对应签署人的 RecipientId 信息
"ApproverType": "ORGANIZATION",
"Name": "张三",
"Mobile": "13000000000"
}
获取 RecipientId 的方法
RecipientId 可由模板中的 Recipients 数组中获取:
"Recipients": [
{
"RecipientId": "yDxj5UUgydjmlo9dUuO4zjECPLh3sviC",
"RecipientType": "ENTERPRISE",
"RoleName": "企业签署方", // 在控制台创建模板时可自行指定
...
},
{
"RecipientId": "yDxj5UUgydjmlox6UuO4zjEyRdyOzcD5",
"RecipientType": "PERSON",
"RoleName": "个人签署方", // 在控制台创建模板时可自行指定
...
}
]
其中,RoleName 可以在创建模板时自行指定,用于判断签署方:
注:对于CreateFlowsByTemplates(模板发起合同)接口:
单B、单C、B2C 场景,可以 “不” 传递模板信息中对应签署人的 RecipientId 信息,我们内部帮您自动推断签署人和模板中控件的绑定关系;
例如 B2C 场景:
"FlowApprovers": [
{
"ApproverType": "PERSON",
"Name": "张三",
"Mobile": "13000000000"
},
{
"OpenId": "employee_open_id",
"OrganizationOpenId":"org_open_id",
"OrganizationName": "测试企业",
"ApproverType": "ORGANIZATION"
}
]