查询往来单位详情列表

说明

往来单位详情列表接口,可根据往来单位创建时间或更新时间查询。

接口限制

最多返回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  新增联系人姓名、联系电话、联系邮箱、联系地址、自定义字段
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2026-09-23 10:19:53

results matching ""

    No results matching ""

    results matching ""

      No results matching ""