印章相关回调
一. 印章创建、删除、停用、启用、授权/解除授权回调
1. 回调触发时机
在印章创建、删除、停用、启用印章时进行回调通知；可以根据回调中的Operate字段确定是哪种行为
2. 回调消息类型
OperateSeal
3. 其他说明
会出现的印章Operate行为
| 印章事件 | 对应Operate |
|---|---|
| 印章创建 | Create |
| 印章删除 | Delete |
| 印章停用 | Disable |
| 印章启用 | Enable |
| 印章更新信息 | Update |
| 印章授权给某些员工 | Valid |
| 取消某些员工的印章授权 | Invalid |
| 审批流印章审核 | Void |
| 电子签平台印章审核 | 对应Operate为空 |
印章的生命周期说明
- 在控制台/接口上传印章后，会触发【Create事件】
- 如果是系统创建的电子印章，无需经过审核，直接触发【Enable事件】，此时印章可以正常使用
- 如果是上传图片创建的电子印章，需要经过电子签后台人员进行审核，审核结果会触发【AuditSealAuth事件】(这个事件的回调可以参考下面的 印章审核结果通知)
- 如果审核通过，会触发【Enable事件】，此时印章可以正常使用
- 印章可用后，如果更新印章的基本信息（包括印章名称，印章描述，印章尺寸与印章类型），会触发【Update】事件
- 印章可用后，如果进行印章授权/取消授权操作，会触发【Valid/Invalid事件】
- 印章可用后，如果进行了停用操作，会触发【Disable事件】，此时印章不可用
- 印章停用后，如果进行了删除操作，会触发【Delete事件】
【Enable】事件可以作为印章可用的标准事件
4. 回调结构体
MsgData结构体定义
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| ApplicationId | String | 第三方应用的应用编号 |
| ProxyOrganizationOpenId | String | 第三方平台子客企业的唯一标识，定义Agent中的ProxyOrganizationOpenId一样, 可以参考Agent结构体 |
| ProxyOperatorOpenId | String | 执行对应印章动作的第三方平台子客企业员工的唯一标识 |
| AuthorizedOperatorOpenId | String | 1. 如果印章授权给员工的行为, 此处为被授权员工的OpenId 2. 如果是取消某员工的印章授权, 此处为被取消授权员工的OpenId 3. 其他印章行为没有此字段 |
| SealId | String | 对应的印章ID，为32位字符串 |
| SealName | String | 对应的印章的名称 |
| SealType | String | 对应的印章类型, 类型的值包括: OFFICIAL:企业公章 CONTRACT:企业合同专用章 ORGANIZATION_SEAL:客户本地上传的企业印章 LEGAL_PERSON_SEAL:客户本地上传的法人印章 FINANCE:财务专用章 PERSONNEL:人事专用章 |
| SubSealType | String | 对应其他印章子类型，当印章是其他子类型印章时，会回调当前字段。如需使用其他子类型印章，请联系对接客服申请开通。 |
| Operate | String | 印章行为, 可以参考上面的 会出现的印章Operate行为 |
| AuthorizedUsers | Array of AuthorizedUsersInfo | 1. 如果印章启用或者停用行为, 是此印章权限的员工们的OpenId 2. 其他印章行为没有此字段 |
| OccurTime | Integer | 本次回调对应的事件（如印章 Create/Enable/Disable/Delete/Update/Valid/Invalid 或审核节点变化）实际发生时间，Unix 标准时间戳（单位：秒）。集成方可基于该字段对同一SealId 的多条回调按时间重新排序，以修正因网络传输/重试导致的到达乱序。 |
AuthorizedUsersInfo结构体定义
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| OpenId | String | 被授予此印章权限的第三方平台子客企业员工的唯一标识 |
5. 示例
{
"MsgId": "yDRIGUUgygs8oey1UuO4zjEC8S6bOcm8",
"MsgType": "OperateSeal",
"MsgVersion": "ThirdPartyApp",
"MsgData": {
"ApplicationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
"ProxyOrganizationOpenId": "org_dianziqian",
"AuthorizedOperatorOpenId": "",
"SealId": "yDxbNUyKQDxGYNUuO4zjEwvl3XYQmAcO",
"SealName": "合同专用章",
"SealType": "OFFICIAL",
"ProxyOperatorOpenId": "n9527",
"Operate": "Enable",
"AuthorizedUsers": [
{
"OpenId": "n02468"
},
{
"OpenId": "n13579"
}
]
}
}
二. 印章审核结果通知
1. 回调触发时机
如果 创建电子印章或者控制台等上传图片的方式生成的电子印章, 会经过电子签平台审核人员的审核, 审核结果会通过此回调通知贵方
2. 回调消息类型
AuditSealAuth
3. 其他说明
印章审核一般1~3日
4. 回调结构体
MsgData结构体定义
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| ApplicationId | String | 第三方应用的应用编号 |
| ProxyOrganizationOpenId | String | 第三方平台子客企业的唯一标识，定义Agent中的ProxyOrganizationOpenId一样, 可以参考Agent结构体 |
| ProxyOperatorOpenId | String | 印章创建者的第三方平台子客企业员工的唯一标识 |
| SealId | String | 对应的印章ID，为32位字符串 |
| SealName | String | 对应的印章的名称 |
| SealType | String | 对应的印章类型, 类型的值为下面: OFFICIAL:企业公章 CONTRACT:企业合同专用章 ORGANIZATION_SEAL:客户本地上传的企业印章 LEGAL_PERSON_SEAL:客户本地上传的法人印章 FINANCE:财务专用章 PERSONNEL:人事专用章 |
| ReviewStatus | String | 电子签平台审核的结果, 结果的值: PENDING：审批中 PASS：通过 REJECT：拒绝 CHECKING:节点审批完成，待电子签平台审批 |
| ReviewReason | String | 审核驳回时, 此字段表示驳回的原因 |
| ReviewUserId | String | 当前审批人OpenId |
| NodeStatus | String | 当前审批节点状态， PENDING：审批中 PASS：通过 REJECT：拒绝 CHECKING:节点审批完成，待电子签平台审批 |
| NodeName | String | 当前审批节点名称 |
| OccurTime | Integer | 本次回调对应的事件（如印章 Create/Enable/Disable/Delete/Update/Valid/Invalid 或审核节点变化）实际发生时间，Unix 标准时间戳（单位：秒）。集成方可基于该字段对同一SealId 的多条回调按时间重新排序，以修正因网络传输/重试导致的到达乱序。 |
5. 示例
{
"MsgId": "yDRIGUUgygs8oey1UuO4zjEC8S6bOcm8",
"MsgType": "AuditSealAuth",
"MsgVersion": "ThirdPartyApp",
"MsgData": {
"ApplicationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
"ProxyOrganizationOpenId": "org_dianziqian",
"ProxyOperatorOpenId": "n9527",
"SealId": "yDxbNUyKQDxGYNUuO4zjEwvl3XYQmAcO",
"SealName": "合同专用章",
"SealType": "OFFICIAL",
"ReviewStatus": "REJECT",
"ReviewReason": "印章不清晰",
"ReviewUserId": "n02468",
"NodeName": "审批节点1",
"NodeStatus": "REJECT"
}
}
三. 用印申请审批状态通知
1. 回调触发时机
客户用印审批单状态变化会通过此回调通知贵方
2. 回调消息类型
SealPolicyWorkflow
3. 其他说明
会出现回调状态
| 用印申请审批状态 | 对应SealPolicyWorkflowStatus |
|---|---|
| 用印申请审批中 | PENDING |
| 用印申请审批通过 | ALLOW |
| 用印申请审批拒绝 | DENY |
| 用印申请审批过期 | EXPIRE |
| 用印申请审批取消 | CANCEL |
4. 回调结构体
MsgData结构体定义
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| ApplicationId | String | 第三方应用的应用编号 |
| WorkflowInstanceId | String | 用印申请审批单唯一标识 |
| SealPolicyWorkflowStatus | String | 用印申请审批状态 |
| NextApprovalNodeUserInfoList | Array of NextApprovalNodeUserInfo | 下一节点的审批人信息集合 |
| SealId | String | 对应的印章ID，为32位字符串 |
| SealName | String | 对应的印章的名称 |
| FlowId | String | 对应的合同流程ID，为32位字符串 |
| FlowName | String | 对应的合同流程的名称 |
| WorkflowCreatorId | String | 对应的用印申请发起人的ID，为32位字符串 |
| WorkflowCreatorName | String | 对应的用印申请发起人的名称 |
NextApprovalNodeUserInfo结构体定义
| 参数名称 | 参数类型 | 参数描述 |
|---|---|---|
| UserId | String | 审批人用户ID |
| UserName | String | 审批人用户姓名 |
5. 示例
{
"MsgId": "yDRIGUUgygs8oey1UuO4zjEC8S6bOcm8",
"MsgType": "SealPolicyWorkflow",
"MsgVersion": "ThirdPartyApp",
"MsgData": {
"ApplicationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
"WorkflowInstanceId": "1722174200405303290",
"SealPolicyWorkflowStatus": "PENDING",
"NextApprovalNodeUserInfoList": [
{
"UserId": "yDRS4UUgygqdcjjdUuO4zjEC0osCOsHS",
"UserName": "典子谦1"
},
{
"UserId": "yDRS4UUgygqdcjjdUuO4zjEC0osCOsHV",
"UserName": "典子谦2"
}
],
"SealId": "yDxbNUyKQDxGYNUuO4zjEwvl3XYQmAcO",
"SealName": "合同专用章",
"FlowId": "yDwFdUUckpsveo27UEQPEVo14KnASuGI",
"FlowName": "采购合同",
"WorkflowCreatorId": "yDRS4UUgygqdcjjdUuO4zjEC0osCOsHZ",
"WorkflowCreatorName": "典子谦0"
}
}
四. 员工执业章回调通知
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位字符串 |
| UserData | String | 企业调用创建个人印章授权给企业使用的授权二维码获取个人授权执业章给企业的微信二维码时,传入的参数UserData将被返回，以便业务方进行相应的对应处理 |
4. 示例
示例一: 印章授权
{
"MsgId": "yDwFkUUckpstin4sUuZjBEY5Ia2XB7sz",
"MsgType": "EmployeeSealAuth",
"MsgVersion": "CustomApp",
"MsgData": {
"SealId": "yDRS4UUgygqdcj51UuO4zjEyWTmzsIAR",
"SealName": "张三-执业章-24070820",
"SealStatus": 0,
"OperatorName": "张三",
"AuthTime": 1720442405,
"AuthOrganizationId": "yDRSRUUgygj6qnyvUuO4zjE1vLuGdWjL",
"AuthApplicationId": "",
"UserData": "QmFzZTYOIEJhc2U2NCA="
}
}