1. 合同管理
智书合同API
  • 智书开放平台概述
  • 开发对接流程
  • 基本概念
    • 应用鉴权
    • 用户身份体系
  • 对接方式
    • 选择对接方式
    • 【识别用户身份】选择自建应用的方式快速对接
    • 智书开平与飞书开平对接差异
      • 智书合同新用户流程差异
      • 从飞书合同迁移到智书合同流程差异
  • API调用指南
    • API列表
    • 频控策略
    • 调用流程
      • 流程概述
      • 获取访问凭证
      • 调用API
  • 事件订阅
    • 事件概述
    • 事件列表
    • 订阅流程
      • 获取 Encrypt Key
      • 获取 Verification Token
      • 添加事件
      • 接收并处理事件
      • 配置订阅方式
  • 认证及授权
    • 获取访问凭证
      • 获取 tenant_access_token
  • 智书合同
    • 合同类型
      • 查询合同类型目录
    • 模版管理
      • 查看模板列表
      • 创建模版实例
      • 查看模版详情
    • 文件管理
      • 上传合同相关文件
      • 下载合同相关文件
    • 合同管理
      • 事件
        • 协商事件
        • 合同信息变更
        • 合同状态变更
        • 合同分享事件
        • 取消合同分享事件
      • form表单、币种、国家说明
        • 合同创建Form组件说明
        • 币种说明
        • 国家地区编码
      • 创建合同
        POST
      • 删除草稿合同
        DELETE
      • 提交合同
        POST
      • 重新提交合同
        POST
      • 更新合同
        PATCH
      • 更新合同字段信息
        PUT
      • 查看合同详情
        GET
      • 搜索合同
        POST
      • 根据合同编号查询
        POST
      • 合同协商操作记录信息查询
        GET
      • 合同电子签转纸质签
        POST
      • 查询合同分享记录
        GET
    • 付款
      • 事件
        • 合同新建付款
      • 创建付款申请
      • 更新付款信息
      • 查看付款信息
      • 查询付款申请列表
    • 付款计划
      • 同步付款记录
      • 搜索付款计划
    • 付款记录
      • 创建付款记录
      • 更新付款记录
      • 查询付款记录详情
      • 根据付款计划id查询付款记录
    • 审批管理
      • 发起流程审批
      • 查询审批实例详情
    • 合同权限管理
      • 授予合同权限
      • 合同分享
    • 文件
      • 生成合同打印文件
    • 合同协商
      • 查询合同协商邀请链接
    • 电子签
      • 获取个人认证&授权页面链接
      • 获取机构认证&授权页面链接
    • 审批事件
      • 审批-待办任务变更
      • 审批-抄送、知会状态变更
    • 事件ip
      • 获取事件出口IP
    • 审批矩阵
      • 矩阵-预发布规则表配置
      • 矩阵-发布规则表配置
      • 矩阵-查询规则表列表
      • 矩阵-查询规则表列头信息
      • 矩阵-创建规则表行
      • 矩阵-删除规则表行
      • 矩阵-修改规则表行
      • 矩阵-根据行ID查询规则表单行信息
      • 矩阵-根据筛选条件查询规则表行信息列表
      • 矩阵-查询规则表行信息列表
  • 智书主数据
    • 固定汇率
      • 更新固定汇率
      • 查询固定汇率
    • 交易方
      • 事件
        • 交易方-基础信息变更
        • 交易方-公司视图变更
        • 交易方-联系人变更
        • 交易方-经营地址变更
        • 交易方-银行账户变更
      • 创建交易方
      • 更新交易方
      • 获取交易方
      • 获取单个交易方信息
      • 获取交易方全量数据
      • 根据证件id精确查询交易方
      • 字段配置查询
    • 法人实体
      • 创建法人实体
      • 更新法人实体信息
      • 获取法人实体
      • 获取单个法人实体信息
      • 获取法人实体全量数据
    • 文件
      • 下载主数据附件
  • 第三方系统相关配置
    • 关联单据
      • 关联前置单据
    • 外部数据回填
      • 表单字段回填
      • 审批人回填
    • 外部校验
      • 外部校验
  1. 合同管理

搜索合同

POST
https://open.qfei.cn/open-apis/contract/v1/contracts/search

请求说明:#

接口频率限制1000 次/分钟、50次/秒
权限要求查看、创建、编辑和删除合同信息

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Query 参数

Header 参数

Body 参数application/json

