印章相关回调

一. 印章回调通知

1. 回调触发时机

在印章创建、删除、停用、启用、印章授权、解除印章授权、印章审核通过、印章审核驳回时进行回调通知

可以根据回调中的Operate字段确定是哪种行为

2. 回调消息类型

OperateSeal

3. 其他说明

会出现的印章Operate行为

印章事件	对应Operate
印章创建	Create
印章删除	Delete
印章停用	Disable
印章启用	Enable
印章授权给某些员工	Valid
取消某些员工的印章授权	Invalid
审批流印章审核	Void
电子签平台印章审核	对应Operate为空

印章的生命周期说明

1. 在控制台上传印章后，会触发【Create事件】
2. 如果是系统创建的电子印章，无需经过审核，直接触发【Enable事件】，此时印章可以正常使用
3. 如果是上传图片创建的电子印章，需要经过电子签后台人员进行审核，审核结果会触发【AuditSealAuth事件】
4. 如果审核通过，会触发【Enable事件】，此时印章可以正常使用
5. 印章可用后，如果进行印章授权/取消授权操作，会触发【Valid/Invalid事件】
6. 印章可用后，如果进行了停用操作，会触发【Disable事件】，此时印章不可用
7. 印章停用后，如果进行了删除操作，会触发【Delete事件】

【Enable】事件可以作为印章可用的标准事件

4. 回调结构体

MsgData结构体定义

参数名称	参数类型	参数描述
OrganizationId	String	企业 ID，为32位字符串。仅在非审核结果回调时有值
OperatorUserId	String	操作人 UserId，为32位字符串。仅在非审核结果回调时有值
SealId	String	对应的印章ID，为32位字符串
SealName	String	对应的印章的名称
SealType	String	对应的印章类型, 类型的值包括 - OFFICIAL: 企业公章 - CONTRACT: 企业合同专用章 - ORGANIZATION_SEAL: 客户本地上传的企业印章 - LEGAL_PERSON_SEAL: 客户本地上传的法人印章 - FINANCE: 财务专用章 - PERSONNEL: 人事专用章
Operate	String	印章行为, 可以参考上面的 会出现的印章Operate行为
AuthorizedUsers	AuthorizedUser 数组	1. 如果印章授权给某些员工的行为, 此处为授权给与的员工们的信息 2. 如果是取消某些员工的印章授权, 此处为取消授权员工们的信息 3. 其他印章行为没有此字段
ReviewStatus	String	电子签平台审核的结果。仅在审核结果回调时有值： PENDING：审批中 PASS：通过 REJECT：拒绝 CHECKING:节点审批完成，待电子签平台审批
ReviewReason	String	审核驳回时, 此字段表示驳回的原因。仅在审核结果回调时有值
AuthorizedOperatorUserId	String	1. 如果印章授权给员工的行为, 此处为被授权员工的UserId 2. 如果是解除某个员工的印章授权, 此处为被解除授权员工的UserId 3. 其他印章行为没有此字段
ReviewUserId	String	当前审批人UserId
NodeStatus	String	当前审批节点状态， PENDING：审批中 PASS：通过 REJECT：拒绝 CHECKING:节点审批完成，待电子签平台审批
NodeName	String	当前审批节点名称

AuthorizedUser结构体定义

参数名称	参数类型	参数描述
Id	String	被授予此印章权限的电子签平台企业员工的唯一标识，为32位字符串
Name	String	被授予此印章权限的用户姓名

5. 示例

示例一: 印章授权

{
  "MsgId": "yDRIGUUgygs8oey1UuO4zjEC8S6bOcm8",
  "MsgType": "OperateSeal",
  "MsgVersion": "CustomApp",
  "MsgData": {
    "OrganizationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
    "OperatorUserId": "yDRCLUUgygq2xun5UuO4zjEwg0vjoimj",
    "SealId": "yDxbNUyKQDxGYNUuO4zjEwvl3XYQmAcO",
    "SealName": "合同专用章",
    "SealType": "OFFICIAL",
    "Operate": "Valid",
    "AuthorizedUsers": [
      {
        "Id": "yDRCLUUgxxxxxxzjEwg0vjoimj",
        "Name": "张三"
      },
      {
        "OpenId": "yDxbWUyxxxxxxSvEkRMHc55R",
        "Name": "李四"
      }
    ]
  }
}

示例二: 印章审核驳回

{
  "MsgId": "yDRIGUUgygs8oey1UuO4zjEC8S6bOcm8",
  "MsgType": "OperateSeal",
  "MsgVersion": "CustomApp",
  "MsgData": {
    "SealId": "yDxbNUyKQDxGYNUuO4zjEwvl3XYQmAcO",
    "SealName": "合同专用章",
    "SealType": "OFFICIAL",
    "ReviewStatus": "REJECT",
    "ReviewReason": "印章不清晰",
    "ReviewUserId": "yDtCvUUlahec8eUuLkPRzRSlgdhflAz2",
    "NodeName": "审批节点1",
    "NodeStatus": "REJECT"
  }
}

二. 员工执业章回调通知

1. 回调触发时机

在个人用户将个人印章授权给企业时，会进行员工执业章回调通知。

2. 回调消息类型

EmployeeSealAuth

3. 回调结构体

MsgData结构体定义

参数名称	参数类型	参数描述
SealId	String	对应的印章ID，为32位字符串
SealName	String	对应的印章的名称
SealStatus	Integer	印章状态，初始时为0-待审核状态
OperatorName	String	授权人姓名
AuthTime	Integer	授权时间戳，格式为Unix标准时间戳（秒）
AuthOrganizationId	String	被授权的企业Id，为32位字符串
AuthApplicationId	String	被授权的应用Id，为32位字符串

4. 示例

示例一: 印章授权

{
  "MsgId": "yDwFkUUckpstin4sUuZjBEY5Ia2XB7sz",
  "MsgType": "EmployeeSealAuth",
  "MsgVersion": "CustomApp",
  "MsgData": {
    "SealId": "yDRS4UUgygqdcj51UuO4zjEyWTmzsIAR",
    "SealName": "张三-执业章-24070820",
    "SealStatus": 0,
    "OperatorName": "张三",
    "AuthTime": 1720442405,
    "AuthOrganizationId": "yDRSRUUgygj6qnyvUuO4zjE1vLuGdWjL",
    "AuthApplicationId": ""
  }
}