跳到主要内容

印章相关回调

一. 印章回调通知​

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