3.48 是否可发起新变更校验接口

test-测试环境

https://oc-test.onecontract-cloud.com

POST

https://oc-test.onecontract-cloud.com/api/hitf/v2/rest/async/invoke/OC_CHANGE_CHECK

使用场景: 通过此接口判断是否可发起指定变更类型的变更

请求参数

Query 参数

userId

string

可选

userId，LOGINNAME 登录账号, EMAIL 邮箱, USERID 合同系统用户ID

示例值:

zhenling_openapi_admin

userIdType

string

可选

userId类型，userIdType=EMAIL时填邮箱，userIdType=USERID时填合同系统的USERID，userIdType=LOGINNAME时填合同系统的登录名

示例值:

LOGINNAME

Header 参数

Authorization

string

可选

默认值:

Body 参数application/json

contractNumber

string | null

合同编码

可选

合同流水号不传，此字段必填变更类型是：终止/补充协议删除变更单时的入参是原合同的合同编码

contractSerialNumber

string | null

合同流水号

可选

合同编码不传，此字段必填

changeType

string

变更类型

必需

作废: OBSOLETED 终止: FINAL 修改合同内容: CHANGE_INFO 补充协议: CHANGE_AGREEMENT

示例

{
    "contractNumber": "",
    "contractSerialNumber": "A2024090902",
    "changeType": "SUPPLEMENT"
}

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://oc-test.onecontract-cloud.com/api/hitf/v2/rest/async/invoke/OC_CHANGE_CHECK?userId=zhenling_openapi_admin&userIdType=LOGINNAME' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Content-Type: application/json' \
--data-raw '{
    "contractNumber": "",
    "contractSerialNumber": "A2024090902",
    "changeType": "SUPPLEMENT"
}'

返回响应

🟢200成功

application/json

Body

code

string

业务响应编码

必需

0 代表处理成功，非0代表处理失败

data

object

业务响应数据

可选

message

string

业务响应信息

必需

示例

示例 1异常示例成功示例

{
    "code": "0",
    "data": {
        "subCode": "0"
    },
    "message": "成功"
}

3.47 旧变更提交校验接口

3.19 查询合同是否存在在途的变更