跳到主要内容

印章相关回调

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

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