签盾开放平台-公有云版
  1. 帮助文档
签盾开放平台-公有云版
  • 快速入手
    • 接入流程
    • 业务流程
  • 帮助文档
    • 基本概念
    • 合同状态说明
    • 印章指定位置
    • 静默签使用说明
    • 常见错误码
    • 回调接入文档
  • 开发前必读
    • 公共请求格式
    • 移动端(Android,IOS,微信小程序,H5)--接入
  • 认证授权
    • 用户认证&授权流程
    • 个人认证&授权
      • 获取个人认证&授权链接
      • 查询个人认证信息
      • 查询个人授权信息
    • 企业认证&授权
      • 获取企业认证&授权链接
      • 查询企业认证信息
      • 查询企业授权信息
  • 合同签署
    • 文件处理
      • 本地文件上传
        • 上传合同文件
        • 上传合同附件
      • 模版文件使用
        • 基于模板创建合同文件
      • 获取文件关键字坐标
    • 合同发起
      • 发起合同
    • 合同操作
      • 获取参与方操作链接(签署链接)
      • 催办合同签署
      • 撤回合同
    • 合同查询
      • 查询企业合同类目
      • 获取合同预览链接
      • 查询合同详情
      • 分页查询合同列表
      • 查询合同存证信息
      • 下载合同文件及合同附件
  • 审批管理
    • 审批流程使用场景
    • 列表查询用户可用的审批流程
      GET
    • 分页查询审批状态合同列表
      POST
    • 查询签署用印审批详情
      GET
    • 查询发起合同审批详情
      GET
    • 获取审批操作链接
      POST
  • 企业管理
    • 企业信息查询
    • 分页查询员工
    • 新增员工
    • 删除员工
  • 印章管理
    • 分页查询个人印章列表
    • 分页查询企业印章列表
    • 查询个人印章详情
    • 查询企业印章详情
    • 获取印章静默签授权链接
  • 回调通知
    • 回调接入文档
    • 接口测试
    • 获取回调信息
    • 回调成功确认
    • 回调成功确认(新)
  • 开放接口
    • 企业四要素校验
    • 企业三要素校验
    • 身份证OCR识别
    • 营业执照OCR识别
    • 身份二要素校验
    • 银行卡二要素
    • 银行卡三要素
    • 银行卡四要素
    • 个人二要素诉讼信息
    • 个人运营商三要素
    • 企业工商四要素
  1. 帮助文档

基本概念

应用 (APP)

签盾为客户提供数字化业务服务,客户可以通过调用签盾平台开放接口,将电子合同和电子服务融合到自己的业务场景中。这样的数字化业务系统被称为应用(APP),也就是客户的业务系统集成了签盾平台服务。

名词解释说明
应用
(APP)
每个需要集成对接签盾平台的业务系统被称为一个应用。
企业管理员可在企业控制台中,创建以及管理不同应用。
应用标识
(Appkey)
签盾平台为每个应用生成唯一的标识Appkey,用于在API接口对接时识别不同的应用。
因为不同的应用可能有不同的配置要求,建议不要使用多个不同的业务应用系统共用一个Appkey。
应用秘钥
(AppSecret)
签盾平台为每个应用生成唯一的安全访问秘钥,和appkey组成<appkey, AppSecret>对,用于接入认证和参数签名,是接口和数据安全的保障。
为了保证数据安全,请务必不要泄漏AppSecret。
企业管理员可以在企业控制台中查看和管理应用秘钥,一旦发现<appkey, AppSecret>可能泄露,请尽快更新AppSecret。
集成方应用所属主体。目前只有企业组织主体的应用可集成。
企业应用企业内部使用,为企业自身或其关联企业(如集团型公司的分子公司)提供电子签服务的应用。

个人用户 (Psn)

在应用中的个人用户。
对于个人用户在使用特定应用程序(APP)时,通常需要创建一个帐号,以便在该应用程序中使用。如果这些用户想要访问签盾平台的服务,就需要注册并获得一个唯一的用户ID,以便在后续的API调用中标识身份并指定相应的参数

名词解释说明
个人用户
(openPsnId)
一个人在签盾平台注册了帐号,但可以在多个应用程序中使用签盾的电子合同和电子签名服务。
每个应用程序的用户都有一个独立的openPsnId,方便API对接和数据维护。
个人使用账号
(psnAccount)
目前签盾平台只支持允许使用手机号码作为个人账号,该账号仅提供登录签盾平台以及接受短信通等。
个人证件编号
(psnIDNum)
在签盾平台认证时,使用证件类型的编号。
目前只支持大陆身份证认证,如身份证号。

