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

更新交易方

PUT
https://open.qfei.cn/open-apis/mdm/v1/vendors/7003410079584092448
使用该接口根据 id 更新交易方的全部字段,字段是否必填是根据后台动态配置的,如想获取配置,可从主数据的配置开放文档里获取,参数采用驼峰式。

请求说明:#

接口频率限制1000 次/分钟、50 次/秒
权限要求查看、创建、编辑主数据的供应商相关信息

请求参数

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

Header 参数

Body 参数application/json必填

示例
{
    "id": "7023646046559404327",
    "adCountry": "CN",
    "adProvince": "MDPS00000001",
    "adCity": "MDCY00001226",
    "address": "上海市浦东新区世纪大道1000号",
    "adPostcode": "100100",
    "legalPerson": "张三",
    "certificationType": "0",
    "certificationId": "913100xxxxx555781R",
    "contactPerson": "李四",
    "isRisked":false,
    "contactTelephone": "021-87853200",
    "contactMobilePhone": "+8617621685955",
    "fax": "021-87853200",
    "email": "shunxing@xxx.com",
    "status": 1,
    "vendor": "V00108006",
    "vendorText": "张三样例",
    "shortText": "王五",
    "vendorType": "",
    "vendorCategory": "11",
    "vendorNature": "0",
    "linkedEmployee": "6959513973725069601",
    "linkedCustomer": "客户",
    "associatedWithLegalEntity": true,
    "appendix": [
                    {
                        "tenantId": "6977354570259330000",
                        "fileId": "609a128628ad4eaebd3063c59928a103",
                        "fileName": "xxxx.xlsx",
                        "fileType": "XLSX",
                        "fileSize": 13367,
                        "downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
                    }
                ],
    "extendInfo": [
        {
            "fieldType": 0,
            "fieldValue": "文本值",
            "options": [
                ""
            ],
            "num": 1.11,
            "date": "2021-10-14",
            "rangeDate": [
                ""
            ],
            "fieldCode": "VXX000001",
            "appendix": [
                             {
                                 "tenantId": "6977354570259330000",
                                 "fileId": "609a128628ad4eaebd3063c59928a103",
                                 "fileName": "xxxx.xlsx",
                                 "fileType": "XLSX",
                                 "fileSize": 13367,
                                 "downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
                             }
                         ]
        }
    ],
    "vendorAccounts": [
        {
            "id": "1453263653228318721",
            "account": "62448345986564434",
            "iban": "46677",
            "accountName": "上海xxx技术有限(上海)分公司",
            "bankId": "MDBK00061195",
            "bankCode": "308290003732",
            "swiftCode": "BOFAUS3NINQ",
            "vendorSiteCode": "99999999",
            "bankName": "xx银行股份有限公司苏州支行",
            "bankAcronym": "ZJTLCB",
            "country": "CN",
            "bankControlCode": "99999999",
            "extendInfo": [
                {
                    "fieldType": 0,
                    "fieldValue": "文本值",
                    "options": [
                        ""
                    ],
                    "num": 1.11,
                    "date": "2021-10-14",
                    "rangeDate": [
                        ""
                    ],
                    "fieldCode": "VXX000001",
                    "appendix": [
                                     {
                                         "tenantId": "6977354570259330000",
                                         "fileId": "609a128628ad4eaebd3063c59928a103",
                                         "fileName": "xxxx.xlsx",
                                         "fileType": "XLSX",
                                         "fileSize": 13367,
                                         "downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
                                     }
                                 ]
                }
            ]
        }
    ],
    "vendorAddresses": [
        {
            "id": "1433488030078558209",
            "country": "CN",
            "province": "MDPS00000001",
            "city": "MDCY00000001",
            "county": "MDCA00002746",
            "address": "北京市海淀区苏州街",
            "extendInfo": [
                {
                    "fieldType": 0,
                    "fieldValue": "文本值",
                    "options": [
                        ""
                    ],
                    "num": 1.11,
                    "date": "2021-10-14",
                    "rangeDate": [
                        ""
                    ],
                    "fieldCode": "VXX000001",
                    "appendix": [
                                     {
                                         "tenantId": "6977354570259330000",
                                         "fileId": "609a128628ad4eaebd3063c59928a103",
                                         "fileName": "xxxx.xlsx",
                                         "fileType": "XLSX",
                                         "fileSize": 13367,
                                         "downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
                                     }
                                 ]
                }
            ]
        }
    ],
    "vendorCompanyViews": [
        {
            "id": "1453263653228318721",
            "companyCode": "1001",
            "glAccount": "22020101",
            "vendorSiteCode": "999999",
            "paymentTerm": "PT09",
            "downPaymentTerm": "PT08",
            "extendInfo": [
                {
                    "fieldType": 0,
                    "fieldValue": "文本值",
                    "options": [
                        ""
                    ],
                    "num": 1.11,
                    "date": "2021-10-14",
                    "rangeDate": [
                        ""
                    ],
                    "fieldCode": "VXX000001",
                    "appendix": [
                                     {
                                         "tenantId": "6977354570259330000",
                                         "fileId": "609a128628ad4eaebd3063c59928a103",
                                         "fileName": "xxxx.xlsx",
                                         "fileType": "XLSX",
                                         "fileSize": 13367,
                                         "downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
                                     }
                                 ]
                }
            ]
        }
    ],
    "vendorContacts": [
        {
            "id": "1433488091906793474",
            "name": "张三",
            "position": "董事长",
            "email": "haha@xxx.com",
            "phone": "13333323333",
            "remark": "备注",
            "extendInfo": [
                {
                    "fieldType": 0,
                    "fieldValue": "文本值",
                    "options": [
                        ""
                    ],
                    "num": 1.11,
                    "date": "2021-10-14",
                    "rangeDate": [
                        ""
                    ],
                    "fieldCode": "VXX000001",
                    "appendix": [
                                     {
                                         "tenantId": "6977354570259330000",
                                         "fileId": "609a128628ad4eaebd3063c59928a103",
                                         "fileName": "xxxx.xlsx",
                                         "fileType": "XLSX",
                                         "fileSize": 13367,
                                         "downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
                                     }
                                 ]
                }
            ]
        }
    ],
    "glAccount": "22020101",
    "downPaymentTerm": "PT09",
    "paymentTerm": "PT08",
    "vendorSiteCode": "999999"
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request PUT 'https://open.qfei.cn/open-apis/mdm/v1/vendors/7003410079584092448?user_id=11112312312&user_id_type=user_id' \
--header 'vendor_id: 7003410079584092448' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "id": "7023646046559404327",
    "adCountry": "CN",
    "adProvince": "MDPS00000001",
    "adCity": "MDCY00001226",
    "address": "上海市浦东新区世纪大道1000号",
    "adPostcode": "100100",
    "legalPerson": "张三",
    "certificationType": "0",
    "certificationId": "913100xxxxx555781R",
    "contactPerson": "李四",
    "isRisked":false,
    "contactTelephone": "021-87853200",
    "contactMobilePhone": "+8617621685955",
    "fax": "021-87853200",
    "email": "shunxing@xxx.com",
    "status": 1,
    "vendor": "V00108006",
    "vendorText": "张三样例",
    "shortText": "王五",
    "vendorType": "",
    "vendorCategory": "11",
    "vendorNature": "0",
    "linkedEmployee": "6959513973725069601",
    "linkedCustomer": "客户",
    "associatedWithLegalEntity": true,
    "appendix": [
                    {
                        "tenantId": "6977354570259330000",
                        "fileId": "609a128628ad4eaebd3063c59928a103",
                        "fileName": "xxxx.xlsx",
                        "fileType": "XLSX",
                        "fileSize": 13367,
                        "downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
                    }
                ],
    "extendInfo": [
        {
            "fieldType": 0,
            "fieldValue": "文本值",
            "options": [
                ""
            ],
            "num": 1.11,
            "date": "2021-10-14",
            "rangeDate": [
                ""
            ],
            "fieldCode": "VXX000001",
            "appendix": [
                             {
                                 "tenantId": "6977354570259330000",
                                 "fileId": "609a128628ad4eaebd3063c59928a103",
                                 "fileName": "xxxx.xlsx",
                                 "fileType": "XLSX",
                                 "fileSize": 13367,
                                 "downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
                             }
                         ]
        }
    ],
    "vendorAccounts": [
        {
            "id": "1453263653228318721",
            "account": "62448345986564434",
            "iban": "46677",
            "accountName": "上海xxx技术有限(上海)分公司",
            "bankId": "MDBK00061195",
            "bankCode": "308290003732",
            "swiftCode": "BOFAUS3NINQ",
            "vendorSiteCode": "99999999",
            "bankName": "xx银行股份有限公司苏州支行",
            "bankAcronym": "ZJTLCB",
            "country": "CN",
            "bankControlCode": "99999999",
            "extendInfo": [
                {
                    "fieldType": 0,
                    "fieldValue": "文本值",
                    "options": [
                        ""
                    ],
                    "num": 1.11,
                    "date": "2021-10-14",
                    "rangeDate": [
                        ""
                    ],
                    "fieldCode": "VXX000001",
                    "appendix": [
                                     {
                                         "tenantId": "6977354570259330000",
                                         "fileId": "609a128628ad4eaebd3063c59928a103",
                                         "fileName": "xxxx.xlsx",
                                         "fileType": "XLSX",
                                         "fileSize": 13367,
                                         "downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
                                     }
                                 ]
                }
            ]
        }
    ],
    "vendorAddresses": [
        {
            "id": "1433488030078558209",
            "country": "CN",
            "province": "MDPS00000001",
            "city": "MDCY00000001",
            "county": "MDCA00002746",
            "address": "北京市海淀区苏州街",
            "extendInfo": [
                {
                    "fieldType": 0,
                    "fieldValue": "文本值",
                    "options": [
                        ""
                    ],
                    "num": 1.11,
                    "date": "2021-10-14",
                    "rangeDate": [
                        ""
                    ],
                    "fieldCode": "VXX000001",
                    "appendix": [
                                     {
                                         "tenantId": "6977354570259330000",
                                         "fileId": "609a128628ad4eaebd3063c59928a103",
                                         "fileName": "xxxx.xlsx",
                                         "fileType": "XLSX",
                                         "fileSize": 13367,
                                         "downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
                                     }
                                 ]
                }
            ]
        }
    ],
    "vendorCompanyViews": [
        {
            "id": "1453263653228318721",
            "companyCode": "1001",
            "glAccount": "22020101",
            "vendorSiteCode": "999999",
            "paymentTerm": "PT09",
            "downPaymentTerm": "PT08",
            "extendInfo": [
                {
                    "fieldType": 0,
                    "fieldValue": "文本值",
                    "options": [
                        ""
                    ],
                    "num": 1.11,
                    "date": "2021-10-14",
                    "rangeDate": [
                        ""
                    ],
                    "fieldCode": "VXX000001",
                    "appendix": [
                                     {
                                         "tenantId": "6977354570259330000",
                                         "fileId": "609a128628ad4eaebd3063c59928a103",
                                         "fileName": "xxxx.xlsx",
                                         "fileType": "XLSX",
                                         "fileSize": 13367,
                                         "downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
                                     }
                                 ]
                }
            ]
        }
    ],
    "vendorContacts": [
        {
            "id": "1433488091906793474",
            "name": "张三",
            "position": "董事长",
            "email": "haha@xxx.com",
            "phone": "13333323333",
            "remark": "备注",
            "extendInfo": [
                {
                    "fieldType": 0,
                    "fieldValue": "文本值",
                    "options": [
                        ""
                    ],
                    "num": 1.11,
                    "date": "2021-10-14",
                    "rangeDate": [
                        ""
                    ],
                    "fieldCode": "VXX000001",
                    "appendix": [
                                     {
                                         "tenantId": "6977354570259330000",
                                         "fileId": "609a128628ad4eaebd3063c59928a103",
                                         "fileName": "xxxx.xlsx",
                                         "fileType": "XLSX",
                                         "fileSize": 13367,
                                         "downloadUrl": "https://xxxx.qfei.cn/downloadxxxxxxxxxx"
                                     }
                                 ]
                }
            ]
        }
    ],
    "glAccount": "22020101",
    "downPaymentTerm": "PT09",
    "paymentTerm": "PT08",
    "vendorSiteCode": "999999"
}'

返回响应

🟢200成功
application/json
Body

示例
{
    "code": 0,
    "msg": "success",
    "data": {
        "id": "7023646046559404327"
    }
}
修改于 2026-01-20 07:22:06
上一页
创建交易方
下一页
获取交易方
Built with