はじめに
ネットバンキングの「総合振込」「一括振込」機能で使われる全銀フォーマット（全銀協規定フォーマット）。
仕様書は全国銀行協会から公開されていますが、実際に実装しようとすると細かい罠が多いフォーマットです。この記事では仕様を解説しつつ、Node.js（TypeScript）での実装例を紹介します。
全銀フォーマットとは
全国銀行協会（全銀協）が1976年に制定した、振込データの交換用フォーマットです。正式名称は「全銀協規定フォーマット（全銀フォーマット）」。
50年近く現役で使われている化石のような仕様ですが、ほぼすべての銀行のネットバンキングがこのフォーマットでの振込データ取り込みに対応しています。
基本仕様
| 項目 | 仕様 |
|---|---|
| 文字コード | Shift-JIS（JIS X 0201） |
| レコード長 | 120バイト固定長 |
| 改行コード | CR+LF（\r\n） |
| ファイル拡張子 |
.txt（CSVではない） |
| カナ | 半角カタカナ |
レコード構成
ファイルは4種類のレコードで構成されます：
┌────────────────────────────────┐
│ ヘッダーレコード（1行） │ ← 振込依頼人情報
├────────────────────────────────┤
│ データレコード（N行） │ ← 振込先情報（1件1行）
│ データレコード │
│ データレコード │
│ ... │
├────────────────────────────────┤
│ トレーラレコード（1行） │ ← 合計件数・合計金額
├────────────────────────────────┤
│ エンドレコード（1行） │ ← 終了マーカー
└────────────────────────────────┘
ヘッダーレコード（120バイト）
振込依頼人（自社）の情報を格納します。
| 位置 | バイト数 | 内容 | 備考 |
|---|---|---|---|
| 1 | 1 | データ区分 | 固定値 1
|
| 2-3 | 2 | 種別コード |
21（総合振込） |
| 4 | 1 | コード区分 |
0（JIS） |
| 5-14 | 10 | 委託者コード | 右スペース埋め |
| 15-54 | 40 | 委託者名（カナ） | 半角カナ、右スペース埋め |
| 55-58 | 4 | 振込指定日 | MMDD形式 |
| 59-62 | 4 | 仕向銀行番号 | 左ゼロ埋め |
| 63-77 | 15 | 仕向銀行名 | 半角カナ、右スペース埋め |
| 78-80 | 3 | 仕向支店番号 | 左ゼロ埋め |
| 81-95 | 15 | 仕向支店名 | 半角カナ、右スペース埋め |
| 96 | 1 | 預金種目 |
1=普通, 2=当座 |
| 97-103 | 7 | 口座番号 | 左ゼロ埋め |
| 104-120 | 17 | ダミー | スペース |
実装
interface ZenginHeaderInfo {
clientCode: string; // 委託者コード 10桁
clientName: string; // 委託者名 カナ40桁
transferDate: string; // MMDD
bankCode: string; // 仕向銀行 4桁
branchCode: string; // 仕向支店 3桁
accountType: "普通" | "当座";
accountNumber: string; // 7桁
}
function generateHeader(header: ZenginHeaderInfo): string {
const parts = [
"1", // データ区分 (1)
"21", // 種別コード (2)
"0", // コード区分 (1)
padRight(header.clientCode, 10), // 委託者コード (10)
padRight(header.clientName, 40), // 委託者名 (40)
header.transferDate.padStart(4, "0"), // 振込指定日 (4)
padLeft(header.bankCode, 4), // 仕向銀行番号 (4)
padRight("", 15), // 仕向銀行名 (15)
padLeft(header.branchCode, 3), // 仕向支店番号 (3)
padRight("", 15), // 仕向支店名 (15)
accountTypeCode(header.accountType), // 預金種目 (1)
padLeft(header.accountNumber, 7), // 口座番号 (7)
padRight("", 17), // ダミー (17)
];
return parts.join("");
}
データレコード（120バイト）
振込先1件につき1行。
| 位置 | バイト数 | 内容 | 備考 |
|---|---|---|---|
| 1 | 1 | データ区分 | 固定値 2
|
| 2-5 | 4 | 銀行番号 | 左ゼロ埋め |
| 6-20 | 15 | 銀行名（カナ） | 半角カナ、右スペース埋め |
| 21-23 | 3 | 支店番号 | 左ゼロ埋め |
| 24-38 | 15 | 支店名（カナ） | 半角カナ、右スペース埋め |
| 39-42 | 4 | 手形交換所番号 | 0000 |
| 43 | 1 | 預金種目 |
1=普通, 2=当座 |
| 44-50 | 7 | 口座番号 | 左ゼロ埋め |
| 51-80 | 30 | 受取人名（カナ） | 半角カナ、右スペース埋め |
| 81-90 | 10 | 金額 | 左ゼロ埋め |
| 91 | 1 | 新規コード | 0 |
| 92-101 | 10 | 顧客コード1 | スペース |
| 102-111 | 10 | 顧客コード2 | スペース |
| 112 | 1 | 振込区分 |
0（電信扱い） |
| 113-120 | 8 | ダミー | スペース |
実装
interface ZenginTransferRecord {
bankCode: string; // 4桁
branchCode: string; // 3桁
accountType: "普通" | "当座";
accountNumber: string; // 7桁
accountNameKana: string;// カナ30桁
amount: number;
}
function generateDataRecord(record: ZenginTransferRecord): string {
const parts = [
"2", // データ区分 (1)
padLeft(record.bankCode, 4), // 銀行番号 (4)
padRight("", 15), // 銀行名 (15)
padLeft(record.branchCode, 3), // 支店番号 (3)
padRight("", 15), // 支店名 (15)
"0000", // 手形交換所番号 (4)
accountTypeCode(record.accountType), // 預金種目 (1)
padLeft(record.accountNumber, 7), // 口座番号 (7)
padRight(record.accountNameKana, 30), // 受取人名 (30)
padLeft(record.amount, 10), // 金額 (10)
"0", // 新規コード (1)
padRight("", 10), // 顧客コード1 (10)
padRight("", 10), // 顧客コード2 (10)
"0", // 振込区分 (1)
padRight("", 8), // ダミー (8)
];
return parts.join("");
}
トレーラレコード（120バイト）
| 位置 | バイト数 | 内容 | 備考 |
|---|---|---|---|
| 1 | 1 | データ区分 | 固定値 8
|
| 2-7 | 6 | 合計件数 | 左ゼロ埋め |
| 8-19 | 12 | 合計金額 | 左ゼロ埋め |
| 20-120 | 101 | ダミー | スペース |
エンドレコード（120バイト）
| 位置 | バイト数 | 内容 | 備考 |
|---|---|---|---|
| 1 | 1 | データ区分 | 固定値 9
|
| 2-120 | 119 | ダミー | スペース |
ユーティリティ関数
半角カナ変換
全銀フォーマットでは半角カタカナを使います。全角カタカナ→半角カタカナの変換が必要です。
const KANA_MAP: Record<string, string> = {
"ア": "ｱ", "イ": "ｲ", "ウ": "ｳ", "エ": "ｴ", "オ": "ｵ",
"カ": "ｶ", "キ": "ｷ", "ク": "ｸ", "ケ": "ｹ", "コ": "ｺ",
"サ": "ｻ", "シ": "ｼ", "ス": "ｽ", "セ": "ｾ", "ソ": "ｿ",
"タ": "ﾀ", "チ": "ﾁ", "ツ": "ﾂ", "テ": "ﾃ", "ト": "ﾄ",
// ... 濁音・半濁音・小書き文字も対応
"ガ": "ｶﾞ", "ギ": "ｷﾞ", "グ": "ｸﾞ", // ...
"パ": "ﾊﾟ", "ピ": "ﾋﾟ", "プ": "ﾌﾟ", // ...
"ッ": "ｯ", "ャ": "ｬ", "ュ": "ｭ", "ョ": "ｮ",
"ー": "ｰ",
};
function toHankakuKana(str: string): string {
let result = "";
for (const ch of str) {
result += KANA_MAP[ch] ?? ch;
}
return result;
}
注意: 濁音（ガ、ギ...）と半濁音（パ、ピ...）は半角カナだと2文字になります（例: ガ → ｶﾞ）。バイト数計算時にこれを考慮しないと120バイトを超えるバグが発生します。
右スペース埋め・左ゼロ埋め
// 文字列を指定桁数に右スペースパディング
function padRight(str: string, len: number): string {
const hankaku = toHankakuKana(str);
if (hankaku.length >= len) return hankaku.slice(0, len);
return hankaku + " ".repeat(len - hankaku.length);
}
// 数値を指定桁数に左ゼロパディング
function padLeft(num: string | number, len: number): string {
const s = String(num);
if (s.length >= len) return s.slice(0, len);
return "0".repeat(len - s.length) + s;
}
ファイル全体の生成
function generateZenginFile(
header: ZenginHeaderInfo,
records: ZenginTransferRecord[]
): string {
const lines: string[] = [];
lines.push(generateHeader(header));
for (const record of records) {
lines.push(generateDataRecord(record));
}
const totalAmount = records.reduce((sum, r) => sum + r.amount, 0);
lines.push(generateTrailer(records.length, totalAmount));
lines.push(generateEnd());
return lines.join("\r\n"); // CR+LF
}
出力例
121001234567890ｶﾌﾞｼｷｶﾞｲｼﾔ ﾃｽﾄ 053100050 001 10123456
20005 012 000011234567ｶﾌﾞｼｷｶﾞｲｼﾔ ｻﾝﾌﾟﾙ 00001540000 00
8000001000001540000
9
実装時のハマりポイント
1. Shift-JISエンコード
Node.jsのデフォルトはUTF-8なので、最終的にShift-JISに変換する必要があります：
import iconv from "iconv-lite";
const utf8Content = generateZenginFile(header, records);
const sjisBuffer = iconv.encode(utf8Content, "Shift_JIS");
2. 半角カナの濁音バイト数
半角カナの濁音「ｶﾞ」はShift-JISで2バイトです。全角カナ「ガ」は2バイト。変換後のバイト数が変わらないケースが多いですが、文字数は変わるので注意。
3. 銀行名・支店名フィールドは省略可
データレコードの銀行名（15バイト）と支店名（15バイト）は、銀行番号・支店番号があればスペース埋めで省略可能です。実装をシンプルにできます。
4. 金額の上限
金額フィールドは10桁（左ゼロ埋め）なので、最大9,999,999,999円（約100億円）まで。通常の請求書では問題になりませんが、バリデーションは入れておくと安心です。
5. ゆうちょ銀行の特殊対応
ゆうちょ銀行は独自の口座体系（記号5桁 + 番号7〜8桁）を持っています。全銀フォーマットでは以下のように変換が必要です：
-
金融機関コード:
9900（固定） -
支店コード: 記号の2〜3桁目 +
8（例:10080→008） - 口座番号: 番号の末尾1桁を除いた数字
テスト
固定長フォーマットはテストが不可欠です。1バイトずれると全体が崩れます：
describe("全銀フォーマット生成", () => {
test("ヘッダーレコードは120バイト", () => {
const header = generateHeader(testHeaderInfo);
expect(header.length).toBe(120);
});
test("データレコードは120バイト", () => {
const record = generateDataRecord(testRecord);
expect(record.length).toBe(120);
});
test("トレーラの合計金額が正しい", () => {
const trailer = generateTrailer(3, 462000);
expect(trailer.substring(7, 19)).toBe("000000462000");
});
});
まとめ
- 全銀フォーマットは1976年制定の古い仕様だが、今もネットバンキングで現役
- Shift-JIS・120バイト固定長・半角カナという、現代のWeb開発とは対極の仕様
- 濁音の文字数変化、バイト数計算、ゆうちょ変換が主なハマりポイント
- テストを書かないと確実にバグる
この仕様で実際にサービスを作りました。請求書をアップロードするだけで全銀フォーマットのファイルを自動生成します：
トルカ 振込アシスト — https://toruca.app
全銀フォーマットの実装で困っている方の参考になれば幸いです。