仕訳エンジン — 403_subledger_engine

1. 基本情報

焦点質問: INV承認/STL消込時にどのような仕訳を自動生成するか？

アーキテクチャ図

flowchart TB
    subgraph BUD["20s BUD — 予算・契約マスタ"]
        bud["20_bud_xxx"]
    end

    subgraph WRK["30s WRK — サブ元帳"]
        ORD["31_wrk_order (ORD)
発注・契約台帳"]
        INV["32_wrk_invoice (INV) ★SSOT
請求・債権債務台帳"]
        STL["33_wrk_bank (STL)
入出金・消込台帳"]
    end

    subgraph TRN["40s TRN — 総勘定元帳"]
        JNL["42_trn_journal (JNL)
仕訳台帳 — SSOT"]
    end

    bud -->|"RPA起票
401_bat_rpa.js"| INV
    bud -->|"RPA起票"| ORD

    INV -->|"Action A
費用計上仕訳"| JNL
    INV -.->|"STL自動作成"| STL
    STL -->|"Action B
決済仕訳"| JNL
    STL -->|"Action B: 残高更新"| INV
    INV <-->|"ORD残高減算"| ORD

ライフサイクル

flowchart LR
    A["ORD
発注済"] --> B["INV
未処理"]
    B --> C["INV
承認済"]
    C -->|"Action A"| D["TRN生成
+ ORD残高減算"]
    D --> E["STL
消込済"]
    E -->|"Action B"| F["TRN生成
+ INV残高=0
+ Action A TRN
決済日_実績更新"]

2. インターフェース定義

Action A 入出力

Action B 入出力

3. データスキーマ

42_trn_journal (TRN_JOUR)

注: ヘッダー名はコード上の buildTrnRow_ で使用される名称と一致。税抜金額_実績 / 消費税額_実績 / 税込金額_実績 / 仕訳ステータス はコード実装に基づく正式名称。

4. 処理ロジック

4.1 Action A — INV承認 → 費用計上仕訳

STEP 1〜2: 初期化

経理向け補足: 「天引き額Map」は、給与支払い時に源泉税・住民税・社会保険料などを給与から差し引く（天引きする）金額の集計。仕訳振替INVの金額を合算し、STL（決済）の差引支給額算出に使用する。キーは ORD_ID|YYYY-MM（対象月は摘要の【RPA:HC】接頭辞の直後7文字から抽出）。

STEP 3: INVスキャン → TRN生成

STEP 4〜5: STL自動作成 + 即決済完了

STEP 6: 一括書き込み

INV → TRN 列マッピング (Action A)

全フィールドをヘッダー名ベース (buildTrnRow_) で設定。列番号のハードコードなし。

ORD発注残高の減算

減算額 = INV の 税込金額_計画
ordBalUpdates[ordId] = ordMap[ordId].balance - 税込金額_計画
→ 31_wrk_order の 発注残高(自動計算) 列に書き戻し

4.2 Action B — STL消込 → 決済仕訳

STEP 1〜3: 初期化

STEP 4: STLスキャン → 決済仕訳生成

経理向け補足: 「決済日 < INV発生日」は、費用の発生（計上）より前に代金を支払っている状態。前払費用（例: 年払いSaaSの一括支払い）や売上入金（入金が納品より先）の場合は会計上正当なため処理を続行する。それ以外のケースは入力誤りの可能性があるためスキップし、警告ダイアログを表示する。

STEP 5: INV未決済残高の再計算

STEP 6: 一括書き込み

注: B6.2 では消込手段が空の場合に「手動」を自動セットし、緑ハイライト(#d9ead3)をクリアする。

STL → TRN 列マッピング (Action B: メイン決済仕訳)

STL → TRN 列マッピング (Action B: 差額仕訳)

5. 財務ロジック (FRD)

※ 本セクションは経理担当・CFOが検証可能な表現で記述。技術用語は使用しない。 → 技術詳細: §4 参照

5.1 費用計上時の仕訳パターン

請求書が承認されると、以下の仕訳パターンで費用計上仕訳を自動生成する。

5.2 決済消込時の仕訳パターン

消込済の入出金レコードに対して、以下の仕訳パターンで決済仕訳を自動生成する。

5.3 天引き額の計算（給与支払い）

差引支給額 = 月額給与・報酬の請求総額 − 天引き合計（源泉税 + 住民税 + 社会保険料等）

• 天引き対象: 同一発注+同一対象月の仕訳振替INV金額の合計
• 対象月の判定: 摘要の「【RPA:HC】YYYY-MM」から抽出
• STL自動作成時の決済金額として使用

5.4 未決済残高の再計算

未決済残高 = 請求総額（絶対値） − 全消込済STLの決済金額合計

• 残高=0 → 「決済完了」
• 残高>0 かつ一部消込済 → 「部分決済」
• 減算方式ではなく、全STL合計から逆算して再計算する（整合性保証）
• 集計条件: 消込済 かつ 自動仕訳JNL_IDあり（Action B処理済のSTLのみ）

5.5 バリデーションルール

6. 冪等性・整合性保証

7. テスト仕様

付録A: ヘルパー関数一覧

generateTrnId_

TRN_ID発番: "TRN_{yyyyMMdd}_{NNNN}" 形式
  - dateStr ごとにキャッシュし、既存TRN_IDの最大連番+1から発番
  - offset でバッチ内連番を加算
  - バッチ開始時に _cache をリセット

generateStlId_

STL_ID発番: "STL_{yyyyMMdd}_{NNNN}" 形式
  - generateTrnId_ と同じロジック
  - 33_wrk_bank の決済ID(STL)列から最大連番を取得

buildHeaderIndex_

ヘッダー配列からインデックスMapを構築: { ヘッダー名: インデックス }
全シートの列参照で使用。列順序の変更に強い。

buildTrnRow_

TRNヘッダーインデックスMap + fields (ヘッダー名→値) から TRN行配列を構築。
列番号のハードコードなしに TRN行を組み立てる。

付録B: メンテナンスツール

メニュー「⚙️ システム管理」から実行可能。

42_trn_journal の孤立TRN削除 (cleanupOrphanTrn)

孤立条件（いずれかに該当）:
  (1) TRN_IDが 32/33 の自動仕訳JNL_ID にない
  (2) 管理IDが 32 の INV_ID にも 33 の STL_ID にも存在しない

動作:
  対象の取引ID一覧をダイアログに表示（20件超は省略）
  OK → 下の行から順に削除

31/32/33 タブの重複行チェック (cleanupDuplicateRows)

ID列(ORD_ID / INV_ID / STL_ID)で重複を検出。
最初の行を残し、重複行を赤色(#F4CCCC)でマーク。
解消後の再チェックで赤を自動リセット。

32/33 タブの整合性チェック (checkInvStlConsistency)

チェック1: 承認済/部分決済/決済完了(現金決済)のINVにSTLがない → 黄色マーク
チェック2: STLが参照するINVが32に存在しない → 黄色マーク
チェック3: 32/33のJNL_IDが42に存在しない(TRN欠落) → 青色マーク
解消後の再チェックで色を自動リセット。

付録C: ADR

実装方針: ヘッダー名ベース参照

全シート (INV, STL, ORD, TRN) の列参照を buildHeaderIndex_ + ヘッダー名で行う。 列番号のハードコードは一切使用しない。スキーマ変更時にコード修正が不要になる。

// 列参照
const invIdx = buildHeaderIndex_(invData[0]);
const status = row[invIdx['請求ステータス']];

// TRN行構築
const trnRow = buildTrnRow_(trnIdx, trnColCount, {
  '取引ID': trnId,
  '発生日(P/L計上日)': accrualDate,
  // ...
});

// 書き戻し
invSheet.getRange(rowNum, invIdx['自動仕訳JNL_ID'] + 1).setValue(trnId);