跳到主要内容

印章相关回调

一. 印章回调通知

1. 回调触发时机

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

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

2. 回调消息类型

OperateSeal

3. 其他说明

会出现的印章Operate行为

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

印章的生命周期说明 印章的生命周期

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

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

4. 回调结构体

MsgData结构体定义

参数名称参数类型参数描述
OrganizationIdString企业 ID,为32位字符串。仅在非审核结果回调时有值
OperatorUserIdString操作人 UserId,为32位字符串。仅在非审核结果回调时有值
SealIdString对应的印章ID,为32位字符串
SealNameString对应的印章的名称
SealTypeString对应的印章类型, 类型的值包括
- OFFICIAL: 企业公章
- CONTRACT: 企业合同专用章
- ORGANIZATION_SEAL: 客户本地上传的企业印章
- LEGAL_PERSON_SEAL: 客户本地上传的法人印章
- FINANCE: 财务专用章
- PERSONNEL: 人事专用章
OperateString印章行为, 可以参考上面的 会出现的印章Operate行为
AuthorizedUsersAuthorizedUser 数组1. 如果印章授权给某些员工的行为, 此处为授权给与的员工们的信息
2. 如果是取消某些员工的印章授权, 此处为取消授权员工们的信息
3. 其他印章行为没有此字段
ReviewStatusString电子签平台审核的结果。仅在审核结果回调时有值:
PASS:通过
REJECT:拒绝
ReviewReasonString审核驳回时, 此字段表示驳回的原因。仅在审核结果回调时有值
AuthorizedOperatorUserIdString1. 如果印章授权给员工的行为, 此处为被授权员工的UserId
2. 如果是解除某个员工的印章授权, 此处为被解除授权员工的UserId
3. 其他印章行为没有此字段

AuthorizedUser结构体定义

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

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": "印章不清晰"
}
}

二. 员工执业章回调通知

1. 回调触发时机

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

2. 回调消息类型

EmployeeSealAuth

3. 回调结构体

MsgData结构体定义

参数名称参数类型参数描述
SealIdString对应的印章ID,为32位字符串
SealNameString对应的印章的名称
SealStatusInteger印章状态,初始时为0-待审核状态
OperatorNameString授权人姓名
AuthTimeInteger授权时间戳,格式为Unix标准时间戳(秒)
AuthOrganizationIdString被授权的企业Id,为32位字符串
AuthApplicationIdString被授权的应用Id,为32位字符串

4. 示例

示例一: 印章授权

{
"MsgId": "yDwFkUUckpstin4sUuZjBEY5Ia2XB7sz",
"MsgType": "EmployeeSealAuth",
"MsgVersion": "CustomApp",
"MsgData": {
"SealId": "yDRS4UUgygqdcj51UuO4zjEyWTmzsIAR",
"SealName": "张三-执业章-24070820",
"SealStatus": 0,
"OperatorName": "张三",
"AuthTime": 1720442405,
"AuthOrganizationId": "yDRSRUUgygj6qnyvUuO4zjE1vLuGdWjL",
"AuthApplicationId": ""
}
}
购买咨询
微信客服
4006-808-062
4006-808-062