1. 3.合同管理
甄零开放平台
  • 开发者指南
    • 开发者指南(必读)
    • 集成示例(必读)
    • 错误码
    • 数据字典
    • 更新日志
  • 1.认证及授权
    • 1.1 获取 Token
      POST
    • 查询异步接口处理状态
      GET
  • 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.1 创建合同
      • 3.2 合同创建进度查询
      • 3.3 清理合同上传的文件
      • 3.4 合同文件上传
    • 查询合同关联数据
      • 3.24 合同列表查询
      • 3.25 合同详情查询
      • 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.50 查询合同自定义域变量
    • 变更合同[3.45-3.48]
      • 3.19 查询合同是否存在在途的变更
      • 3.45 合同老变更删除
      • 3.46 合同新变更删除
      • 3.47 旧变更提交校验接口
      • 3.48 是否可发起新变更校验接口
    • 文件操作
      • 3.11 通过fileKey下载文件
      • 3.15 通用附件上传接口
      • 3.51 批量下载文件
      • 3.52 获取文件下载链接
    • 3.6 模板变量查询
      POST
    • 3.7 合同正文及附件下载
      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 租户已办列表查询接口
    • 7.8 外部系统审批后回调
  • 数据模型
    • 创建合同-关联对象
      • 创建合同-合同相对方
      • 创建合同-合同行
      • 创建合同-自定义合同行
      • 创建合同-签约信息
      • 创建合同-签约节点信息
      • 创建合同-合同关联关系
      • 创建合同-收款计划
      • 创建合同-付款计划
      • 创建合同-拓展信息
      • 自定义域变量
    • 合同
      • 合同查询-合同对象
      • 合同关联对象查询参数
    • 主数据
      • 物料
    • 工作流
      • 工作流任务
    • 用户上下文
    • date
    • 通用返回结构
  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"
                },
                {
                    "operation": "ADD",
                    "textFileKey": "107/94b4d90ec7684ca9a320eb232921d874@销售合同.docx",
                    "documentName": "销售合同.docx"
                }
            ]
        },
        "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 'https://oc-test.onecontract-cloud.com/api/hitf/v2/rest/async/invoke/CONTRACTTAB' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--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"
                },
                {
                    "operation": "ADD",
                    "textFileKey": "107/94b4d90ec7684ca9a320eb232921d874@销售合同.docx",
                    "documentName": "销售合同.docx"
                }
            ]
        },
        "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
Bodyapplication/json

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