跳到主要内容

印章相关回调

一. 印章创建、删除、停用、启用、授权/解除授权回调

1. 回调触发时机

在印章创建、删除、停用、启用印章时进行回调通知;可以根据回调中的Operate字段确定是哪种行为

2. 回调消息类型

OperateSeal

3. 其他说明

会出现的印章Operate行为

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

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

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

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

4. 回调结构体

MsgData结构体定义

参数名称参数类型参数描述
ApplicationIdString第三方应用的应用编号
ProxyOrganizationOpenIdString第三方平台子客企业的唯一标识,定义Agent中的ProxyOrganizationOpenId一样, 可以参考Agent结构体
ProxyOperatorOpenIdString执行对应印章动作的第三方平台子客企业员工的唯一标识
AuthorizedOperatorOpenIdString1. 如果印章授权给员工的行为, 此处为被授权员工的OpenId
2. 如果是取消某员工的印章授权, 此处为被取消授权员工的OpenId
3. 其他印章行为没有此字段
SealIdString对应的印章ID,为32位字符串
SealTypeString对应的印章类型, 类型的值包括:
OFFICIAL:企业公章
CONTRACT:企业合同专用章
ORGANIZATION_SEAL:客户本地上传的企业印章
LEGAL_PERSON_SEAL:客户本地上传的法人印章
FINANCE:财务专用章
PERSONNEL:人事专用章
OperateString印章行为, 可以参考上面的 会出现的印章Operate行为
AuthorizedUsersArray of AuthorizedUsersInfo1. 如果印章启用或者停用行为, 是此印章权限的员工们的OpenId
2. 其他印章行为没有此字段

AuthorizedUsersInfo结构体定义

参数名称参数类型参数描述
OpenIdString被授予此印章权限的第三方平台子客企业员工的唯一标识

5. 示例

{
"MsgId": "yDRIGUUgygs8oey1UuO4zjEC8S6bOcm8",
"MsgType": "OperateSeal",
"MsgVersion": "ThirdPartyApp",
"MsgData": {
"ApplicationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
"ProxyOrganizationOpenId": "org_dianziqian",
"AuthorizedOperatorOpenId":"",
"SealId": "yDxbNUyKQDxGYNUuO4zjEwvl3XYQmAcO",
"SealType": "OFFICIAL",
"ProxyOperatorOpenId": "n9527",
"Operate": "Enable",
"AuthorizedUsers": [{
"OpenId": "n02468"
}, {
"OpenId": "n13579"
}
]
}
}

二. 印章审核结果通知

1. 回调触发时机

如果创建电子印章或者控制台等上传图片的方式生成的电子印章, 会经过电子签平台审核人员的审核, 审核结果会通过此回调通知贵方

2. 回调消息类型

AuditSealAuth

3. 其他说明

印章审核一般1~3日

4. 回调结构体

MsgData结构体定义

参数名称参数类型参数描述
ApplicationIdString第三方应用的应用编号
ProxyOrganizationOpenIdString第三方平台子客企业的唯一标识,定义Agent中的ProxyOrganizationOpenId一样, 可以参考Agent结构体
SealIdString对应的印章ID,为32位字符串
SealNameString对应的印章的名称
SealTypeString对应的印章类型, 类型的值为下面:
OFFICIAL:企业公章
CONTRACT:企业合同专用章
ORGANIZATION_SEAL:客户本地上传的企业印章
LEGAL_PERSON_SEAL:客户本地上传的法人印章
FINANCE:财务专用章
PERSONNEL:人事专用章
ReviewStatusString电子签平台审核的结果, 结果的值:
PASS:审核通过
REJECT:审核驳回
ReviewReasonString审核驳回时, 此字段表示驳回的原因

5. 示例

{
"MsgId": "yDRIGUUgygs8oey1UuO4zjEC8S6bOcm8",
"MsgType": "AuditSealAuth",
"MsgVersion": "ThirdPartyApp",
"MsgData": {
"ApplicationId": "yDxbWUyKQDxgXVUuO4zjEB8mxCcDjAyF",
"ProxyOrganizationOpenId": "org_dianziqian",
"SealId": "yDxbNUyKQDxGYNUuO4zjEwvl3XYQmAcO",
"SealName": "合同专用章",
"SealType": "OFFICIAL",
"ReviewStatus": "REJECT",
"ReviewReason": "印章不清晰"
}
}

三. 用印申请审批状态通知

1. 回调触发时机

客户用印审批单状态变化会通过此回调通知贵方

2. 回调消息类型

SealPolicyWorkflow

3. 其他说明

会出现回调状态

用印申请审批状态对应SealPolicyWorkflowStatus
用印申请审批中PENDING
用印申请审批通过ALLOW
用印申请审批拒绝DENY
用印申请审批过期EXPIRE
用印申请审批取消CANCEL

4. 回调结构体

MsgData结构体定义

参数名称参数类型参数描述
ApplicationIdString第三方应用的应用编号
WorkflowInstanceIdString用印申请审批单唯一标识
SealPolicyWorkflowStatusString用印申请审批状态
NextApprovalNodeUserInfoListArray of NextApprovalNodeUserInfo下一节点的审批人信息集合
SealIdString对应的印章ID,为32位字符串
SealNameString对应的印章的名称
FlowIdString对应的合同流程ID,为32位字符串
FlowNameString对应的合同流程的名称
WorkflowCreatorIdString对应的用印申请发起人的ID,为32位字符串
WorkflowCreatorNameString对应的用印申请发起人的名称

NextApprovalNodeUserInfo结构体定义

参数名称参数类型参数描述
UserIdString审批人用户ID
UserNameString审批人用户姓名

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结构体定义

参数名称参数类型参数描述
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