印章相关回调

一. 印章回调通知

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. 回调结构体

rrr/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": ""
  }
}

三. 用印记录回调通知

1. 回调触发时机

使用企业印章签署合同时，会进行用印记录回调通知。
注意：该回调需要开通白名单，请联系客户经理开通，完成开通后签署的合同才会有对应的用印记录回调。

2. 回调消息类型

SealUse

3. 回调结构体

MsgData结构体定义

参数名称	参数类型	参数描述
SealUseCallbackRecords	Array of SealUseCallbackRecord	用印记录数组

SealUseCallbackRecord结构体定义

参数名称	参数类型	参数描述
SealId	String	对应的印章ID，为32位字符串
SealName	String	对应的印章的名称
FlowId	String	合同Id ，为32位字符串
FlowName	String	合同名称
SignCount	Integer	盖章次数
CreatorId	String	用印人Id，为32位字符串
CreatorName	String	用印人名称
SignTime	Integer	用印时间戳 ，格式为Unix标准时间戳（秒）
AuditUserId	String	授权人Id
AuditUserName	String	授权人姓名
AuditTime	Integer	授权时间戳，格式为Unix标准时间戳（秒）
OrganizationId	String	企业Id，为32位字符串