# 納付月セマンティクス

月次計算における「年/月」ラベルが何を指しているかは、運用上きわめて重要です。

## 2 つの解釈

```{list-table}
:header-rows: 1

* - セマンティクス
  - 意味
  - 例(2026 年 4 月行)
* - **発生月(分)**
  - 当月分の保険料
  - 2026 年 4 月分(5 月末納付)
* - **納付月**
  - 当月に納付する保険料
  - 2026 年 4 月納付分(= 2026 年 3 月分の保険料)
```

## 本プロジェクトは「納付月」運用

行ラベル「年/月」は **納付月** を意味します。例えば 2026/4 行は「2026 年 4 月に納付する分 = 2026 年 3 月分の保険料」を指します。年金事務所の通知書が納付タイミング基準で届くことに合わせています。

### 通知額との照合

例として、標準報酬月額 88,000 円・介護該当の場合の 2026 年 4 月の通知額は **26,513 円**。これは:

```{math}
\begin{aligned}
健保(11.47\%, 介護込み) &= 10{,}093 \\
厚年(18.30\%) &= 16{,}104 \\
拠出金(0.36\%) &= 316 \\
\hline
合計 &= 26{,}513 \;\checkmark
\end{aligned}
```

支援金(202 円)は含まれていません。これは、**支援金が「令和 8 年 4 月分(5 月納付分)から」開始** だからです。納付月セマンティクスでは、2026/4 行は 3 月分なので **まだ支援金は発生しません**。

## 料率マスタへの反映

このセマンティクスを正しく扱うため、料率マスタの 2026 年付近は次のように分割しています:

```{list-table}
:header-rows: 1

* - 適用開始日
  - 健保
  - 支援金
  - 月次計算で適用される行
* - 2025-04-01
  - 0.0991 + 0.0159
  - 0
  - 2025/4 〜 2026/3
* - **2026-04-01**
  - 0.0985 + 0.0162
  - **0**
  - 2026/4 のみ(健保改定だけ反映、支援金まだなし)
* - **2026-05-01**
  - 0.0985 + 0.0162(変わらず)
  - **0.0023**
  - 2026/5 以降(支援金開始)
```

これにより:

```{list-table}
:header-rows: 1

* - 対象月
  - 内容(納付月解釈)
  - 納付額
* - 2026/3
  - 2026 年 2 月分 = 旧料率
  - 26,540
* - **2026/4**
  - 2026 年 3 月分 = 健保改定済・支援金まだ
  - **26,513** ← 通知額と完全一致
* - **2026/5**
  - 2026 年 4 月分 = 健保改定済・支援金開始
  - **26,715** ← +202 円(支援金分)
* - 2026/6 以降
  - 同上
  - 26,715
```

## 運用上の備忘記載

混乱を避けるため、運用先(Excel ブック・Web アプリのいずれも)では **「行ラベル(年/月)の意味 = 納付月」** を備忘として明記しておきます。改定や引き継ぎの際は、ここを最初に確認してください。

## 発生月運用に切り替えたい場合

実務的にどうしても発生月で記録したい場合は次のいずれか:

1. **料率マスタの適用開始日を 1 ヶ月手前にずらす**(例: 2026/5/1 → 2026/4/1)。
2. 既存データを丸ごと 1 ヶ月シフトしてから記録(過去データの整合性が崩れるため非推奨)。

ただし、年金事務所の通知書は実際の「納付月」基準で届くため、本プロジェクトでも納付月セマンティクスのままにしておくのが運用上はシンプルです。