查询往来单位详情列表
说明
往来单位详情列表接口,可根据往来单位创建时间或更新时间查询。
接口限制
最多返回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 (澳大利亚各银行的区域代码,主要办理清付结算时使用) |
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 新增往来单位查询接口