跳到主要内容

通过模板发起合同

使用模板发起流程

在完成接入准备、子客企业激活之后,且有了子客模板之后,使用模板发起流程。

  1. 使用DescribeTemplates查询模块列表
  2. 然后用CreateFlowsByTemplates发起合同。
  3. 获取到 flowid 后,放入CreateSignUrls,获取到电子签小程序的 url。可以使用此链接跳转到小程序进行签署。

签署方说明

签署方分类

签署方分为下面三类:

参与方类型必传字段说明
个人Name、Mobile个人参与方,目前签署控件只支持:
SIGN_SIGNATURE:手写签名
SIGN_DATE:签署日期
企业签署方Name、Mobile、OrganizationName企业参与方,其中:
OrganizationName:为签署方在工商注册的企业名称
支持的签署控件:
SIGN_SIGNATURE:手写签名
SIGN_SEAL:签署印章
SIGN_DATE:签署日期
企业静默签署方 \ 此签署方由系统自动完成签署。
  • 无需指定参与人信息,签署人信息默认为发起人(Operator)的信息
  • 必须为 SIGN_SEAL 类型的控件指定印章 ID(控件的 ComponentValue 字段)
  • 不能指定 SIGN_SIGNATURE 类型的签署控件,因为系统无法进行手写签名
  • 模板发起合同签署方参数

    参数说明

    下面给出了不同类型的合同签署方的参数:


    # 个人类型
    {
    "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 可以在创建模板时自行指定,用于判断签署方:

    img

    注:对于 CreateFlowsByTemplates(模板发起合同)接口:

    单 B、单 C、B2C 场景,可以 “不” 传递模板信息中对应签署人的 RecipientId 信息,我们内部帮您自动推断签署人和模板中控件的绑定关系;

    例如 B2C 场景:

    "FlowApprovers": [
    {
    "ApproverType": "PERSON",
    "Name": "张三",
    "Mobile": "13000000000"
    },
    {
    "OpenId": "employee_open_id",
    "OrganizationOpenId":"org_open_id",
    "OrganizationName": "测试企业",
    "ApproverType": "ORGANIZATION"
    }
    ]