示例
{
    "page_size": 0,
    "page_token": "tblKz5D60T4JlfcT",
    "contract_number": "CT20210708000030",
    "combine_condition": {
        "user_id": "d84df55b",
        "permission": 0,
        "contract_status": 3,
        "pay_type": 0,
        "contract_category_name": "技术咨询合同",
        "contract_name": "合同名称",
        "contract_number": "CT20210708000030",
        "archive_number": "AT20210708000030",
        "create_time_start": "2021-10-01 11:11:11",
        "create_time_end": "2021-10-01 11:11:11",
        "update_time_start": "2021-10-01 11:11:11",
        "update_time_end": "2021-10-01 11:11:11",
        "submited_time_start": "2021-10-01 11:11:11",
        "submited_time_end": "2021-10-01 11:11:11",
        "archived_time_start": "2021-10-01 11:11:11",
        "archived_time_end": "2021-10-01 11:11:11",
        "owner_user_id": "d84df55b",
        "form": [
            {
                "attribute_name": "受理人",
                "attribute_value": "6982118143107809580",
                "module_name": "相关单据"
            },
            {
                "attribute_name": "受理人",
                "attribute_value": "6982118143107809580",
                "module_name": "相关单据"
            },
            {
                "attribute_name": "受理人",
                "attribute_value": "6982118143107809580",
                "module_name": "相关单据"
            }
        ],
        "contract_status_in": "1,2,3",
        "contract_category_abbreviation": "CUBG"
    }
}

