BankcodeJP API Reference
BankcodeJP for kintone

銀行・支店の入力と点検を、kintoneで。

検索や名称からの候補確認で銀行・支店情報を入力し、保存済みレコードも点検できます。PC向けのプラグインです。

初めて導入する / 導入済みの版を更新する

機能・活用例を見る

ダウンロード

バージョン 0.1.15 / プラグイン名 BankcodeJP for kintone

公開時のファイル名:bankcodejp-kintone-0.1.15-signed.zip(22,988 bytes)。ZIPは解凍せず、そのままkintoneへ読み込みます。

SHA-256
0f786ad610e89d39d04a2fb6fd046299e7808475e2f02dc713ad08aced141da7
プラグインID
pijfglafjhhahnahgfpmgmlokkhajndf
ダウンロードしたファイルを確認する

ZIPとSHA256SUMSを同じフォルダーに保存して、ファイル名とハッシュを照合します。一致しなければ読み込まず、再取得してください。

macOS:

shasum -a 256 -c SHA256SUMS

Windows PowerShell:

Get-FileHash .\bankcodejp-kintone-0.1.15-signed.zip -Algorithm SHA256

Windowsでは表示されたハッシュを、このページのSHA-256と比較してください。

プラン・利用上限

Consoleの料金プランでBankcodeJP for kintoneを契約します。Search APIや銀行・支店選択ウィジェットとは別のサービスです。

プラン料金(税別)銀行・支店検索Resolve(名称から候補確認)一覧点検
Free0円50回/日・1回/秒3回/日・1回/秒1操作100件まで
Standard月額4,980円/年額59,760円5,000回/日・5回/秒300回/日・2回/秒1操作100件まで

同じアカウントのkintone用Public Client・アプリでAPI利用枠を共有します。日次枠は日本時間9時にリセットされます。通常Search APIのAPIキーの利用枠とは別です。

一覧点検の100件は、1操作で選べるレコード数の上限です。APIの残枠を増やすものではなく、検索・Resolveの上限に達すると停止します。

Consoleで料金プランを確認する / 料金ページ

導入前の準備

  • プラグインが利用できるkintoneの契約コースをご用意ください。ライトコースでは利用できません。
  • kintoneシステム管理者がZIPを登録し、アプリ管理者が利用するアプリに追加・設定します。
  • 既存プラグインとの組み合わせは、検証用アプリで確認してから業務アプリへ適用してください。
  • 既に同じIDのプラグインをお使いの場合は、手動更新へ進んでください。

kintone公式:プラグインの登録方法

初回導入

  1. 署名済みZIPを取得して確認します。
  2. kintoneの歯車メニューから「kintoneシステム管理」→「プラグイン」→「読み込む」を開き、ZIPをそのまま選択します。
  3. 一覧に「BankcodeJP for kintone」、バージョン「0.1.15」が表示されたことを確認します。
  4. 対象アプリの「アプリの設定」→「設定」→「プラグイン」で追加します。

登録しただけでは入力補助は使えません。続いてPublic Clientと項目対応を設定します。

初期設定

1. Public Clientを作成する

  1. ConsoleのPublic Clientで「作成」を選びます。
  2. 用途が分かる名前を付け、利用環境を選びます。機能は「銀行・支店入力・点検(kintone)」を選択してください。
  3. 許可するWebサイト(Origin)に https://{subdomain}.cybozu.com を登録します。例:https://example.cybozu.com。/k/1/などのパスは付けません。
  4. 作成直後に表示されるPublic Keyを控えます。Public Keyはこのときだけ表示されます。

APIキーを入力する欄ではありません。Public Keyを紛失した場合は新しいClientを作成し、不要になったClientを無効化してください。

2. フォームの項目を用意する

ボタンを置く「スペース」と、次の文字列(1行)フィールドを用意します。フィールドコードの例は自由に変更できます。

