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. 合同管理

更新合同

PATCH
https://open.qfei.cn/open-apis/contract/v1/contracts/{contract_id}

请求说明:#

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

请求参数

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

Query 参数

Header 参数

Body 参数application/json

示例
{
	"archive_attachment_fields": [
		"7088230837300330520"
	],
	"ocr_file_id": "7088230837300330528",
	"scan_file_id": "7088230837300330528"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://open.qfei.cn/open-apis/contract/v1/contracts/6951358043686715692?user_id_type=user_id' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
	"archive_attachment_fields": [
		"7088230837300330520"
	],
	"ocr_file_id": "7088230837300330528",
	"scan_file_id": "7088230837300330528"
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 0,
    "data": {
        "contract": {
            "amount": 192.33,
            "approved_time": "",
            "archived_time": "1632129892912",
            "business_type_code": 0,
            "business_type_name": "合同申请",
            "contract_category_abbreviation": "DAJINGLING",
            "contract_category_name": "测试合同",
            "contract_category_number": "003004",
            "contract_id": 7020719356854157612,
            "contract_name": "我是合同名称真的01",
            "contract_number": "OPEN-20211019-003",
            "contract_status_code": 9,
            "contract_status_name": "archived",
            "contract_version": 1,
            "counter_party_list": [
                {
                    "counter_party_code": "V00104531",
                    "counter_party_id": "7010668391945994535",
                    "counter_party_name": "点点滴滴"
                }
            ],
            "create_employee_id": 6977191621892784428,
            "create_employee_name": null,
            "create_time": "1634638606464",
            "create_user_id": "ae721f86",
            "create_user_name": "项扬扬",
            "currency_code": "CNY",
            "currency_name": "人民币元",
            "department_id": null,
            "department_name": null,
            "end_date": "2021-12-01",
            "estimated_amount": 0.00,
            "form": "[{\"attribute_key\":\"custom_1_4b240e5146de4c2f9e0a0c8125d74599\",\"attribute_name\":\"我是单行文本\",\"attribute_type\":\"singleline_text\",\"module_name\":\"自定义模块\",\"attribute_value\":\"测试单行文本XYY\"},{\"attribute_key\":\"custom_2_0757f9c5465948b689582a454916f238\",\"attribute_name\":\"我是多行文本\",\"attribute_type\":\"multiline_text\",\"module_name\":\"自定义模块\",\"attribute_value\":\"测试多行多行多行多行多行多行多行多行多行多行多行多行多行多行多行多行多行多行多行多行多行多行多行多行多行文本XYY\\n ni你好,我是第二行\"},{\"attribute_key\":\"custom_10_6afd71c1fb2d47a0a3669a5ae82180ec\",\"attribute_name\":\"我是日期\",\"attribute_type\":\"date\",\"module_name\":\"自定义模块\",\"attribute_value\":\"2021-01-02\"},{\"attribute_key\":\"custom_1_dc9d6264b4184219b6c4e5e32c7ba82f\",\"attribute_name\":\"必填文本\",\"attribute_type\":\"singleline_text\",\"module_name\":\"自定义模块\",\"attribute_value\":\"2021-01-02\"}]",
            "form_id": 7018922262925410604,
            "group_id": 7020719356854190380,
            "legal_entity_list": [
                {
                    "legal_entity_code": "LX0001",
                    "legal_entity_id": "6978686565570068768",
                    "legal_entity_name": "北京电影公司1"
                }
            ],
            "our_party_list": [
                {
                    "our_party_code": "LX0001",
                    "our_party_id": "6978686565570068768",
                    "our_party_name": "北京电影公司1"
                }
            ],
            "payment_plan_list": [
                {
                    "payment_plan_id": "6978686565570068768",
                    "source_id": "外部导入的id",
                    "payment_amount": 100.01,
                    "currency_code": "CNY",
                    "payment_date": "2021-11-11",
                    "payment_desc": "这个是测试的付款",
                    "payment_condition": "深圳加工中心",
                    "payment_rate": 30%,
                    "need_check": false,
                    "prepaid": false
                }
            ],
            "contract_budget_list": [
                {
                    "source_id": "外部导入的id",
                    "uuid": "550E8400-E29B-11D4-A716-446655440000",
                    "contract_budget_id": "6978686565570068768",
                    "budget_year": "2012",
                    "budget_department_id": "预算部门id",
                    "budget_department_name": "预算部门名称",
                    "budget_department_info": "预算部门信息",
                    "budget_subject_code": "10010",
                    "budget_subject_name": "预算科目名称",
                    "budget_subject_info": "预算科目信息",
                    "cost_center_code": "成本中心编码",
                    "cost_center_name": "成本中心名称",
                    "cost_center_info": "成本中心信息",
                    "cost_center_group_code": "成本中心组编码",
                    "cost_center_group_name": "成本中心组名称",
                    "cost_center_group_info": "成本中心组信息",
                    "budget_code": "10010",
                    "budget_code_name": "预算编码名称",
                    "budget_taxed_amount": 100.01,
                    "budget_taxed_amount_currency": "CNY",
                    "budget_occupied_amount": 100.01,
                    "budget_occupied_amount_currency": "CNY",
                    "tax_rate": 0.14,
                    "tax_amount": 100.01,
                    "tax_amount_currency": "CNY",
                    "remark": "备注",
                    "extra_info": "额外信息"
                }
            ],
            "relation": {
                "relation_contracts": [
                    {
                        "relation_key": "associated_contract",
                        "relation_name": "关联合同",
                        "contract_ids": [
                            "7078246130773278764",
                            "7078238650995228716",
                            "7078250426785087532"
                        ]
                    },
                    {
                        "relation_key": "custom_1028_864c3b6635e0461eb2a7e14ab0aa6e62",
                        "relation_name": "审批中关联合同",
                        "contract_ids": [
                            "7078250426785087532",
                            "7078238545953423404",
                            "7078234069678604332"
                        ]
                    },
                    {
                        "relation_key": "custom_1028_15e0271b9f224ae29e29d86701b184ff",
                        "relation_name": "签订中关联合同",
                        "contract_ids": [
                            "7078232576942604332",
                            "7078241638220496940",
                            "7078217348645732396"
                        ]
                    }
                ],
                "related_contract_ids": [
                    "7078142292200439852",
                    "7077899236163403820"
                ]
            },
            "owner_employee_id": 6977191621892784428,
            "parent_contract_category_bbreviation": "OUTSOURCE",
            "parent_contract_category_name": "外包类合同",
            "parent_contract_category_number": "003",
            "pay_type_code": 1,
            "pay_type_name": "收入类",
            "property_type_code": 0,
            "property_type_name": "固定总价",
            "remark": "说明:来自开放平台接口导入",
            "signed_time": "",
            "source_type_code": 4,
            "source_type_name": "开放平台",
            "start_date": "2021-01-01",
            "submitted_time": "1632043492912",
            "submitter_employee_id": 0,
            "template_id": 0,
            "update_time": "1634638606464"
        }
    },
    "msg": "success"
}
修改于 2026-01-20 08:04:26
上一页
重新提交合同
下一页
更新合同字段信息
Built with