甄零开放平台
  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.40 创建合同

test-测试环境
https://oc-test.onecontract-cloud.com
test-测试环境
https://oc-test.onecontract-cloud.com
POST
/api/hitf/v2/rest/async/invoke/SOURCE_HEADER
请先通过 「3.4 合同文件上传」 接口上传合同相关的附件。
1.
合同自动创建接口,可基于上游系统来源单据关键信息自动创建合同,合同信息包括合同头、相对方、合同行、自定义合同行、收付款计划、签约信息、关联关系、合同文本等内容。
2.
在接口中可控制是否直接创建合同草稿还是创建为中间来源单据,可控制创建的合同是否自动提交,可控制合同中的相对方信息是否自动回写相对方主数据库等。
3.创建完成结果通过异步方式回调

请求参数

Header 参数

Body 参数application/json

示例
{
    "data": [
        {
            "autoCreateFlag": true,
            "autoSubmit": true,
            "operateMethod": "",
            "sourceCode": "DEMO_20250101008",
            "sourceSystem": "oms",
            "type": "oms",
            "categoryUuid": "",
            "categoryCode": "0101",
            "categoryCodeType": "CODE",
            "templateUniqueKey": "",
            "templateUniqueKeyType": "",
            "propertyCode": "ORDINARY",
            "amount": "1000.12",
            "validDateStartType": "DATE",
            "startDate": "2025-01-01",
            "validDateEndType": "DATE",
            "endDate": "2050-01-01",
            "validFlag": "",
            "sourceName": "",
            "principalId": "",
            "principalCode": "0001",
            "principalCodeType": "CODE",
            "departmentId": "",
            "departmentCode": "1001",
            "departmentCodeType": "CODE",
            "belongingDepartmentId": "",
            "belongingDepartmentCode": "1001",
            "belongingDepartmentCodeType": "CODE",
            "reCreateNewContract": false,
            "userId": "",
            "userCode": "zhenling_openapi_admin",
            "userCodeType": "LOGIN_NAME",
            "childList": [
                {
                    "childType": "partyInformation",
                    "data": [
                        {
                            "roleCode": "J",
                            "roleOrder": "1",
                            "partyNumber": "91310115MA1K4PGE3T",
                            "ourFlag": "true",
                            "ourParty": "true",
                            "sourceKey": ""
                        },
                        {
                            "roleCode": "Y",
                            "roleOrder": "2",
                            "partyNumber": "91330108MAD23G379L",
                            "ourFlag": "false",
                            "ourParty": "false",
                            "sourceKey": ""
                        }
                    ]
                },
                {
                    "childType": "contractLine",
                    "data": [
                        {
                            "price": 100.123456,
                            "quantity": 1,
                            "materialsCode": ""
                        }
                    ]
                },
                {
                    "childType": "custContractLine",
                    "data": [
                        {
                            "customLineCode": "materials",
                            "item": "物品",
                            "attributeVarchar1": "物品描述"
                        }
                    ]
                },
                {
                    "childType": "associatedInfo",
                    "data": [
                        {
                            "relContractSerialNumber": "202504080001",
                            "relContractNumber": "CON_0120250408001",
                            "typeCode": "SC"
                        }
                    ]
                },
                {
                    "childType": "signInformation",
                    "data": [
                        {
                            "sealOrder": "OSF",
                            "sealMaterial": "PHYSICALSEAL",
                            "signCount": 2,
                            "deadline": ""
                        }
                    ]
                },
                {
                    "childType": "signNode",
                    "data": [
                        {
                            "partyNumber": "91310115MA1K4PGE3T",
                            "partyNumberType": "CODE",
                            "signatoryEmpCode": "0001",
                            "signatoryEmpCodeType": "CODE"
                        },
                        {
                            "partyNumber": "91330108MAD23G379L",
                            "partyNumberType": "CODE",
                            "signatoryName": "李四"
                        }
                    ]
                },
                {
                    "childType": "collectionPlanJ",
                    "data": [
                        {
                            "planType": "ACYCLIC",
                            "totalAmount": 100,
                            "planStartDate": "2025-01-01",
                            "planEndDate": "2025-12-31"
                        }
                    ]
                }
            ]
        }
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://oc-test.onecontract-cloud.com/api/hitf/v2/rest/async/invoke/SOURCE_HEADER' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Content-Type: application/json' \
--data-raw '{
    "data": [
        {
            "autoCreateFlag": true,
            "autoSubmit": true,
            "operateMethod": "",
            "sourceCode": "DEMO_20250101008",
            "sourceSystem": "oms",
            "type": "oms",
            "categoryUuid": "",
            "categoryCode": "0101",
            "categoryCodeType": "CODE",
            "templateUniqueKey": "",
            "templateUniqueKeyType": "",
            "propertyCode": "ORDINARY",
            "amount": "1000.12",
            "validDateStartType": "DATE",
            "startDate": "2025-01-01",
            "validDateEndType": "DATE",
            "endDate": "2050-01-01",
            "validFlag": "",
            "sourceName": "",
            "principalId": "",
            "principalCode": "0001",
            "principalCodeType": "CODE",
            "departmentId": "",
            "departmentCode": "1001",
            "departmentCodeType": "CODE",
            "belongingDepartmentId": "",
            "belongingDepartmentCode": "1001",
            "belongingDepartmentCodeType": "CODE",
            "reCreateNewContract": false,
            "userId": "",
            "userCode": "zhenling_openapi_admin",
            "userCodeType": "LOGIN_NAME",
            "childList": [
                {
                    "childType": "partyInformation",
                    "data": [
                        {
                            "roleCode": "J",
                            "roleOrder": "1",
                            "partyNumber": "91310115MA1K4PGE3T",
                            "ourFlag": "true",
                            "ourParty": "true",
                            "sourceKey": ""
                        },
                        {
                            "roleCode": "Y",
                            "roleOrder": "2",
                            "partyNumber": "91330108MAD23G379L",
                            "ourFlag": "false",
                            "ourParty": "false",
                            "sourceKey": ""
                        }
                    ]
                },
                {
                    "childType": "contractLine",
                    "data": [
                        {
                            "price": 100.123456,
                            "quantity": 1,
                            "materialsCode": ""
                        }
                    ]
                },
                {
                    "childType": "custContractLine",
                    "data": [
                        {
                            "customLineCode": "materials",
                            "item": "物品",
                            "attributeVarchar1": "物品描述"
                        }
                    ]
                },
                {
                    "childType": "associatedInfo",
                    "data": [
                        {
                            "relContractSerialNumber": "202504080001",
                            "relContractNumber": "CON_0120250408001",
                            "typeCode": "SC"
                        }
                    ]
                },
                {
                    "childType": "signInformation",
                    "data": [
                        {
                            "sealOrder": "OSF",
                            "sealMaterial": "PHYSICALSEAL",
                            "signCount": 2,
                            "deadline": ""
                        }
                    ]
                },
                {
                    "childType": "signNode",
                    "data": [
                        {
                            "partyNumber": "91310115MA1K4PGE3T",
                            "partyNumberType": "CODE",
                            "signatoryEmpCode": "0001",
                            "signatoryEmpCodeType": "CODE"
                        },
                        {
                            "partyNumber": "91330108MAD23G379L",
                            "partyNumberType": "CODE",
                            "signatoryName": "李四"
                        }
                    ]
                },
                {
                    "childType": "collectionPlanJ",
                    "data": [
                        {
                            "planType": "ACYCLIC",
                            "totalAmount": 100,
                            "planStartDate": "2025-01-01",
                            "planEndDate": "2025-12-31"
                        }
                    ]
                }
            ]
        }
    ]
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": "100250",
    "data": {
        "results": [
            {
                "endDate": "2050-01-01",
                "validFlag": "",
                "sourceSystem": "oms",
                "departmentId": "",
                "departmentCode": "1001",
                "principalId": "",
                "childList": [
                    {
                        "childType": "partyInformation",
                        "data": [
                            {
                                "sourceKey": "",
                                "ourParty": "true",
                                "roleCode": "J",
                                "ourFlag": "true",
                                "roleOrder": "1",
                                "partyNumber": "91310115MA1K4PGE3T"
                            },
                            {
                                "sourceKey": "",
                                "ourParty": "false",
                                "roleCode": "Y",
                                "ourFlag": "false",
                                "roleOrder": "2",
                                "partyNumber": "91330108MAD23G379L"
                            }
                        ]
                    },
                    {
                        "childType": "contractLine",
                        "data": [
                            {
                                "quantity": "1",
                                "price": "100.123456",
                                "materialsCode": ""
                            }
                        ]
                    },
                    {
                        "childType": "custContractLine",
                        "data": [
                            {
                                "item": "物品",
                                "customLineCode": "materials",
                                "attributeVarchar1": "物品描述"
                            }
                        ]
                    },
                    {
                        "childType": "associatedInfo",
                        "data": [
                            {
                                "relContractSerialNumber": "202504080001",
                                "relContractNumber": "CON_0120250408001",
                                "typeCode": "SC"
                            }
                        ]
                    },
                    {
                        "childType": "signInformation",
                        "data": [
                            {
                                "signCount": "2",
                                "sealOrder": "OSF",
                                "sealMaterial": "PHYSICALSEAL",
                                "deadline": ""
                            }
                        ]
                    },
                    {
                        "childType": "signNode",
                        "data": [
                            {
                                "signatoryEmpCodeType": "CODE",
                                "partyNumberType": "CODE",
                                "signatoryEmpCode": "0001",
                                "partyNumber": "91310115MA1K4PGE3T"
                            },
                            {
                                "partyNumberType": "CODE",
                                "signatoryName": "李四",
                                "partyNumber": "91330108MAD23G379L"
                            }
                        ]
                    },
                    {
                        "childType": "collectionPlanJ",
                        "data": [
                            {
                                "totalAmount": "100",
                                "planType": "ACYCLIC",
                                "planStartDate": "2025-01-01",
                                "planEndDate": "2025-12-31"
                            }
                        ]
                    }
                ],
                "type": "oms",
                "userCodeType": "LOGIN_NAME",
                "userCode": "zhenling_openapi_admin",
                "autoSubmit": true,
                "sourceCode": "DEMO_20250101007",
                "propertyCode": "ORDINARY",
                "validDateStartType": "DATE",
                "principalCode": "0001",
                "subCode": "500003",
                "belongingDepartmentCode": "1001",
                "departmentCodeType": "CODE",
                "validDateEndType": "DATE",
                "belongingDepartmentId": "",
                "templateUniqueKeyType": "",
                "amount": "1000.12",
                "operateMethod": "",
                "categoryCode": "0101",
                "autoCreateFlag": true,
                "principalCodeType": "CODE",
                "reCreateNewContract": false,
                "userId": "",
                "categoryCodeType": "CODE",
                "categoryUuid": "",
                "templateUniqueKey": "",
                "belongingDepartmentCodeType": "CODE",
                "sourceName": "",
                "subMessage": "[DEMO_20250101007]来源单数据已经创建了非草稿状态的合同, 需要先作废已存在合同再来源创建",
                "startDate": "2025-01-01"
            }
        ]
    },
    "message": "简单校验失败"
}
上一页
3.24 合同列表查询
下一页
3.26 来源创建上传文件清空
Built with