智慧签名

背景与适用场景

个人签署方在签署合同时，默认可以使用多种签名方式，包括：

• HANDWRITE：实时手写签名
• HANDWRITTEN_ESIGN：长效手写签名（从个人中心已保存的手写印章中选择）
• OCR_ESIGN：AI 智能识别手写签名（即 智慧签名）
• ESIGN：个人印章
• SYSTEM_ESIGN：系统一键生成的签名（根据用户姓名生成）
• IMG_ESIGN：图片印章（上传 PNG 图片作为签名）

各签名样式可参考下图：

在某些业务场景下（如入职合同、金融借贷、租赁协议等），发起方希望签署人必须手写自己的真实姓名，不能随意涂鸦、简写、写他人姓名或用系统生成的签名代替。此时可以将个人签署方的签名方式限定为智慧签名（OCR_ESIGN）。

智慧签名（OCR_ESIGN）的特点：

• 限制对象为 SIGN_SIGNATURE签署控件；对其他签署控件（如SIGN_SEAL、SIGN_PAGING_SEAL等）不适用。
• 用户必须手写签名，系统会通过 OCR 识别 + 姓名比对 校验手写内容与签署人实名信息中的姓名是否一致；
• 若手写内容与真实姓名不匹配，系统将拒绝签署，从而有效防止乱签名、代签、签错名等风险；
• 支持开通 "高级签署能力" 中的 "正楷临摹签名失败后更换其他签名类型" 能力：开通后，当签署人连续 5 次 OCR 识别失败，系统会自动切换为手写签名方式，允许签署人以普通手写签名完成签署，避免因多次识别失败导致签署流程阻塞。

使用方式

方式一：通过模板发起合同

模板发起合同时，签名方式需要在模板的签名控件上预先配置，合同发起时不可修改。登录电子签控制台编辑模板，在签名控件的「属性编辑 - 指定签名/印章类型」中，仅勾选 正楷临摹签名，保存模板。

方式二：通过文件发起合同（CreateFlowByFiles）

文件发起合同时，直接在 Approvers 签署方对象中通过 ComponentLimitType 字段指定签名方式限制。

调用 CreateFlowByFiles - 用 PDF 文件创建签署流程 接口：

{
  "Operator": {
    "UserId": "yDRCLUUgygq2xun5UuO4zjEwg0vjoimj"
  },
  "FlowName": "限制智慧签名的入职合同",
  "FileIds": ["yDRSRUUgygj6qnwfUuO4zjEwc193c2hH"],
  "Approvers": [
    {
      "ApproverType": 1,
      "ApproverName": "张三",
      "ApproverMobile": "18888888888",
      "SignComponents": [
        {
          "ComponentType": "SIGN_SIGNATURE",
          "ComponentPosX": 160,
          "ComponentExtra":"{\"ComponentTypeLimit\":[\"OCR_ESIGN\"]}"
          "ComponentPosY": 360,
          "ComponentWidth": 120,
          "ComponentHeight": 45,
          "ComponentPage": 1,
          "FileIndex": 0
        }
      ]
    }
  ]
}

关键参数说明：

参数	说明
ComponentTypeLimit	字符串数组，指定允许的签名方式；只传 "OCR_ESIGN" 即强制使用智慧签名

注：如果您希望允许多种签名方式（例如同时允许实时手写与智慧签名），可传 ["HANDWRITE", "OCR_ESIGN"]；此处不传或传空数组表示允许所有签名方式。

签署端效果

效果演示视频：点击查看签署端效果