商社の財務部が、外貨預金の月末残高とレートを Apps Script で集計して通貨ごとの円換算額の増減を分け、AI で前月からの動きの説明文を作る
外貨預金の月末残高と月末のレートから、通貨ごとの円換算額と前月からの増減を計算し、増減を「為替の動きの分」と「残高の動きの分」に分けます。 そのうえで入出金の明細から主な動きをAIに要約させ、月次の資金の報告に載せる説明文の下書きを作ります。
- 生成AI
- ChatGPT/Claude/Gemini
- 連携・自動化
- Google Apps Script/Make/Python
- 対象業界
- 商社/小売/製造
- 対象部門
- 経理/財務
- 対象業務
- 書類作成/集計・分析
- 主な課題
- 属人化している/書類作成に時間がかかる/確認ミスが多い
- AIで行う処理
- 要約
- 主な効果
- 品質標準化/属人化解消/工数削減
- 導入難易度
- ★★☆☆☆
- 実装レベル
- 本格構成
- 費用感
- API連携(中)
- 人間の確認
- 条件付き
01導入前 / 導入後の業務フロー
- 8行のインターネットバンキングにログインし、外貨預金の月末残高と当月の入出金の明細を CSV で書き出す
- 銀行ごとに列の並びが違う CSV を開き、口座ごとの月末残高を報告のスプレッドシートに写す
- 取引銀行が公表した月末のレートを通貨ごとに表に入れ、口座ごとに円換算額を計算する
- 前月の報告の表から前月末の残高とレートを写し、通貨ごとの増減を出す
- 増減の大きい通貨について、明細を開いて大きな入金・出金を探し、摘要から何の動きかを読み取る
- 通貨ごとに説明文を書き、全体の要約を添えて財務部長に回す
- 財務部長の確認のあと、経営会議の資料と経理へ渡す
- 人8行のインターネットバンキングから残高と明細の CSV を書き出し、ドライブの取り込みのフォルダに置く
- 人取引銀行が公表した月末のレートを、レートの表に通貨ごとに入れる
- 自動時間主導のトリガーで Apps Script が動き、必要な CSV とレートがそろっているかを確かめる
- 自動銀行ごとの列の対応表で CSV を読み、口座ごとの月末残高と明細を共通の形にそろえる
- 自動前月末の残高に当月の入出金を足し引きした値が月末残高と合うかを、口座ごとに確かめる
- 自動米ドルのレートを日本銀行の API の17時時点の値と比べ、離れすぎていれば止める
- 自動口座ごと・通貨ごとに円換算額、前月からの増減、為替の分、残高の分を計算する
- 自動通貨ごとに大きな入出金を拾い、摘要と金額を Claude API に渡して、動きの分類と数値の枠付きの説明文を返させる
- 自動説明文に数字が直接書かれていないか、枠の名前が正しいかを確かめ、計算した値を差し込む
- 人財務の担当が、表と説明文、「よく分からない入出金」の一覧を確かめて直す
- 人財務部長が確認し、経営会議の資料と経理へ渡す
各工程の詳しい説明を読む
- 8行のインターネットバンキングにログインし、外貨預金の月末残高と当月の入出金の明細を CSV で書き出す
- 銀行ごとに列の並びが違う CSV を開き、口座ごとの月末残高を報告のスプレッドシートに写す
- 取引銀行が公表した月末のレートを通貨ごとに表に入れ、口座ごとに円換算額を計算する
- 前月の報告の表から前月末の残高とレートを写し、通貨ごとの増減を出す
- 増減の大きい通貨について、明細を開いて大きな入金・出金を探し、摘要から何の動きかを読み取る
- 通貨ごとに説明文を書き、全体の要約を添えて財務部長に回す
- 財務部長の確認のあと、経営会議の資料と経理へ渡す
(a)写す回数が多い。 2番・3番・4番はどれも写す作業で、60口座×(残高・レート・前月の値)を毎月手で動かしています。どこか1か所の写し違いが、通貨の合計と全体の合計に伝わります。
(b)レートの入れ違いに気づきにくい。 ユーロの欄に英ポンドの値を入れる、前月のレートのまま残す、といった誤りは「為替が動いたのだろう」と読まれ、報告に載ったまま翌月に見つかることがあります。
(c)為替の分と残高の分が混ざって書かれる。 円換算額の増減には、レートが動いた分と外貨そのものが動いた分が入っています。分けずに「為替の影響もあり増加」と書くと、どちらが主だったのか分かりません。
(d)明細を読む作業が重い。 理由を書くには摘要を読んで何の取引かを当てる必要があり、銀行ごとに摘要の書き方が違います。
- 【人】 8行のインターネットバンキングから残高と明細の CSV を書き出し、ドライブの取り込みのフォルダに置く
- 【人】 取引銀行が公表した月末のレートを、レートの表に通貨ごとに入れる
- 【自動】 時間主導のトリガーで Apps Script が動き、必要な CSV とレートがそろっているかを確かめる
- 【自動】 銀行ごとの列の対応表で CSV を読み、口座ごとの月末残高と明細を共通の形にそろえる
- 【自動】 前月末の残高に当月の入出金を足し引きした値が月末残高と合うかを、口座ごとに確かめる
- 【自動】 米ドルのレートを日本銀行の API の17時時点の値と比べ、離れすぎていれば止める
- 【自動】 口座ごと・通貨ごとに円換算額、前月からの増減、為替の分、残高の分を計算する
- 【自動】 通貨ごとに大きな入出金を拾い、摘要と金額を Claude API に渡して、動きの分類と数値の枠付きの説明文を返させる
- 【自動】 説明文に数字が直接書かれていないか、枠の名前が正しいかを確かめ、計算した値を差し込む
- 【人】 財務の担当が、表と説明文、「よく分からない入出金」の一覧を確かめて直す
- 【人】 財務部長が確認し、経営会議の資料と経理へ渡す
7番目と9番目が、この設計の分かれ目です。 数字は全部 Apps Script が出し、AIは数字に触れません。AIの出した文に数字が入っていたら、その時点で人に回します。 説明文の数字と表の数字が食い違うことが、作りの上で起こりません。
5番目の残高の検算も、手作業では省かれていた確認です。 合わない口座は、書き出しの漏れか定期預金の満期・預入のような明細に出にくい動きがあった口座です。
02今回想定するシステム構成
各行のインターネットバンキング(外貨預金の残高・明細の CSV) ▼【人】ドライブの取り込みのフォルダに置く ▼【人】レートの表に月末のレートを入れる ▼【トリガー】時間主導(月初の営業日の朝、1日1回) Google Apps Script ├──▶ 銀行ごとの列の対応表で CSV を読み、共通の形へ ├──▶ 残高の検算(前月末+入金-出金=月末) ├──▶ 日本銀行 時系列統計の API(米ドル・円 17時時点)とレートを照合 ├──▶ 円換算額・増減・為替の分・残高の分を計算 ├──▶ 通貨ごとに大きな入出金を拾う ▼ Claude API(Messages API、構造化出力) │ 動きの分類、数値の枠付きの説明文、よく分からない入出金 ▼ Google Apps Script ── 数字の混入と枠の名前を確かめ、値を差し込む ▼ 報告のシート(表・説明文・要確認の一覧)── 財務の担当へ通知 ▼ 【人】担当が確認・修正 → 財務部長の確認 → 経営会議の資料と経理へ
| 役割 | 想定する製品 | 代替候補 |
|---|---|---|
| 実行環境 | Google Apps Script | Python、Make |
| 生成AI | Claude API(Messages API、構造化出力) | OpenAI API、Gemini API |
| 保管 | Google スプレッドシート(口座の表・銀行ごとの列の対応表・レート・報告・記録) | - |
| 取込 | Google ドライブ(CSV の取り込みのフォルダ) | - |
| 参照値 | 日本銀行 時系列統計データ検索サイトの API | - |
新しく足すのは、Apps Script の処理と Claude API の呼び出し、それに口座の表・銀行ごとの列の対応表・レートの表・摘要の手がかりの表です。 インターネットバンキングと会計システムには書き込みません。
照合に使う参照値は、日本銀行が2026年2月18日に提供を始めた時系列統計データ検索サイトの API です。 外国為替市況のデータベース(FM08)に、東京市場のドル・円のスポットの17時時点の値(FXERD04、オファーとビッドの中間値)があります。これは換算に使うレートではなく、入れたレートの取り違えを見る物差しです。 換算には取引銀行の月末のレート(TTM など自社の規程で決めたもの)を使い、ずれの許容幅は自社で決めます。
AIの部品は Claude API の構造化出力です。 公式のページでは、output_config.format に type: "json_schema" でスキーマを渡すと、スキーマに沿った JSON が返るとされています。数値の最小・最大や文字列の長さの制約はスキーマに書けないので、範囲の確かめは Apps Script の側で行います。
03どうやって実装するのか
処理の起点を決める
時間主導のトリガーで、月初の営業日の朝に1日1回動かします。 公式のページでは、時間主導のトリガーは1分ごとから月1回まで設定でき、実行の時刻は少しずれることがあるとされています。月1回にすると、CSV がそろう前に動いて空振りし、次の月まで動かなくなるので、月初の5営業日のあいだは毎朝動かし、そろった日に一度だけ本処理をする作りにします。
動き出したら、まず「そろっているか」だけを見ます。 口座の表にある60口座それぞれについて、その銀行の CSV が取り込みのフォルダにあるか、レートの表にその月の8通貨の値が入っているかを確かめます。1つでも欠けていれば本処理をせず、何が足りないかを担当に知らせて終わります。 半分だけそろった状態で換算すると、合計が前月から大きく動いたように見えます。
同じ月の本処理は一度しか走らせません。 実行の記録のシートで結果が「完了」の月は、トリガーが動いてもそこで止まります。時刻は朝9時以降にします。 日本銀行の API の説明書では、データは原則として8時50分ごろに更新されるとされています。
入力データを集める
| データ | 中身 | 取得元 |
|---|---|---|
| 残高の CSV | 口座番号の下4桁、通貨、月末の残高 | 各行のインターネットバンキング |
| 明細の CSV | 日付、入金・出金、金額、摘要 | 各行のインターネットバンキング |
| 口座の表 | 銀行、通貨、種類(普通・定期)、用途、前月末の残高 | 自社で用意(前月の報告から自動で引き継ぐ) |
| レートの表 | 通貨ごとの月末のレート、出どころ(銀行名・レートの種類) | 担当が入力 |
| 参照値 | 東京市場のドル・円のスポットの17時時点 | 日本銀行の API |
| 摘要の手がかりの表 | 摘要に出る語と、取引の種類の対応 | 自社で用意 |
質を決めるのは、いちばん下の表です。 「IMPORT PAYMENT」「仕入代金」「為替予約受渡」「定期預入」のような摘要の語と自社での取引の種類の対応で、AIに渡すときの手がかりになります。 摘要に出る取引先が仕入先か販売先かも書いておきます。口座番号は下4桁だけを持ちます。
データの取得方法を決める
CSV は、銀行ごとの列の対応表を見て読みます。 銀行によって列の並び、日付の書き方、入金と出金を1列に符号で入れるか2列に分けるかが違います。対応表に「残高はこの列、日付はこの書式、入出金はこの列」を銀行ごとに書き、Apps Script のコードには銀行ごとの分岐を書きません。 銀行が書き出しの形を変えたときは、表を直すだけで済みます。
CSV の文字列は Utilities の parseCsv で2次元の配列にします。 公式のページでは、CSV の文字列を表の形の2次元の配列にして返すとされています。日本の銀行の CSV は Shift_JIS のことが多いので、ファイルの中身を文字コードを指定して文字列にしてから渡します。
日本銀行の API は UrlFetchApp.fetch で呼びます。 説明書の例にならい、コード API に format=json、lang=jp、db=FM08、code=FXERD04 と期間を付けます。日次の系列でも、期間は年月(YYYYMM)で指定すると説明書にあります。返ってくる JSON には日付の並びと値の並びがあり、土日・祝日の値は null です。 月末が休日なら、月末から遡って最初に値のある日を使います。
https://www.stat-search.boj.or.jp/api/v1/getDataCode
?format=json&lang=jp&db=FM08&code=FXERD04&startDate=202610&endDate=202610 AIへ渡す前に整形する
- そろっているかの確認 … 60口座の CSV と8通貨のレートがあるか。欠けがあれば止めて知らせます
- 共通の形にそろえる … 対応表で列を読み、日付、通貨、金額を同じ形にします。金額の桁区切りのカンマや通貨の記号を外します
- 残高の検算 … 口座ごとに「前月末の残高+当月の入金-当月の出金」と CSV の月末残高を比べます。合わない口座は換算に進めず、要確認に出します
- 定期預金の動きの確認 … 満期・預入・書き換えは、普通預金の明細に入らず、定期の口座の残高だけが動くことがあります。同じ通貨の普通と定期の動きを並べ、行き来として対にできるかを見ます
- レートの照合 … 米ドルのレートを日本銀行の17時時点の値と比べ、許容幅を超えれば止めます。ほかの通貨は前月のレートからの変化率を見て、極端な動きを止めます
- 大きな入出金を拾う … 通貨ごとに、金額の大きい順に入出金を並べ、その通貨の当月の動きの合計の8割に届くところまでを拾います。細かい手数料や利息はまとめて「その他」にします
- 渡す情報を絞る … AIに渡すのは、通貨、取引の日付、入金・出金、外貨の金額、摘要、手がかりの表で付けた候補の種類だけです。口座番号、銀行の担当者名、社内の決裁番号は渡しません
3番目を省かないでください。 合わない口座を残したまま説明文を作ると、AIは「入金があったため増加」ともっともらしく書きます。 理由の付けようのない数字に理由を付ける前に、数字のほうを止めます。
5番目で米ドルだけを照合するのは、外国為替市況のデータベースの日次の値が東京市場のドル・円とユーロ・ドルだけだからです。 ユーロはこの2つを掛けて大まかに確かめ、残りの6通貨は前月からの変化率と担当の目視で補います。
AIに処理させる
させるのは、通貨ごとの大きな入出金を取引の種類に分け、動きの理由を短い文にまとめることだけです。 計算はすべて済んでいて、AIには結果の値を見せずに、どの値をどこで使うかを枠の名前で指させます。
| 見るもの | させること | 判断できないときの扱い |
|---|---|---|
| 大きな入出金の摘要と金額 | 取引の種類(輸入の支払・輸出の入金・為替予約の受渡・円転・外貨転・口座間の振替・定期の預入と満期・利息・手数料)に分ける | 種類を決められなければ unclear にし、よく分からない入出金の一覧に出す |
| 通貨ごとの入出金の分け方 | 増減の主な理由を1〜2文で書く | 理由を明細から言えなければ、その旨を書く |
| 為替の分と残高の分の大きさの順 | どちらが主だったかを、渡された順位どおりに書く | 順位を自分で決めない |
| 全通貨の動き | 報告の冒頭の要約を2〜3文で書く | - |
3行目の「順位」は、Apps Script が比べて渡します。 AIに金額を比べさせると、桁の読み違いで順序が入れ替わることがあります。結果だけを「為替の分が主」「残高の分が主」として渡します。
| させないこと | 理由 |
|---|---|
| 金額・レート・増減の数字を書くこと | 表と食い違う原因になる。数字は枠で指し、後から差し込む |
| 為替の先行きや相場の評価 | 報告の目的は前月の事実の説明。見通しは財務部長が書く |
| 為替予約の過不足の判断 | ヘッジの方針に関わる。別の仕組み(UC-0223 など)と人が見る |
| 会計上の換算差額や損益の説明 | 換算のレートや帳簿の価額は会計の側で決まる |
| 摘要に無い取引先や目的を補うこと | 明細から言えないことを、もっともらしく足させない |
1行目がいちばん大事な禁止です。 文の中に「約120万ドルの減少」と書かせると、端数の丸め方や単位で表とずれ、読む側はどちらが正しいのか確かめ直すことになります。
指示内容を固定する
あなたは商社の財務部で、外貨預金の月次の報告の説明文を下書きする立場です。
渡された入出金の明細と、計算済みの結果の「順位」だけを使って書いてください。
【やること】
1. 各通貨の入出金(items)を、次のどれかに分けてください。
import_payment(輸入の支払)/export_receipt(輸出の入金)/
forward_settlement(為替予約の受渡)/jpy_conversion(円転)/
fx_purchase(外貨転)/internal_transfer(口座間の振替)/
time_deposit(定期の預入・満期)/interest(利息)/fee(手数料)/
unclear(決められない)
2. 各通貨について、残高が増えた・減った主な理由を1〜2文で書いてください。
3. 全体の要約を2〜3文で書いてください。
【数字の書き方(厳守)】
- 金額・レート・増減・比率の数字を、文の中に一切書かないでください。
- 数字が必要な箇所は、次の枠の名前をそのまま書いてください。
{{通貨.jpy_change}} 円換算額の増減
{{通貨.fx_effect}} 為替の動きによる分
{{通貨.balance_effect}} 外貨の残高の動きによる分
{{通貨.fc_change}} 外貨の残高の増減
{{total.jpy_change}} 全通貨の円換算額の増減
(「通貨」の部分は USD・EUR などのコードに置き換える)
- 渡された枠の一覧に無い名前を作らないでください。
【守ること】
- 為替と残高のどちらが主だったかは、渡された main_driver のとおりに書いてください。
自分で比べ直さないでください。
- 取引の種類は、摘要と手がかり(hint)から言えるものだけにしてください。
摘要に取引先の名前や目的が無いとき、補って書かないでください。
- 決められない入出金は unclear とし、unclear_items に理由を書いてください。
- 為替の見通し、相場の評価、為替予約の過不足、会計上の損益は書かないでください。
- 文体は「です・ます」にせず、報告の体(「〜により減少」)で書いてください。
【対象月】{target_month}
【通貨ごとの計算の順位】{drivers}
【使える枠の一覧】{placeholders}
【通貨ごとの入出金】{items}
「自分で比べ直さない」を明記するのは、AIが入出金の金額を足し上げて、渡した順位と違う結論を書くことがあるからです。 渡す明細は大きいものだけなので、足し上げても全体にはなりません。順位は全件から計算した側に置きます。
「枠の一覧に無い名前を作らない」も同じ理由です。 何も言わないと {{USD.total_change}} のような名前を作り、差し込みの段階で空になります。作られた名前は、差し込む前の確かめで見つけて人に回します。
出力形式を固定する
次の形の JSON で受け取ります。
{
"target_month": "2026-10",
"currencies": [
{
"currency": "USD",
"classified_items": [
{ "item_id": "USD-0012", "category": "import_payment", "basis": "摘要にIMPORT PAYMENTと仕入先名" }
],
"comment": "輸入の代金の支払が輸出の入金を上回り、外貨の残高は{{USD.fc_change}}。円換算額は{{USD.jpy_change}}で、主に残高の動きによる({{USD.balance_effect}})。",
"unclear_items": [
{ "item_id": "USD-0031", "reason": "摘要が振込番号のみで取引の種類を決められない" }
]
}
],
"summary": "全通貨の円換算額は{{total.jpy_change}}。米ドルとユーロで輸入の支払が続き、残高の減少が為替の影響を上回った。"
}
category は前の節の10種類のどれかで、スキーマの enum で縛ります。item_id は Apps Script が明細に振った番号で、AIが新しく作ることはできません。 返ってきた番号が渡した明細に無ければ、その通貨を人に回します。
1つ目の理由は、数字の差し込みを機械で確かめられることです。 comment と summary の文から {{ と }} で囲まれた名前を拾い、使える枠の一覧と照らします。枠の外に数字が1文字でもあれば、その文は差し込まずに担当に回します。 確かめは正規表現で足ります。
| 確かめること | 合わないとき |
|---|---|
| 枠の外に数字が無い | その通貨の文を差し込まず、要確認に出す |
| 枠の名前が一覧にある | 同上 |
item_id が渡した明細にある | 同上 |
main_driver と文の主語が食い違わない | 担当の確認で見る(機械では見ない) |
2つ目は、取引の種類の分け方を毎月ためられることです。 記録に残した classified_items が、摘要の手がかりの表を育てる材料になります。
差し込む値の単位と丸めは、Apps Script の側で1か所に決めます(円換算額は百万円の単位で小数1桁、「増加」「減少」の語を付ける、など)。報告の表と文で同じ書き方になります。
システムへ連携する
| つなぎ先 | 方式 | 内容 |
|---|---|---|
| 取り込みのフォルダ | Apps Script のドライブの操作 | 銀行ごとの CSV を読む |
| 報告のスプレッドシート | Apps Script のスプレッドシートの操作 | 口座の表・レートを読み、表と説明文を書く |
| 日本銀行の API | UrlFetchApp.fetch(GET) | ドル・円の17時時点の値を取る |
| Claude API | UrlFetchApp.fetch(POST) | 分類と説明文の下書き |
| 通知 | Gmail またはチャット | 担当に完了・要確認・欠けを知らせる |
Claude API は Messages API を呼びます。 公式のページでは、要求には Authorization: Bearer の認証(または旧来の x-api-key)、anthropic-version、content-type: application/json のヘッダーが要るとされています。API キーはスクリプトのプロパティに置き、コードに書きません。 UrlFetchApp.fetch は muteHttpExceptions を付けると失敗の応答でも例外を投げずに中身を返すので、状態コードと本文を記録してから分岐します。
会計システムへは書き込みません。 この構成が出すのは月次の報告の表と説明文までで、換算の仕訳は経理が会計の規程に沿って起こします。 インターネットバンキングにも書き込まず、CSV の書き出しは人が行います。
人が確認する
担当が見るのは、上から順に3つです。 全部の明細を開き直す必要はありません。
- 止まったもの … 残高の検算が合わない口座、照合で止まったレート、数字が混ざった説明文。ここは必ず全部見ます
- よく分からない入出金 … インターネットバンキングで詳細を開き、種類を決めて摘要の手がかりの表に足します
- 説明文と表の向き … 文の「減少」「増加」と表の符号、主な理由(為替か残高か)が表と合っているかを読みます
3番目は機械では見ません。 枠で数字は守れても、「為替の影響で減少」と書きながら表では為替の分がプラス、という文の向きまでは守れません。 財務部長は、担当の直した報告だけを見ます。
目標は、60口座をならして1口座6分です。 止まった口座が数口座、よく分からない入出金が十数件という想定で、それより多い月は、銀行の CSV の形が変わったか、手がかりの表が足りていません。
例外に対処する
| 起きること | 対応 |
|---|---|
| CSV が欠けている | 本処理をせず、欠けている銀行と口座を担当に知らせる |
| 銀行が CSV の列を変えた | 対応表の列が見つからない時点で止める。表を直してから再実行 |
| 残高の検算が合わない | その口座は換算に進めず要確認へ。定期の動きと書き出しの期間を先に疑う |
| レートが入っていない・前月のまま | 本処理をせず担当に知らせる。前月と同じ値は、変化が0のときも一度確かめる |
日本銀行の API が応答しない・null が続く | 照合を保留にして翌朝に回す。留意点のとおり、繰り返し叩かない |
| 新しい口座・新しい通貨が CSV に出る | 口座の表に無い口座は換算せず、担当に知らせる |
| Claude API が失敗する・形が合わない | 表は完成させ、説明文だけ空欄にして担当に知らせる |
| 説明文に数字や知らない枠が入る | その通貨の文を差し込まず、要確認に出す |
unclear が多すぎる | 手がかりの表の不足を疑う。説明文はその旨を書かせたまま人が補う |
上の3行が大半を占めます。 どれもAIの問題ではなく、書き出しの手順と口座の表の整備の問題です。 直すほうが、プロンプトを磨くより効きます。
Claude API が失敗しても、表は完成させます。 説明文が無くても、報告の骨格は月初に間に合います。
記録を残す
- 取り込んだ CSV の原本(ファイル名に銀行と対象月を付けて、月ごとのフォルダへ移す)
- 共通の形にそろえた残高と明細、残高の検算の結果
- 使ったレートと出どころ、日本銀行の API で取った値と照合の結果
- 計算した円換算額・増減・為替の分・残高の分(口座ごと・通貨ごと)
- Claude API に渡した内容と返ってきた JSON の全文、確かめの結果
- 担当と財務部長が直した箇所(AIの文・担当の直し・部長の直しを並べて)
- 実行の記録(対象月・日時・結果・止まった理由)
3つ目で「レートの出どころ」を残さないと、数か月後に表を見直したときに同じ値を再現できません。 6つ目は、2人が同じ直しをしていればプロンプトに足すべき決まりです。
04実装レベルの3段階
最小構成では、転記の時間は減りません。 60口座を手で写すのは同じで、確かめるための段階です。 半自動化で、1口座15分が10分程度になります。 転記と換算と前月の値の写しが無くなりますが、明細を読んで説明を書く作業が残ります。本格構成で6分になり、この段階が本記事の想定です。 残る6分は、止まったもの・よく分からない入出金・文の向きの確認です。 段階を飛ばさないでください。 半自動化を2〜3か月回すと、CSV の癖と検算が合わない口座の型が先に分かります。 定期預金の扱いを決めてから説明文を足します。
05工数削減シミュレーション
導入後 60件 × 6分 ÷ 60 = 6 時間/月
自社条件で導入効果を整理したい方へ
このユースケースを自社に当てはめた場合の前提値と削減見込みを、業務ヒアリングをもとに整理します。
06向いている企業・向いていない企業
- 輸出入の決済のために複数の銀行に米ドル・ユーロ・人民元などの外貨預金を持ち、口座の数が数十に及ぶ商社・メーカー・輸入の小売。月初に財務の担当が各行の残高を表に写し、月末のレートで円に直して前月と比べ、「なぜ増えたか・減ったか」の説明を毎月手で書いている場合。説明の書き方が担当ごとに違い、レートの入れ違いや前月の値の写し違いが後から見つかったことがある場合。Google Workspace を使える場合。
- 外貨預金の口座が数口座で、毎月の動きがほとんど無い場合。財務の管理のシステムや会計のシステムで、外貨の残高の円換算と増減の要因の表まで自動で出ている場合。会計上の換算の仕訳(期末の換算差額の計上)そのものを自動にしたい場合は、この構成では扱いません。なお、どのレートで換算するか、為替予約をどう扱うかといった会計・税務の判断は、この構成では代替できません。
07最小構成で試す方法
- 先月の報告の表(口座ごとの残高・レート・円換算額・前月の値)と、増減の大きかった2〜3通貨の明細を用意する
- 表計算で、通貨ごとに「為替の分=前月末の外貨の残高×(当月のレート-前月のレート)」「残高の分=(当月の外貨の残高-前月の外貨の残高)×当月のレート」を計算する列を足す
- 2つの分の合計が円換算額の増減と一致するかを確かめる
- 明細の摘要と金額、為替と残高のどちらが主かを、手元のAIサービスの画面に貼る
- 「入出金を取引の種類に分け、増減の主な理由を1〜2文で書いてください。数字は書かず、{{USD.jpy_change}} のような枠で書いてください」と指示する
- 出てきた文を、先月実際に書いた説明と並べる
2番目と3番目だけでも、説明の半分は書けます。 AIの出番はその後です。
| 出てきた内容 | 判断 |
|---|---|
| 先月の説明と同じ理由が出た | CSV の読み込みとつないで、半自動化に進む |
| 数字を書いてしまった | 指示の書き方で直る。構成は有効 |
| 摘要から取引の種類が分からない | 摘要の手がかりの表が先。 AIの問題ではない |
3行目が出ることは珍しくありません。 担当が頭の中に持っている「この摘要はこの取引先」という知識を表にすることが、この構成の最初の成果です。
08実装時につまずきやすいポイント
| 問題 | 対策 |
|---|---|
| 説明文の数字が表とずれる | AIに数字を書かせない。 枠で指させ、Apps Script が差し込む |
| AIが渡した順位と違う結論を書く | 「比べ直さない」を指示に書き、順位は全件から計算した側に置く |
| 残高の検算が合わないまま説明文が出る | 合わない口座は換算に進めない。定期の動きと書き出しの期間を先に疑う |
| レートを別の通貨の欄に入れる | 米ドルは日本銀行の17時時点の値、ほかは前月からの変化率で止める |
月末が休日で API の値が null | 月末から遡って最初に値のある日を使う |
| 日次の系列の期間の指定で失敗する | 説明書のとおり、日次でも年月(YYYYMM)で指定する |
| 銀行の CSV の文字が化ける | Shift_JIS を指定して文字列にしてから CSV として読む |
| 摘要から取引の種類が分からない | 手がかりの表に摘要の語と取引先を足す。unclear の一覧が材料 |
| 為替の見通しまで書いてしまう | 指示で禁じ、見通しは財務部長が書く欄を分ける |
| 日本銀行の API を何度も叩く | 月1回・1系列。失敗したら翌朝に回す |
上の2行が、この構成の失敗のほとんどです。 どちらも「AIが数字を扱う」ところから出ています。
3行目と4行目を省くと、誤った数字にもっともらしい理由の文が付いた報告ができます。 止める仕組みを先に作ってください。
09セキュリティ・AIガバナンス上の注意点
この構成で扱うデータ: 取引銀行ごとの外貨預金の残高、入出金の明細(金額・日付・摘要。摘要には仕入先・販売先の名前が入りうる)、月末のレートです。
- AIに渡す範囲を、説明に要る項目までに限る … 渡すのは通貨・日付・入出金・外貨の金額・摘要・候補の種類だけです。口座番号、銀行名と口座の対応、円換算額の表そのものは渡しません。 銀行名を渡さなくても、説明文は書けます
- API の保存の扱いを確かめる … Claude のデータの保持のページでは、プロンプトと出力は既定では保持しないとされ、例外として Covered Models(Claude Fable 5 系・Claude Mythos 5 系)は30日の保持が必要とされています。また、自動の安全の仕組みで引っかかった場合は最大2年保持しうるとされています。使うモデルが Covered Models に当たらないかを、導入の前に確かめてください
- API キーをコードに書かない … スクリプトのプロパティに置き、スクリプトの編集の権限を財務部の担当に限ります。時間主導のトリガーは作った人のアカウントで動くとされているので、異動の前に作り直します
- 日本銀行の API の留意点を守る … 短い時間に高い頻度でアクセスすることは禁じられています。この構成は社内の報告だけに使い、外へ公開するサービスにはしません。 公開する場合は、留意点にあるクレジットの表示と日本銀行への連絡が求められます
- この構成は会計・税務の判断を代替しない … どのレートで換算するか、換算差額をどう計上するか、為替予約をどう扱うかは、会計の規程と経理・監査法人との取り決めで決めることです。 この構成が出すのは、前月からの動きの説明の下書きです
- 報告のシートの共有を絞る … 取引の規模と取引先が見える資料です。共有は財務部と報告を受ける人に限ります
誤りが起きた場合のリスクは、誤った数字を載せることと、理由の説明が誤っていることの2つです。 前者は検算とレートの照合で、後者は担当の確認で防ぎます。
10まず何から始めるか
1週目:口座の表と銀行ごとの列の対応表を作る
60口座の銀行・通貨・種類・用途・前月末の残高を並べ、8行の CSV の列の並び・日付の書式・入出金の持ち方を対応表に起こします。
2週目:為替の分と残高の分を表計算で出す
先月の報告の表に、為替の分と残高の分の列を足し、合計が増減と一致するかを確かめます。 担当2人で、この2つを並べた形の報告でよいかを財務部長と合わせます。
3週目:最小構成で説明文を試す
2〜3通貨の明細で枠付きの説明文を書かせ、数字を書いていないか、摘要から言えないことを足していないかを見ます。
4週目:Apps Script で CSV の読み込みと検算をつなぐ
取り込みのフォルダから CSV を読み、残高の検算と換算と分解までを作ります。この時点では AI を呼ばず、表だけを月初に出します。
2か月目: 日本銀行の API でのレートの照合を足し、止まった件数を数えます。3か月目以降: Claude API の呼び出しと数字の混入の確かめを足し、1口座15分が何分になったかを実測します。担当2人の直しが毎月同じ型に収まり、それをプロンプトに戻した時点で、この構成は完成です。
11関連ユースケース
12この仕組みを理解するための記事
13技術仕様の確認日・参考情報
| 確認した内容 | 情報源 | 確認日 |
|---|---|---|
| 時系列統計データ検索サイトで、JSON 形式や CSV 形式で時系列統計データを取得できる API の提供を2026年2月18日に始めたこと | 日本銀行: 時系列統計データ検索サイトにおけるAPI機能の提供開始 | 2026-11-17 |
コード API のリクエストの形(format・lang・db・startDate・endDate・code)。日次の系列も期間を年月(YYYYMM)で指定すること。1回のリクエストの系列数の上限が250件、データ数の上限が60,000件であること。データが原則8時50分ごろに更新されること | 日本銀行: API機能利用マニュアル | 2026-11-17 |
| 短い時間における高い頻度のアクセスを禁じること。負荷に応じてアクセスを制限することがあること。サービスを公開する場合はクレジットの表示と日本銀行への連絡を求めること | 日本銀行: API機能利用時の留意点について | 2026-11-17 |
| 時間主導のトリガーが1分ごとから月1回まで設定でき、実行の時刻が少しずれることがあること。インストール型トリガーが作成者のアカウントで動くこと | Google: Installable Triggers | 2026-11-17 |
parseCsv が CSV の文字列を2次元の配列にして返すこと | Google: Class Utilities | 2026-11-17 |
UrlFetchApp.fetch で HTTP の要求を送れること。muteHttpExceptions で失敗の応答でも例外を投げないこと | Google: Class UrlFetchApp | 2026-11-17 |
構造化出力を output_config.format の json_schema で指定すること。オブジェクトに additionalProperties: false が要ること。enum が使え、数値の最小・最大や文字列の長さの制約が使えないこと | Claude: Structured outputs | 2026-11-17 |
要求に Authorization: Bearer(または旧来の x-api-key)、anthropic-version、content-type のヘッダーが要ること | Claude: API overview | 2026-11-17 |
| プロンプトと出力を既定では保持しないこと。Covered Models は30日の保持が必要なこと。自動の安全の仕組みで引っかかった場合は最大2年保持しうること | Claude: API and data retention | 2026-11-17 |
外国為替市況のデータベース(FM08)の系列(FXERD04 が東京市場のドル・円のスポットの17時時点、オファーとビッドの中間値であること。休日の値が null で返ること)は、メタデータ API とコード API の応答で2026-11-17に確かめました。
換算に使うレートの種類、換算差額の会計処理、為替予約の扱いは、自社の会計の規程と、経理・監査法人との取り決めで決めてください。 本記事は公式のページで確認できた範囲だけを扱っています。
実装ステータス:構成例。 公開仕様に基づいて設計した構成であり、当社で実際に構築・検証したものではありません。工数の数値はモデル条件による試算です。
自社の業務に使えるAI活用候補を整理します
このユースケース(UC-3479)についてのご相談はこちらから。
