CAPEX（設備投資・借入）自動起票 — 24_bud_capex_loan

1. 基本情報

焦点質問: 設備投資・借入マスタからどのようなINV（資産計上・減価償却・返済・利息）を自動生成するか？

2. 前提条件・依存関係

3. 入力スキーマ

24_bud_capex_loan カラム定義

4. 処理ロジック（マトリクス）

共通INVフィールド（buildCommon が自動設定）: 有効フラグ=true, 請求ID=INV_YYYYMMDD_NNNN(自動発番), 起票日時=now, 起票者="RPA自動起票", 請求ステータス="未処理", 通貨="JPY", 税区分="対象外", 消費税額_計画=0, 収支区分="支出", 税込金額_計画=税抜金額_計画, 未決済残高=税抜金額_計画

全Rowに対して isDuplicate_() による摘要ベースの重複チェックあり。存在すればSKIP。

親ORD自動作成: 管理IDが存在し31_wrk_orderに未登録の場合、buildOrdRow_ でORDを自動作成する。

4.1 初期化・スキップ判定

4.2 初回イベント（発生年月のみ — Row A/B/C/C2）

4.3 毎月イベント — 減価償却（Row D）

4.4 毎月イベント — 返済・利息（Row E/F）

4.5 書き出し

脚注:

• ※1: コード上は debtAccount を24タブの負債科目列から取得。空文字の場合はそのまま空文字となる（デフォルト値なし）
• ※2: 端数調整により Σfee = 取得価額 が保証される。ROUND丸めの累積誤差を最終月で吸収

5. 出力サマリー

イベント一覧（1資産あたり）

ORD自動作成

管理IDが存在し31_wrk_orderに未登録の場合、以下のORDを自動作成する。

6. 業務ルール

1. 資産計上・減価償却はCF非対象 — Row A〜C は決済手段="資産計上"、Row D は決済手段="資産計上"。Cash Flow計算書に影響しない
2. 会社支払開始年月 — この月から返済(Row E/F)を起票。それより前の月は返済をスキップ
3. 初回イベントは発生年月のみ — Row A/B/C は発生年月に1回だけ生成
4. 償却は発生年月の翌月から — m=1 なので addMonths(occurYm, 1) が初回
5. 端数調整 — 月額償却 = ROUND(取得価額/償却月数)。最終月に残額を調整して累計=取得価額を保証
6. 頭金 = 取得価額 − 借入金額 — 差額がなければ Row C/C2 は生成しない
7. 頭金返済の分割 — 頭金分割回数>1の場合、発生月から分割回数分の月にわたり ROUND(頭金/分割回数) ずつ返済INVを生成。最終回は端数調整
8. 月額返済額の手入力優先 — 手入力があればそれを使用。0なら借入金額÷返済月数で自動計算
9. 初回返済額 — curRepayYm === payStartYm かつ初回返済額>0の場合のみ適用。それ以外は月額返済額
10. 減価償却の2行ペア — Row D-1(P/L費用: +fee) + Row D-2(B/S資産: -fee)でセット
11. 返済INVの符号 — Row E の税抜金額_計画は -repayAmt（負値: B/S負債の減少を表現）
12. 申請種別の動的決定 — 返済INV(Row C2/E/F)の申請種別は決済手段の文字列から決定: 立替→経費精算、振込→手動振込、振替→自動引落、その他→請求書受領(AP)
13. 組織名の転送 — 24タブの組織名を ORD および全 INV 行にそのままコピーする
14. 決済ラグの全角対応 — 決済ラグ(月)列の全角数字は半角に自動変換される

7. 冪等性（二重起票防止）

8. エラーハンドリング

9. テスト仕様

テストデータ（CPX_0001 社用車）

算出変数:

頭金           = 2,960,000 - 1,960,000 = 1,000,000
月額償却費     = ROUND(2,960,000 / 24) = 123,333
最終月償却     = 2,960,000 - 123,333 × 23 = 123,341（端数調整）
返済終了月     = 2026-04 + 60 - 1 = 2031-03
償却開始月     = 2025-11（発生年月の翌月）
償却終了月     = 2027-10（24ヶ月後）

単体テスト観点

ケース A: 初回実行（target=2025-10 / 発生年月）

32タブ期待結果（INV 3行 — 初回イベントのみ）

返済 Row E/F: 会社支払開始年月=2026-04 > target=2025-10 → SKIP 償却 Row D: 発生年月の翌月(2025-11)から開始、target=2025-10 → SKIP STL: 全て資産計上 → 0行

期待値サマリー

B/S等式チェック: 資産 2,960,000 = 負債 2,960,000 (1,960,000 + 1,000,000) ✓

ケース B: 償却開始後（target=2025-11）

32タブ期待結果（INV 2行 — 償却1ヶ月目）

返済 Row E/F: 会社支払開始年月=2026-04 > target=2025-11 → SKIP STL: 全て資産計上 → 0行

期待値サマリー（累計: 2025-10 + 2025-11）

ケース C: 返済開始後（target=2026-04）

32タブ期待結果（INV 4行 — 償却 + 返済 + 利息）

償却は6ヶ月目（m=6: addMonths("2025-10",6)="2026-04"）。

33タブ期待結果（STL 2行 — Action A後）

期待値サマリー（target=2026-04 単月）

ケース D: 償却最終月（target=2027-10 / 24ヶ月目）

32タブ期待結果 — 端数調整

月額償却: 123,333 × 23ヶ月 = 2,836,659
最終月:   2,960,000 - 2,836,659 = 123,341（端数調整）

この月以降、Row D は生成されない。Row E/F は2031-03まで継続。

付録

付録A: Action A→Action Bの流れ

Action A（INV承認 → TRN + STL自動作成）

資産計上Row（A, B, C）と減価償却Row（D-1, D-2）は決済手段="資産計上" のため STL対象外（現金移動なし）。 口座振替等のRow（C2, E, F）のみSTLが自動作成される。

STL 1: 元本返済 (Row E) — 税込金額_決済 = repayAmt
STL 2: 支払利息 (Row F) — 税込金額_決済 = monthlyInterest
STL 3: 頭金返済 (Row C2) — 税込金額_決済 = 分割額（該当する場合）

親ORDあり: CAPEX INVは親ORD_IDが設定されるが、ORDの発注残高はCAPEX全体の取得価額であり、個別INVの差引きには影響しない。STL税込金額_決済 = INV請求総額。

Action B（STL消込 → 決済仕訳）

STLに決済日・消込済を入力 → Action B で決済仕訳生成 → INV未決済残高=0。