支払予定表自動作成システム
業務委託 | Forward Deployed Engineer
背景と課題
Google Driveに届く請求書(PDF・JPEG)を読み,支払先・金額・支払方法を支払予定表に転記する手作業を自動化するため,Google Apps Script(GAS)のシステムを作った.GASには1回の実行時間の上限があり,請求書が多い月でも途中で止まらずに処理を続けられることが求められた.
構成と処理の流れ
設定・メイン処理・Drive・Gemini・スプレッドシートの5つのモジュールに分け,スプレッドシートのメニューから実行する.1件ずつ,請求書を読み取り → ファイル名を付け直し → 支払予定表に書き込み → 処理済みフォルダへ移動する.
- 読み取り: Gemini APIのJSONモードで,会社名・金額・カナ読み・支払方法の4項目を1回の呼び出しで取り出す.出力の形はプロンプトで指定し,受け取り側の会社名は抜き出さないよう指示して,発行元を会社名として取る.
- 会社名の正規化: Unicode NFKCで表記をそろえ,法人格の表記ゆれ((株)・株式会社など)を対応表で正式な形に統一し,末尾の敬称と空白・制御文字を取り除く.モデルの出力は正規化済みと信用せず,同じ規則をコードでもかける.
- 会社マスタ: 新しい会社は自動で登録し,カナ読みが空なら補い,マスタをカナ順に並べ直す.支払予定表はマスタからカナ読みを引いてカナ順に並べる.
- 月別のシート: 月ごとのシートに支払先ごとの行で書き込む.
GASの制約への対処と設計の判断
- 時間の上限: 1件を処理する前に経過時間を確かめ,5分を過ぎていればそこで止めて(GASの上限は6分),処理済みと残りの件数を知らせる.処理済みのファイルは未処理フォルダから移動するので,もう一度実行すれば残りから再開する.
- 二重実行の防止: スクリプトロックで,2つの実行が同時に走らないようにした.
- 失敗の扱い: Gemini APIのエラーや応答の形の誤りは「要確認」シートに記録し,次のファイルへ進む.失敗したファイルは未処理フォルダに残るので,次の実行で再び処理される.
- 秘密情報とモデル: APIキーはコードに書かずスクリプトプロパティに置く.使うモデルは共有のモデル登録情報から生成した設定ファイルで決め,スクリプトプロパティで上書きできるようにした.GASはローカルの登録情報を読めないため,生成したファイルに埋め込む形にした.
開発と検証
claspでローカルとGASを同期して開発した.自動テストはなく,clasp pushのあとスプレッドシートから実行し,手順書の確認項目で動作を確かめる.
使用技術
Google Apps ScriptGemini APIGoogle Drive (DriveApp)Google Sheets (SpreadsheetApp)UrlFetchAppLockServiceclaspJavaScript