SAPの銀行マスタから銀行名や所在地を取得したいときは、汎用モジュールBAPI_BANK_GETDETAILを利用できます。銀行国と銀行コードを指定して1件の銀行情報を読むためのBAPIです。銀行口座や取引先の振込先を取得する処理とは対象が異なります。
BAPI_BANK_GETDETAILで取得できるもの
| 項目 | 内容 |
|---|---|
| 入力 | BANKCOUNTRY(銀行国)、BANKKEY(銀行コード) |
| 主な出力 | BANK_ADDRESSに銀行名、銀行番号、所在地などの情報 |
| 結果確認 | RETURNのメッセージ種別と内容を確認 |
銀行コードは国ごとに管理されるため、コードだけで検索せず、銀行国と組み合わせて指定します。利用できる出力項目やメッセージはシステムのリリースにより異なる場合があるので、実装前にSE37でインターフェースを確認してください。
SE37での確認手順
SE37でBAPI_BANK_GETDETAILを表示し、「インポート」「エクスポート」「例外」とドキュメントを確認します。- テスト実行で、実際に登録されている銀行国・銀行コードを入力します。
- 返却された銀行名、所在地、銀行番号と
RETURNを確認し、業務で必要な項目がそろうか判断します。
プログラムから呼び出す際は、RETURNにエラーがないことだけでなく、期待した銀行キーに対するデータが返ったことも確認します。名称が取得できなかった場合は、入力値の国・コード、対象クライアントに銀行マスタが存在するかを先に調べます。
直接SELECTする場合との使い分け
銀行マスタの代表的なテーブルはBNKAです。単純な一括参照ではテーブルやリリース済みの参照インターフェースが適することもあります。一方、特定の銀行をキーで取得し、標準の取得手段に合わせたい場合はこのBAPIを検討します。大量件数を1件ずつ呼ぶ設計は性能を確認してください。
銀行マスタと銀行口座は別物です。BAPI_BANK_GETDETAILから顧客・仕入先の口座番号や自社の銀行口座残高まで取得できるわけではありません。必要な情報の所在を先に特定すると、誤った参照先を選ばずに済みます。
参考・関連記事
- SAPの標準テーブル一覧:銀行マスタを含むテーブル調査の入口
- SE16Nでテーブルデータを確認する方法:登録データの確認方法
- 入金・出金と消込の使い分け:FIの入出金処理の流れ
- 汎用モジュール一覧:関連する標準機能を探す