签署方入参指引

一. 示例角色介绍

本示例有4个角色，分别是：

1. 合同的发起方

企业名字	企业的OrganizationOpenId	员工名字	员工的OpenId	手机号	身份证
典子谦示例企业	org_dianziqian	典子谦	n9527	13700000000	650000199005050001

2. 自然人（个人）签署方

名字	手机号	身份证
刘波	13700000000	650000199005050001

3. 发起方同应用下的其他子企业

企业名字	企业的OrganizationOpenId	员工名字	员工的OpenId	手机号	身份证
张三示例企业	org_zhangsan	张三	n02468	18888888888	37000019890303000X

4. 平台企业（SAAS企业）

企业名字	员工名字	手机号	身份证
腾讯科技（深圳）有限公司	马超	15100000000	65000019870404000X

二. 传参示例

1.自然人（个人）签署方手动签署

（选填）IdCardNumber和IdCardType：证件类型和证件号
（必传）Name：签署方的名字
（必传）Mobile：签署方的手机号
（固定）ApproverType：需设置为PERSON

文件发起

{
  "ApproverType": "PERSON",
  "Name": "刘波",
  "Mobile": "13700000000",
  "IdCardNumber": "650000199005050001",
  "IdCardType": "ID_CARD",
  "SignComponents": [
    {
      "ComponentType": "SIGN_SIGNATURE",
      "FileIndex": 0,
      "ComponentWidth": 112,
      "ComponentHeight": 40,
      "ComponentPage": 1,
      "ComponentPosX": 146.15625,
      "ComponentPosY": 472.78125
    }
  ],
  //其他参数省略
}

模板发起

{
  "ApproverType": "PERSON",
  "Name": "刘波",
  "Mobile": "13700000000",
  "IdCardNumber": "650000199005050001",
  "IdCardType": "ID_CARD",
  "RecipientId": "yDRS4UUgygqdcjjdUuO4zjEC0osCOsHS",
  //其他参数省略
}

2.自然人（个人）签署方自动签署

（选填）IdCardNumber和IdCardType：证件类型和证件号
（必传）Name：签署方的名字
（必传）Mobile：签署方的手机号
（固定）ApproverType：需设置为PERSON_AUTO_SIGN

文件发起

{
  "ApproverType": "PERSON_AUTO_SIGN",
  "Name": "刘波",
  "Mobile": "13700000000",
  "IdCardNumber": "650000199005050001",
  "IdCardType": "ID_CARD",
  "SignComponents": [
    {
      "ComponentType": "SIGN_SIGNATURE",
      "FileIndex": 0,
      "ComponentWidth": 112,
      "ComponentHeight": 40,
      "ComponentPage": 1,
      "ComponentPosX": 146.15625,
      "ComponentPosY": 472.78125,
      //印章已经在对方开通自动签署的设置好了，这里不用传使用哪个印章
    }
  ],
  //其他参数省略
}

模板发起

{
  "ApproverType": "PERSON_AUTO_SIGN",
  "Name": "刘波",
  "Mobile": "13700000000",
  "IdCardNumber": "650000199005050001",
  "IdCardType": "ID_CARD",
  "RecipientId": "yDRS4UUgygqdcjjdUuO4zjEC0osCOsHS",
  //其他参数省略
}

3. 发起方同应用下的其他子企业手动签署

（选填）IdCardNumber和IdCardType：证件类型和证件号
（必传）Name：签署方的名字
（必传）Mobile：签署方的手机号
（必传）OpenId：企业员工标识
（必传）OrganizationName：子企业名称
（必传）OrganizationOpenId：子企业的标识
（固定）ApproverType：需设置为ORGANIZATION

文件发起

{
  "ApproverType": "ORGANIZATION",
  "Name": "张三",
  "Mobile": "18888888888",
  "IdCardNumber": "37000019890303000X",
  "IdCardType": "ID_CARD",
  "OrganizationOpenId": "org_zhangsan",
  "OpenId": "n02468",
  "OrganizationName":"张三示例企业",
  "SignComponents": [
    {
      "ComponentType": "SIGN_SEAL",
      "FileIndex": 0,
      "ComponentWidth": 112,
      "ComponentHeight": 40,
      "ComponentPage": 1,
      "ComponentPosX": 146.15625,
      "ComponentPosY": 472.78125
    }
  ],
  //其他参数省略
}

