查询往来单位详情列表
说明
往来单位详情列表接口,可根据往来单位创建时间或更新时间查询。
接口限制
最多返回50个往来单位。
接口地址
/api/openapi/tradingPartner/list/V2
请求类型
POST
请求参数
| 字段名称 |
字段类型 |
必填 |
字段说明 |
| startTime |
Long |
否 |
查询开始(创建/更新)时间戳(包含) |
| endTime |
Long |
否 |
查询结束(创建/更新)时间戳(包含) |
| pageNo |
int |
否 |
分页序号(默认为1) |
| pageSize |
int |
否 |
分页大小(默认为50,上限为150) |
| bizCodes |
List |
否 |
往来单位编码 |
| parentBizCode |
String |
否 |
分类的业务编码 |
| keyword |
String |
否 |
往来单位编码/名字(模糊查询) |
参数样例
{
"bizCodes":[],
"parentBizCode":"",
"keyword":"",
"startTime": 1761208262587,
"endTime": 1761294662000,
"pageNo": 1,
"pageSize": 50
}
响应参数
响应参数说明
| 字段名称 |
类型 |
是否必填 |
字段说明 |
| hasNextPage |
boolean |
是 |
是否有下一页 |
| bizCode |
String |
是 |
往来单位编码 |
| name |
String |
是 |
往来单位名称(根据语言环境显示) |
| nameZh |
String |
否 |
往来单位名称(中文) |
| nameEn |
String |
否 |
往来单位名称(英文) |
| partnerType |
String |
是 |
往来单位关系;SUPPLIER-供应商,CUSTOMER-客户,ALL-既是供应商也是客户 |
| partnerProperty |
String |
是 |
往来单位性质;CORP-公司,SELF_EMPLOYED-个体工商户 |
| accounts |
json |
否 |
账户信息 |
| parentBizCode |
String |
否 |
父节点编码 |
| parentName |
String |
否 |
父节点名称 |
| reMarks |
String |
否 |
往来单位备注 |
| authzList |
authzList |
否 |
部门、人员、或用户组授权范围 |
| companyAuthzList |
authzList |
否 |
公司授权范围 |
| legalEntityAuthzList |
authzList |
否 |
公司抬头授权范围 |
| enabled |
boolean |
是 |
是否启用 |
| taxNumber |
boolean |
否 |
税务登记号 |
| contactName |
String |
否 |
联系人姓名 |
| contactPhone |
String |
否 |
联系电话 |
| contactEmail |
String |
否 |
联系邮箱 |
| contactAddress |
String |
否 |
联系地址 |
| customObject |
CustomObject |
否 |
自定义字段 |
account相关字段说明
| 字段名称 |
类型 |
是否必填 |
字段说明 |
| bankCountry |
string[] |
否 |
银行所在国家 |
| bankCountryName |
string[] |
否 |
银行所在国家名称 |
| bankCountryNameEn |
string[] |
否 |
银行所在国家名称(英文) |
| bankCode |
String |
否 |
银行简写 |
| bankName |
String |
否 |
银行名字 |
| bankAcctName |
String |
是 |
账户名 |
| bankAcctNumber |
String |
是 |
银行账号 |
| bankLocation |
String |
否 |
开户行所在城市名称(如“杭州市”) |
| bankBranchNo |
String |
否 |
联行号 |
| bankBranchName |
String |
否 |
分支行名称 |
| paymentType |
string[] |
是 |
支付类型;ALIPAY-支付宝,BANK-银行账户,CASH-现金,OTHER-其他 |
| hasBankBranch |
String |
否 |
是否有分支行 |
| swiftCode |
String |
否 |
海外银行编码 |
| abroadPayeeAddress |
String |
否 |
海外收款人地址 |
| abroadBankAddress |
String |
否 |
海外开户银行地址 |
| acceptCcy |
String |
是 |
币种(如果是多个使用中文逗号隔开,NOLIMIT表示不限制) |
| remark |
String |
否 |
备注 |
| ibanNumber |
String |
否 |
ibanNumber(欧洲银行委员会制定的国际银行账户号码,适用于欧洲国家地区的付款业务) |
| abaNumber |
String |
否 |
abaNumber(美国银行协会制定的金融机构识别码,主要用于美国以及北美地区) |
| bsbNumber |
String |
否 |
bsbNumber (澳大利亚各银行的区域代码,主要办理清付结算时使用) |
| abroadBankCode |
String |
否 |
海外银行BankCode |
| bankNameEn |
String |
否 |
银行名称(英文) |
| usedForCrossBorderRemittance |
Boolean |
否 |
用于判断中国账户是否跨境汇款,默认为否 |
| selfEmployeeIsPersonal |
boolean |
否 |
账户性质,默认为true,表示对公账户。false表示对私账户。 |
authzList相关字段说明
| 参数key |
类型 |
说明 |
| authzType |
String |
授权范围类型;STAFF-人员,DEPARTMENT-部门,USER_GROUP-用户组 |
| authzCode |
String |
授权范围编码(内码) |
| authzName |
String |
授权对象名 |
| includeChildDept |
boolean |
是否包含下级 |
| bizCode |
String |
业务编码(员工工号、部门编码、公司抬头编码、用户组编码) |
参数样例
{
"code": "ACK",
"messageCode": "",
"message": "",
"data": {
"hasNextPage": false,
"list": [
{
"bizCode": "TRP1910241VN6IWOW",
"name": "120",
"nameZh": "120",
"nameEn": "Jack",
"partnerType": [
"SUPPLIER"
],
"partnerProperty": [
"CORP"
],
"parentBizCode": "TRP1912191H4NL98G",
"parentName": "oapi导入目录",
"contactName": "xm",
"contactPhone": "dh",
"contactEmail": "yx",
"contactAddress": "dz",
"customObject": {
"CF29": "333"
},
"accounts": [
{
"bankCountry": "CHINA",
"bankCountryName": "中国",
"bankCountryNameEn": "China",
"bankCode": "",
"bankName": "",
"bankAcctName": "张三",
"bankAcctNumber": "",
"bankLocation": "",
"bankBranchName": "",
"bankBranchNo": "",
"paymentType": "CASH",
"bsbNumber": "233876186"
}
]
},
{
"bizCode": "TRP1910241VMZCUF4",
"name": "中文名",
"nameZh": "中文名",
"nameEn": "Kidding",
"partnerType": [
"SUPPLIER"
],
"partnerProperty": [
"CORP"
],
"reMarks": "备注",
"accounts": [
{
"bankCountry": "CHINA",
"bankCode": "icbc",
"bankName": "工商银行",
"bankAcctName": "车撒的发生的",
"bankAcctNumber": "634523452452334231423",
"bankLocation": "北京市",
"bankBranchNo": "",
"paymentType": "BANK",
"bankBranchName": "",
"bsbNumber": "233876186",
"swiftCode": "lxlxl111",
"bankNameEn": "wwww444"
}
],
"authzList": [
{
"authzType": "STAFF",
"authzCode": "UI1804041BV1ZU3F",
"authzName": "张三",
"includeChildDept": false,
"bizCode": "employeeId"
}
],
"legalEntityAuthzList": [
{
"authzType": "LEGAL_ENTITY",
"authzCode": "ELC1811081MFHDCZK",
"authzName": "杭州每刻科技有限公司",
"includeChildDept": false,
"bizCode": "legalEntityBizCode"
}
],
"companyAuthzList": [
{
"authzType": "COMPANY",
"authzCode": "DI333333FHDCZK",
"authzName": "杭州每刻科技有限公司",
"bizCode": "companyBizCode"
}
]
}
]
}
}
修改记录
2023-02-08 新增往来单位查询接口
2025-12-09 新增返回参数bankNameEn字段
2025-12-17 账户返回国家名称和国家英文名称
2025-01-15 账户新增bankCardType银行卡性质、persoanal账户性质字段
2026-03-06 新增联系人姓名、联系电话、联系邮箱、联系地址、自定义字段