查询往来单位详情列表

说明

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

接口限制

最多返回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  新增往来单位查询接口
Copyright © 杭州每刻科技有限公司 www.maycur.com all right reserved,powered by Gitbook该文件修订时间: 2024-11-20 10:52:00

results matching ""

    No results matching ""

    results matching ""

      No results matching ""