Add unterhaltsvors implementation 2009 to 2016

.pre-commit-config.yaml

@@ -6,7 +6,7 @@ repos:
       - id: check-useless-excludes
       # - id: identity  # Prints all files passed to pre-commits. Debugging.
   - repo: https://github.com/lyz-code/yamlfix
-    rev: 1.16.0
+    rev: 1.17.0
     hooks:
       - id: yamlfix
   - repo: https://github.com/pre-commit/pre-commit-hooks
@@ -57,7 +57,7 @@ repos:
       - id: blacken-docs
       # exclude: docs/source/how_to_guides/optimization/how_to_specify_constraints.md
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.6.1
+    rev: v0.6.3
     hooks:
       - id: ruff
       #   args:
@@ -103,7 +103,7 @@ repos:
           - '88'
         files: (docs/.|CHANGES.md|CODE_OF_CONDUCT.md)
   - repo: https://github.com/pre-commit/mirrors-mypy
-    rev: v1.11.1
+    rev: v1.11.2
     hooks:
       - id: mypy
         args:

CHANGES.md

@@ -6,6 +6,7 @@ releases are available on [Anaconda.org](https://anaconda.org/conda-forge/gettsi
 
 ## Unpublished
 
+- {gh}`790` Add unterhaltsvors implementation 2009 to 2016 ({ghuser}`mjbloemer`).
 - {gh}`788` Pension benefit earnings test for early retirees ({ghuser}`MImmesberger`).
 - {gh}`786` Check directly whether child and parent are in same Bedarfsgemeinschaft for
   Kindergeldübertrag ({ghuser}`MImmesberger`).

src/_gettsim/interface.py

@@ -149,19 +149,6 @@ def compute_taxes_and_transfers(  # noqa: PLR0913
         enforce_signature=True,
     )
 
-    if "unterhalt" in params:
-        if (
-            "mindestunterhalt" not in params["unterhalt"]
-            and "unterhaltsvors_m" in processed_functions
-        ):
-            raise NotImplementedError(
-                """
-Unterhaltsvorschuss is not implemented yet prior to 2016, see
-https://github.com/iza-institute-of-labor-economics/gettsim/issues/479.
-
-        """
-            )
-
     results = tax_transfer_function(**input_data)
 
     # Prepare results.

src/_gettsim/parameters/unterhalt.yaml

@@ -6,56 +6,97 @@ mindestunterhalt:
   description:
     de: >-
       § 1612a BGB, § 1 Mindesunterhaltsverordnung. Mindestunterhalt für Kinder in
-      Abhängigkeit des Alters (unter 6, unter 12, bis 17 Jahre)
+      Abhängigkeit des Alters (0 - 5 Jahre, 6 - 11 Jahre, 12 - 17 Jahre).
     en: >-
-      Minimum Child Alimony depending on age of child (below 6, below 12, up to 17
-      years).
+      Minimum Child Alimony depending on age of child (0 - 5 years, 6 - 11 years, 12 -
+      17 years).
   unit: Euro
   reference_period: Month
   2016-01-01:
-    6: 335
-    12: 384
-    18: 450
+    1:
+      min_alter: 0
+      max_alter: 5
+      betrag: 335
+    2:
+      min_alter: 6
+      max_alter: 11
+      betrag: 384
+    3:
+      min_alter: 12
+      max_alter: 17
+      betrag: 450
     reference: V. v. 03.12.2015 BGBl. I S. 2188.
   2017-01-01:
-    6: 342
-    12: 393
-    18: 460
+    deviation_from: previous
+    1:
+      betrag: 342
+    2:
+      betrag: 393
+    3:
+      betrag: 460
     reference: V. v. 03.12.2015 BGBl. I S. 2188.
   2018-01-01:
-    6: 348
-    12: 399
-    18: 467
+    deviation_from: previous
+    1:
+      betrag: 348
+    2:
+      betrag: 399
+    3:
+      betrag: 467
     reference: Artikel 1 V. v. 28.09.2017 BGBl. I S. 3525.
   2019-01-01:
-    6: 354
-    12: 406
-    18: 476
+    deviation_from: previous
+    1:
+      betrag: 354
+    2:
+      betrag: 406
+    3:
+      betrag: 476
     reference: Artikel 1 V. v. 28.09.2017 BGBl. I S. 3525.
   2020-01-01:
-    6: 369
-    12: 424
-    18: 497
+    deviation_from: previous
+    1:
+      betrag: 369
+    2:
+      betrag: 424
+    3:
+      betrag: 497
     reference: Artikel 1 V. v. 12.09.2019 BGBl. I S. 1393.
   2021-01-01:
-    6: 393
-    12: 451
-    18: 528
+    deviation_from: previous
+    1:
+      betrag: 393
+    2:
+      betrag: 451
+    3:
+      betrag: 528
     reference: Artikel 1 V. v. 03.11.2020 BGBl. I S. 2344.
   2022-01-01:
-    6: 396
-    12: 455
-    18: 533
+    deviation_from: previous
+    1:
+      betrag: 396
+    2:
+      betrag: 455
+    3:
+      betrag: 533
     reference: Artikel 1 V. v. 30.11.2021 BGBl. I S. 5066.
   2023-01-01:
-    6: 437
-    12: 502
-    18: 588
+    deviation_from: previous
+    1:
+      betrag: 437
+    2:
+      betrag: 502
+    3:
+      betrag: 588
     reference: Artikel 1 V. v. 30.11.2022 BGBl. I S. 2130.
   2024-01-01:
-    6: 480
-    12: 551
-    18: 645
+    deviation_from: previous
+    1:
+      betrag: 480
+    2:
+      betrag: 551
+    3:
+      betrag: 645
     reference: Artikel 1 V. v. 29.11.2023 BGBl. I Nr. 330.
 abzugsrate_kindergeld:
   name:

src/_gettsim/parameters/unterhaltsvors.yaml

@@ -15,40 +15,92 @@ mindesteinkommen:
   2017-01-01:
     scalar: 600
     reference: Art. 23 G. v. 14.08.2017 BGBl. I S. 3122.
-altersgrenze_mindesteinkommen:
+altersgrenzen_bezug:
   name:
-    de: >-
-      Altersgrenze, ab der UHV nur mit einem Mindesteinkommen in Höhe von
-      `mindesteinkommen` bezogen werden kann.
-    en: >-
-      Age threshold from which on Unterhaltsvorschuss is only paied if earnings are
-      above `mindesteinkommen`.
-  description:
-    de: § 1 (1a) Nr. 2 Unterhaltsvorschussgesetz
-    en: null
-  unit: Years
-  2017-01-01:
-    scalar: 12
-    reference: Art. 23 G. v. 14.08.2017 BGBl. I S. 3122.
-altersgrenzen:
-  name:
-    de: Altersgrenzen für den Bezug von Unterhaltsvorschuss
-    en: age limits for receiving alimony payments
+    de: Altersgrenzen für den Bezug von Unterhaltsvorschuss bis Juni 2017.
+    en: Age limits for receiving alimony payments until June 2017.
   description:
     de: >-
       Kinder, die das 12. Lebensjahr noch nicht vollendet haben und bei einem
-      alleinerziehenden Elternteil leben haben Anspruch auf Unterhaltszahlungen. Zudem
-      können auch Kinder bis zur Vollendung des 18. Lebensjahres Unterhaltsvorschuss
-      bekommen, wenn das Elternteil ein Mindesteinkommen hat.
+      alleinerziehenden Elternteil leben haben Anspruch auf Unterhaltszahlungen. Seit
+      Juli 2017 gelten die Altersgrenzen des Mindestunterhalts.
     en: >-
       Children under the age of 12 living with a single parent are entitled to alimony
-      payments. In addition, children up to the age of 18 receive advance on alimony
-      payments if the parent has income beyond a minimal threshold.
+      payments. Since July 2017, the age limits of the minimum alimony apply.
   reference: § 1 Abs. 1, 1a UhVorschG
-  2017-01-01:
-    1: 6
-    2: 12
-    3: 18
+  2008-01-01:
+    1:
+      min_alter: 0
+      max_alter: 5
+    2:
+      min_alter: 6
+      max_alter: 11
+    reference: G. v. 21.12.2007 BGBl. I S. 3194
+faktor_jüngste_altersgruppe:
+  name:
+    de: >-
+      Faktor mit dem das sächliche Existenzminimum multipliziert wird um den
+      Unterhaltsvorschuss für Kinder der jüngsten Altersgruppe zu berechnen.
+    en: >-
+      Factor by which the sächliche Existenzminimum is multiplied to calculate
+      the advance child alimony for children of the youngest age group.
+  2009-01-01:
+    scalar: 0.87
+    reference: § 1612a Abs. 1 BGB
+unterhaltsvors_anwendungsvors:
+  name:
+    de: Unterhaltsvorschuss für Kinder entsprechend Anwendungsvorschriften
+    en: Advance Child Alimony according to application regulations
+  description:
+    de: >-
+      Der Unterhaltsvorschuss wird 2009 bis 2015 prinzipiell berechnet basierend auf den
+      Parametern Kinderfreibetrag für das sächliche Existenzminimum und dem Kindergeld
+      für das erste Kind. Wird das Kindergeld unterjährig geändert oder der
+      Kinderfreibetrag unterjährig rückwirkend geändert, gelten abweichende
+      Anwendungsvorschriften, die von unveränderten Werten für Kindergeld bzw.
+      Kinderfreibetrag ausgehen können. Hier werden die entsprechenden Werte für den
+      Unterhaltsvorschuss (d.h. nach Abzug des unterstellten Kindergeldes) verwendet.
+    en: >-
+      The advance child alimony is calculated in principle from 2009 to 2015 based on
+      the parameters parameters 'child allowance for the material minimum subsistence
+      level' (Kinderfreibetrag für das sächliche Existenzminimum) and Kindergeld for the
+      first child. If the Kindergeld is changed during the year or the or the child
+      allowance is changed retroactively during the year, deviating application rules
+      apply, which can be based on unchanged values for Kindergeld or child child
+      allowance can be assumed. Here, the corresponding values for the advance child
+      alimony (i.e. after deduction of the assumed Kindergeld) are used.
+  unit: Euro
+  reference_period: Month
+  2015-01-01:
+    1: 133
+    2: 180
+    reference: null
+    note: >-
+      Durch Anpassung des Kinderfreibetrags in der Mitte des Jahres gilt eine vorläufige
+      Anwendungsvorschrift, welche den Mindestunterhalt basierend auf dem alten
+      Kinderfreibetrag berechnet. § 11a Anwendungsvorschrift: "Im Sinne dieses Gesetzes
+      beträgt für die Zeit vom 1. Januar 2015 bis zum 30. Juni 2015 die
+      Unterhaltsleistung nach § 2 Absatz 1 Satz 1 monatlich 317 Euro für ein Kind, das
+      das sechste Lebensjahr noch nicht vollendet hat, und monatlich 364 Euro für ein
+      Kind, das das zwölfte Lebensjahr noch nicht vollendet hat." Der
+      Unterhaltsvorschuss berechnet sich aus diesem Mindestunterhalt abzüglich des
+      Kindergeldes für das erste Kind vor Anpassung des Kinderfreibetrags (hier: 184
+      Euro).
+  2015-07-01:
+    1: 144
+    2: 192
+    reference: Artikel 9 Gesetz v. 16.07.2015 BGBl. I S. 1202.
+    note: >-
+      § 11a Anwendungsvorschrift: "Für die Zeit vom 1. Juli 2015 bis zum 31. Dezember
+      2015 beträgt die Unterhaltsleistung nach § 2 Absatz 1 Satz 1 monatlich 328 Euro
+      für ein Kind, das das sechste Lebensjahr noch nicht vollendet hat, und monatlich
+      376 Euro für ein Kind, das das zwölfte Lebensjahr noch nicht vollendet hat. 3Bis
+      zum 31. Dezember 2015 gilt als für ein erstes Kind zu zahlendes Kindergeld im
+      Sinne von § 2 Absatz 2 Satz 1 ein Betrag in Höhe von monatlich 184 Euro." Der
+      Unterhaltsvorschuss berechnet sich aus diesem Mindestunterhalt abzüglich des
+      Kindergeldes für das erste Kind vor Anpassung des Kinderfreibetrags (hier: 184
+      Euro). Ab 2016 orientiert sich der Unterhaltsvorschuss wieder an den regulären
+      Mindestunterhaltsbeträgen.
 rounding:
   unterhaltsvors_m:
     note: