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

GASで『全銀フォーマット』生成の設計全書。Shift_JIS・バイト計算・外部マスタ連携の手順

    銀行振込の自動化において、最大の難所となるのが「全銀フォーマット」の作成です。 前回、「銀行振込の裏側を解剖!」についての記事を書きましたが、今回はその第2弾。

    「どうやってGASで、あの厳格な固定長ファイルを組み上げるのか?」という実装設計にスポットを当てて解説します。

    1. GASの「文字数」と全銀の「バイト数」の乖離

    最初につまずくのが、「120バイト固定長」というルールです。 GASの string.length は「文字数」を返しますが、全銀フォーマットが求めているのは「Shift_JISにおけるバイト数」です。

    • UTF-8(GAS): 「ア」も「亜」も3バイト(または文字数として1)

    • Shift_JIS(銀行): 「ア」は1バイト、「亜」は2バイト

    この乖離を埋めるために、1文字ずつ文字コードを判定してバイト数を計算するロジックが不可欠になります。

    function getByteCount(str) {
      let count = 0;
      for (let i = 0; i < str.length; i++) {
        let c = str.charCodeAt(i);
        // 半角英数および半角カナ(FF61-FF9F)は1バイト、それ以外は2バイト
        if ((c >= 0x0020 && c <= 0x007e) || (c >= 0xff61 && c <= 0xff9f)) count += 1;
        else count += 2;
      }
      return count;
    }

    この計算を基に、足りない分を半角スペースで埋める(右パディング)、あるいは0で埋める(左パディング)という共通関数を自作するのが、設計の第一歩です。


    2. GitHubマスタ(ZenginCode)による「表記ゆれ」の根絶

    スプレッドシート上の銀行名や支店名は、人間が入力する以上必ず「三菱UFJ」「三菱UFJ銀行」といった表記ゆれが発生します。しかし、銀行システムは半角カナ一択な上、1文字のズレも許してくれません。

    そこで活用したのが、有志によりメンテナンスされているzengin-codeです。

    実装の工夫:キャッシュ機構

    毎行外部へフェッチ(UrlFetchApp)に行くと処理が重くなり、GASの制限時間に引っかかります。 zenginCache というオブジェクトを用意し、一度取得した銀行・支店データは使い回す設計にしました。

    「コード(番号)さえ合っていれば、名称はマスタから正解の半角カナを引っ張ってくる」という逆引きロジックを組むことで、入力ミスによるエラーを未然に防いでいます。


    3. 鉄壁の「半角カナ変換」と「サニタイズ」

    全銀フォーマットのデータレコードにおいて、漢字や全角記号が1文字でも混入すると、その行以降のバイト数がすべてズレる致命的なエラーになります。

    今回は、以下の2段構えで「データの清浄化」を行いました。

    • マッピング変換: アイウエオ → アイウエオ のように、独自のマップ関数で徹底的に半角へ変換。

    • 正規表現のフィルター: 最後に以下の正規表現を通し、半角英数カナ以外の文字をすべて除去します。
      res.replace(/[^\u0020-\u007E\uFF61-\uFF9F]/g, "");

    この「絶対に想定外の文字を外に出さない」というガードが、フォーマットチェック一発合格の最大の要因です。


    4. GASでShift_JISの「Blob」を生成する魔法

    GASの標準はUTF-8ですが、銀行が求めているのはShift_JISのバイナリデータです。 普通に出力すると文字化けしますが、GASにはこの変換を一行でやってのけるメソッドが存在します。

    const blob = Utilities.newBlob("")
      .setDataFromString(output, "Shift_JIS")
      .setName(fileName);

    この setDataFromString でエンコーディングを明示することで、Googleの世界のデータを、銀行の世界の言葉(Shift_JIS)へと正しく翻訳できます。


    まとめ:正確なコードは、経理の安心に繋がる

    全銀フォーマットの作成は、まるで「1ミリのズレも許さないレンガ積み」のような作業です。

    しかし、一度正確なロジックを組んでしまえば、これまで数十分かけていた手入力の作業が、わずか数秒〜数十秒、ノーミスで完了します。GASによる自動化の本質は時短だけでなく、「ミスが許されない作業からの解放」という心理的安全性にあると、改めて実感しました。

    もし皆さんの会社で「全銀ファイル作成に苦労している」という方がいれば、ぜひこの「バイト数管理」と「マスタ連携」の視点を取り入れてみてください!

    今回解説したコードの全文はこちらから確認できます👇
    https://gist.github.com/sawahotaru/6eaffb07685f61c532b09ecd11ed4083

    あなたへのおすすめ