1.成为开发者

使用开放签API接口的前提是已成为企业开发者，并已获取对接所需的appAuthToken和私钥，以下是成为企业开发者的流程说明

1.1.注册并成为企业用户

1.1.1.注册个人账号

开放签提供个人账号快速注册的方式，输入手机号和短信验证码进行账号的注册和登录
说明：若输入的手机号未在开放签注册，登录时，会自动为当前手机号创建账号，密码默认为123456，请登录后，重新修改密码。

1.1.2.企业实名认证

个人账号注册完成后，登录系统，进行企业认证，若已存在企业账号，且企业已完成实名，则忽略该步骤。
企业认证流程操作说明：
https://www.yuque.com/huxin-ch41t/kaifangqian/ikzttzudk6f2zikb

1.2.企业用户升级为开发者

使用admin账号登录开放签系统，进入运营管理后台。

1.2.1.企业认证信息审核

进入“企业认证审核”页面，对企业认证信息进行审核。

1.2.2.升级企业用户为核心企业

开放签企业用户分为核心企业和普通企业两种：
（1）核心企业：可以发起和接收合同；
（2）普通企业：仅支持被动接收合同，不支持发起合同；
仅有核心企业可开通开发者授权，所以需要将对应的企业升级为“核心企业”。

1.2.3.创建开发者授权凭证

新增凭证，为对应的核心企业开通开发者授权凭证。

如果使用支付宝开放平台密钥工具，加密算法选择“RSA2”。

获取对接所需的appAuthToken和私钥。

2.调用API接口的前期准备

2.1.制作企业印章

登录开放签账号，切换到对应的企业身份，进入【企业管理后台】应用；

进入到印章管理页面，新增或修改企业印章；

印章管理的相关操作说明见：
https://www.yuque.com/huxin-ch41t/kaifangqian/haha1mgwh330g572

2.2.配置签署文件模板

登录开放签账号，切换到对应的企业身份，进入【企业管理后台】应用；
进入到模板管理页面，新增或修改模板；

如果签约文件无需模板或已经配置模板，则忽略该步骤。

详细操作说明见：
https://www.yuque.com/huxin-ch41t/kaifangqian/ob0fp6wbo43gf5gm

以下以劳动合同文件模板为例，进行模板制作的说明：
第一步：上传文件模板并配置模板基本信息：

第二步：模板控制配置
拖拽页面正上方的填写控件至文件正文区域，逐项配置对应的控件属性。

2.3.配置业务线

进入到业务线管理页面，新增或修改业务线。
业务线的详细说明见：
https://www.yuque.com/huxin-ch41t/kaifangqian/bmq3kzuavpudvxov

以下以劳动合同签署场景为例，进行业务线配置的说明。

劳动合同签署示例场景描述：
（1）企业与员工签署劳动合同；
（2）签约文件使用模板文件，其中模板中的员工姓名、身份证号码信息由员工填写，其余内容由发起方企业填写；
（3）流程为：发起签署->员工完善合同->企业印章自动签署->员工签署合同->签署完成;
（4）企业自动盖章，盖章后，员工可以通过以下两种方式签署合同：
1）通过短信/邮箱方式通知到员工，员工打开链接完成签署；
2）发起成功后，调用开放签“获取合同短链接”接口，返回对应员工的签署链接，业务系统自定义方式，将签署链接通知给员工。

2.3.1.第一步：业务线创建

2.3.2.第二步：业务线配置

2.3.2.1.签署方设置

选择“经办人发起时，按照预设流程发起并签署”模式，配置发起方的内部签署流程，并添加个人接收方。

设置发起方内部签署流程：选择印章，并选择自动签署

添加个人接收方

2.3.2.2.签约文件设置

点击“选择公共模板”，选择劳动合同模板作为签约文件。

2.3.2.3.位置及参数设置

为签约方设置签署位置，同时指定模板参数的填写方。
点击左侧“位置及参数设置”，进入设置页面。
页面左侧：可指定各个签署方在文件上签署的位置,拖拽签署方下面对应的签署控件到文档正文区域；
页面中间：劳动合同文档正文；
页面右侧：设置模板参数的填写方，其中员工姓名、员工身份证号由个人接收方填写，其余参数由发起方填写。
设置完成后，保存配置，并返回到业务线列表页面。

2.3.2.4.通知设置

2.3.3.第三步：启用业务线

配置完成的业务线默认为“停用”状态，点击“启用”按钮进行启用。

3.签署流程（劳动合同签署示例场景）