模板发起

{
  "ApproverType": "ORGANIZATION",
  "Name": "张三",
  "Mobile": "18888888888",
  "IdCardNumber": "37000019890303000X",
  "IdCardType": "ID_CARD",
  "OrganizationOpenId": "org_zhangsan",
  "OrganizationName":"张三示例企业",
  "OpenId": "n02468",
  "RecipientId": "yDRS4UUgygqdcjjdUuO4zjEC0osCOsHS",
  //其他参数省略
}

4. 发起方同应用下的其他子企业自动签署

提示

A.合作方需要开通【企业自动签署】功能，请对方访问【拓展服务】进行开通。 B.合作方需要走合作方授权流程。 C.合作方自动签署能力为白名单功能，使用前请联系对接的客户经理沟通。

这里只做演示，具体的文档可以参考自动签署

（选填）IdCardNumber和IdCardType：证件类型和证件号
（必传）Name：签署方的名字
（必传）Mobile：签署方的手机号
（必传）OpenId：企业员工标识
（必传）OrganizationName：子企业名称
（必传）OrganizationOpenId：子企业的标识
（固定）ApproverType：需设置为ENTERPRISESERVER

文件发起

{
  "ApproverType": "ENTERPRISESERVER",
  "Name": "张三",
  "Mobile": "18888888888",
  "IdCardNumber": "37000019890303000X",
  "IdCardType": "ID_CARD",
  "OrganizationOpenId": "org_zhangsan",
  "OpenId": "n02468",
  "OrganizationName":"张三示例企业",
  "SignComponents": [
    {
      "ComponentType": "SIGN_SEAL",
      "FileIndex": 0,
      "ComponentWidth": 112,
      "ComponentHeight": 40,
      "ComponentPage": 1,
      "ComponentPosX": 146.15625,
      "ComponentPosY": 472.78125,
      //印章已经在对方走授权流程的时候设置好了，这里不用传使用哪个印章
    }
  ],
  //其他参数省略
}

模板发起

{
  "ApproverType": "ENTERPRISESERVER",
  "Name": "张三",
  "Mobile": "18888888888",
  "IdCardNumber": "37000019890303000X",
  "IdCardType": "ID_CARD",
  "OrganizationOpenId": "org_zhangsan",
  "OpenId": "n02468",
  "OrganizationName":"张三示例企业",
  "RecipientId": "yDRS4UUgygqdcjjdUuO4zjEC0osCOsHS",
  //其他参数省略
}

5. 发起方自己手动签署

（选填）IdCardNumber和IdCardType：证件类型和证件号
（必传）Name：签署方的名字
（必传）Mobile：签署方的手机号
（必传）OpenId：企业员工标识
（必传）OrganizationName：子企业名称
（必传）OrganizationOpenId：子企业的标识
（固定）ApproverType：需设置为ORGANIZATION

文件发起

{
  "ApproverType": "ORGANIZATION",
  "Name": "典子谦",
  "Mobile": "13700000000",
  "IdCardNumber": "650000199005050001",
  "IdCardType": "ID_CARD",
  "OrganizationOpenId": "org_dianziqian",
  "OpenId": "n9527",
  "OrganizationName":"典子谦示例企业",
  "SignComponents": [
    {
      "ComponentType": "SIGN_SEAL",
      "FileIndex": 0,
      "ComponentWidth": 112,
      "ComponentHeight": 40,
      "ComponentPage": 1,
      "ComponentPosX": 146.15625,
      "ComponentPosY": 472.78125,
      "ComponentValue": ""
    }
  ],
  //其他参数省略
}

模板发起

{
  "ApproverType": "ORGANIZATION",
  "Name": "典子谦",
  "Mobile": "13700000000",
  "IdCardNumber": "650000199005050001",
  "IdCardType": "ID_CARD",
  "OrganizationOpenId": "org_dianziqian",
  "OpenId": "n9527",
  "OrganizationName":"典子谦示例企业",
  "RecipientId": "yDRS4UUgygqdcjjdUuO4zjEC0osCOsHS",
  //其他参数省略
}

