审批

请求地址

/v2/contract/employeeaudit

请求方法

POST

请求格式

application/json;charset=UTF-8

请求参数

参数 类型 必须 描述
contractId String 合同ID,合同ID与业务ID二选一,不能同时为空
bizId String 业务ID,合同ID与业务ID二选一,不能同时为空
tenantName String 签署方名称,若以子公司身份签署,需要传递子公司全名
pass Bolean 审批是否通过
comment String 审批意见

返回参数

参数 类型 描述
responseCode String 响应码
message String 响应消息

响应码

(全局响应码请查看文档末“全局响应码”):

响应码 描述
11990005 无效的参数:参数格式错误,必传参数未传,参数超出取值范围,参数类型不正确;
11011107 未轮到签署
11101003 合同不存在
11011101 无效的合同状态
14990002 权限不匹配

请求示例

Http示例

POST /v2/contract/employeeaudit HTTP/1.1
Host: [host]
x-qys-open-timestamp: [替换为请求头生成的TimeStamp]
x-qys-open-signature: [替换为请求头生成的Signature]
x-qys-open-accesstoken: [替换为请求头生成的Token]
Content-Type: application/json
{
    "contractId": "2591540368898105360",
    "bizId": null,
    "pass": true,
    "comment": "同意"
}
Java示例

// 初始化sdkClient
String serverUrl = "https://openapi.qiyuesuo.cn";
String accessKey = "替换为您申请的开放平台App Token";
String accessSecret = "替换为您申请的开放平台App Secret";
SdkClient sdkClient = new SdkClient(serverUrl, accessKey, accessSecret);
// 审批
ContractAuditRequest request = new ContractAuditRequest(contractId, true, "审批通过");
String response = sdkClient.service(request);
SdkResponse<Object> responseObj = JSONUtils.toQysResponse(response);
if(responseObj.getResponseCode().equals("00000000")) {
  logger.info("审批成功");
} else {
  logger.info("请求失败,错误码:{},错误信息:{}", responseObj.getCode(), responseObj.getMessage());
}
C#示例

// 初始化sdkClient
string serverUrl = "https://openapi.qiyuesuo.cn";
string accessKey = "替换为您申请的开放平台App Token";
string accessSecret = "替换为您申请的开放平台App Secret";
SDKClient client = new SDKClient(accessKey, accessSecret, serverUrl);
// 组装员工审批请求
ContractAuditRequest request = new ContractAuditRequest("2589012016299597907",true, "审批通过");
string response = null;
try
{
  response = client.Service(request);
}
catch (Exception e)
{
  throw new Exception(e.Message);
}
// 解析返回内容
SdkResponse<Object> responseObject = HttpJsonConvert.DeserializeResponse<Object>(response);
if (!responseObject.ResponseCode.Equals("00000000"))
{
  throw new Exception("员工审批失败,失败原因:" + responseObject.Message);
}
Console.WriteLine(“员工审批成功”);
PHP示例

// 初始化$sdkClient
class Util {
    const     url = "https://openapi.qiyuesuo.cn";
    const     accessKey = "替换为您申请的开放平台App Token";
    const     accessSecret = "替换为您申请的开放平台App Secret";
}
$sdkClient = Util::getSDk();
$contractAuditRequest = new ContractAuditRequest();
$contractAuditRequest->setContractId('2590804900506210559');
$contractAuditRequest->setPass(true);
$contractAuditRequest->setComment('同意');
$result = $sdkClient->service($contractAuditRequest);
print_r($result);
return $result;
Python示例

# 初始化SdkClient
url = "https://openapi.qiyuesuo.cn"
accessToken = '替换为您申请的开放平台App Token'
accessSecret = '替换为您申请的开放平台App Secret'
sdkClient = SdkClient(url, accessToken, accessSecret)
# 合同审批
audit_response = sdkClient.request(ContractAuditRequest(draft_contractid, True, '符合要求,审核通过'))
# 解析返回数据
audit_mapper = json.loads(audit_response)
if audit_mapper['responseCode'] != '00000000':
    raise Exception('审批合同失败,失败原因:', audit_mapper['message'])
print('合同审批成功')
Go示例

sdkClient := http.NewSdkClient("https://openapi.qiyuesuo.cn", "替换为您申请的开放平台App Token", "替换为您申请的开放平台App Secret")
req := request.ContractAuditRequest{}
req.ContractId = "3121742127780930396"
pass := true
req.Pass = &pass
req.Comment = "掐指一算,今日不宜通过"
response, err := sdkClient.Service(req)
if err != nil {
    fmt.Println("request failed,", err.Error())
    return
}
fmt.Println(response)

审批

请求地址

