增量查询供应商和银行信息

接口描述

此接口为增量接口用于按照供应商最后变更日期查询供应商和供应商的银行信息。

请求URI

/api/openapi/suppliers

请求方式

GET

请求参数示例

/api/openapi/suppliers?startTime=2020-02-01 00:00:00&endTime=2021-04-27 00:00:00&page=1&size=10

请求参数说明

参数名	类型	是否必填	说明
startTime	String	是	查询开始时间。格式: yyyy-MM-dd HH:mm:ss
endTime	String	是	查询结束时间。格式: yyyy-MM-dd HH:mm:ss
page	int	是	页码, 第一页的page为1
size	int	是	每页结果数。最大50
companyCode	String	否	公司编码

接口返回示例

{
  "total": 2,
  "current": 1,
  "pageSize": 10,
  "pages": 1,
  "hasPrevious": false,
  "hasNext": false,
  "data": [
    {
      "companyCode": "JP002",
      "typeCode": "KIGYOU",
      "code": "1004973",
      "name": "XXX株式会社",
      "halfKanaName": "VENDOR",
      "businessRegistrationNumber": "T2201845125542",
      "businessCategory": "1001",
      "businessRegistrationDate": "2022-09-10",
      "effectiveDate": "2021-04-20",
      "status": "1001",
      "legalRepresentative": "XXXXX",
      "checkNetNo": "ddd1",
      "taxId": "123456",
      "contact": {
        "name": "XXXXX",
        "phone": "070-4309-1234",
        "email": "xxx@mail.com",
        "fax": "1234567",
        "address": "住所XXXXX",
        "halfKanaAddress": "QQQ",
        "postalCode": "12112"
      },
      "remark": "XXXXX",
      "description": "XXXXX",
      "payeeLegalRepresentativeNumber": "1234567890123",
      "externalKey": "GAIBU123456",
      "allowTempBank": false,
      "customFields": [
        {
          "fieldCode": "date",
          "value": "2020-03-21T00:00:00.000Z"
        },
        {
          "fieldCode": "time",
          "value": "23:56"
        },
        {
          "fieldCode": "country",
          "value": "AE"
        }
      ],
      "bankAccounts": [
        {
          "bankCode": "0005",
          "bankName": "三菱ＵＦＪ銀行",
          "bankBranchCode": "001",
          "bankBranchName": "本店",
          "bankAccountNo": "1234567",
          "bankAccountName": "bankAccountName",
          "bankAccountFBName": "bankAccountFBName",
          "status": "1001",
          "bankAccountTypeCode": "4",
          "isTransferFeeAfforded": false,
          "isPrimary": true,
          "isCheckPayment": true
        },
        {
          "bankCode": "0000",
          "bankName": "日本銀行",
          "bankBranchCode": "426",
          "bankBranchName": "横浜支店",
          "bankAccountNo": "1234567",
          "bankAccountName": "bankAccountName",
          "bankAccountFBName": "bankAccountFBName",
          "status": "1001",
          "bankAccountTypeCode": "4",
          "isTransferFeeAfforded": true,
          "isPrimary": false,
          "isCheckPayment": true
        }
      ]
    },
    {
      "companyCode": "JP002",
      "typeCode": "KIGYOU",
      "code": "1004974",
      "name": "XXX株式会社",
      "halfKanaName": "VENDOR",
      "businessRegistrationNumber": "T2201845125542",
      "businessCategory": "1001",
      "businessRegistrationDate": "2022-09-10",
      "effectiveDate": "2021-04-20",
      "status": "1001",
      "legalRepresentative": "XXXXX",
      "checkNetNo": "ddd1",
      "taxId": "123456",
      "contact": {
        "name": "XXXXX",
        "phone": "070-4309-1234",
        "email": "xxx@mail.com",
        "fax": "1234567",
        "address": "住所XXXXX",
        "halfKanaAddress": "QQQ",
        "postalCode": "12112"
      },
      "remark": "XXXXX",
      "description": "XXXXX",
      "allowTempBank": false,
      "customFields": [
        {
          "fieldCode": "date",
          "value": "2020-03-21T00:00:00.000Z"
        },
        {
          "fieldCode": "time",
          "value": "23:56"
        },
        {
          "fieldCode": "country",
          "value": "AE"
        }
      ],
      "paymentTerm":"001" ,
      "selectPaymentMethod":"N" ,
      "paymentMethods":["code001","code002","code003"] ,
      "defaultPaymentMethod": "code001",
      "bankAccounts": [
        {
          "bankCode": "0005",
          "bankName": "三菱ＵＦＪ銀行",
          "bankBranchCode": "001",
          "bankBranchName": "本店",
          "bankAccountNo": "1234567",
          "bankAccountName": "bankAccountName",
          "bankAccountFBName":"bankAccountFBName",
          "status": "1001",
          "bankAccountTypeCode": "4",
          "isTransferFeeAfforded": false,
          "isPrimary": true,
          "isCheckPayment": true
        },
        {
          "bankCode": "0000",
          "bankName": "日本銀行",
          "bankBranchCode": "426",
          "bankBranchName": "横浜支店",
          "bankAccountNo": "1234567",
          "bankAccountName": "bankAccountName",
          "bankAccountFBName":"bankAccountFBName",
          "status": "1001",
          "bankAccountTypeCode": "4",
          "isTransferFeeAfforded": true,
          "isPrimary": false,
          "isCheckPayment": true
        }
      ]
    }
  ]
}