6. 发起方自己自动签署

提示

A.为启用【企业自动签署】功能，请访问【拓展服务】进行开通，并开通应用平台方授权。 B.若需通过文件自动签署，请联系您的对接经理，申请加入白名单。 C.若需通过模板自动签署，请配置相应的模板成自动签署模板。

这里只做演示，具体的文档可以参考自动签署

（固定）ApproverType：模板发起设置为ORGANIZATION，文件发起设置为ENTERPRISESERVER

{
  "ApproverType": "ENTERPRISESERVER ",
  "SignComponents": [
    {
      "ComponentType": "SIGN_SEAL",
      "FileIndex": 0,
      "ComponentWidth": 112,
      "ComponentHeight": 40,
      "ComponentPage": 1,
      "ComponentPosX": 146.15625,
      "ComponentPosY": 472.78125,
      //印章已经在走授权流程的时候设置好了，这里不用传使用哪个印章
    }
  ],
  //其他参数省略
}

模板发起

{
  "ApproverType": "ORGANIZATION",
  "RecipientId": "yDRS4UUgygqdcjjdUuO4zjEC0osCOsHS",
  //其他参数省略
}

7. 发给平台企业（SAAS企业）签署

提示

发给平台企业（SAAS企业）签署，对方只能手动签署，不能自动签署

（选填）IdCardNumber和IdCardType：证件类型和证件号
（必传）OrganizationName：SaaS企业的名字
（必传）Name：签署方的名字
（必传）Mobile：签署方的手机号
（固定）ApproverType：需设置为ORGANIZATION
（固定）NotChannelOrganization：需设置为True

文件发起

{
  "ApproverType": "ORGANIZATION",
  "Name": "马超",
  "Mobile": "15100000000",
  "IdCardNumber": "65000019870404000X",
  "IdCardType": "ID_CARD",
  "OrganizationName":"腾讯科技（深圳）有限公司",
  "NotChannelOrganization": true,
  "SignComponents": [
    {
      "ComponentType": "SIGN_SEAL",
      "FileIndex": 0,
      "ComponentWidth": 112,
      "ComponentHeight": 40,
      "ComponentPage": 1,
      "ComponentPosX": 146.15625,
      "ComponentPosY": 472.78125,
      "ComponentValue": ""
    }
  ],
  //其他参数省略
}

模板发起

{
  "ApproverType": "ORGANIZATION",
  "Name": "马超",
  "Mobile": "15100000000",
  "IdCardNumber": "65000019870404000X",
  "IdCardType": "ID_CARD",
  "OrganizationName":"腾讯科技（深圳）有限公司",
  "NotChannelOrganization": true,
  "RecipientId": "yDRS4UUgygqdcjjdUuO4zjEC0osCOsHS",
  //其他参数省略
}

一. 示例角色介绍​

1. 合同的发起方​

2. 自然人（个人）签署方​

3. 发起方同应用下的其他子企业​

4. 平台企业（SAAS企业）​

二. 传参示例​

1.自然人（个人）签署方手动签署​

文件发起​

模板发起​

2.自然人（个人）签署方自动签署​

文件发起​

模板发起​

3. 发起方同应用下的其他子企业手动签署​

文件发起​

模板发起​

4. 发起方同应用下的其他子企业自动签署​

文件发起​

模板发起​

5. 发起方自己手动签署​

文件发起​

模板发起​

6. 发起方自己自动签署​

模板发起​

7. 发给平台企业（SAAS企业）签署​

文件发起​

模板发起​

一. 示例角色介绍

1. 合同的发起方

2. 自然人（个人）签署方

3. 发起方同应用下的其他子企业

4. 平台企业（SAAS企业）

二. 传参示例

1.自然人（个人）签署方手动签署

文件发起

模板发起

2.自然人（个人）签署方自动签署

文件发起

模板发起

3. 发起方同应用下的其他子企业手动签署

文件发起

模板发起

4. 发起方同应用下的其他子企业自动签署

文件发起

模板发起

5. 发起方自己手动签署

文件发起

模板发起

6. 发起方自己自动签署

模板发起

7. 发给平台企业（SAAS企业）签署

文件发起

模板发起