/v2/contract/employeeaudit

请求方法

POST

请求格式

application/json;charset=UTF-8

请求参数

参数 类型 必须 描述
contractId String 合同ID,合同ID与业务ID二选一,不能同时为空
bizId String 业务ID,合同ID与业务ID二选一,不能同时为空
tenantName String 签署方名称,若以子公司身份签署,需要传递子公司全名
pass Bolean 审批是否通过
comment String 审批意见

返回参数

参数 类型 描述
responseCode String 响应码
message String 响应消息

响应码

(全局响应码请查看文档末“全局响应码”):

响应码 描述
11990005 无效的参数:参数格式错误,必传参数未传,参数超出取值范围,参数类型不正确;
11011107 未轮到签署
11101003 合同不存在
11011101 无效的合同状态
14990002 权限不匹配

请求示例

Http示例

POST /v2/contract/employeeaudit HTTP/1.1
Host: [host]
x-qys-open-timestamp: [替换为请求头生成的TimeStamp]
x-qys-open-signature: [替换为请求头生成的Signature]
x-qys-open-accesstoken: [替换为请求头生成的Token]
Content-Type: application/json
{
    "contractId": "2591540368898105360",
    "bizId": null,
    "pass": true,
    "comment": "同意"
}
Java示例

// 初始化sdkClient
String serverUrl = "https://openapi.qiyuesuo.cn";
String accessKey = "替换为您申请的开放平台App Token";
String accessSecret = "替换为您申请的开放平台App Secret";
SdkClient sdkClient = new SdkClient(serverUrl, accessKey, accessSecret);
// 审批
ContractAuditRequest request = new ContractAuditRequest(contractId, true, "审批通过");
String response = sdkClient.service(request);
SdkResponse<Object> responseObj = JSONUtils.toQysResponse(response);
if(responseObj.getResponseCode().equals("00000000")) {
  logger.info("审批成功");
} else {
  logger.info("请求失败,错误码:{},错误信息:{}", responseObj.getCode(), responseObj.getMessage());
}
C#示例

// 初始化sdkClient
string serverUrl = "https://openapi.qiyuesuo.cn";
string accessKey = "替换为您申请的开放平台App Token";
string accessSecret = "替换为您申请的开放平台App Secret";
SDKClient client = new SDKClient(accessKey, accessSecret, serverUrl);
// 组装员工审批请求
ContractAuditRequest request = new ContractAuditRequest("2589012016299597907",true, "审批通过");
string response = null;
try
{
  response = client.Service(request);
}
catch (Exception e)
{
  throw new Exception(e.Message);
}
// 解析返回内容
SdkResponse<Object> responseObject = HttpJsonConvert.DeserializeResponse<Object>(response);
if (!responseObject.ResponseCode.Equals("00000000"))
{
  throw new Exception("员工审批失败,失败原因:" + responseObject.Message);
}
Console.WriteLine(“员工审批成功”);
PHP示例

// 初始化$sdkClient
class Util {
    const     url = "https://openapi.qiyuesuo.cn";
    const     accessKey = "替换为您申请的开放平台App Token";
    const     accessSecret = "替换为您申请的开放平台App Secret";
}
$sdkClient = Util::getSDk();
$contractAuditRequest = new ContractAuditRequest();
$contractAuditRequest->setContractId('2590804900506210559');
$contractAuditRequest->setPass(true);
$contractAuditRequest->setComment('同意');
$result = $sdkClient->service($contractAuditRequest);
print_r($result);
return $result;
Python示例

# 初始化SdkClient
url = "https://openapi.qiyuesuo.cn"
accessToken = '替换为您申请的开放平台App Token'
accessSecret = '替换为您申请的开放平台App Secret'
sdkClient = SdkClient(url, accessToken, accessSecret)
# 合同审批
audit_response = sdkClient.request(ContractAuditRequest(draft_contractclass, True, '符合要求,审核通过'))
# 解析返回数据
audit_mapper = json.loads(audit_response)
if audit_mapper['responseCode'] != '00000000':
    raise Exception('审批合同失败,失败原因:', audit_mapper['message'])
print('合同审批成功')
Go示例

sdkClient := http.NewSdkClient("https://openapi.qiyuesuo.cn", "替换为您申请的开放平台App Token", "替换为您申请的开放平台App Secret")
req := request.ContractAuditRequest{}
req.ContractId = "3121742127780930396"
pass := true
req.Pass = &pass
req.Comment = "掐指一算,今日不宜通过"
response, err := sdkClient.Service(req)
if err != nil {
    fmt.Println("request failed,", err.Error())
    return
}
fmt.Println(response)
常见
问题
在线
客服
电话
咨询