BAPI_BANK_GETDETAILで銀行マスタ情報を取得する方法

SAPの銀行マスタから銀行名や所在地を取得したいときは、汎用モジュールBAPI_BANK_GETDETAILを利用できます。銀行国と銀行コードを指定して1件の銀行情報を読むためのBAPIです。銀行口座や取引先の振込先を取得する処理とは対象が異なります。

BAPI_BANK_GETDETAILで取得できるもの

項目内容
入力BANKCOUNTRY(銀行国)、BANKKEY(銀行コード)
主な出力BANK_ADDRESSに銀行名、銀行番号、所在地などの情報
結果確認RETURNのメッセージ種別と内容を確認

銀行コードは国ごとに管理されるため、コードだけで検索せず、銀行国と組み合わせて指定します。利用できる出力項目やメッセージはシステムのリリースにより異なる場合があるので、実装前にSE37でインターフェースを確認してください。

SE37での確認手順

  1. SE37でBAPI_BANK_GETDETAILを表示し、「インポート」「エクスポート」「例外」とドキュメントを確認します。
  2. テスト実行で、実際に登録されている銀行国・銀行コードを入力します。
  3. 返却された銀行名、所在地、銀行番号とRETURNを確認し、業務で必要な項目がそろうか判断します。

プログラムから呼び出す際は、RETURNにエラーがないことだけでなく、期待した銀行キーに対するデータが返ったことも確認します。名称が取得できなかった場合は、入力値の国・コード、対象クライアントに銀行マスタが存在するかを先に調べます。

直接SELECTする場合との使い分け

銀行マスタの代表的なテーブルはBNKAです。単純な一括参照ではテーブルやリリース済みの参照インターフェースが適することもあります。一方、特定の銀行をキーで取得し、標準の取得手段に合わせたい場合はこのBAPIを検討します。大量件数を1件ずつ呼ぶ設計は性能を確認してください。

銀行マスタと銀行口座は別物です。BAPI_BANK_GETDETAILから顧客・仕入先の口座番号や自社の銀行口座残高まで取得できるわけではありません。必要な情報の所在を先に特定すると、誤った参照先を選ばずに済みます。

参考・関連記事

関連記事

PAGE TOP