印章相关回调
一. 印章回调通知
1. 回调触发时机
在印章创建、删除、停用、启用、印章授权、解除印章授权、印章审核通过、印章审核驳回时进行回调通知
可以根据回调中的Operate字段确定是哪种行为
2. 回调消息类型
OperateSeal
3. 其他说明
会出现的印章Operate行为
| 印章事件 | 对应Operate |
|---|---|
| 印章创建 | Create |
| 印章删除 | Delete |
| 印章停用 | Disable |
| 印章启用 | Enable |
| 印章授权给某些员工 | Valid |
| 取消某些员工的印章授权 | Invalid |
| 印章审核 | 对应Operate为空 |
印章的生命周期说明
- 在控制台上传印章后，会触发【Create事件】
- 如果是系统创建的电子印章，无需经过审核，直接触发【Enable事件】，此时印章可以正常使用
- 如果是上传图片创建的电子印章，需要经过电子签后台人员进行审核，审核结果会触发【AuditSealAuth事件】
- 如果审核通过，会触发【Enable事件】，此时印章可以正常使用
- 印章可用后，如果进行印章授权/取消授权操作，会触发【Valid/Invalid事件】
- 印章可用后，如果进行了停用操作，会触发【Disable事件】，此时印章不可用
- 印章停用后，如果进行了删除操作，会触发【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 | 电子签平台审核的结果。仅在审核结果回调时有值： PASS：通过 REJECT：拒绝 |
| ReviewReason | String | 审核驳回时, 此字段表示驳回的原因。仅在审核结果回调时有值 |
| AuthorizedOperatorUserId | String | 1. 如果印章授权给员工的行为, 此处为被授权员工的UserId 2. 如果是解除某个员工的印章授权, 此处为被解除授权员工的UserId 3. 其他印章行为没有此字段 |
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": "印章不清晰"
}
}
二. 员工执业章回调通知
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": ""
}
}