甄零开放平台
  1. 3.合同管理
甄零开放平台
  • 开发者指南
    • 开发者指南(必读)
    • 集成示例(必读)
    • 错误码
    • 数据字典
    • 更新日志
  • 1.认证及授权
    • 1.1 获取 Token
      POST
  • 2.主数据
    • 2.1 相对方批量查询
      POST
    • 2.2 相对方创建及更新
      POST
    • 4.1 组织信息创建及更新
      POST
    • 4.2 岗位创建及更新
      POST
    • 4.3 员工创建及更新
      POST
    • 4.4 值集创建及更新
      POST
    • 4.5 独立值集值查询
      POST
    • 5.3 物料创建及更新
      POST
  • 3.合同管理
    • 查询合同关联数据
      • 3.27 查询合同相对方
      • 3.28 查询合同关联资源
      • 3.29 查询合同关联关系
      • 3.30 查询合同租赁条款
      • 3.31 查询合同扩展信息
      • 3.32 查询合同自定义合同行
      • 3.33 查询合同行
      • 3.34 查询合同付款计划
      • 3.35 查询合同收款计划
      • 3.36 查询合同审批记录
      • 3.37 查询合同归档信息
      • 3.38 查询合同归附件
      • 3.39 查询合同授权信息
      • 3.40 查询合同正文
      • 3.41 查询合同签约信息
    • 变更
      • 3.45 合同老变更删除
      • 3.46 合同新变更删除
      • 3.47 旧变更提交校验接口
      • 3.48 是否可发起新变更校验接口
      • 3.19 查询合同是否存在在途的变更
    • 3.4 合同文件上传
      POST
    • 3.5 获取文件预览链接
      POST
    • 3.6 模板变量查询
      POST
    • 3.7 合同正文及附件下载
      POST
    • 3.11 通过fileKey下载文件
      GET
    • 3.15 通用附件上传接口
      POST
    • 3.24 合同列表查询
      POST
    • 3.40 创建合同
      POST
    • 3.26 来源创建上传文件清空
      POST
    • 3.21 批量合同删除
      POST
    • 3.49 合同修改及变更
      POST
    • 合同取消归档
      POST
    • 合同履约信息更新
      POST
  • 6.合同履行
    • 6.4 付款计划支付回调-新合同履行
    • 6.5 付款计划创建-新合同履行
    • 6.6 收款计划查询
    • 6.7 开票信息查询
  • 7.工作流
    • 7.1 个人待办列表查询接口
    • 7.2 个人已办列表查询接口
    • 7.4 审批拒绝指定工作流
    • 7.5 审批同意指定工作流
    • 7.7 租户已办列表查询接口
    • 3.43 外部系统审批后回调
  1. 3.合同管理

3.49 合同修改及变更

test-测试环境
https://oc-test.onecontract-cloud.com
test-测试环境
https://oc-test.onecontract-cloud.com
POST
/api/hitf/v2/rest/async/invoke/CONTRACTTAB

请求参数

Header 参数

Body 参数application/json

