搜索合同-多语言
POST
https://open.qfei.cn/open-apis/contract/v1/contracts/search/i18n
请求说明：#
| 接口频率限制 | 1000 次/分钟、50次/秒 |
|---|---|
| 权限要求 | 查看、创建、编辑和删除合同信息 |
请求参数
Authorization
在 Header 添加参数
Authorization
，其值为在 Bearer 之后拼接 Token示例：
Authorization: Bearer ********************Query 参数
Header 参数
Body 参数application/json
示例
{
"combine_condition": {
"submit_user_id": "{申请人用户id}",
"permission": 0, // 拥有的合同
"contract_status": 7, // 合同状态：已签约
"pay_type": 1, // 合同支出类型：收入类
"contract_category_name": "设备采购合同",
"contract_name": "合同名称-xx公司的合同",
"contract_number": "CT20210407000006",
"archive_number": "AT20210408000020",
// 查询提交时间在"2021-10-01 00:00:00" 到 "2021-10-08 00:00:00" 的合同
"submited_time_start": "2021-10-01 00:00:00",
"submited_time_end": "2021-10-08 00:00:00",
// 查询提交时间在"2021-10-01 00:00:00" 到 "2021-10-08 00:00:00" 的合同
"archived_time_start": "2021-10-01 00:00:00",
"archived_time_end": "2021-10-08 00:00:00",
"form": [
{
"attribute_name": "外部单据",
"module_name": "相关单据",
"attribute_value": "{\"id\":\"B76A1A02-F768-4F2E-8A42-A0B2F2BADFEE\"}"
}
]
},
"page_size": 10,
"page_token": "$pageToken" // 上一次分页请求响应中的返回值
}请求示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://open.qfei.cn/open-apis/contract/v1/contracts/search/i18n?user_id_type=user_id&lang=' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"combine_condition": {
"submit_user_id": "{申请人用户id}",
"permission": 0, // 拥有的合同
"contract_status": 7, // 合同状态：已签约
"pay_type": 1, // 合同支出类型：收入类
"contract_category_name": "设备采购合同",
"contract_name": "合同名称-xx公司的合同",
"contract_number": "CT20210407000006",
"archive_number": "AT20210408000020",
// 查询提交时间在"2021-10-01 00:00:00" 到 "2021-10-08 00:00:00" 的合同
"submited_time_start": "2021-10-01 00:00:00",
"submited_time_end": "2021-10-08 00:00:00",
// 查询提交时间在"2021-10-01 00:00:00" 到 "2021-10-08 00:00:00" 的合同
"archived_time_start": "2021-10-01 00:00:00",
"archived_time_end": "2021-10-08 00:00:00",
"form": [
{
"attribute_name": "外部单据",
"module_name": "相关单据",
"attribute_value": "{\"id\":\"B76A1A02-F768-4F2E-8A42-A0B2F2BADFEE\"}"
}
]
},
"page_size": 10,
"page_token": "$pageToken" // 上一次分页请求响应中的返回值
}'返回响应
🟢200成功
application/json
Bodyapplication/json
示例
{
"code": 0,
"data": {
"has_more": false,
"items": [
{
"approved_time": "",
"archived_time": "",
"business_type_code": 0,
"business_type_name": "合同申请",
"contract_budget_list": [],
"contract_category_abbreviation": "TEST",
"contract_category_name": "二级分类",
"contract_category_number": "02B02C",
"contract_id": 7064242957469090081,
"contract_name": "法务合同",
"contract_number": "CT20220214000001",
"contract_status_code": 3,
"contract_status_name": "process",
"contract_version": 1,
"counter_party_list": [
{
"counter_party_code": "V00043657",
"counter_party_id": "7021113741768917280",
"counter_party_name": "飞书科技有限公司"
}
],
"create_time": "1644772234530",
"create_user_id": "ou_6198bd87e2cd6c0a9c48bd7485e81a61",
"create_user_name": "测试人员",
"currency_code": "",
"currency_name": "未选择",
"estimated_amount": -1.00,
"form": "[{\"attribute_key\":\"custom_1_8462be1977114e27976dd32fb8cb9ddb\",\"attribute_name\":\"单行文本必填\",\"attribute_type\":\"singleline_text\",\"module_name\":\"测试验证\",\"attribute_value\":\"1\"},{\"attribute_key\":\"custom_10_988842d236954a11b0eae116a744f1e1\",\"attribute_name\":\"日期\",\"attribute_type\":\"date\",\"module_name\":\"测试验证\",\"attribute_value\":\"2022-02-22\"}]",
"form_id": 7054898331377467680,
"group_id": 7064242957515227430,
"our_party_list": [
{
"our_party_code": "L00125001",
"our_party_id": "7052572274884346145",
"our_party_name": "华质卓越生产力促进（北京）有限公司"
}
],
"parent_contract_category_abbreviation": "ONEPI",
"parent_contract_category_name": "XYY一级类型",
"parent_contract_category_number": "02B",
"pay_type_code": 4,
"pay_type_name": "无金额",
"payment_plan_list": [],
"property_type_code": 2,
"property_type_name": "无金额",
"remark": "1",
"signed_time": "",
"source_id": "",
"source_type_code": 0,
"source_type_name": "默认-上传文件",
"submitted_time": "1644772274140",
"template_id": 0,
"update_time": "1644772274140"
}
],
"page_token": "10"
},
"msg": "success"
}修改于 2026-08-04 03:18:50