項目フィールドコードの例必須
ボタンを表示するスペースbankcodejpSpace(スペースの要素ID)必須
銀行コードbankCode必須
銀行名bankName必須
銀行名カナbankKana任意
支店コードbranchCode必須
支店名branchName必須
支店名カナbranchKana任意

コードも文字列で保存し、先頭の0を保持します。テーブル内・自動計算・ルックアップとそのコピー先は対象外です。同じフィールドを複数の項目へ割り当てないでください。

3. 設定を保存してアプリを更新する

  1. 対象アプリのプラグイン設定を開き、Public Key、表示スペース、銀行・支店の項目対応を選びます。
  2. 「設定を保存」を押します。
  3. アプリの設定へ戻り、「アプリを更新」を実行します。

使い方・動作確認

  1. レコードの編集画面で「銀行・支店を検索」を開き、銀行と支店を選び、「この銀行・支店を入力」で反映します。
  2. 名称から調べる場合は「名称から候補を確認」を開き、候補と反映する値を確認して「確認した内容を反映」を選びます。
  3. 反映後にkintoneの通常の「保存」を押し、レコードを開き直して値が残っていることを確認します。プラグインは自動保存しません。
  4. 一覧の「複数レコードをチェック」で、表示中のページから対象を選びます。設定の確認後に表示される上限は、Free・Standard共通で1操作100件です。一覧からの自動書き換えは行いません。

銀行・支店マスターの候補確認・照合です。口座の実在や口座名義を確認するものではありません。

手動更新

新しい版のZIPを管理者が読み込んで更新します。このZIP配布版に自動更新や新版の通知機能はありません。このページの変更履歴をご確認ください。

  1. システム管理のプラグイン一覧で、現在のバージョンと同じIDを使っているアプリを確認します。利用アプリの確認方法
  2. 現在の公開キー・表示スペース・項目対応を控え、変更履歴と新しいZIPのハッシュを確認します。
  3. システム管理の「プラグイン」→「読み込む」から、新しい版の署名済みZIPを読み込みます。既存プラグインを削除する必要はありません。
  4. バージョンとIDが正しいこと、各アプリの設定が維持されていることを確認します。項目設定を変更した場合は、設定保存後に「アプリを更新」を実行します。
  5. レコードを開き直し、検索・反映・通常保存を確認します。

同じIDの更新は、そのkintone環境で同じプラグインを使うアプリに及びます。APIの銀行・支店マスターの日々の更新だけで、プラグインを入れ直す必要はありません。

変更履歴

0.1.15

  • 名称・説明から「開発版」表記を削除しました。
  • 0.1.14の社内検証版と同じプラグインID・設定項目を維持しています。
  • 検索・Resolve・点検の機能と利用上限の変更はありません。

配布状況はダウンロード欄をご確認ください。ファイル名が同じまま内容を差し替える更新は行いません。

無効化・復旧

  1. 対象アプリの「アプリの設定」→「設定」→「プラグイン」を開きます。
  2. BankcodeJP for kintoneの「無効にする」を選び、アプリの設定へ戻ります。
  3. 「アプリを更新」を実行してからレコードを開き直し、通常の閲覧・保存ができることを確認します。

無効化は設定を保持してプラグインの動作を止めます。必要なら同じ手順で有効に戻せます。ダウンロードの停止だけでは、導入済みプラグインは止まりません。

古いZIPへの上書きダウングレードは復旧手順に含めていません。修正版が必要な場合は、同じIDの新しい版をご案内します。kintone公式:無効化の手順

困ったとき

  • ボタンが出ない:スペースの要素ID、プラグインの有効状態、設定保存後の「アプリを更新」を確認します。
  • 認証・利用権エラー:Public Clientが有効か、kintone機能・Origin・契約が正しいか確認します。
  • 上限エラー(429):画面の案内に従って待ちます。秒間上限と日次上限は別に適用されます。

BankcodeJPに問い合わせる。バージョン、エラー表示、発生時刻をお知らせください。認証トークンや業務レコード全文を送る必要はありません。