示例
[
  {
    "contractInfo": {
      "operation": "UPDATE",
      "id": 320190341213332457,
      "attributeVarchar1": "TWP9",
      "contractName": "TWP2024060701精确更新9"
    },
    "extendInfo":{
      "operateType": "incremental",
      "data": {
        "operation": "UPDATE",
        "attributeDatetime1": "2024/07/26 14:31:11",
        "attributeDatetime49": "2024/07/26 14:31:11",
        "attributeDecimal51": "6666"
      }
    },
    "documentFiles": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "UPDATE",
          "id": "511345",
          "sourceTemplateNumber": "20240110007"
        },
        {
          "operation": "DELETE",
          "id": "511257"
        },
        {
          "operation": "ADD",
          "sourceKey": "TWP2024061801",
          "sourceTemplateNumber": "20231213001"
        }
      ]
    },
    "contractTrads": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "UPDATE",
          "id": "12267710",
          "partyNumber": "20240612006"
        },
        {
          "operation": "UPDATE",
          "id": "12267711",
          "partyNumber": "2024060601209TWP",
          "autoCreateTradingParty": true,
          "mainPartyName": "TWP测试61209",
          "accountType": "COMPANY",
          "certificateType": "24",
          "certificateNumber": "sdfasdfsdfsf61209",
          "customerSupplier": "S,C",
          "tradingContacts": [
            {
              "contactName": "T联系人",
              "contactType": "CHOPOWNER",
              "certificateType": "13",
              "certificateNumber": "huzhao",
              "nationality": "中国",
              "mobilePhone": "15386046280",
              "email": "1094790168@qq.com",
              "acquiescent": true,
              "employeeId": null,
              "active": true
            }
          ],
          "tradingBanks": [
            {
              "accountName": "T银行帐户名",
              "accountNumber": "T银行帐号",
              "bankName": "T银行名称",
              "branchName": "T支行名称",
              "interBankNo": "102110006579",
              "branchCountry": "中国",
              "branchProvince": "山西",
              "branchCity": "长治市",
              "branchAddress": "T支行地址",
              "acquiescent": true,
              "active": true
            }
          ]
        },
        {
          "operation": "ADD",
          "sourceKey": "TWP2024061207sourceKey",
          "partyNumber": "20240606006",
          "roleCode": "W",
          "roleOrder": "1",
          "ourParty": false,
          "ourFlag": false,
          "signatoryFlag": false
        }
      ]
    },
    "contractLines": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "TWP2024062001",
          "attributeLongtext1": "twplongtext1",
          "attributeDatetime2": "2024/06/20 15:47:01",
          "attributeDecimal3": "20.20",
          "materialsCode": "20240620010",
          "quantity": "11",
          "materialsName": "20240620010"
        }
      ]
    },
    "custContractLines": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "TWP2024062001",
          "attributeLongtext1": "twpcustlongtext1",
          "attributeDatetime2": "2024/06/19 15:47:01",
          "attributeDecimal3": "19.19",
          "customLineCode": "HCBM_CONTRACT_CUST_LINE_TABLE_FZ"
        }
      ]
    },
    "signInformations": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "TWP2024061902",
          "sealMaterial": "PHYSICALSEAL",
          "sealOrder": "DISORDER",
          "signCount": "11",
          "remark": "TWP2"
        }
      ]
    },
    "signNodes":{
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "TWP2024062001",
          "employeeNumber": "0001",
          "partyNumber": "A20240730006"
        }
      ]
    },
    "paymentPlanJs":{
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "JYY2024062001003",
          "planType": "CYCLE",
          "expenseItem": "SERVICE",
          "paymentName": "RENT",
          "totalAmount": "1000",
          "planStartDate": "2024-07-30",
          "planEndDate": "2025-07-30",
          "dimensionality": "MONTH",
          "periodInterval": "1"
        }
      ]
    },
    "collectionPlanJs":{
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "TWP202402001005",
          "planType": "ACYCLIC",
          "termCategoryCode": "SERVICE",
          "paymentName": "EQUIPMENT_VALUE",
          "planDate": "2024-07-31",
          "planAmount": 2060,
          "totalAmount": 2060,
          "noTaxAmount": 2000,
          "taxRate": 3,
          "period": 2,
          "terms": "收款条件001"
        }
      ]
    },
    "associatedInfos":{
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "JYY2024073101003",
          "relContractSerialNumber": "A20240722124",
          "relContractNumber": "A20240722125",
          "relContractId": "320190341213344341",
          "typeCode": "GC"
        }
      ]
    },
    "resources": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "UPDATE",
          "sourceKey": "twp-resource-2024081903",
          "resourceNumber": "A20220718029",
          "resourceTotal": "12.21"
        },
        {
          "operation": "ADD",
          "sourceKey": "twp-resource-2024081904",
          "resourceNumber": "A20230421003"
        }
      ]
    },
    "attachmentFiles": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "UPDATE",
          "sourceKey": "twp-attachment-2024081903",
          "fileName": "attachment.docx"
        },
        {
          "operation": "ADD",
          "sourceKey": "twp-attachment-2024081904",
          "attachmentNumber": "1733294867622",
          "fileKey": "hcbm-mdata-attachments/636/HUAWEI_CLOUD/d4b92fc7148e480eabc3ccf12370b254@attach1.docx",
          "fileName": "attach1.docx",
          "needArchive": false,
          "needSignature": false
        }
      ]
    }
  }
]

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://oc-test.onecontract-cloud.com/api/hitf/v2/rest/async/invoke/CONTRACTTAB' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Content-Type: application/json' \
--data-raw '[
  {
    "contractInfo": {
      "operation": "UPDATE",
      "id": 320190341213332457,
      "attributeVarchar1": "TWP9",
      "contractName": "TWP2024060701精确更新9"
    },
    "extendInfo":{
      "operateType": "incremental",
      "data": {
        "operation": "UPDATE",
        "attributeDatetime1": "2024/07/26 14:31:11",
        "attributeDatetime49": "2024/07/26 14:31:11",
        "attributeDecimal51": "6666"
      }
    },
    "documentFiles": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "UPDATE",
          "id": "511345",
          "sourceTemplateNumber": "20240110007"
        },
        {
          "operation": "DELETE",
          "id": "511257"
        },
        {
          "operation": "ADD",
          "sourceKey": "TWP2024061801",
          "sourceTemplateNumber": "20231213001"
        }
      ]
    },
    "contractTrads": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "UPDATE",
          "id": "12267710",
          "partyNumber": "20240612006"
        },
        {
          "operation": "UPDATE",
          "id": "12267711",
          "partyNumber": "2024060601209TWP",
          "autoCreateTradingParty": true,
          "mainPartyName": "TWP测试61209",
          "accountType": "COMPANY",
          "certificateType": "24",
          "certificateNumber": "sdfasdfsdfsf61209",
          "customerSupplier": "S,C",
          "tradingContacts": [
            {
              "contactName": "T联系人",
              "contactType": "CHOPOWNER",
              "certificateType": "13",
              "certificateNumber": "huzhao",
              "nationality": "中国",
              "mobilePhone": "15386046280",
              "email": "1094790168@qq.com",
              "acquiescent": true,
              "employeeId": null,
              "active": true
            }
          ],
          "tradingBanks": [
            {
              "accountName": "T银行帐户名",
              "accountNumber": "T银行帐号",
              "bankName": "T银行名称",
              "branchName": "T支行名称",
              "interBankNo": "102110006579",
              "branchCountry": "中国",
              "branchProvince": "山西",
              "branchCity": "长治市",
              "branchAddress": "T支行地址",
              "acquiescent": true,
              "active": true
            }
          ]
        },
        {
          "operation": "ADD",
          "sourceKey": "TWP2024061207sourceKey",
          "partyNumber": "20240606006",
          "roleCode": "W",
          "roleOrder": "1",
          "ourParty": false,
          "ourFlag": false,
          "signatoryFlag": false
        }
      ]
    },
    "contractLines": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "TWP2024062001",
          "attributeLongtext1": "twplongtext1",
          "attributeDatetime2": "2024/06/20 15:47:01",
          "attributeDecimal3": "20.20",
          "materialsCode": "20240620010",
          "quantity": "11",
          "materialsName": "20240620010"
        }
      ]
    },
    "custContractLines": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "TWP2024062001",
          "attributeLongtext1": "twpcustlongtext1",
          "attributeDatetime2": "2024/06/19 15:47:01",
          "attributeDecimal3": "19.19",
          "customLineCode": "HCBM_CONTRACT_CUST_LINE_TABLE_FZ"
        }
      ]
    },
    "signInformations": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "TWP2024061902",
          "sealMaterial": "PHYSICALSEAL",
          "sealOrder": "DISORDER",
          "signCount": "11",
          "remark": "TWP2"
        }
      ]
    },
    "signNodes":{
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "TWP2024062001",
          "employeeNumber": "0001",
          "partyNumber": "A20240730006"
        }
      ]
    },
    "paymentPlanJs":{
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "JYY2024062001003",
          "planType": "CYCLE",
          "expenseItem": "SERVICE",
          "paymentName": "RENT",
          "totalAmount": "1000",
          "planStartDate": "2024-07-30",
          "planEndDate": "2025-07-30",
          "dimensionality": "MONTH",
          "periodInterval": "1"
        }
      ]
    },
    "collectionPlanJs":{
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "TWP202402001005",
          "planType": "ACYCLIC",
          "termCategoryCode": "SERVICE",
          "paymentName": "EQUIPMENT_VALUE",
          "planDate": "2024-07-31",
          "planAmount": 2060,
          "totalAmount": 2060,
          "noTaxAmount": 2000,
          "taxRate": 3,
          "period": 2,
          "terms": "收款条件001"
        }
      ]
    },
    "associatedInfos":{
      "operateType": "incremental",
      "data": [
        {
          "operation": "ADD",
          "sourceKey": "JYY2024073101003",
          "relContractSerialNumber": "A20240722124",
          "relContractNumber": "A20240722125",
          "relContractId": "320190341213344341",
          "typeCode": "GC"
        }
      ]
    },
    "resources": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "UPDATE",
          "sourceKey": "twp-resource-2024081903",
          "resourceNumber": "A20220718029",
          "resourceTotal": "12.21"
        },
        {
          "operation": "ADD",
          "sourceKey": "twp-resource-2024081904",
          "resourceNumber": "A20230421003"
        }
      ]
    },
    "attachmentFiles": {
      "operateType": "incremental",
      "data": [
        {
          "operation": "UPDATE",
          "sourceKey": "twp-attachment-2024081903",
          "fileName": "attachment.docx"
        },
        {
          "operation": "ADD",
          "sourceKey": "twp-attachment-2024081904",
          "attachmentNumber": "1733294867622",
          "fileKey": "hcbm-mdata-attachments/636/HUAWEI_CLOUD/d4b92fc7148e480eabc3ccf12370b254@attach1.docx",
          "fileName": "attach1.docx",
          "needArchive": false,
          "needSignature": false
        }
      ]
    }
  }
]'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": "0",
    "data": {
        "batchId": "401f4357-52c5-4a1c-b5ac-7b2cde71183a"
    },
    "message": "成功"
}
上一页
3.21 批量合同删除
下一页
合同取消归档
Built with