以上劳动合同业务线的签署流程为：
1.
通过接口发起签署；
2.
发起签署成功后，员工填写合同；
3.
员工填写合同完成后，发起方自动完成签署；
4.
发起方自动完成签署后，员工签署合同；
5.
员工签署合同后，整个签署流程结束；

3.1.通过接口发起签署

根据“发起签署”的参数要求，定义请求参数，并调用接口发起签署，发起成功后接口返回对应的合同contractId，后续会使用该合同contractId进行获取合同短链接、下载签约文件等操作。

详细的接口及参数说明见“发起签署”接口。

劳动合同示例场景的传参示例：

  "appAuthToken": "***",
  //应用授权凭证
  "uniqueCode": "***",
  //流水号，用于标识某笔业务
  "signReId": "***",
  //业务线id
  "sn": "000001",
  //合同编号
  "expireDate": "2046-10-30",
  //签署截止日期
  "subject": "劳动合同",
  //合同主题
  "send": "1",
  //1 直接发起
  "operator": { //发起方企业经办人信息，该经办人已经加入到开发者对应的企业中，并拥有业务线的使用权限
    "name": "***",
    "contactType": "MOBILE",
    "contact": "***" //手机号
  },
  "signTemplateParamList": [ //发起方填写的模板参数值，；
    {
      "templateId": "***",
      //模板id，获取模板ID：在企业管理后台->模板管理列表中拷贝模板ID
      "templateName": "劳动合同",
      //模板名称
      "templateParamList": [ //模板参数集合，在企业管理后台中下载对应的模板参数，筛选出需要发起方填写的参数集合
        {
          "paramKey": "service_period",
          //服务期限（年）
          "paramValue": "5" 
        },
        {
          "paramKey": "probation_period",
          //试用期（月）
          "paramValue": "3" 
        },
        {
          "paramKey": "post",
          //岗位
          "paramValue": "市场运营总监" 
        },
        {
          "paramKey": "salary",
          //年薪（万）
          "paramValue": "40" 
        }]
    }],
  "signerList": [ //签署方信息
    {
      "signerType": "RECEIVER_PERSONAL",
      //发起方：SENDER；企业接收方：RECEIVER_ENT；个人接收方：RECEIVER_PERSONAL  
      "signerOrder": "2",
      //签署顺序（业务线设置的顺序）
      "receiver": { //signerType为个人时，必传，员工的信息
        "name": "***",
        "contactType": "MOBILE",
        "contact": "***"
      }
    }]
}

3.2.员工填写合同

员工可通过两种方式获取到合同填写链接：
1）通过短信/邮箱方式通知到员工，业务线中对应的通知配置需打开；

2）调用开放签“获取合同短链接”接口，获取对应员工的合同填写链接

员工通过合同短链接完成合同填写，填写页面如下：

3.3.发起方自动完成签署

员工填写合同完成后，发起方自动完成签署。
发起方可以登录开放签系统，查看合同签署进度。

3.4.员工签署合同

发起方自动完成签署后，流程进行到需要员工签署合同。
员工可通过两种方式获取到合同签署链接。
1）通过短信/邮箱方式通知到员工，业务线中对应的通知配置需打开；

2）调用开放签“获取合同短链接”接口，获取对应员工的合同签署链接

员工通过合同短链接完成合同签署，签署页面如下：

3.5.下载签约文件

员工签署合同后，整个签署流程结束，可登录开放签平台查看合同签署详情，下载签约文件、下载签署记录报告等。

同时，也可以通过调用“下载签约文件”接口，下载签约后的合同文件。

接入流程

1.成为开发者#

1.1.注册并成为企业用户#

1.1.1.注册个人账号#

1.1.2.企业实名认证#

1.2.企业用户升级为开发者#

1.2.1.企业认证信息审核#

1.2.2.升级企业用户为核心企业#

1.2.3.创建开发者授权凭证#

2.调用API接口的前期准备#

2.1.制作企业印章#

2.2.配置签署文件模板#

2.3.配置业务线#

2.3.1.第一步：业务线创建#

2.3.2.第二步：业务线配置#

2.3.2.1.签署方设置#

2.3.2.2.签约文件设置#

2.3.2.3.位置及参数设置#

2.3.2.4.通知设置#

2.3.3.第三步：启用业务线#

3.签署流程（劳动合同签署示例场景）#

3.1.通过接口发起签署#

3.2.员工填写合同#

3.3.发起方自动完成签署#

3.4.员工签署合同#

3.5.下载签约文件#