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.10 合同模板查询
      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.10 合同模板查询

test-测试环境
https://oc-test.onecontract-cloud.com
test-测试环境
https://oc-test.onecontract-cloud.com
POST
/api/hitf/v2p/rest/invoke/SFpFUk86T1JDSEVTVFJBVElPTjpISVRGLkFQSS5EQVRBX1FVRVJZ
使用场景:按模板最后更新时间,分页查询本租户状态为「有效」的合同模板。查到的 templateUuid 可作为【3.6 模板变量查询】的 templateUniqueKey。
错误返回:
情形返回
page、size 缺失或小于 1;startTime、endTime 缺失success=true,result.errcode=-1,result.errmsg 依次列出所有不合法的参数,如 Invalid parameter [page]Invalid parameter [startTime]
condition 里用了不支持的字段(见 condition 说明)success=false,message=execute failed,不返回 result

请求参数

Query 参数

Header 参数

Body 参数application/json

示例
{
    "page": 1,
    "size": 10,
    "startTime": "2025-01-01 00:00:00",
    "endTime": "2025-12-31 23:59:59",
    "condition": {
        "templateNumber@EQUAL": "YOUR_TEMPLATE_NUMBER",
        "currentFlag@EQUAL": "1"
    }
}

请求示例代码

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/v2p/rest/invoke/SFpFUk86T1JDSEVTVFJBVElPTjpISVRGLkFQSS5EQVRBX1FVRVJZ?domain=CONTRACT_TEMPLATE' \
--header 'Authorization: bearer eb2446a6-93f9-456b-b713-5cb6f6adf765' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 1,
    "size": 10,
    "startTime": "2025-01-01 00:00:00",
    "endTime": "2025-12-31 23:59:59",
    "condition": {
        "templateNumber@EQUAL": "YOUR_TEMPLATE_NUMBER",
        "currentFlag@EQUAL": "1"
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "message": "execute success",
    "result": {
        "errcode": "0",
        "errmsg": "ok",
        "data": {
            "content": [
                {
                    "templateUuid": "6f1c2e9a4b7d4e0f9a3b5c7d9e1f2a3b",
                    "templateNumber": "YOUR_TEMPLATE_NUMBER",
                    "templateName": "采购合同模板",
                    "version": "1",
                    "currentFlag": true,
                    "groupUuid": "8a2b4c6d8e0f4a1b3c5d7e9f1a3b5c7d",
                    "statusCode": "V",
                    "editMode": "FTE",
                    "templateType": "CONTRACT",
                    "contractPropertyCode": "ORDINARY",
                    "templateSourceCode": "I",
                    "fileName": "采购合同模板.docx",
                    "fileKey": "hcbm-template/1000/HUAWEI_CLOUD/2025Y/03M/6f1c2e9a4b7d4e0f9a3b5c7d9e1f2a3b@采购合同模板.docx",
                    "fileType": "MC",
                    "categoryUuid": "3e5f7a9b1c3d4e5f7a9b1c3d5e7f9a1b",
                    "categoryName": "采购类合同",
                    "categoryCode": "PURCHASE",
                    "startDate": "2025-03-01 00:00:00",
                    "endDate": "2027-12-31 00:00:00",
                    "creatorId": "100000000000000001",
                    "creatorName": "张三",
                    "createdByName": "张三",
                    "allowFileRewrite": true,
                    "openRevision": false,
                    "modifyFlag": false,
                    "preCheckStatus": "SUCCESS",
                    "tenantId": "1000",
                    "id": "0",
                    "createdBy": "100000000000000001",
                    "creationDate": "2025-03-01 10:00:00",
                    "lastUpdatedBy": "100000000000000001",
                    "lastUpdateDate": "2025-03-01 10:05:00",
                    "objectVersionNumber": "3"
                }
            ],
            "totalPages": 1,
            "page": "1",
            "size": 10
        }
    },
    "success": true
}
上一页
3.7 合同正文及附件下载
下一页
3.21 批量删除合同
Built with