ORD 自動紐づけ — 31_wrk_order

1. 概要

焦点質問: INVと発注(ORD)はどのように自動紐づけされるか？

RPA起票時に 31_wrk_order (ORD) を自動作成し、32_wrk_invoice (INV) の 親発注ID(ORD) に紐づける。 Action A 実行時に ORD の発注残高が自動減算され、契約消化率を追跡できるようにする。

1.1 背景・課題

INV（請求）が単体で存在する状態では、契約単位の消化状況を把握できない。ORDを自動作成しINVと紐づけることで、発注残高の追跡と予実管理を実現する。

1.2 対象ソース（段階的に実装）

2. 設計判断

3. 変更内容

3.1 スキーマ変更

3.1.1 31_wrk_order のリニューアル（15列→19列）

旧ヘッダー（15列）

["有効フラグ","発注ID(ORD)","起票日時","起票者","発注ステータス",
 "取引先名","PJ名","契約・件名","契約形態",
 "税抜金額_発注","消費税額_発注","税込金額_発注","発注残高(自動計算)",
 "摘要","証憑URL"]

新ヘッダー（19列）

["有効フラグ","発注ID(ORD)","起票日時","起票者",
 "取引先名","契約・件名","摘要","契約形態",
 "開始年月","終了年月",
 "税抜金額_発注","消費税額_発注","税込金額_発注","発注残高(自動計算)",
 "PJ名","発注ステータス","参照元区分","参照元ID",
 "証憑URL"]

列マップ

参照元区分の値

ソース別の開始年月・終了年月

3.1.2 ソースタブの管理ID列名を統一

全予算タブのID列名を 「管理ID」 に統一する。プレフィクス (EMP_/SUB_/CPX_/PIP_/ADH_) で種別が判別できるため、列名を分ける必要がない。

3.2 ロジック変更

3.2.1 Phase 1: HC → ORD自動紐づけ

ORD 1件の定義

契約月数の算出: 開始年月〜終了年月の月数（終了月を含む）。 例: 2025-11 〜 2026-03 → (2026-2025)×12 + (3-11) + 1 = 5ヶ月 終了年月が未設定の場合は {適用年度+1}-03 をフォールバック適用後に計算。

ORD検索・作成ロジック（マトリクス）

ヘルパー関数

3.2.2 冪等性（二重起票防止）

3.2.3 101_sys_config.js の変更

WRK_ORDR headers 更新

'WRK_ORDR': { headers: ["有効フラグ","発注ID(ORD)","起票日時","起票者",
  "取引先名","契約・件名","摘要","契約形態",
  "開始年月","終了年月",
  "税抜金額_発注","消費税額_発注","税込金額_発注","発注残高(自動計算)",
  "PJ名","発注ステータス","参照元区分","参照元ID",
  "証憑URL"], color: "#b45f06" },

WRK_ORDR フォーマット処理の更新

if (key === 'WRK_ORDR') {
  // C(3):起票日時 I(9):開始年月 J(10):終了年月
  // K(11):税抜金額_発注 L(12):消費税額_発注 M(13):税込金額_発注 N(14):発注残高
  sheet.getRange("C2:C").setNumberFormat('yyyy-mm-dd hh:mm');
  sheet.getRange("I2:J").setNumberFormat('yyyy-mm');
  sheet.getRange("K2:N").setNumberFormat('#,##0');
  if (maxR > 1) sheet.getRange(2, 1, maxR - 1, 1).insertCheckboxes();
}

setVali の列番号更新

setVali('WRK_ORDR', 5, 'E', '31_wrk_order');   // 取引先名 (E列)
setVali('WRK_ORDR', 15, 'H', '31_wrk_order');  // PJ名 (O列)
setVali('WRK_ORDR', 16, 'S', '31_wrk_order');  // 発注ステータス (P列)

BUD_SUBS, BUD_PIPE の headers 更新

// 23_bud_subscription: "契約ID" → "管理ID"
// 21_bud_pipeline: "案件ID" → "管理ID"

3.2.4 403_subledger_engine.js の変更

Action A の ORD残高減算をヘッダー名ベース (indexOf) に変更:

// 旧 (列番号ハードコード)
const currentBal = Number(ordData[i][12]);
const totalIncTax = Number(ordData[i][11]) || 0;
ordSheet.getRange(ordMap[ordId].rowIndex, 13).setValue(newBal);

// 新 (ヘッダー名ベース)
const ordH = ordData[0];
const iOrdId = ordH.indexOf('発注ID(ORD)');
const iOrdTotalIncTax = ordH.indexOf('税込金額_発注');
const iOrdBalance = ordH.indexOf('発注残高(自動計算)');
// ... indexOf で取得した値を使用

4. 影響範囲

§3.2.1 詳細関数: generateOrdId_ / buildOrdRow_ / writeOrdRows_ / buildOrdMap_

5. テスト仕様

付録A: 将来拡張（Phase 2以降）