在开发者集成e签宝SaaS API（以下简称API）前，建议开发者先对e签宝产品的基本概念以及e签宝的产品功能有所了解，这会让开发者更好地理解电子签名以及e签宝的产品功能，使集成过程更加顺畅。开发者对接过程中也可以随时在该篇文档中搜索一些API产品相关的概念解释。
用户的注册、认证和授权
根据《电子签名法》的要求，任何需要在e签宝使用电子签名服务的个人或企业都需要在e签宝平台注册和实名认证，以保障签署过程的合规性。开发者可以根据自身业务情况，选择让用户在开发者业务系统中完成e签宝注册和实名认证或者在签署过程的e签宝页面中完成注册和实名认证。
个人用户和企业用户
概念 | 解释 |
个人用户账号(psnId) | 个人用户注册后，e签宝根据个人用户的登录凭证（手机号或邮箱）为个人用户创建账号，一个登录凭证对应一个psnId |
企业用户账号(orgId) | 企业用户注册后，e签宝根据企业用户的企业名称为企业用户创建账号，一个企业名称对应一个orgId |
企业组织成员 | 个人用户注册且完成实名认证后，可以作为个人用户独立存在，也可以加入企业用户的组织中，成为企业的组织成员。加入企业后，根据被分配的角色不同，将拥有不同的功能权限和数据权限 |
企业管理员 | 首次在e签宝为企业完成实名认证的个人用户将自动成为企业的管理员角色，管理员角色拥有企业在e签宝系统中的最高权限。 管理员可以通过签署授权书的方式将管理员角色进行转授 |
企业法定代表人 | 企业的法定代表人加入企业成为企业的组织成员后，会自动被识别，并成为企业的法定代表人角色，企业的法定代表人拥有等同于企业管理员的权限 |
实名认证和意愿认证
概念 | 解释 |
个人实名认证 | 个人实名认证共有三种方式 ①运营商三要素（手机号，姓名，身份证号） ②银行卡四要素（银行卡号，银行卡绑定手机号，姓名，身份证号） ③人脸识别认证（可使用支付宝或腾讯云两种人脸识别通道） |
企业实名认证 | 企业实名认证共有三种方式 ①法定代表人本人/授权书认证（如实名认证的经办人为法定代表人本人操作则为法定代表人认证，如非法定代表人本人则为授权书认证，授权书认证需要联系企业法定代表人通过e签宝线上签署授权书） ②对公账户打款认证（e签宝向企业对公账户进行随机金额打款，经办人向企业的财务了解具体金额后在页面中填写并提交给e签宝确认，校验通过即完成实名） ③企业支付宝认证（需要企业开通企业支付宝，开通后可直接进行一键授权完成认证） 注意：用户在操作企业实名认证前，需要先完成个人实名认证。 |
意愿认证 | 个人用户或企业的经办人操作授权、签署等行为时，需要进行一次意愿认证，表明是本人操作 意愿认证共有两种方式 ①人脸识别认证（可使用支付宝或腾讯云两种人脸识别通道） ②短信验证码认证（若用户注册时或注册后未绑定手机号，则无法使用该方式 |
用户授权
若开发者业务系统是第三方平台，将e签宝电子签名服务集成到自身平台后，为自己平台上的个人或企业用户提供电子签名服务，则可能涉及到需要个人或企业用户将自身的身份信息和他们在e签宝上的部分权限授权给平台，以便开发者可以通过API获取个人或企业用户的身份信息，管理个人或企业用户的印章、签署流程、合同，代表个人或企业用户发起电子合同的签署等。若开发者未经过个人或企业用户的授权，在调用相关接口时，会受到e签宝授权校验的拦截。
用户操作企业授权时，若用户并非企业的法定代表人或管理员，则授权后需要管理员的审批通过后才能授权成功。
若开发者业务系统是企业自用系统，如OA、HRM、CRM等，通常情况下不需要使用授权服务。
关于用户授权相关的功能，可以点此查看。
概念 | 解释 |
授权流程(authFlowId) | 开发者系统每发起一次授权，都会返回一个authFlowId。获取到authFlowId的30天内使用相同入参发起，authFlowId不会改变，直到30天后授权流程失效。 |
授权范围(scope) | 开发者可以根据实际需要向个人或企业用户获取以下授权范围 get_org_identity_info - 授权允许获取企业账号基本信息(法定代表人证件号) get_psn_identity_info - 授权允许获取个人账号基本信息(姓名、证件号、手机号、邮箱、银行卡号) org_initiate_sign - 授权允许代表企业用户发起合同签署 psn_initiate_sign - 授权允许代表个人用户发起合同签署 manage_org_resource - 授权允许获取企业用户的模板、印章、组织成员等资源的权限 manage_psn_resource - 授权允许获取个人用户的印章等资源的权限 use_org_order - 授权允许获取企业用户套餐订单的使用权限 |
准备待签署文件和发起签署流程
开发者系统要使用e签宝完成一次完整合规的电子合同的签署，至少需要准备待签署文件和发起签署流程两步，这两步共有三种实现方式
①直接上传完整的待签署文件，并发起签署流程：
开发者可在系统中自动生成文件，或由开发者系统中的用户上传文件，并直接使用该文件发起签署。
该方式适用于系统能够直接生成或获取待签署文件的场景。
②通过文件模板生成待签署文件，并发起签署流程：
开发者可在系统中自动生成文件，或由开发者系统中的用户上传文件后，将该文件作为模板底稿获取e签宝的文件模板配置页面，并提供给系统用户。用户在页面中将需要填写的控件拖拽到合适的位置并保存为文件模板。
在使用时，可以由系统自动对控件进行填写，或者让用户在e签宝提供的填写页面中进行填写，填写完成后即可生成待签署文件，文件模板可以反复使用。生成待签署文件后，开发者系统可以使用该文件发起签署。
该方式适用于待签署文件需要让用户根据每次发起签署所需信息的不同进行填写完善的场景。
③通过流程模板直接发起合同拟定和签署流程：
开发者可为企业用户获取流程模板的配置页面，由企业用户的经办人完成流程模板中填写方、签署方、参与顺序、抄送方、文件、业务控件、签署区控件、合同附件等内容的配置，并保存为流程模板。
在使用时，需要开发者系统直接使用流程模板发起合同拟定和签署流程。可以让用户根据模板所设置的填写顺序在e签宝提供的填写页面中进行填写。合同拟定完成后，根据开发者系统发起签署时的设置，可以自动开启后续的签署流程或者由开发者系统自行开启后续的签署流程。
该方式适用于合同拟定需要多方参与填写的场景。
文件模板和流程模板
概念 | 解释 |
文件模板(docTemplate) | 文件模板是归属于开发者的资源，开发者管理和使用文件模板时，不需要获取授权。 文件模板分为两种： ①PDF模板 PDF模板基于.pdf文件进行配置，用户可以在PDF模板的配置页面上拖拽控件，且控件是直接覆盖于PDF的内容之上。PDF模板的控件在填写后，不会对文件中的内容产生影响。 ②HTML模板 HTML模板是基于.doc或.docx文件进行配置，用户可以在HTML模板的配置页面上拖拽控件，且拖放后的控件会根据文件中的内容格式自动嵌入到文件的内容之中而不会覆盖于内容上。HTML模板的控件在填写后，会使文件中的内容自适应展示，比如换行。 |
流程模板(signTemplate) | 流程模板是归属于企业用户的资源，开发者使用非自身企业的流程模板时，需要通过授权获取企业资源的管理权限。 流程模板中除了具备文件模板的功能外，还支持在模板中设置填写方、签署方、参与顺序、抄送方、文件、业务控件、签署区控件、合同附件等内容。 流程模板中目前仅支持PDF模板，未来迭代中将会同样支持HTML模板 |
控件(component) | 控件分为基础控件和自定义控件 ①基础控件 基础控件又分为业务控件和签署区控件两类 业务控件包括文本、数字、身份证号、手机号、下拉选择、单选、多选、勾选、动态表格（仅限HTML模板）、图片等 签署区控件的作用是拖放和固定签章位置，包括普通签署区、骑缝章签署区、备注签署区三种 业务属性上，普通签署区、骑缝章签署区均用来进行签名和盖章；备注签署区则是用来签署固定文案，比如已知情已同意等。 ②自定义控件 自定义控件是e签宝开放平台提供给开发者配置自己业务系统中所需的一些固定属性的控件的功能。 自定义控件可以基于各种业务控件进行属性设置，开发者若有需要可以联系e签宝交付顾问咨询。 开发者维护好自定义控件后，可以在配置文件模板或流程模板的页面中提供给用户使用。 |
签署流程
签署流程是归属于企业用户的资源，开发者在代表非自身企业发起签署，或管理非自身企业的签署流程时，需要通过用户授权获取代表企业发起签署的权限和企业资源的管理权限。
关于签署相关的功能，可以点此查看。
概念 | 解释 |
签署流程(signFlowId) | 开发者系统每发起一次签署流程，都会获得一个新的signFlowId，开发者可以根据signFlowId来串联系统所需的业务流程。（一模一样的任务信息重新发起签署，也会生成新的signFlowId，就变成了新的签署流程，与原流程无关联） |
发起方(initiator) | 签署流程的发起需要设置发起方，发起方可以是开发者自身企业，也可以是开发者系统中的个人或企业用户。 发起方也是签署流程的归属方。 |
抄送方(copier) | 签署流程发起后，抄送方将收到短信或邮件通知，以知悉本次的签署情况。 |
合同附件(attachment) | 合同附件是不需要进行拟定和签署的附属材料，但是签署方签署时可以看到附件。 |
印章管理和用印
电子印章(seal)是归属于个人或企业用户的资源，开发者在管理非自身企业的印章时，需要通过用户授权获取个人或企业资源的管理权限。
在电子合同签署时，需要签署方将电子印章放置到待签署的PDF文件上，e签宝会将印章图片和PDF文件进行合成并完成电子签名。
概念 | 解释 |
个人印章 | 个人用户或获取到个人资源管理权限的开发者系统可以通过以下三种方式创建印章： ①模板印章：基于e签宝提供的印章模板，选择印章的样式、颜色、尺寸等，提交后由e签宝自动生成印章并完成创建 ②图片印章：用户扫描实体印章并上传图片，该方式创建的印章需要由e签宝审核通过后才能创建成功，e签宝审核会有一定延迟。 ③手绘印章：用户扫描二维码后在手机号完成带有AI校验的手绘签名，提交成功后即可完成创建 个人用户在完成实名认证后，e签宝会自动为个人用户创建默认的模板印章，样式如图所示  |
企业印章 | 拥有印章管理权限的企业成员或获取到企业资源管理权限的开发者系统可以通过以下两种方式创建印章： ①模板印章：基于e签宝提供的印章模板，选择印章的业务类型、样式、颜色、尺寸等，提交后由e签宝自动生成印章并完成创建 ②图片印章：拥有印章管理权限的企业成员或开发者系统扫描实体印章并上传图片，该方式创建的印章需要由e签宝审核通过后才能创建成功，e签宝审核会有一定延迟。 企业用户在完成实名认证后，e签宝会自动为企业用户创建默认的模板印章，样式如图所示  |
企业法定代表人印章 | 创建企业法定代表人印章前需要先经过企业法定代表人的授权 法定代表人完成授权书的线上签署后，拥有印章管理权限的企业成员才能创建法定代表人印章，可通过模板印章和图片印章两种方式创建。 |
用印（盖章/签字） | 个人印章只有个人用户本身具有用印权限，其他人或开发者系统无法通过任何方式代替或代表个人用户用印 企业印章在默认情况下，只有法定代表人和管理员角色具有用印权限，其他人若想使用企业印章，则需要在签署过程中由法定代表人和管理员对本次用印情况进行审批，审批通过后才能完成一次性的用印。 企业印章还可以通过授权的方式，将印章的使用权限和审批权限下放给企业下的成员，或者将用印权限授权给其他企业的管理员和法人。 |
企业印章授权 | 企业印章授权分为两种，均必须由法定代表人或管理员进行操作，并完成授权书的线上签署。可设置授权的有效期： ①企业内部授权： 针对某一个企业印章，将印章的使用权限或审批权限一次性赋予多位员工 ②授权其他企业： 针对某一个企业印章，将印章的使用权限授权给其他企业的管理员和法人 注意：企业在法定代表人或管理员的变更后，会导致之前法定代表人或管理员作出的授权失效。 |
我要纠错