SaaS 自動起票 — 23_bud_subscription

1. 基本情報

焦点質問: SaaSサブスクからどのようなINVを自動生成するか？

23_bud_subscription（SaaS契約マスタ）の各行に対し、契約形態（月額/年額）・決済ラグ・支払基準日を考慮して 対象年月までの未起票分を一括で INV 行に展開 する。1契約1ヶ月あたり1行のINVを生成し、HC RPAのような預り金・仕訳振替・益税の派生Rowは不要。

2. 前提条件・依存関係

3. 入力スキーマ

23_bud_subscription カラム定義

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

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

HCとの違い: SaaS INVは1契約1ヶ月あたり1行のみ。預り金・仕訳振替・益税などの派生Rowは不要。

旧仕様との差異（コード検証結果）:

• 旧S4.5「起票時期チェック（settleDate > targetDate → SKIP）」は現在のコードには存在しない。代わりに行別の rowTargetYm で利用月ベースのループ上限を制御している（S2.7）
• 旧W1.2「最終起票年月日・最終決済予定日の書き戻し」は現在のコードでは行われない（コメント「手入力のため書き戻しなし」）
• ORD（31_wrk_order）の自動作成が追加されている（S2.9, W1.1）
• 申請種別が決済手段に応じて自動判定される（S3.6）。旧仕様では固定値「請求書受領(AP)」

5. 出力サマリー

32_wrk_invoice（INV行）

31_wrk_order（ORD行）

6. 業務ルール

1. 行別の最終起票年月日で起票範囲を制御 — 各行の最終起票年月日（手入力）を「ここまで起票済」の上限として扱う。最終起票年月日は決済予定日ベースの値なので、利用月ベースに変換（ラグ分を差し引く）してループ上限とする
2. 取引先名が「選定中」「未定」なら空に — INVに不確定な名前を入れない
3. 年額の課金月 — 開始月と同じ月にだけ起票（コード上は月の一致で判定）
4. 決済ラグの全角対応 — 全角数字を半角に変換してパース
5. 解約済は除外 — 利用ステータスに「解約済」を含むSaaSは起票しない
6. 1契約1INV/月 — HCと異なり、預り金・益税等の派生Rowは生成しない
7. ORD自動作成 — 管理ID+開始年月をキーにORDを検索し、未存在なら自動作成する。契約金額は月額単価×契約月数（終了年月未設定なら12ヶ月）
8. 管理ID自動発番 — 管理IDが空の行には SAS_NNNN を自動採番し23タブに書き戻す
9. 申請種別の自動判定 — 決済手段に「振込」を含む→手動振込、「クレカ」「振替」を含む→自動引落、その他→請求書受領(AP)
10. 決済手段「未定」の除外 — 決済手段に「未定」を含む場合はINVの決済手段を空にする
11. 前払い(ラグ<0)の有効開始年月 — ラグが負の場合、開始年月にラグ月を加算した月を有効開始年月とする（支払月が開始月より前になるため）

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

再実行安全性: 同一条件で再実行しても、重複チェックにより既起票分はスキップされるため、二重起票は発生しない。

8. エラーハンドリング

9. テスト仕様

単体テスト観点

テストデータ（23タブ 3行）

ケース A: M365 Premium（月額・後払い・ラグ+1）target=2026-02

算出変数

startYm       = "2026-01"
curYm         = "2026-01"（最終起票=2026-02-10 → lastBilledYm="2026-02" → curYm="2026-03"の場合あり）
cycle         = "月額" → shouldBill = true
lag           = 1
payDay        = 10（後）

32タブ期待結果（INV 2行: 1月分・2月分）

前提: 最終起票年月日をクリアしてtarget=2026-02で実行

注: 2月分の決済日_計画=2026-03-10 > targetDate=2026-02-28 のため、2月分はスキップされる。実際にはINV 1行（1月分のみ）。

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

期待値サマリー

ケース B: オフィス家賃（月額・前払い・ラグ-1）target=2026-05

算出変数

startYm       = "2026-02"
cycle         = "月額" → shouldBill = true
lag           = -1     ← 前払い（翌月分を前月に支払い）
payDay        = 25（前）

32タブ期待結果

前提: 最終起票=2026-05-25 → lastBilledYm="2026-05" → curYm="2026-06"

注: 6月利用分を5月に前払い。発生日(6月末) > 決済日_計画(5月25日) → 期ズレパターン: 前払費用。

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

期待値サマリー

ケース C: 3行同時テスト（target=2026-02）

前提: 全行の最終起票年月日をクリア

期待される32タブ INV行数

合計: INV 4行

注: オフィス家賃はラグ=-1（前払い）のため、3月利用分の決済日_計画(02-25)もtarget(02-28)内に入り、2行起票される。

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

全消込後の期待値サマリー

付録

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

SaaS INVはHCと同じ汎用エンジン（403_subledger_engine.js）で処理される。

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

1. 32タブで請求ステータスを "承認済" に変更
2. Action A を実行
3. 結果:
   - 42_trn_journal: TRN 1行追加（費用計上仕訳）
     発生日 = INVの発生日
     決済日_計画 = INVの決済日_計画
     科目名 = INVの科目名
     金額 = INVの税込金額_計画
   - 32タブ: 自動仕訳JNL_ID ← TRN_ID
   - 33タブ: STL 1行自動作成（仕訳振替以外のINVのみ）
     税込金額_決済 = 税込金額_計画 ← 仕訳振替Rowなし → そのまま

ORDありの場合のSTL金額: SaaS INVはORDに紐づくが、jeFxAmtMapによる仕訳振替分の差引きは発生しない（SaaS INVに仕訳振替Rowがないため）。STL税込金額_決済 = INV税込金額_計画となる。

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

1. 33タブでSTLに決済日・決済ステータス="消込済" を入力
2. Action B を実行
3. 結果:
   - 42_trn_journal: TRN追加（決済仕訳）
     決済日_実績 = STLの決済日
   - 33タブ: 自動仕訳JNL_ID ← TRN_ID
   - 32タブ: INVの未決済残高=0、請求ステータス=決済完了

付録B: 決済ラグによる期ズレパターン

期ズレは 602_datamart_main.js の processEvent() が自動処理する（B/S形状ロジック）。