PageResposne

参数名	类型	说明
total	int	查询结果总个数
current	int	当前页数
pageSize	int	每页结果计
pages	int	查询结果总分页数
hasPrevious	boolean	是否有上一页
hasNext	boolean	是否有下一页

接口返回字段

字段名	类型	约束	说明
companyCode	String	最大长度 50	公司编码
typeCode	String	最大长度 50	供应商类型代码
code	String	最大长度 50	供应商代码只可输入[英文字,数字,.,_,-]
name	String	最大长度 50	供应商名称
halfKanaName	String	最大50文字	供应商名称半角假名
businessRegistrationNumber	String	最大14文字	事业者登记编号
businessCategory	Integer	1001:课税事业者 1002:免税事业者	事业者类别
businessRegistrationDate	Date	日期格式：yyyy-MM-dd	事业者登记日期
effectiveDate	Date	日期格式：yyyy-mm-dd	启用日期
status	String	固定长度：4	状态有效：1001（默认）无效：1002
legalRepresentative	String	最大长度 30	法人代表
checkNetNo	String	最大长度 30	电债NetNO
taxId	String	最大长度 30	税务登记号只可输入[英文字,数字]
contact	Contact		联系人信息
remark	String	最大长度 200	备注
description	String	最大长度 50	备注（查询用）
payeeLegalRepresentativeNumber	String	最大长度50	收款人法人编号
externalKey	String	最大长度50	外部Key
allowTempBank	Boolean		是否允许临时银行 true:允许 false:不允许
customFields	CustomField[]	最多10个	fieldCode不能重复
paymentTerm	String		付款条件
selectPaymentMethod	String		可选付款方式 Y：全部（默认） N：部分
paymentMethods	List		付款方式仅可选付款方式为N：部分时，更新
defaultPaymentMethod	String		默认付款方式
bankAccounts	BankAccount[]		银行账号信息

Contact

字段名	类型	约束	说明
name	String	最大30文字	联系人
phone	String	最大20文字	联系人电话只可输入[数字,-]
email	String	最大30文字	联系人邮箱
fax	String	最大20文字	传真
address	String	最大200文字	地址
halfKanaAddress	String	最大200文字	地址半角假名
postalCode	String	最大10文字	邮政编码[数字或-]

CustomField

参数名	类型	必填	主键	约束	说明
fieldCode	String	○	○	最大长度 50	自定义字段编码
value	String			最大长度 200	自定义字段值，如果自定义字段设定为必填，则该值不可为空

BankAccount

字段名	类型	约束	说明
bankCode	String	固定4文字	银行编码
bankName	String	最大50文字	银行名称
bankBranchCode	String	固定3文字	支行编码
bankBranchName	String	最大50文字	支行名称
bankAccountNo	String	最大7文字	银行账号
bankAccountName	String	最大50文字	银行账号名称
bankAccountFBName	String	最大50文字	银行账户名(半角片假名)
bankAccountTypeCode	String	固定1文字	账户类别 1：活期存款 2：无息存款 4：定期存款 9：其它
isTransferFeeAfforded	Boolean		银行手续费负担方 true：对方 false：本方
status	String	固定4文字	状态有效：1001 无效：1002
isPrimary	Boolean		是否主账户
isCheckPayment	Boolean		是否支票支付

失败示例

{
  "message": "无效的公司编码",
  "errorCode": "6047055"
}

字段说明

字段名称	类型	说明
message	String	返回信息说明
errorCode	String	返回错误编码

错误代码

errorCode	message	说明
0013	参数:{0},最大长度{1}
6047055	无效的公司编码
121309	公司Code与登录的公司Code不一致
120003	缺少必填项:{0}
120005	传入参数格式异常:{0},正确格式为:{1}

← 查询供应商和银行信息