企业组织 (Corp)

在使用签盾平台的应用中,企业是指组织或公司,这些企业是签盾平台的用户,只是并没有对企业提供独立的登录账号,而是由企业成员使用个人帐号登录后代表企业使用电子合同和电子签服务。企业和成员之间的关系由企业管理后台组织模块管理。个人也可以申请加入企业,并由管理员(或且有权限的员工)确认后建立企业成员关系。
在特定的应用(APP)中,每个企业都有自己的唯一企业主体标识(openCorpId)。如果企业想要通过该APP使用签盾平台的服务,就需要先加入签盾平台。

名词解释说明
企业帐号
(openCorpId)
一家企业在签盾平台注册了账号,可以在多个应用系统中(不同的AppId)使用签盾的电子合同和电子签名服务,作为不同系统的企业用户。
为方便API对接和维护,签盾平台为每个特定Appkey上的企业用户分配独立的openCorpId。
企业证件编号
(corpIDNum)
企业在签盾平台认证时,使用证件类型的编号。目前只支持企业营业执照认证,如社会社会信用统一代码。
员工编号
(staffId)
企业员工在不同的企业, 有唯一的staffId,不同的appKey保持唯一

用户授权 (Authorization)

名词解释说明
帐号绑定经过用户帐号绑定授权后,签盾平台将应用内的用户标识和统一帐号建立绑定关系,<openPsnId, psnId>、<openCorpId, CorpId>。
帐号绑定授权是基础,在建立了与签盾主体帐号关系后,才能进一步确定主体对该应用的授权范围。
个人用户授权个人用户授权范围:
帐号
get_psn_ident_info:授权允许获取个人身份信息
签名
get_psn_signature_info:授权允许获取个人用户的签名资源
签署任务
psn_sign_task_init:授权允许代表个人发起签署
get_psn_sign_task_info:授权允许获取个人用户的签署任务
get_psn_sign_task_file:授权允许获取个人用户的签署文件
企业用户授权企业用户授权范围:
帐号
get_corp_ident_info: 授权允许获取企业基本信息
印章
get_corp_seal_info: 授权允许获取企业的印章相关资源管理权限
组织
get_corp_organization: 授权允许获取企业的组织成员等资源管理权限
模板
get_corp_template: 授权允许获取企业的模板数据
签署任务
corp_sign_task_init: 授权允许代表企业发起签署
get_corp_sign_task_info: 授权允许获取企业的签署任务
get_corp_sign_task_file: 授权允许获取企业的签署文件

文档和模板 (Document)

名词解释说明
合同
(Contract)
合同是数字签名所要保护的数字内容部分。
数字签名主要保护合同中需要保密的数字内容。
在进行数字签名后,原始文档会被转换为固定的格式,并携带签名主体的真实数字身份信息和内容摘要信息,以确保文档不可篡改和不可抵赖。
这些合同最终将以PDF或OFD文件格式实现数字签名和固化保存。
附件
(Attachment)
在签署任务中,除了需要签署的文档文件,还可以添加其他任何形式的文件作为补充资料,以方便各方参与者查看和参考,并补充所签署内容的信息。
这些附件内容并不是数字签名要保护的部分,因此不会参与数字签名的内容摘要计算。
需要注意的是,本平台将拦截任何形式的可执行文件(如.exe、.sys、.com、.dll、.app等),以防止恶意程序通过本平台进行传播。

签署任务 (SignTask)

名词解释说明
签署任务
(contractId)
每个电子合同签署流程,就是一个在线协作流程,签署任务就是整个电子协作流程的核心。
每次发起方提交合同时,必须创建一个签署任务,以跟踪整个协作流程,各方围绕这一个签署任务展开在线协作。
发起方
(Initiator)
签署任务的发起主体。
签署任务的发起可以是个人,也可以是某个企业,若是企业的话,由企业内部具有权限的员工进行发起。
其他签署方或抄送方,将可看到该签署任务是有谁发起订单,并且相关的一些费用消耗,也通常记录在发起方的账户上。
签署方(Signer)需要参与该合同的具体签署的个人或者企业。一个签署任务可以有多个签署方进行签署,且发起方并不一定需要参与签署。
抄送方
(CopyReceiver)
不需要参与该合同的具体签署的个人或企业。抄送方在发起签署任务后,可了解该签署任务的具体进展,并可以查看到所有合同以及附件,签署任务等信息。
修改于 2023-09-12 10:39:01
上一页
业务流程
下一页
合同状态说明
Built with