合同审批

发起审批

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

第三方应用目前可通过Web嵌入页面的方式创建带有发起审批的合同。详细步骤如下：

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

调用获取发起合同嵌入链接接口时，设置BaseFlowInfo结构体中的NeedCreateReview参数为true。

示例：

{
    "Agent":{
        "AppId":"应用号ID", 
        "ProxyOperator":{
            "OpenId":"操作人openId"
        },
        "ProxyOrganizationOpenId":"子客企业openId"
    },
    "ResourceId": "模版ID",
    "ResourceType": 1, // 模版
    "FlowInfo": {
        "FlowName": "预发起合同测试",
        "FlowType": "预发起合同",
        "FlowDescription": "预发起合同审批测试",
        "NeedCreateReview": true // 开启发起方发起前审核
    },
    "FlowOption": {
        "CanEditFlow": true
    },
    "FlowApproverList": [
        {
            "ApproverType": 0,
            "OrganizationOpenId": "子客企业openId",
            "OrganizationName": "子客企业名称",
            "OpenId": "操作人openId",
            "RecipientId": "签署方ID",
            "NotChannelOrganization": false
        }
    ]
}

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

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

3. 提交审批结果

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

示例：

{
    "Agent":{
        "AppId":"应用号ID",
        "ProxyOperator":{
            "OpenId":"操作人openId"
        },
        "ProxyOrganizationOpenId":"子客企业openId"
    },
    "FlowId":"合同ID",
    "ReviewType":"PASS",
    "OperateType":"CreateReview"  // 发起审批
}

签署审批

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

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

通过API发起

1. 合同发起

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

合同发起时（需签署审批的）签署方示例：

"FlowApprovers": [{
    "ApproverType": "ORGANIZATION",
    "OpenId": "employee_open_id",
    "OrganizationOpenId":"org_open_id",
    "OrganizationName": "测试企业",
    "ApproverNeedSignReview": true,  // 签署前需要审批
    "SignComponents": [
        // 签署控件略
    ]
}]

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

{
  "Agent": {
    "ProxyOperator": {
      "OpenId": "employee_open_id"
    },
    "ProxyOrganizationOpenId": "org_open_id",
    "AppId": "yD****************************YD"
  },
  "FlowName":"购销合同",
  "FileIds":["yD****************************6e"],
  "NeedSignReview": true,
  "FlowApprovers":[
      // 签署方中无需再传ApproverNeedSignReview
    ]
}

2. 审批通知

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

示例：

{
    "Agent": {
        "ProxyOperator": {
            "OpenId": "employee_open_id"
        },
        "ProxyOrganizationOpenId": "org_open_id",
        "AppId": "yD****************************YD"
    },
    "FlowId": "yD****************************6b",  // 合同ID
    "RecipientId":"yD****************************7v",  // 签署方ID, 发起时返回或通过DescribeFlowDetailInfo获取
    "ReviewType": "PASS",
    "ReviewMessage": "企业内部审核通过，允许签署"
}

嵌入Web页面发起

1. 合同发起

嵌入Web页面的方式仅支持发起方作为签署方时本方企业的签署审批。通过在获取发起合同嵌入链接时，设置BaseFlowInfo结构体中的NeedSignReview参数为true，指明本企业签署前需要审批，审批通过之前本方企业会一直处于签署阻塞状态。

示例：

{
  "Agent":{
    "AppId":"应用号ID",
    "ProxyOperator":{
      "OpenId":"操作人openId"
    },
    "ProxyOrganizationOpenId":"子客企业openId"
  },
  "ResourceId": "模版ID",
  "ResourceType": 1, // 模版
  "FlowInfo": {
    "FlowName": "签署审批合同",
    "FlowType": "测试",
    "FlowDescription": "签署审批合同测试",
    "NeedSignReview": true // 开启发起方发起前审核
  },
  "FlowOption": {
    "CanEditFlow": true
  },
  "FlowApproverList": [
    {
      "ApproverType": 0,
      "OrganizationOpenId": "子客企业openId",
      "OrganizationName": "子客企业名称",
      "OpenId": "操作人openId",
      "RecipientId": "签署方ID",
      "NotChannelOrganization": false
    }
  ]
}

2. 审批通知

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

示例：

{
  "Agent": {
    "ProxyOperator": {
      "OpenId": "employee_open_id"
    },
    "ProxyOrganizationOpenId": "org_open_id",
    "AppId": "yD****************************YD"
  },
  "FlowId": "yD****************************6b",  // 合同ID
  "ReviewType": "PASS",
  "ReviewMessage": "企业内部审核通过，允许签署"
}