メインコンテンツへスキップ
見出し画像

銀行振込の裏側を解剖!三菱UFJ→楽天銀行で実際に通った『全銀フォーマット』解説

    「全銀フォーマットの仕様書を読んだけど、結局どの位置に何を書けばいいのか分からない……」 「テスト送信でエラーが出るけど、120バイトのどこがズレているのか見当もつかない」

    振込業務の自動化を目指すエンジニアにとって、日本独自の「全銀フォーマット(全銀協規定形式)」は最初の大きな壁です。今回は、三菱UFJ銀行(BizSTATION)から楽天銀行などへの振込に実際に成功したデータを元に、その中身を1バイト単位で解剖します。

    特に、エラーの原因になりやすい「銀行名の有無」についても詳しく解説します。

    ※2026年2月27日 公開の記事に文言の追記・修正をしました。

    1. 全銀フォーマットの全体構造

    全銀フォーマットは、1行が「120バイト」と厳格に決まっている固定長データです。 データは大きく分けて4つの「レコード」で構成されます 。

    1. ヘッダーレコード(種別:1):振込元(依頼人)の情報

    2. データレコード(種別:2):振込先ごとの情報(金額、口座番号など)

    3. トレーラレコード(種別:8):合計件数、合計金額

    4. エンドレコード(種別:9):データの終端

    ※多くの仕様書は“レコード本体120バイト+改行(CRLF)2バイト”を前提で説明しています。改行をバイトカウントに入れてないかを必ず確認した方が安全です。


    2. ヘッダーレコード:振込元の定義

    まずはデータの1行目、ヘッダーレコードを見てみましょう。今回の成功データでは、依頼人名として「カブシキガイシヤサンプル」が記録されています 。

    実際の成功データ例(1行目)

    12100123456789カブシキガイシヤサンプル                         03020005ミツビシユ-エフジエイ  001ホンテン           17777777                 

    ヘッダーレコード(種別1)の解説

    バイト位置	項目名			内容例			解説
    1			データ種別		1				ヘッダーを示す固定値
    2-3			種別コード		21				2バイト分。総合振込を意味
    4			コード区分		0				JIS指定
    5-14		依頼人コード		0123456789		銀行から付与される10桁のID。0で省略可
    15-54		依頼人名			カブシキガイシヤサンプル	40バイト分。余りは半角スペース。半角スペースで省略可
    55-58		振込指定日		0302			4バイト分。3月2日を意味。0で省略可
    59-62		仕向銀行番号		0005			4バイト分。三菱UFJ銀行コード。0で省略可
    63-77		仕向銀行名		ミツビシユ-エフジエイ		15バイト分。半角カナ名称。半角スペースで省略可
    78-80		仕向支店番号		001				3バイト枠。3桁の店番。0で省略可
    81-95		仕向支店名		ホンテン				振込元支店名。半角スペースで省略可
    96			預金種目(依頼人)	1				1:普通、2:当座、9:その他 (4:貯蓄が可や9不可の銀行あり) 0で省略可
    97-103		口座番号(依頼人)	7777777			7桁固定。足りない場合は左を「0」で埋める。0で省略可
    104-120		ダミー			(半角スペース)	予備

    ここがポイント! 依頼人名などは必ず半角カナで記述します 。40バイトに満たない場合は、必ず後ろを半角スペースで埋めてください。1バイトでもズレると、その後の銀行コードが読み取れずエラーになります。

    ※2026年2月27日追記:半角スペースやゼロで省略可能な項目も多いので、不安な場合は省略するという手もあります。但し、通るかは銀行によって異なります。


    3. データレコード:振込先の詳細と「銀行名」の謎

    2行目以降が、実際の振込先情報です。ここでは「銀行名あり」と「銀行名なし(空欄)」の違いを比較します。

    パターンA:銀行名あり(楽天銀行への例)

    20036ラクテン           101ホンテン               18888888サワホタル                         00002085000000000000000000000007
    • 銀行コード0036(楽天銀行)の後に、銀行名カナが埋まっています 。

    • 上記識別表示使用ケース:[92-111]顧客コード各10桁×2 OR EDI情報(20桁)

    • 識別表示未使用時:[92-111]半角スペース20桁

    パターンB:銀行名なし(空欄版)

    20036               101ホンテン               18888888サワホタル                         00002085000                    7
    • 銀行コード0036の後にあるはずの銀行名15バイト分が、半角スペースになっています 。

    • 上記識別表示使用ケース:[92-111]顧客コード各10桁×2 OR EDI情報(20桁)

    • 識別表示未使用時:[92-111]半角スペース20桁

    データレコード(種別2)の解説

    バイト位置	項目名			内容例			解説
    1		データ種別			2				データレコードを示す固定値
    2-5		被仕向銀行番号		0036			銀行コード。4桁で指定
    6-20	被仕向銀行名			(空欄)			15バイトの半角スペース。半角スペースで省略可
    21-23	被仕向支店番号		101				3桁の支店コード
    24-38	被仕向支店名			ホンテン + 空白11	15バイト固定。足りない分は後ろをスペースで埋める。半角スペースで省略可
    39-42	手形交換所番号		空白4(UFJ仕様)	【最重要】 「魔の4バイト」三菱UFJ銀行 BizSTATIONではスペース
    43		預金種目				1				1:普通、2:当座、9:その他 (4:貯蓄が可や9不可の銀行あり)
    44-50	口座番号				8888888			7桁固定。足りない場合は左を「0」で埋める
    51-80	受取人名				サワホタル			30バイト固定。
    81-90	振込金額				0000055000		10桁固定。右詰めで左側を「0」で埋める
    91		新規コード			0				通常は「0」を指定
    92-111	顧客コード/EDI情報	(半角スペース)	未使用:半角スペース(20桁) | 識別表示 Y以外:顧客コード各10桁×2 | 識別表示 “Y”:EDI情報(20桁)
    112		振込区分				7 OR 半角スペース	7:電信振込 半角スペースでも可
    113		識別表示				(半角スペース)	非EDI / Y=EDI ※X=振込依頼人番号(UFJ仕様)
    114-120	ダミー				(半角スペース)	予備

    「銀行名」は空でもいい?注意点は?

    結論から言うと、銀行名は空欄(半角スペース埋め)でも取り込みは可能です。 今回の成功例でも、銀行名をスペースで埋めた形式で正常に構成されています 。多くの銀行システムでは、4桁の「銀行コード」さえ合っていれば、銀行名を自動補完してくれるからです。
    ただし、以下の点に注意が必要です:

    • 名前ありのメリット: システム上で確認する際、視認性が高い。

    • 空欄のメリット: 銀行名の正式名称(「楽天」なのか「ラクテン(ギン」まで入れるのか等)を気にする必要がなく、フォーマットエラーを防ぎやすい。

    • 全ての銀行ではない: 通るかどうかは銀行によって異なる

    初心者のうちは、銀行名は「15バイトの半角スペース」で飛ばし、確実な「銀行番号(4桁)」と「支店番号(3桁)」に集中するのが成功への近道です。

    ※2026年2月27日追記:支店名も空欄での省略が可能です。但し、通るかは銀行によって異なります。


    4. トレーラ・エンドレコード:データの締めくくり

    振込データの最後には、必ず「合計」を記載します。

    トレーラレコード例

    8000001000000055000

    トレーラレコード(種別8)の解説

    バイト位置	項目名			内容例			解説
    1			データ種別		8				トレーラレコードを示す固定値
    2-7			合計件数			000001			データの総件数。右詰め・前ゼロ埋め
    8-19		合計金額			000000055000	振込金額の総計。右詰め・前ゼロ埋め
    20-120		予備	101			(半角スペース)	101バイト分の半角スペース
    • 件数のカウント方法 合計件数には、ヘッダー(1)、トレーラ(8)、エンド(9)は含めません。あくまでデータレコード(2)が何行あったかの数字をセットします。
      例:合計件数: 000001(1件分)

    • 合計金額の桁数に注意! データレコード(種別2)での金額は10桁でしたが、トレーラレコードでの合計金額は12桁に増えています。これは、複数件の合計が大きな金額になっても溢れないようにするためです。ここを10桁にしてしまうと、以降のスペースがズレてエラーの原因になります。
      例:合計金額: 000000055000(55,000円分)

    • 120バイトの維持 金額の後ろには101バイトという膨大な予備領域(スペース)が続きます。ご提示のデータでは数字のみですが、実際のファイルとしては、この後ろに101個の半角スペースを繋げて、一行を120バイトにする必要があります。

    エンドレコード

    9                                                                                                                       

    エンドレコード(種別9)の解説

    エンドレコードは「この行でファイルは終わりですよ」と銀行に伝えるためのレコードです。

    バイト位置	項目名			内容例			解説
    1			データ種別		9				トレーラレコードを示す固定値
    2-120		予備				(半角スペース)	119バイト分の半角スペース

    5. 振込エラーを回避するためのチェックリスト

    成功例と比較して、特に間違いやすいポイントをまとめました。

    1. すべて「半角」になっているか

      • 全角の「(」や「スペース」が1つ混ざるだけで、バイト数が狂い、壊滅的なエラーになります。

    2. 文字コードは「Shift-JIS」か

      • プログラムでUTF-8のまま出力すると、カナが3バイト計算になり、120バイトを大幅に超えてしまいます。最終的なファイル保存時は必ずShift-JIS(CP932)を指定してください。

    3. 金額の「右詰め・ゼロ埋め」

      • 00000467480 のように、左側を0で埋めて桁数を合わせます 。

    4. 改行コードの扱い

      • Windows環境(CRLF)で作成するのが一般的です。三菱UFJのBizSTATION等では、改行が含まれていても正しく処理されます。


    6. まとめ

    全銀フォーマットは「120バイトの固定長」というルールさえ守れば、実は非常にシンプルです。 今回ご紹介した「銀行名なし」のパターンは、プログラムで生成する際に銀行名のマスターデータを持つ必要がないため、実装コストを下げるテクニックとしても有効です。

    まずは今回の成功データを参考に、自分の口座番号や金額に書き換えて「120バイト」を維持できているか確認することから始めてみてください。

    次回予告

    今回はデータの構造を詳しく見てきましたが、手作業で120バイトを数えるのは苦行です。 次回は、「スプレッドシートから全銀フォーマットを生成するツール」の作り方を予定しています。お楽しみに!

    あなたへのおすすめ