Spendia Open API

入出金明細情報取込

OpenAPI説明

本APIは、入出金明細情報を一括取り込む際に利用します

リクエストURI

/api/openapi/btob/withdrawal/import

リクエスト形式

POST

リクエスト例

{
  "withdrawalDetails": [
    {
      "tenantId": "1214732595705114600",
      "saasCode": "ABS",
      "identificationNumber": "2024110500000001",
      "bankCode": "0000",
      "branchCode": "093",
      "accountType": "1",
      "accountNumber": "1234567",
      "baseDate": "2024-02-06",
      "baseTime": "16:02:00+09:00",
      "tradeDate": "2024-02-06",
      "continuousNumber": "123456789012",
      "startingDate": "2024-02-06",
      "withdrawalAmount": 8000,
      "depositAmount": 9000,
      "balance": 5000,
      "transactionCategory": "振込入金",
      "financialInstitutionName": "ﾐﾂｲｽﾐﾄﾓ",
      "branchName": "ｶﾝﾀﾞｼﾃﾝ",
      "summary": "摘要"
    },
    {
      "tenantId": "1214732595705114601",
      "saasCode": "ABS",
      "identificationNumber": "2024110500000002",
      "bankCode": "0000",
      "branchCode": "093",
      "accountType": "1",
      "accountNumber": "1234567",
      "baseDate": "2024-02-06",
      "baseTime": "16:02:00+09:00",
      "tradeDate": "2024-02-06",
      "continuousNumber": "123456789013",
      "startingDate": "2024-02-06",
      "withdrawalAmount": 8000,
      "depositAmount": 9000,
      "balance": 5000,
      "transactionCategory": "振込入金",
      "financialInstitutionName": "ﾐﾂｲｽﾐﾄﾓ",
      "branchName": "ｶﾝﾀﾞｼﾃﾝ",
      "summary": "摘要"
    },
    {
      "tenantId": "1214732595705114600",
      "saasCode": "ABS",
      "identificationNumber": "2024110500000003",
      "bankCode": "0000",
      "branchCode": "093",
      "accountType": "1",
      "accountNumber": "1234567",
      "baseDate": "2024-02-06",
      "baseTime": "16:02:00+09:00",
      "tradeDate": "2024-02-06",
      "continuousNumber": "123456789014",
      "startingDate": "2024-02-06",
      "withdrawalAmount": 8000,
      "depositAmount": 9000,
      "balance": 5000,
      "transactionCategory": "振込入金",
      "financialInstitutionName": "ﾐﾂｲｽﾐﾄﾓ",
      "branchName": "ｶﾝﾀﾞｼﾃﾝ",
      "summary": "摘要"
    },
    {
      "tenantId": "1214732595705114601",
      "saasCode": "MT",
      "identificationNumber": "2024110500000004",
      "bankName": "XXXXXX",
      "branchCode": "093",
      "accountType": "1",
      "accountNumber": "1234567",
      "baseDate": "2024-02-06",
      "baseTime": "16:02:00+09:00",
      "tradeDate": "2024-02-06",
      "continuousNumber": "123456789015",
      "startingDate": "2024-02-06",
      "withdrawalAmount": 8000,
      "depositAmount": 9000,
      "balance": 5000,
      "transactionCategory": "振込入金",
      "financialInstitutionName": "ﾐﾂｲｽﾐﾄﾓ",
      "branchName": "ｶﾝﾀﾞｼﾃﾝ",
      "summary": "摘要"
    }
  ]
}

リクエスト項目

入出金明細リスト

項目 タイプ 必須 キー 制限 説明
withdrawalDetails withdrawalDetail[] 入出金明細リスト

withdrawalDetail

項目 タイプ 必須 キー 制限 説明
tenantId String ○ 固定19文字 テナントＩＤ
saasCode String ○ 最大5文字 Saasコード
ABS:AnserBizSOL
MT:MoneyTree
identificationNumber String ○ ○ 固定16文字 入出金明細識別番号
bankCode String ○ 固定4文字 銀行コード
bankName String 最大50文字 銀行名称
branchCode String ○ ○ 固定3文字 支店コード
accountType String ○ ○ 最大2文字 預金種目タイプ
1:普通預金
2:当座預金
4:貯蓄預金
9:その他
accountNumber String ○ ○ 最大12文字 口座番号
baseDate Date ○ format:YYYY-MM-DD 基準日
baseTime Date ○ format:hh:mm:ss+09:00 基準時刻
tradeDate Date ○ ○ format:YYYY-MM-DD 取引日
continuousNumber String ○ 最大12文字 連番
startingDate Date format:YYYY-MM-DD 起算日
withdrawalAmount Number 最大14文字 出金金額
depositAmount Number 最大14文字 入金金額
balance Number 最大14文字 残高
transactionCategory String 最大10文字 取引区分
現金
振替入金
取立
振込
他券振込
振替支払
交換払
小切手
他店券
financialInstitutionName String 最大15文字 金融機関名（振込先）
branchName String 最大15文字 支店名（振込先）
summary String 最大48文字 摘要内容

OpenAPIリターン例

{
  "total": 4,
  "success": 2,
  "failure": 2,
  "successDatas": [ {
    "identificationNumber": "2024110500000001"
  }, {
    "identificationNumber": "2024110500000002"
  }
  ],
  "errorDatas": [ {
    "identificationNumber": "2024110500000003",
    "errorCode": "XXXXX",
    "errorMessage": "XXXXXXXXXXXXXXXXXXXXXXXXXXX"
  }, {
    "identificationNumber": "2024110500000004",
    "errorCode": "XXXXX",
    "errorMessage": "XXXXXXXXXXXXXXXXXXXXXXXXXXX"
  }
  ]
}

項目説明

項目 タイプ 説明
total String 総件数
success String 成功件数
failure String 失敗件数
successDatas successData[] 成功リスト
errorDatas errorData[] 失敗リスト

successData

項目 タイプ 説明
identificationNumber String 入出金明細識別番号

errorData

項目 タイプ 説明
identificationNumber String 入出金明細識別番号
errorCode String エラーメッセージコードを返す
errorMessage String エラーメッセージ内容を返す

エラーコード説明

errorCode message 説明
120003 パラメータ:{0}は指定必須の項目です
0013 パラメータ:{0}は{1}文字以内で指定してください
0010 パラメータ {0} のフォーマットが不正です。
spd.34242.001 パラメータ:{0}は{1}数字で指定してください
spd.26048.003 パラメータ:{0}は半角数字で指定してください
spd.34242.003 Saasコードが不正です
spd.34242.004 テナントIDが存在しません
spd.34242.005 口座番号が存在しません
spd.34242.006 預金種目タイプが不正です
spd.34242.008 入出金明細識別番号:{0}が既に存在します
spd.34242.009 銀行名称が銀行マスタに存在しません
spd.34242.010 パラメータ:{0}、{1}はいずれかを指定してください

←