查询往来单位详情列表
说明
往来单位详情列表接口,可根据往来单位创建时间或更新时间查询。
接口限制
最多返回50个往来单位。
接口地址
/api/openapi/tradingPartner/list/V2
请求类型
POST
请求参数
| 字段名称 |
字段类型 |
必填 |
字段说明 |
| startTime |
String |
否 |
查询开始(创建/更新)时间戳(包含) |
| endTime |
String |
否 |
查询结束(创建/更新)时间戳(包含) |
| pageNo |
int |
否 |
分页序号(默认为1) |
| pageSize |
int |
否 |
分页大小(默认为50,上限为150) |
| bizCodes |
List |
否 |
往来单位编码 |
| parentBizCode |
String |
否 |
分类的业务编码 |
| keyword |
String |
否 |
往来单位编码/名字(模糊查询) |
参数样例
{
"bizCodes":[],
"parentBizCode":"",
"keyword":"",
"startTime": "1003401600000",
"endTime": "1673401600000",
"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 |
否 |
税务登记号 |
account相关字段说明
| 字段名称 |
类型 |
是否必填 |
字段说明 |
| bankCountry |
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 |
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导入目录",
"accounts":[
{
"bankCountry":"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"
}
],
"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 新增往来单位查询接口