请求示例代码

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://open.qfei.cn/open-apis/contract/v1/contracts/search?user_id_type=user_id' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page_size": 0,
    "page_token": "tblKz5D60T4JlfcT",
    "contract_number": "CT20210708000030",
    "combine_condition": {
        "user_id": "d84df55b",
        "permission": 0,
        "contract_status": 3,
        "pay_type": 0,
        "contract_category_name": "技术咨询合同",
        "contract_name": "合同名称",
        "contract_number": "CT20210708000030",
        "archive_number": "AT20210708000030",
        "create_time_start": "2021-10-01 11:11:11",
        "create_time_end": "2021-10-01 11:11:11",
        "update_time_start": "2021-10-01 11:11:11",
        "update_time_end": "2021-10-01 11:11:11",
        "submited_time_start": "2021-10-01 11:11:11",
        "submited_time_end": "2021-10-01 11:11:11",
        "archived_time_start": "2021-10-01 11:11:11",
        "archived_time_end": "2021-10-01 11:11:11",
        "owner_user_id": "d84df55b",
        "form": [
            {
                "attribute_name": "受理人",
                "attribute_value": "6982118143107809580",
                "module_name": "相关单据"
            },
            {
                "attribute_name": "受理人",
                "attribute_value": "6982118143107809580",
                "module_name": "相关单据"
            },
            {
                "attribute_name": "受理人",
                "attribute_value": "6982118143107809580",
                "module_name": "相关单据"
            }
        ],
        "contract_status_in": "1,2,3",
        "contract_category_abbreviation": "CUBG"
    }
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "msg": "success",
    "code": 0,
    "data": {
        "page_token": "1062544079818064208",
        "has_more": true,
        "items": [
            {
                "end_date": "2025-11-30",
                "signed_time": "",
                "contract_version": 1,
                "create_user_name": "周丹",
                "counter_party_list": [
                    {
                        "certification_id": "91110105MA01AA4C3K",
                        "register_address": {
                            "country": "中国大陆",
                            "detail_address": "1"
                        },
                        "certification_name": "统一社会信用代码",
                        "counter_party_code": "A00000038",
                        "counter_party_name": "北京有此山文化传媒有限公司",
                        "sign_party_no": 0,
                        "certification_type": "0",
                        "trading_party_property_code": 0,
                        "counter_party_id": "1061071581373023049",
                        "certifications": [
                            {
                                "certification_id": "91110105MA01AA4C3K",
                                "certification_name": "统一社会信用代码",
                                "certification_type": "0",
                                "status": 1
                            }
                        ]
                    }
                ],
                "archived_time": "",
                "contract_id": 1062544079818064208,
                "contract_budget_list": [],
                "business_type_name": "合同申请",
                "remark": "甲乙双方本着自愿、公平、诚信的原则,依据《中华人民共和国民法典》及相关法律的规定,就甲方购买乙方提供的自研产品或定制化服务事宜达成一致,特订立本合同。",
                "out_currency_code": "USD",
                "contract_status_code": 3,
                "currency_code": "USD",
                "create_employee_id": "27ae7d5a",
                "contract_category_name": "销售类合同-周丹演示",
                "pay_type_code": 2,
                "update_time": "1762743012059",
                "contract_number": "2025110300019",
                "complete_time": "",
                "contract_category_number": "00U001",
                "submitter_user_name": "Bingo",
                "approved_time": "",
                "submitter_user_id": "239cc8bc",
                "in_currency_name": "美元",
                "property_type_name": "fixed",
                "start_date": "2025-11-30",
                "create_user_id": "27ae7d5a",
                "amount": 5000.00,
                "currency_name": "美元",
                "create_time": "1762157621995",
                "business_type_code": 0,
                "department_id": "od-850918a4be34ba792bca979250f5a980",
                "department_name": "解决方案2组",
                "contract_name": "20251103烽火商业服务合同修订版1(V3.0)",
                "submitted_time": "1762157663750",
                "out_currency_name": "美元",
                "contract_status_name": "process",
                "group_id": 1062544079818080592,
                "pay_type_name": "支出类",
                "our_party_list": [
                    {
                        "our_party_name": "上海智书企飞软件技术有限公司",
                        "certification_id": "91310110MA7K2R9N8N",
                        "country": "中国大陆",
                        "certification_name": "统一社会信用代码",
                        "legal_person": "吴彦祖",
                        "address": "北京市朝阳区东风南路8号东枫德必WE人工智能创新基地G栋4层",
                        "sign_party_no": 0,
                        "certification_type": "0",
                        "our_party_code": "L00102002",
                        "tele_phone": "19900006666",
                        "bank_accounts": [
                            {
                                "bank_code": "308100006273",
                                "country": "中国大陆",
                                "bank_id": "1045022586326483834",
                                "account_name": "上海智书企飞软件技术有限公司",
                                "bank_name": "招商银行股份有限公司北京金安支行",
                                "account": "3459871094578139",
                                "selected": true
                            },
                            {
                                "bank_code": "105267100120",
                                "country": "中国大陆",
                                "bank_id": "1066168532225491792",
                                "account_name": "上海智书企飞软件技术有限公司",
                                "bank_name": "建设银行股份有限公司宝泉岭宝建分理处",
                                "account": "443421413",
                                "selected": false
                            }
                        ],
                        "our_party_id": "971960647459799901"
                    }
                ],
                "property_type_code": 0,
                "owner_employee_id": 912658461680993373,
                "in_currency_code": "USD"
            },
            {
                "end_date": "2025-11-30",
                "signed_time": "",
                "contract_version": 1,
                "create_user_name": "周丹",
                "counter_party_list": [
                    {
                        "certification_id": "91110105MA01AA4C3K",
                        "register_address": {
                            "country": "中国大陆",
                            "detail_address": "1"
                        },
                        "certification_name": "统一社会信用代码",
                        "counter_party_code": "A00000038",
                        "counter_party_name": "北京有此山文化传媒有限公司",
                        "sign_party_no": 0,
                        "certification_type": "0",
                        "trading_party_property_code": 0,
                        "counter_party_id": "1061071581373023049",
                        "certifications": [
                            {
                                "certification_id": "91110105MA01AA4C3K",
                                "certification_name": "统一社会信用代码",
                                "certification_type": "0",
                                "status": 1
                            }
                        ]
                    }
                ],
                "archived_time": "",
                "contract_id": 1062540171783700816,
                "contract_budget_list": [],
                "business_type_name": "合同申请",
                "remark": "甲乙双方本着自愿、公平、诚信的原则,依据《中华人民共和国民法典》及相关法律的规定,就甲方购买乙方提供的自研产品或定制化服务事宜达成一致,特订立本合同。",
                "contract_status_code": 6,
                "create_employee_id": "27ae7d5a",
                "contract_category_name": "销售类合同-周丹演示",
                "pay_type_code": 4,
                "update_time": "1763015288311",
                "contract_number": "2025110300018",
                "complete_time": "",
                "contract_category_number": "00U001",
                "submitter_user_name": "Bingo",
                "approved_time": "1763015288311",
                "submitter_user_id": "239cc8bc",
                "property_type_name": "none",
                "start_date": "2025-11-30",
                "create_user_id": "27ae7d5a",
                "create_time": "1762156712083",
                "business_type_code": 0,
                "department_id": "od-850918a4be34ba792bca979250f5a980",
                "department_name": "解决方案2组",
                "contract_name": "20251103烽火商业服务合同修订版1(V3.0)",
                "submitted_time": "1762157740774",
                "contract_status_name": "signing",
                "group_id": 1062540171787895120,
                "pay_type_name": "无收无支",
                "our_party_list": [
                    {
                        "our_party_name": "上海智书企飞软件技术有限公司",
                        "certification_id": "91310110MA7K2R9N8N",
                        "country": "中国大陆",
                        "certification_name": "统一社会信用代码",
                        "legal_person": "吴彦祖",
                        "address": "北京市朝阳区东风南路8号东枫德必WE人工智能创新基地G栋4层",
                        "sign_party_no": 0,
                        "certification_type": "0",
                        "our_party_code": "L00102002",
                        "tele_phone": "19900006666",
                        "bank_accounts": [
                            {
                                "bank_code": "308100006273",
                                "country": "中国大陆",
                                "bank_id": "1045022586326483834",
                                "account_name": "上海智书企飞软件技术有限公司",
                                "bank_name": "招商银行股份有限公司北京金安支行",
                                "account": "3459871094578139",
                                "selected": true
                            },
                            {
                                "bank_code": "105267100120",
                                "country": "中国大陆",
                                "bank_id": "1066168532225491792",
                                "account_name": "上海智书企飞软件技术有限公司",
                                "bank_name": "建设银行股份有限公司宝泉岭宝建分理处",
                                "account": "443421413",
                                "selected": false
                            }
                        ],
                        "our_party_id": "971960647459799901"
                    }
                ],
                "property_type_code": 2,
                "owner_employee_id": 912658461680993373
            },
            {
                "end_date": "2025-11-30",
                "signed_time": "",
                "contract_version": 1,
                "create_user_name": "周丹",
                "counter_party_list": [
                    {
                        "certification_id": "91110105MA01AA4C3K",
                        "register_address": {
                            "country": "中国大陆",
                            "detail_address": "1"
                        },
                        "certification_name": "统一社会信用代码",
                        "counter_party_code": "A00000038",
                        "counter_party_name": "北京有此山文化传媒有限公司",
                        "sign_party_no": 0,
                        "certification_type": "0",
                        "trading_party_property_code": 0,
                        "counter_party_id": "1061071581373023049",
                        "certifications": [
                            {
                                "certification_id": "91110105MA01AA4C3K",
                                "certification_name": "统一社会信用代码",
                                "certification_type": "0",
                                "status": 1
                            }
                        ]
                    }
                ],
                "archived_time": "",
                "contract_id": 1062537368193466697,
                "contract_budget_list": [],
                "business_type_name": "合同申请",
                "remark": "无",
                "contract_status_code": 1,
                "create_employee_id": "27ae7d5a",
                "contract_category_name": "销售类合同-周丹演示",
                "pay_type_code": 4,
                "update_time": "1763452072131",
                "contract_number": "2025110300017",
                "complete_time": "",
                "contract_category_number": "00U001",
                "submitter_user_name": "周丹",
                "approved_time": "",
                "submitter_user_id": "27ae7d5a",
                "property_type_name": "none",
                "start_date": "2025-11-30",
                "create_user_id": "27ae7d5a",
                "create_time": "1762156059320",
                "business_type_code": 0,
                "department_id": "od-eb753f6ddb261ef669c5acb6150cdb23",
                "department_name": "解决方案",
                "contract_name": "20251107产品销售合同",
                "submitted_time": "1762156274626",
                "contract_status_name": "cancelled",
                "group_id": 1062537368201855305,
                "pay_type_name": "无收无支",
                "our_party_list": [
                    {
                        "our_party_name": "上海智书企飞软件技术有限公司",
                        "certification_id": "91310110MA7K2R9N8N",
                        "country": "中国大陆",
                        "certification_name": "统一社会信用代码",
                        "legal_person": "吴彦祖",
                        "address": "北京市朝阳区东风南路8号东枫德必WE人工智能创新基地G栋4层",
                        "sign_party_no": 0,
                        "certification_type": "0",
                        "our_party_code": "L00102002",
                        "tele_phone": "19900006666",
                        "bank_accounts": [
                            {
                                "bank_code": "308100006273",
                                "country": "中国大陆",
                                "bank_id": "1045022586326483834",
                                "account_name": "上海智书企飞软件技术有限公司",
                                "bank_name": "招商银行股份有限公司北京金安支行",
                                "account": "3459871094578139",
                                "selected": true
                            },
                            {
                                "bank_code": "105267100120",
                                "country": "中国大陆",
                                "bank_id": "1066168532225491792",
                                "account_name": "上海智书企飞软件技术有限公司",
                                "bank_name": "建设银行股份有限公司宝泉岭宝建分理处",
                                "account": "443421413",
                                "selected": false
                            }
                        ],
                        "our_party_id": "971960647459799901"
                    }
                ],
                "property_type_code": 2,
                "owner_employee_id": 912658462859592819
            },
            {
                "end_date": "2026-11-02",
                "signed_time": "",
                "contract_version": 1,
                "create_user_name": "周丹",
                "counter_party_list": [
                    {
                        "certification_id": "91110105MA01AA4C3K",
                        "register_address": {
                            "country": "中国大陆",
                            "detail_address": "1"
                        },
                        "certification_name": "统一社会信用代码",
                        "counter_party_code": "A00000038",
                        "counter_party_name": "北京有此山文化传媒有限公司",
                        "sign_party_no": 0,
                        "certification_type": "0",
                        "trading_party_property_code": 0,
                        "counter_party_id": "1061071581373023049",
                        "certifications": [
                            {
                                "certification_id": "91110105MA01AA4C3K",
                                "certification_name": "统一社会信用代码",
                                "certification_type": "0",
                                "status": 1
                            }
                        ]
                    }
                ],
                "archived_time": "",
                "contract_id": 1062536807452770633,
                "contract_budget_list": [],
                "business_type_name": "合同申请",
                "remark": "测试",
                "contract_status_code": 3,
                "create_employee_id": "27ae7d5a",
                "contract_category_name": "行政类合同-周丹演示",
                "pay_type_code": 4,
                "update_time": "1762155957258",
                "contract_number": "2025110300016",
                "complete_time": "",
                "contract_category_number": "00U002",
                "submitter_user_name": "周丹",
                "approved_time": "",
                "submitter_user_id": "27ae7d5a",
                "property_type_name": "none",
                "start_date": "2025-11-03",
                "create_user_id": "27ae7d5a",
                "create_time": "1762155928687",
                "business_type_code": 0,
                "department_id": "od-eb753f6ddb261ef669c5acb6150cdb23",
                "department_name": "解决方案",
                "contract_name": "商品房租赁合同",
                "submitted_time": "1762155957258",
                "contract_status_name": "process",
                "group_id": 1062536807456964937,
                "pay_type_name": "无收无支",
                "our_party_list": [
                    {
                        "our_party_name": "上海智书企飞软件技术有限公司",
                        "certification_id": "91310110MA7K2R9N8N",
                        "country": "中国大陆",
                        "certification_name": "统一社会信用代码",
                        "legal_person": "吴彦祖",
                        "address": "北京市朝阳区东风南路8号东枫德必WE人工智能创新基地G栋4层",
                        "sign_party_no": 0,
                        "certification_type": "0",
                        "our_party_code": "L00102002",
                        "tele_phone": "19900006666",
                        "bank_accounts": [
                            {
                                "bank_code": "308100006273",
                                "country": "中国大陆",
                                "bank_id": "1045022586326483834",
                                "account_name": "上海智书企飞软件技术有限公司",
                                "bank_name": "招商银行股份有限公司北京金安支行",
                                "account": "3459871094578139",
                                "selected": true
                            },
                            {
                                "bank_code": "105267100120",
                                "country": "中国大陆",
                                "bank_id": "1066168532225491792",
                                "account_name": "上海智书企飞软件技术有限公司",
                                "bank_name": "建设银行股份有限公司宝泉岭宝建分理处",
                                "account": "443421413",
                                "selected": false
                            }
                        ],
                        "our_party_id": "971960647459799901"
                    }
                ],
                "property_type_code": 2,
                "owner_employee_id": 912658462859592819
            },
            {
                "end_date": "2026-08-31",
                "signed_time": "1762155946701",
                "contract_version": 1,
                "create_user_name": "宗一桥",
                "counter_party_list": [
                    {
                        "register_address": {
                            "country": "中国大陆"
                        },
                        "certification_name": "统一社会信用代码",
                        "counter_party_code": "V00000014",
                        "counter_party_name": "上海星辰科技有限公司",
                        "sign_party_no": 0,
                        "certification_type": "0",
                        "trading_party_property_code": 0,
                        "counter_party_id": "1039953831225459582",
                        "certifications": [
                            {
                                "certification_name": "统一社会信用代码",
                                "certification_type": "0",
                                "status": 1
                            }
                        ]
                    }
                ],
                "archived_time": "1762156378580",
                "contract_id": 1062531502794867017,
                "contract_b
修改于 2026-03-20 09:05:26
上一页
查看合同详情
下一页
根据合同编号查询
Built with