合同审批

发起审批

在某些情况下，企业发起合同需要先经过相关人员的审批，只有审批通过之后才能真正发起合同。

自建应用目前在以下合同发起方式下开放了发起审批功能：

控制台发起

通过控制台发起合同时，在最后一步打开【更多设置】里的【合同审批】选项，即可开启审批功能，开启后只有相应审批人(下图点击"查看审批人"可见)审批通过后才成功发起合同。

通过控制台发起的带有审批功能的合同，需要审批人在控制台的【待办中心】进行审批。审批人的配置请参见审批流程配置，配置【合同审批】审批流。

注意：审批流是用电子签内置审批的场景，只支持电子签SaaS控制台发起合同的审批，不支持通过接口审批。

嵌入Web页面发起

1. 获取发起合同嵌入链接

调用创建发起流程web页面接口时，设置NeedCreateReview参数为true。

示例：

{
    "Operator":{
        "UserId": "yD****************************o3"
    },
    "ResourceType":1,
    "ResourceId":"yD****************************B2",
    "FlowName": "带发起审批的合同",
    "NeedCreateReview":true,  // 只有审批通过合同才可见
    "Approvers":[{
        "ApproverType":1,
        "ApproverName":"张三",
        "ApproverMobile":"186********",
        "RecipientId": "yD****************************m4"
    },{
        "ApproverType":3,
        "RecipientId": "yD****************************25"
    }]
}

2. 通过嵌入页面预发起合同

访问上一步响应体中的Url链接，点击「提交审批」预发起合同。

3. 提交审批结果

调用CreateFlowSignReview接口提交审批结果：

示例：

{
   "Operator":{
        "UserId": "yD****************************hZ"
    },
    "FlowId": "yD****************************HG",
    "ReviewType":"PASS",
    "OperateType":"CreateReview"  // 合同发起审批
}

签署审批

在某些情况下，合同中的某些企业签署方，只有在合同经过企业相关人员审批通过之后才能进行盖章操作。此场景多见于将企业内部审批流与电子签的自动签署功能相结合，明确责任的同时提升企业效率。

自建应用支持通过API或嵌入Web页面的方式发起带有签署审批的合同，集成流程如下图所示：

通过API发起

1. 合同发起

在发起合同的时候（模版发起见CreateFlow，文件发起见CreateFlowByFiles），针对签署前需要审批的签署方，设置Approvers字段中的ApproverNeedSignReview参数为true，指明需要走审批流程。审核通过之前该签署方会一直处于签署阻塞状态。

示例（文件发起为例）：

{
    "Operator":{
        "UserId": "yD****************************hZ"
    },
    "FlowName":"带签署审批的合同",
    "FileIds":["yD****************************Ex"],
    "Approvers":[{
        "ApproverType":1,
        "ApproverName":"张三",
        "ApproverMobile":"186********",
        "SignComponents":[{
            "ComponentPosX": 100.15625,
            "ComponentPosY": 0.78125,
            "ComponentWidth": 100,
            "ComponentHeight": 100,
            "FileIndex": 0,
            "ComponentPage": 1,
            "ComponentType":"SIGN_SIGNATURE"
        }]
    },{
        "ApproverType":3,
        "OrganizationName":"腾讯云计算（北京）有限责任公司",
        "ApproverNeedSignReview":true,  // 审批通过后企业端才能签署（自动盖章）
        "SignComponents":[{
            "GenerateMode": "FIELD",
            "ComponentName": "seal",
            "FileIndex": 0,
            "ComponentType":"SIGN_SEAL",
            "ComponentValue":"yD****************************Rg"
        }]
    }]
}

注：对于本方企业的签署审批（比如自动签），可以在发起时直接将合同维度的NeedSignReview字段传true，这样审批时可忽略RecipientId字段。通过文件发起示例：

{
    "Operator":{
        "UserId": "yD****************************hZ"
    },
    "FlowName":"带签署审批的合同",
    "FileIds":["yD****************************Ex"],
    "NeedSignReview": true, 
    "Approvers":[
      // 签署方中无需再传ApproverNeedSignReview
    ]
}

2. 审批通知

合同在企业内部通过审批后，业务方通过CreateFlowSignReview接口通知腾讯电子签，解除合同阻塞状态。

示例：

{
  "Operator":{
    "UserId": "yD****************************hZ"
  },
  "FlowId": "yD****************************wy",
  "RecipientId":"yD****************************7v",  // 签署方ID, 发起时返回或通过DescribeFlowInfo获取
  "ReviewType":"PASS"
}

嵌入Web页面发起

1. 合同发起

嵌入Web页面的方式仅支持发起方作为签署方时本方企业的签署审批。通过在创建发起流程web页面时，设置NeedSignReview为true，指明本企业签署前需要审批，审批通过之前合同会一直处于签署阻塞状态。

示例（模版发起为例）：

{
    "Operator":{
        "UserId": "yD****************************o3"
    },
    "ResourceType":1,
    "ResourceId":"yD****************************B2",
    "FlowName": "带签署审批的合同",
    "NeedSignReview":true,
    "Approvers":[{
        "ApproverType":1,
        "ApproverName":"张三",
        "ApproverMobile":"186********",
        "RecipientId": "yD****************************m4"
    },{
        "ApproverType":3,
        "RecipientId": "yD****************************25"
    }]
}

2. 审批通知

合同在企业内部通过审批后，业务方通过CreateFlowSignReview接口通知腾讯电子签，解除合同阻塞状态。

示例：

{
   "Operator":{
        "UserId": "yD****************************hZ"
    },
    "FlowId": "yD****************************wy",
    "ReviewType":"PASS"
}