@fin.cx/tax 2.0.0 → 2.1.0

package/dist_ts/00_commitinfo_data.js

@@ -3,7 +3,7 @@
  */
 export const commitinfo = {
     name: '@fin.cx/tax',
-    version: '2.0.0',
+    version: '2.1.0',
     description: 'German tax computation engine: UStVA Kennzahl aggregation from ledger balances with form rounding, Zahllast and reconciliation checks — exact cents'
 };
 //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiMDBfY29tbWl0aW5mb19kYXRhLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vdHMvMDBfY29tbWl0aW5mb19kYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOztHQUVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sVUFBVSxHQUFHO0lBQ3hCLElBQUksRUFBRSxhQUFhO0lBQ25CLE9BQU8sRUFBRSxPQUFPO0lBQ2hCLFdBQVcsRUFBRSxxSkFBcUo7Q0FDbkssQ0FBQSJ9

package/dist_ts/index.d.ts

@@ -1,3 +1,5 @@
 export * from './ustva.types.js';
 export * from './ustva.accounts.js';
 export * from './ustva.js';
+export * from './zm.js';
+export * from './rates.js';

package/dist_ts/index.js

@@ -1,4 +1,6 @@
 export * from './ustva.types.js';
 export * from './ustva.accounts.js';
 export * from './ustva.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxZQUFZLENBQUMifQ==
+export * from './zm.js';
+export * from './rates.js';
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9pbmRleC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxjQUFjLGtCQUFrQixDQUFDO0FBQ2pDLGNBQWMscUJBQXFCLENBQUM7QUFDcEMsY0FBYyxZQUFZLENBQUM7QUFDM0IsY0FBYyxTQUFTLENBQUM7QUFDeEIsY0FBYyxZQUFZLENBQUMifQ==

package/dist_ts/rates.d.ts

@@ -0,0 +1,112 @@
+/**
+ * The rates of German VAT, dated: which rates German law sets for a supply
+ * carried out on a day, and the transition rules the administration granted
+ * around the rate changes of 2020 and 2021. The rate in force when the supply
+ * is carried out applies (§ 27 Abs. 1 Satz 1 UStG).
+ */
+/** A rate German law sets for a supply, and the days it applies to: from `from`, until `to` inclusive when it ended. */
+export interface IGermanVatRate {
+    ratePercent: number;
+    /** `YYYY-MM-DD` */
+    from: string;
+    /** `YYYY-MM-DD`, inclusive; absent while the rate is in force */
+    to?: string;
+    /** the rate this is: the general rate, the reduced rate, the 0 % of § 12 Abs. 3 UStG, or an average rate of § 24 Abs. 1 Satz 1 UStG by its number */
+    provision: 'general' | 'reduced' | 'zero' | 'average_nr1' | 'average_nr2' | 'average_nr3';
+    /** the provision that sets the rate for these days, and the act that set it */
+    basis: string;
+}
+/**
+ * The rates of German VAT, dated. The table begins on 2007-01-01.
+ * - The general rate, 19 % (§ 12 Abs. 1 UStG, since Art. 4 Nr. 1
+ *   Haushaltsbegleitgesetz 2006, BGBl. I S. 1402, from 2007-01-01), and the
+ *   reduced rate, 7 % (§ 12 Abs. 2 UStG). From 2020-07-01 to 2020-12-31, 16 %
+ *   and 5 % in their place (§ 28 Abs. 1, 2 UStG, Art. 3 Zweites
+ *   Corona-Steuerhilfegesetz, BGBl. I 2020 S. 1512).
+ * - § 24 Abs. 1 Satz 1 Nr. 2 UStG (Sägewerkserzeugnisse, Getränke and
+ *   alkoholische Flüssigkeiten of a farmer or forester taxed by average
+ *   rates): 19 %, the rate it states as read on gesetze-im-internet.de on
+ *   2026-09-27; 16 % from 2020-07-01 to 2020-12-31 (§ 24 Abs. 1 Satz 1 Nr. 2
+ *   i. V. m. § 28 Abs. 3 UStG, Art. 3 Zweites Corona-Steuerhilfegesetz, BGBl. I
+ *   2020 S. 1512, as the BMF letter of 30 June 2020, Rz. 1, cites it; the act's
+ *   own text was not read). That 19 % applied from 2007-01-01 is not verified
+ *   from the amending act: the table starts it there with the general rate.
+ * - The average rates of § 24 Abs. 1 Satz 1 UStG, at which a farmer or
+ *   forester taxed by them charges VAT on the invoice; the recipient deducts
+ *   it as input tax (§ 15 Abs. 1 Satz 1 Nr. 1 UStG). Each from the amending
+ *   act's text:
+ *   - Nr. 1, forestry products: 5,5 % from 2007-01-01 (Art. 4 Nr. 2
+ *     Buchst. a Doppelbuchst. aa Haushaltsbegleitgesetz 2006, "5 Prozent"
+ *     replaced by "5,5 Prozent"); unchanged since.
+ *   - Nr. 3, the other supplies: 10,7 % from 2007-01-01 (the same, Doppelbuchst.
+ *     cc, "9 Prozent" by "10,7 Prozent"); 9,5 % from 2022-01-01 (Art. 1 Nr. 5
+ *     Gesetz zur Umsetzung unionsrechtlicher Vorgaben im Umsatzsteuerrecht of
+ *     21.12.2021, BGBl. I S. 5250); 9,0 % from 2023-01-01 (Art. 12 Nr. 3 Achtes
+ *     Gesetz zur Änderung von Verbrauchsteuergesetzen of 24.10.2022, BGBl. I
+ *     S. 1838); 8,4 % from 2024-12-06 (Art. 24 Nr. 13 Jahressteuergesetz 2024
+ *     of 02.12.2024, BGBl. 2024 I Nr. 387, in force the day after its
+ *     promulgation on 2024-12-05, Art. 56 Abs. 1); 7,8 % from 2025-01-01
+ *     (Art. 25 Nr. 21 of the same, Art. 56 Abs. 7), the rate § 24 Abs. 1 Satz 1
+ *     Nr. 3 UStG states as read on gesetze-im-internet.de on 2026-09-25.
+ * - 0 % for the supplies of § 12 Abs. 3 UStG (photovoltaic installations:
+ *   the modules and components delivered to their operator, their
+ *   intra-Community acquisition, import and installation) from 2023-01-01
+ *   (Art. 16 Nr. 5 Jahressteuergesetz 2022 of 16.12.2022, BGBl. I S. 2294,
+ *   in force on 2023-01-01 by its Art. 43; the amending text as read on
+ *   buzer.de on 2026-09-28, § 12 Abs. 3 as read on gesetze-im-internet.de).
+ */
+export declare const GERMAN_VAT_RATES: readonly IGermanVatRate[];
+/**
+ * The rates of German VAT for a supply carried out on a day (`YYYY-MM-DD`),
+ * each once, in the order of `GERMAN_VAT_RATES`. `undefined` for a day before
+ * the table begins (2007-01-01): the table holds no law for it.
+ */
+export declare function germanVatRatesOn(dayArg: string): readonly number[] | undefined;
+/**
+ * A rate the administration names for some supplies of some days around a
+ * change of the rates, with its source and the supplies it covers. Whether a
+ * supply is one of them is a fact the caller states; this table cannot tell.
+ */
+export interface IGermanVatRateConcession {
+    ratePercent: number;
+    /**
+     * `required`: the letter says the rate is to be applied ("sind … anzuwenden");
+     * `accepted`: the letter allows it or does not object to it ("wird
+     * zugelassen", "wird nicht beanstandet"), and the law's rate of the day may be
+     * applied as well.
+     */
+    standing: 'required' | 'accepted';
+    /** `YYYY-MM-DD` */
+    from: string;
+    /** `YYYY-MM-DD`, inclusive */
+    to: string;
+    /** the BMF letter, its GZ and its Rz. */
+    source: string;
+    /** the supplies it covers, and what it allows */
+    covers: string;
+}
+/**
+ * The transition rules of the administration around the rate changes of
+ * 1 July 2020 and 1 January 2021, each read in the letter itself (the copies of
+ * 8 July 2020 and 5 November 2020 in the Internet Archive of the PDFs on
+ * bundesfinanzministerium.de, read 2026-09-27):
+ * - Rz. 44 of the letter of 30 June 2020 allows the new rates on
+ *   Bewirtungsleistungen in the night of 30 June to 1 July 2020 (accepted), and
+ *   Rz. 22 of the letter of 4 November 2020 requires them on Beherbergungen of
+ *   that night (required), which Rz. 44 had left out.
+ * - Rz. 46 of the letter of 30 June 2020 accepts the old rates, 19 and
+ *   7 percent, on supplies to entrepreneurs in July 2020, with the input tax
+ *   deduction of the stated tax.
+ * - Rz. 22 of the letter of 4 November 2020 allows 16 and 5 percent on
+ *   Bewirtungsleistungen and Beherbergungen in the night of 31 December 2020
+ *   to 1 January 2021.
+ * Not here: Rz. 47 of the letter of 30 June 2020 applies its rules "entsprechend"
+ * to the rise on 1 January 2021; the letters grant no deduction of 16 or
+ * 5 percent stated on a supply of January 2021 beyond the night above, except
+ * for advance payment invoices issued before 2021 (4 November 2020, Rz. 1 and
+ * 2), whose case needs the invoice's date. No letter on the § 24 changes of
+ * 2022, 2023, 2024-12-06 and 2025 was found.
+ */
+export declare const GERMAN_VAT_RATE_CONCESSIONS: readonly IGermanVatRateConcession[];
+/** The transition rules that cover a day of supply (`YYYY-MM-DD`), in the order of `GERMAN_VAT_RATE_CONCESSIONS`. */
+export declare function germanVatRateConcessionsOn(dayArg: string): readonly IGermanVatRateConcession[];

package/dist_ts/rates.js

@@ -0,0 +1,136 @@
+/**
+ * The rates of German VAT, dated: which rates German law sets for a supply
+ * carried out on a day, and the transition rules the administration granted
+ * around the rate changes of 2020 and 2021. The rate in force when the supply
+ * is carried out applies (§ 27 Abs. 1 Satz 1 UStG).
+ */
+const GENERAL = '§ 12 Abs. 1 UStG (Art. 4 Nr. 1 Haushaltsbegleitgesetz 2006, BGBl. I S. 1402)';
+const REDUCED = '§ 12 Abs. 2 UStG';
+const TEMPORARY = '§ 28 Abs. 1, 2 UStG (Art. 3 Zweites Corona-Steuerhilfegesetz, BGBl. I 2020 S. 1512)';
+const SPECIAL_AVERAGE = '§ 24 Abs. 1 Satz 1 Nr. 2 UStG';
+const FORESTRY = '§ 24 Abs. 1 Satz 1 Nr. 1 UStG (Art. 4 Nr. 2 Buchst. a Doppelbuchst. aa Haushaltsbegleitgesetz 2006)';
+const AVERAGE_OTHER = '§ 24 Abs. 1 Satz 1 Nr. 3 UStG';
+const ZERO = '§ 12 Abs. 3 UStG (Art. 16 Nr. 5 Jahressteuergesetz 2022 vom 16.12.2022, BGBl. I S. 2294, in force 2023-01-01 by its Art. 43)';
+/**
+ * The rates of German VAT, dated. The table begins on 2007-01-01.
+ * - The general rate, 19 % (§ 12 Abs. 1 UStG, since Art. 4 Nr. 1
+ *   Haushaltsbegleitgesetz 2006, BGBl. I S. 1402, from 2007-01-01), and the
+ *   reduced rate, 7 % (§ 12 Abs. 2 UStG). From 2020-07-01 to 2020-12-31, 16 %
+ *   and 5 % in their place (§ 28 Abs. 1, 2 UStG, Art. 3 Zweites
+ *   Corona-Steuerhilfegesetz, BGBl. I 2020 S. 1512).
+ * - § 24 Abs. 1 Satz 1 Nr. 2 UStG (Sägewerkserzeugnisse, Getränke and
+ *   alkoholische Flüssigkeiten of a farmer or forester taxed by average
+ *   rates): 19 %, the rate it states as read on gesetze-im-internet.de on
+ *   2026-09-27; 16 % from 2020-07-01 to 2020-12-31 (§ 24 Abs. 1 Satz 1 Nr. 2
+ *   i. V. m. § 28 Abs. 3 UStG, Art. 3 Zweites Corona-Steuerhilfegesetz, BGBl. I
+ *   2020 S. 1512, as the BMF letter of 30 June 2020, Rz. 1, cites it; the act's
+ *   own text was not read). That 19 % applied from 2007-01-01 is not verified
+ *   from the amending act: the table starts it there with the general rate.
+ * - The average rates of § 24 Abs. 1 Satz 1 UStG, at which a farmer or
+ *   forester taxed by them charges VAT on the invoice; the recipient deducts
+ *   it as input tax (§ 15 Abs. 1 Satz 1 Nr. 1 UStG). Each from the amending
+ *   act's text:
+ *   - Nr. 1, forestry products: 5,5 % from 2007-01-01 (Art. 4 Nr. 2
+ *     Buchst. a Doppelbuchst. aa Haushaltsbegleitgesetz 2006, "5 Prozent"
+ *     replaced by "5,5 Prozent"); unchanged since.
+ *   - Nr. 3, the other supplies: 10,7 % from 2007-01-01 (the same, Doppelbuchst.
+ *     cc, "9 Prozent" by "10,7 Prozent"); 9,5 % from 2022-01-01 (Art. 1 Nr. 5
+ *     Gesetz zur Umsetzung unionsrechtlicher Vorgaben im Umsatzsteuerrecht of
+ *     21.12.2021, BGBl. I S. 5250); 9,0 % from 2023-01-01 (Art. 12 Nr. 3 Achtes
+ *     Gesetz zur Änderung von Verbrauchsteuergesetzen of 24.10.2022, BGBl. I
+ *     S. 1838); 8,4 % from 2024-12-06 (Art. 24 Nr. 13 Jahressteuergesetz 2024
+ *     of 02.12.2024, BGBl. 2024 I Nr. 387, in force the day after its
+ *     promulgation on 2024-12-05, Art. 56 Abs. 1); 7,8 % from 2025-01-01
+ *     (Art. 25 Nr. 21 of the same, Art. 56 Abs. 7), the rate § 24 Abs. 1 Satz 1
+ *     Nr. 3 UStG states as read on gesetze-im-internet.de on 2026-09-25.
+ * - 0 % for the supplies of § 12 Abs. 3 UStG (photovoltaic installations:
+ *   the modules and components delivered to their operator, their
+ *   intra-Community acquisition, import and installation) from 2023-01-01
+ *   (Art. 16 Nr. 5 Jahressteuergesetz 2022 of 16.12.2022, BGBl. I S. 2294,
+ *   in force on 2023-01-01 by its Art. 43; the amending text as read on
+ *   buzer.de on 2026-09-28, § 12 Abs. 3 as read on gesetze-im-internet.de).
+ */
+export const GERMAN_VAT_RATES = [
+    { ratePercent: 19, from: '2007-01-01', to: '2020-06-30', provision: 'general', basis: GENERAL },
+    { ratePercent: 19, from: '2021-01-01', provision: 'general', basis: GENERAL },
+    { ratePercent: 7, from: '2007-01-01', to: '2020-06-30', provision: 'reduced', basis: REDUCED },
+    { ratePercent: 7, from: '2021-01-01', provision: 'reduced', basis: REDUCED },
+    { ratePercent: 0, from: '2023-01-01', provision: 'zero', basis: ZERO },
+    { ratePercent: 16, from: '2020-07-01', to: '2020-12-31', provision: 'general', basis: `${TEMPORARY}, in place of the rate of § 12 Abs. 1 UStG` },
+    { ratePercent: 5, from: '2020-07-01', to: '2020-12-31', provision: 'reduced', basis: `${TEMPORARY}, in place of the rate of § 12 Abs. 2 UStG` },
+    { ratePercent: 19, from: '2007-01-01', to: '2020-06-30', provision: 'average_nr2', basis: `${SPECIAL_AVERAGE} (the act that set 19 % from 2007-01-01 not verified)` },
+    { ratePercent: 19, from: '2021-01-01', provision: 'average_nr2', basis: `${SPECIAL_AVERAGE} (19 % as read on gesetze-im-internet.de, 2026-09-27)` },
+    { ratePercent: 16, from: '2020-07-01', to: '2020-12-31', provision: 'average_nr2', basis: `${SPECIAL_AVERAGE} i. V. m. § 28 Abs. 3 UStG (Art. 3 Zweites Corona-Steuerhilfegesetz, BGBl. I 2020 S. 1512, as cited by BMF 30.06.2020 Rz. 1)` },
+    { ratePercent: 5.5, from: '2007-01-01', provision: 'average_nr1', basis: FORESTRY },
+    { ratePercent: 10.7, from: '2007-01-01', to: '2021-12-31', provision: 'average_nr3', basis: `${AVERAGE_OTHER} (Art. 4 Nr. 2 Buchst. a Doppelbuchst. cc Haushaltsbegleitgesetz 2006)` },
+    { ratePercent: 9.5, from: '2022-01-01', to: '2022-12-31', provision: 'average_nr3', basis: `${AVERAGE_OTHER} (Art. 1 Nr. 5 Gesetz zur Umsetzung unionsrechtlicher Vorgaben im Umsatzsteuerrecht, BGBl. I 2021 S. 5250)` },
+    { ratePercent: 9, from: '2023-01-01', to: '2024-12-05', provision: 'average_nr3', basis: `${AVERAGE_OTHER} (Art. 12 Nr. 3 Achtes Gesetz zur Änderung von Verbrauchsteuergesetzen, BGBl. I 2022 S. 1838)` },
+    { ratePercent: 8.4, from: '2024-12-06', to: '2024-12-31', provision: 'average_nr3', basis: `${AVERAGE_OTHER} (Art. 24 Nr. 13 Jahressteuergesetz 2024, BGBl. 2024 I Nr. 387)` },
+    { ratePercent: 7.8, from: '2025-01-01', provision: 'average_nr3', basis: `${AVERAGE_OTHER} (Art. 25 Nr. 21 Jahressteuergesetz 2024, BGBl. 2024 I Nr. 387)` },
+];
+const TABLE_BEGINS = '2007-01-01';
+const assertDay = (dayArg) => {
+    const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(dayArg);
+    const date = match ? new Date(Date.UTC(Number(match[1]), Number(match[2]) - 1, Number(match[3]))) : undefined;
+    if (!date || date.toISOString().slice(0, 10) !== dayArg) {
+        throw new Error(`a day of supply is written YYYY-MM-DD, got '${dayArg}'`);
+    }
+};
+/**
+ * The rates of German VAT for a supply carried out on a day (`YYYY-MM-DD`),
+ * each once, in the order of `GERMAN_VAT_RATES`. `undefined` for a day before
+ * the table begins (2007-01-01): the table holds no law for it.
+ */
+export function germanVatRatesOn(dayArg) {
+    assertDay(dayArg);
+    if (dayArg < TABLE_BEGINS) {
+        return undefined;
+    }
+    return [...new Set(GERMAN_VAT_RATES
+            .filter((rateArg) => rateArg.from <= dayArg && (rateArg.to === undefined || dayArg <= rateArg.to))
+            .map((rateArg) => rateArg.ratePercent))];
+}
+const BMF_2020_06_30 = 'BMF-Schreiben vom 30. Juni 2020, III C 2 - S 7030/20/10009 :004, BStBl I S. 584';
+const BMF_2020_11_04 = 'BMF-Schreiben vom 4. November 2020, III C 2 - S 7030/20/10009 :016';
+const NIGHT_2020_06_30_BEWIRTUNG = 'Bewirtungsleistungen (food and drink for consumption on the spot, tobacco and the like) in the night of 30 June to 1 July 2020, at the rates in force from 1 July 2020 ("wird zugelassen")';
+const NIGHT_2020_06_30_BEHERBERGUNG = 'Beherbergungen and the services that go with them in the night of 30 June to 1 July 2020, at the rates in force from 1 July 2020 ("sind … anzuwenden"; the letter of 30 June 2020, Rz. 44, had left them out)';
+const JULY_2020 = '("wird es … nicht beanstandet") a supply to an entrepreneur carried out in July 2020 whose invoice states the rate in force before 1 July 2020 and whose supplier paid that tax: the invoice need not be corrected, and a recipient entitled to deduct input tax deducts the tax as stated (for § 13b supplies, the tax the recipient computed)';
+const NIGHT_2020_12_31 = 'Bewirtungsleistungen, and Beherbergungen with the services that go with them, in the night of 31 December 2020 to 1 January 2021, at the rates of 16 and 5 percent ("wird zugelassen")';
+/**
+ * The transition rules of the administration around the rate changes of
+ * 1 July 2020 and 1 January 2021, each read in the letter itself (the copies of
+ * 8 July 2020 and 5 November 2020 in the Internet Archive of the PDFs on
+ * bundesfinanzministerium.de, read 2026-09-27):
+ * - Rz. 44 of the letter of 30 June 2020 allows the new rates on
+ *   Bewirtungsleistungen in the night of 30 June to 1 July 2020 (accepted), and
+ *   Rz. 22 of the letter of 4 November 2020 requires them on Beherbergungen of
+ *   that night (required), which Rz. 44 had left out.
+ * - Rz. 46 of the letter of 30 June 2020 accepts the old rates, 19 and
+ *   7 percent, on supplies to entrepreneurs in July 2020, with the input tax
+ *   deduction of the stated tax.
+ * - Rz. 22 of the letter of 4 November 2020 allows 16 and 5 percent on
+ *   Bewirtungsleistungen and Beherbergungen in the night of 31 December 2020
+ *   to 1 January 2021.
+ * Not here: Rz. 47 of the letter of 30 June 2020 applies its rules "entsprechend"
+ * to the rise on 1 January 2021; the letters grant no deduction of 16 or
+ * 5 percent stated on a supply of January 2021 beyond the night above, except
+ * for advance payment invoices issued before 2021 (4 November 2020, Rz. 1 and
+ * 2), whose case needs the invoice's date. No letter on the § 24 changes of
+ * 2022, 2023, 2024-12-06 and 2025 was found.
+ */
+export const GERMAN_VAT_RATE_CONCESSIONS = [
+    { ratePercent: 16, standing: 'accepted', from: '2020-06-30', to: '2020-06-30', source: `${BMF_2020_06_30}, Rz. 44; ${BMF_2020_11_04}, Rz. 22`, covers: NIGHT_2020_06_30_BEWIRTUNG },
+    { ratePercent: 5, standing: 'accepted', from: '2020-06-30', to: '2020-06-30', source: `${BMF_2020_06_30}, Rz. 44; ${BMF_2020_11_04}, Rz. 22`, covers: NIGHT_2020_06_30_BEWIRTUNG },
+    { ratePercent: 16, standing: 'required', from: '2020-06-30', to: '2020-06-30', source: `${BMF_2020_11_04}, Rz. 22`, covers: NIGHT_2020_06_30_BEHERBERGUNG },
+    { ratePercent: 5, standing: 'required', from: '2020-06-30', to: '2020-06-30', source: `${BMF_2020_11_04}, Rz. 22`, covers: NIGHT_2020_06_30_BEHERBERGUNG },
+    { ratePercent: 19, standing: 'accepted', from: '2020-07-01', to: '2020-07-31', source: `${BMF_2020_06_30}, Rz. 46`, covers: JULY_2020 },
+    { ratePercent: 7, standing: 'accepted', from: '2020-07-01', to: '2020-07-31', source: `${BMF_2020_06_30}, Rz. 46`, covers: JULY_2020 },
+    { ratePercent: 16, standing: 'accepted', from: '2021-01-01', to: '2021-01-01', source: `${BMF_2020_11_04}, Rz. 22`, covers: NIGHT_2020_12_31 },
+    { ratePercent: 5, standing: 'accepted', from: '2021-01-01', to: '2021-01-01', source: `${BMF_2020_11_04}, Rz. 22`, covers: NIGHT_2020_12_31 },
+];
+/** The transition rules that cover a day of supply (`YYYY-MM-DD`), in the order of `GERMAN_VAT_RATE_CONCESSIONS`. */
+export function germanVatRateConcessionsOn(dayArg) {
+    assertDay(dayArg);
+    return GERMAN_VAT_RATE_CONCESSIONS.filter((entryArg) => entryArg.from <= dayArg && dayArg <= entryArg.to);
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmF0ZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy9yYXRlcy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7R0FLRztBQWVILE1BQU0sT0FBTyxHQUFHLDhFQUE4RSxDQUFDO0FBQy9GLE1BQU0sT0FBTyxHQUFHLGtCQUFrQixDQUFDO0FBQ25DLE1BQU0sU0FBUyxHQUFHLHFGQUFxRixDQUFDO0FBQ3hHLE1BQU0sZUFBZSxHQUFHLCtCQUErQixDQUFDO0FBQ3hELE1BQU0sUUFBUSxHQUFHLHFHQUFxRyxDQUFDO0FBQ3ZILE1BQU0sYUFBYSxHQUFHLCtCQUErQixDQUFDO0FBQ3RELE1BQU0sSUFBSSxHQUFHLDhIQUE4SCxDQUFDO0FBRTVJOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXNDRztBQUNILE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUE4QjtJQUN6RCxFQUFFLFdBQVcsRUFBRSxFQUFFLEVBQUUsSUFBSSxFQUFFLFlBQVksRUFBRSxFQUFFLEVBQUUsWUFBWSxFQUFFLFNBQVMsRUFBRSxTQUFTLEVBQUUsS0FBSyxFQUFFLE9BQU8sRUFBRTtJQUMvRixFQUFFLFdBQVcsRUFBRSxFQUFFLEVBQUUsSUFBSSxFQUFFLFlBQVksRUFBRSxTQUFTLEVBQUUsU0FBUyxFQUFFLEtBQUssRUFBRSxPQUFPLEVBQUU7SUFDN0UsRUFBRSxXQUFXLEVBQUUsQ0FBQyxFQUFFLElBQUksRUFBRSxZQUFZLEVBQUUsRUFBRSxFQUFFLFlBQVksRUFBRSxTQUFTLEVBQUUsU0FBUyxFQUFFLEtBQUssRUFBRSxPQUFPLEVBQUU7SUFDOUYsRUFBRSxXQUFXLEVBQUUsQ0FBQyxFQUFFLElBQUksRUFBRSxZQUFZLEVBQUUsU0FBUyxFQUFFLFNBQVMsRUFBRSxLQUFLLEVBQUUsT0FBTyxFQUFFO0lBQzVFLEVBQUUsV0FBVyxFQUFFLENBQUMsRUFBRSxJQUFJLEVBQUUsWUFBWSxFQUFFLFNBQVMsRUFBRSxNQUFNLEVBQUUs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

package/dist_ts/ustva.d.ts

@@ -1,2 +1,19 @@
 import type { IUstvaInput, IUstvaResult } from './ustva.types.js';
+/**
+ * The labels of the Kennzahlen this module fills. Kz 21, 45 and 87 carry the
+ * titles of their fields in ELSTER's "Anleitung zur UStVA 2026" (read
+ * 2026-09-25).
+ */
+export declare const USTVA_KENNZAHL_LABELS: Readonly<Record<number, string>>;
+/**
+ * The Kennzahlen this module fills, in the order of the UStVA 2026 form
+ * (ELSTER, "Anleitung zur UStVA 2026"): taxable supplies (81, 86, 87), tax-free
+ * supplies (41, 43, 48), intra-Community acquisitions (89, 93), the tax the
+ * recipient owes (46/47, 84/85), supplies whose recipient owes the tax (60),
+ * services in the rest of the Community (21), other non-taxable turnover (45),
+ * input tax (66, 61, 62, 67), the Sondervorauszahlung (39) and the result (83).
+ * A Kennzahl computed but not listed here is reported as an issue, never
+ * dropped.
+ */
+export declare const USTVA_KENNZAHL_ORDER: readonly number[];
 export declare function computeUstva(input: IUstvaInput): IUstvaResult;

package/dist_ts/ustva.js

@@ -21,9 +21,15 @@
 import { vatFromNetCents } from '@fin.cx/calculation';
 import { getChart } from '@fin.cx/chartdata';
 import { VAT_ACCOUNTS } from './ustva.accounts.js';
-const KENNZAHL_LABELS = {
+/**
+ * The labels of the Kennzahlen this module fills. Kz 21, 45 and 87 carry the
+ * titles of their fields in ELSTER's "Anleitung zur UStVA 2026" (read
+ * 2026-09-25).
+ */
+export const USTVA_KENNZAHL_LABELS = {
     81: 'Steuerpflichtige Umsätze 19 %',
     86: 'Steuerpflichtige Umsätze 7 %',
+    87: 'Steuerpflichtige Lieferungen und sonstige Leistungen (0 %)',
     89: 'Innergemeinschaftliche Erwerbe 19 %',
     93: 'Innergemeinschaftliche Erwerbe 7 %',
     41: 'Steuerfreie innergemeinschaftliche Lieferungen',
@@ -34,6 +40,8 @@ const KENNZAHL_LABELS = {
     84: 'Andere Leistungen eines im Ausland ansässigen Unternehmers (§13b)',
     85: 'Steuer zu Kennzahl 84',
     60: 'Steuerpflichtige Umsätze, für die der Leistungsempfänger die Steuer schuldet (§13b)',
+    21: 'Sonstige Leistungen im übrigen Gemeinschaftsgebiet',
+    45: 'Übrige nicht steuerbare Umsätze (Leistungsort nicht im Inland)',
     66: 'Vorsteuer aus Rechnungen anderer Unternehmer',
     61: 'Vorsteuer aus innergemeinschaftlichem Erwerb',
     62: 'Entrichtete Einfuhrumsatzsteuer',
@@ -41,8 +49,17 @@ const KENNZAHL_LABELS = {
     39: 'Anrechnung der Sondervorauszahlung (Dauerfristverlängerung)',
     83: 'Verbleibende Umsatzsteuer-Vorauszahlung / Überschuss',
 };
-/** result order follows the form sections */
-const KENNZAHL_ORDER = [81, 86, 89, 93, 41, 43, 48, 46, 47, 84, 85, 60, 66, 61, 62, 67, 39, 83];
+/**
+ * The Kennzahlen this module fills, in the order of the UStVA 2026 form
+ * (ELSTER, "Anleitung zur UStVA 2026"): taxable supplies (81, 86, 87), tax-free
+ * supplies (41, 43, 48), intra-Community acquisitions (89, 93), the tax the
+ * recipient owes (46/47, 84/85), supplies whose recipient owes the tax (60),
+ * services in the rest of the Community (21), other non-taxable turnover (45),
+ * input tax (66, 61, 62, 67), the Sondervorauszahlung (39) and the result (83).
+ * A Kennzahl computed but not listed here is reported as an issue, never
+ * dropped.
+ */
+export const USTVA_KENNZAHL_ORDER = [81, 86, 87, 41, 43, 48, 89, 93, 46, 47, 84, 85, 60, 21, 45, 66, 61, 62, 67, 39, 83];
 /** full euros, cents truncated toward zero (form rule for bases) */
 function truncateToEur(cents) {
     return Math.trunc(cents / 100);
@@ -208,7 +225,7 @@ export function computeUstva(input) {
             kennzahl,
             kind,
             value,
-            label: KENNZAHL_LABELS[kennzahl] ?? `Kennzahl ${kennzahl}`,
+            label: USTVA_KENNZAHL_LABELS[kennzahl] ?? `Kennzahl ${kennzahl}`,
             accounts,
         });
     };
@@ -260,7 +277,13 @@ export function computeUstva(input) {
     if (kzValue(67) !== 0 || kz47Cents !== 0 || kz85Cents !== 0) {
         checks.push(`§13b input vs output tax: Kz 67 ${kzValue(67)} vs Kz 47+85 ${kz47Cents + kz85Cents} (diff ${rcDeductionDiff}; non-zero = partial deduction or inconsistency)`);
     }
-    const kennzahlen = KENNZAHL_ORDER.filter((kennzahl) => values.has(kennzahl)).map((kennzahl) => values.get(kennzahl));
+    const kennzahlen = USTVA_KENNZAHL_ORDER.filter((kennzahl) => values.has(kennzahl)).map((kennzahl) => values.get(kennzahl));
+    // a figure the form order does not place would be left out of the filing: say so instead
+    for (const [kennzahl, value] of values) {
+        if (!USTVA_KENNZAHL_ORDER.includes(kennzahl)) {
+            issues.push(`Kennzahl ${kennzahl} (from ${value.accounts.join(', ')}) has no place in this module's form order — it cannot be filed; add it to USTVA_KENNZAHL_ORDER`);
+        }
+    }
     return {
         chart: input.chart,
         year: input.year,
@@ -277,4 +300,4 @@ export function computeUstva(input) {
         issues,
     };
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXN0dmEuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy91c3R2YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQW1CRztBQUNILE9BQU8sRUFBRSxlQUFlLEVBQWUsTUFBTSxxQkFBcUIsQ0FBQztBQUNuRSxPQUFPLEVBQUUsUUFBUSxFQUFzQixNQUFNLG1CQUFtQixDQUFDO0FBQ2pFLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQVNuRCxNQUFNLGVBQWUsR0FBMkI7SUFDOUMsRUFBRSxFQUFFLCtCQUErQjtJQUNuQyxFQUFFLEVBQUUsOEJBQThCO0lBQ2xDLEVBQUUsRUFBRSxxQ0FBcUM7SUFDekMsRUFBRSxFQUFFLG9DQUFvQztJQUN4QyxFQUFFLEVBQUUsZ0RBQWdEO0lBQ3BELEVBQUUsRUFBRSx3REFBd0Q7SUFDNUQsRUFBRSxFQUFFLHlDQUF5QztJQUM3QyxFQUFFLEVBQUUsZ0VBQWdFO0lBQ3BFLEVBQUUsRUFBRSx1QkFBdUI7SUFDM0IsRUFBRSxFQUFFLG1FQUFtRTtJQUN2RSxFQUFFLEVBQUUsdUJBQXVCO0lBQzNCLEVBQUUsRUFBRSxxRkFBcUY7SUFDekYsRUFBRSxFQUFFLDhDQUE4QztJQUNsRCxFQUFFLEVBQUUsOENBQThDO0lBQ2xELEVBQUUsRUFBRSxpQ0FBaUM7SUFDckMsRUFBRSxFQUFFLGlEQUFpRDtJQUNyRCxFQUFFLEVBQUUsNkRBQTZEO0lBQ2pFLEVBQUUsRUFBRSxzREFBc0Q7Q0FDM0QsQ0FBQztBQUVGLDZDQUE2QztBQUM3QyxNQUFNLGNBQWMsR0FBRyxDQUFDLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxDQUFDLENBQUM7QUFFaEcsb0VBQW9FO0FBQ3BFLFNBQVMsYUFBYSxDQUFDLEtBQWE7SUFDbEMsT0FBTyxJQUFJLENBQUMsS0FBSyxDQUFDLEtBQUssR0FBRyxHQUFHLENBQUMsQ0FBQztBQUNqQyxDQUFDO0FBRUQsNEVBQTRFO0FBQzVFLFNBQVMsWUFBWSxDQUFDLE9BQWUsRUFBRSxXQUFtQjtJQUN4RCxPQUFPLE9BQU8sR0FBRyxXQUFXLENBQUM7QUFDL0IsQ0FBQztBQUVELFNBQVMsb0JBQW9CLENBQUMsS0FBd0IsRUFBRSxhQUFxQjtJQUMzRSxNQUFNLFVBQVUsR0FBRyxhQUFhLENBQUMsQ0FBQyxDQUFDLENBQUM7SUFDcEMsT0FBTyxLQUFLLEtBQUssT0FBTyxDQUFDLENBQUMsQ0FBQyxVQUFVLEtBQUssR0FBRyxDQUFDLENBQUMsQ0FBQyxVQUFVLEtBQUssR0FBRyxDQUFDO0FBQ3JFLENBQUM7QUFFRCxNQUFNLFVBQVUsWUFBWSxDQUFDLEtBQWtCO0lBQzdDLE1BQU0sT0FBTyxHQUFHLFFBQVEsQ0FBQyxLQUFLLENBQUMsS0FBSyxFQUFFLEtBQUssQ0FBQyxJQUFJLENBQUMsQ0FBQztJQUNsRCxNQUFNLFFBQVEsR0FBRyxJQUFJLEdBQUcsQ0FBQyxPQUFPLENBQUMsUUFBUSxDQUFDLEdBQUcsQ0FBQyxDQUFDLE9BQU8sRUFBRSxFQUFFLENBQUMsQ0FBQyxPQUFPLENBQUMsYUFBYSxFQUFFLE9BQU8sQ0FBQyxDQUFDLENBQUMsQ0FBQztJQUM5RixNQUFNLFdBQVcsR0FBbUIsRUFBRSxHQUFHLFlBQVksQ0FBQyxLQUFLLENBQUMsS0FBSyxDQUFDLEVBQUUsR0FBRyxLQUFLLENBQUMsV0FBVyxFQUFFLENBQUM7SUFDM0YsTUFBTSxNQUFNLEdBQUcsSUFBSSxHQUFHLENBQUMsS0FBSyxDQUFDLGNBQWMsSUFBSSxFQUFFLENBQUMsQ0FBQztJQUNuRCxNQUFNLFNBQVMsR0FBRyxLQUFLLENBQUMsNEJBQTRCLElBQUksR0FBRyxDQUFDO0lBQzVELE1BQU0sTUFBTSxHQUFhLEVBQUUsQ0FBQztJQUM1QixNQUFNLE1BQU0sR0FBYSxFQUFFLENBQUM7SUFFNUIsMEVBQTBFO0lBQzFFLE1BQU0sYUFBYSxHQUFHLElBQUksR0FBRyxFQUFrQixDQUFDO0lBQ2hELE1BQU0sWUFBWSxHQUFHLElBQUksR0FBRyxFQUFrQixDQUFDO0lBQy9DLE1BQU0sWUFBWSxHQUFHLElBQUksR0FBRyxFQUFvQixDQUFDO0lBQ2pELE1BQU0sVUFBVSxHQUFHLENBQ2pCLE1BQTJCLEVBQzNCLFFBQWdCLEVBQ2hCLEtBQWEsRUFDYixhQUFxQixFQUNmLEVBQUU7UUFDUixNQUFNLENBQUMsR0FBRyxDQUFDLFFBQVEsRUFBRSxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsUUFBUSxDQUFDLElBQUksQ0FBQyxDQUFDLEdBQUcsS0FBSyxDQUFDLENBQUM7UUFDMUQsTUFBTSxJQUFJLEdBQUcsWUFBWSxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsSUFBSSxFQUFFLENBQUM7UUFDOUMsSUFBSSxDQUFDLElBQUksQ0FBQyxRQUFRLENBQUMsYUFBYSxDQUFDO1lBQUUsSUFBSSxDQUFDLElBQUksQ0FBQyxhQUFhLENBQUMsQ0FBQztRQUM1RCxZQUFZLENBQUMsR0FBRyxDQUFDLFFBQVEsRUFBRSxJQUFJLENBQUMsQ0FBQztJQUNuQyxDQUFDLENBQUM7SUFFRixJQUFJLHlCQUF5QixHQUFHLENBQUMsQ0FBQztJQUNsQyxJQUFJLHdCQUF3QixHQUFHLENBQUMsQ0FBQztJQUNqQyxJQUFJLHdCQUF3QixHQUFHLENBQUMsQ0FBQztJQUNqQyxJQUFJLG9CQUFvQixHQUFHLENBQUMsQ0FBQztJQUM3QixJQUFJLG1CQUFtQixHQUFHLENBQUMsQ0FBQztJQUM1QixNQUFNLGVBQWUsR0FBYSxFQUFFLENBQUM7SUFFckMsS0FBSyxNQUFNLFFBQVEsSUFBSSxLQUFLLENBQUMsU0FBUyxFQUFFLENBQUM7UUFDdkMsSUFBSSxRQUFRLENBQUMsV0FBVyxLQUFLLENBQUM7WUFBRSxTQUFTO1FBQ3pDLE1BQU0sRUFBRSxhQUFhLEVBQUUsV0FBVyxFQUFFLEdBQUcsUUFBUSxDQUFDO1FBRWhELGlEQUFpRDtRQUNqRCxJQUFJLFdBQVcsQ0FBQyxjQUFjLENBQUMsUUFBUSxDQUFDLGFBQWEsQ0FBQyxFQUFFLENBQUM7WUFDdkQseUJBQXlCLElBQUksQ0FBQyxXQUFXLENBQUM7WUFDMUMsU0FBUztRQUNYLENBQUM7UUFDRCxJQUFJLFdBQVcsQ0FBQyxhQUFhLENBQUMsUUFBUSxDQUFDLGFBQWEsQ0FBQyxFQUFFLENBQUM7WUFDdEQsd0JBQXdCLElBQUksQ0FBQyxXQUFXLENBQUM7WUFDekMsU0FBUztRQUNYLENBQUM7UUFDRCxJQUFJLFdBQVcsQ0FBQyxhQUFhLENBQUMsUUFBUSxDQUFDLGFBQWEsQ0FBQyxFQUFFLENBQUM7WUFDdEQsd0JBQXdCLElBQUksQ0FBQyxXQUFXLENBQUM7WUFDekMsU0FBUztRQUNYLENBQUM7UUFDRCxJQUFJLFdBQVcsQ0FBQyx3QkFBd0IsQ0FBQyxRQUFRLENBQUMsYUFBYSxDQUFDLEVBQUUsQ0FBQztZQUNqRSxvQkFBb0IsSUFBSSxDQUFDLFdBQVcsQ0FBQztZQUNyQyxTQUFTO1FBQ1gsQ0FBQztRQUNELElBQUksV0FBVyxDQUFDLG1CQUFtQixDQUFDLFFBQVEsQ0FBQyxhQUFhLENBQUMsRUFBRSxDQUFDO1lBQzVELG1CQUFtQixJQUFJLENBQUMsV0FBVyxDQUFDO1lBQ3BDLFNBQVM7UUFDWCxDQUFDO1FBQ0QsSUFBSSxXQUFXLENBQUMsbUNBQW1DLENBQUMsUUFBUSxDQUFDLGFBQWEsQ0FBQyxFQUFFLENBQUM7WUFDNUUsTUFBTSxDQUFDLElBQUksQ0FDVCxXQUFXLGFBQWEscUdBQXFHLENBQUMsV0FBVyxzR0FBc0csV0FBVyxDQUFDLHdCQUF3QixDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsRUFBRSxDQUNoUyxDQUFDO1lBQ0YsU0FBUztRQUNYLENBQUM7UUFFRCxNQUFNLE9BQU8sR0FBRyxRQUFRLENBQUMsR0FBRyxDQUFDLGFBQWEsQ0FBQyxDQUFDO1FBQzVDLElBQUksQ0FBQyxPQUFPLEVBQUUsQ0FBQztZQUNiLE1BQU0sT0FBTyxHQUFHLE1BQU0sQ0FBQyxRQUFRLENBQUMsYUFBYSxFQUFFLEVBQUUsQ0FBQyxDQUFDO1lBQ25ELElBQUksT0FBTyxJQUFJLEtBQUssSUFBSSxPQUFPLElBQUksS0FBSztnQkFBRSxTQUFTLENBQUMsb0JBQW9CO1lBQ3hFLElBQUksb0JBQW9CLENBQUMsS0FBSyxDQUFDLEtBQUssRUFBRSxhQUFhLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxHQUFHLENBQUMsYUFBYSxDQUFDLEVBQUUsQ0FBQztnQkFDbkYsTUFBTSxDQUFDLElBQUksQ0FDVCx5QkFBeUIsYUFBYSxrQkFBa0IsS0FBSyxDQUFDLEtBQUssSUFBSSxLQUFLLENBQUMsSUFBSSxnREFBZ0QsQ0FDbEksQ0FBQztZQUNKLENBQUM7aUJBQU0sQ0FBQztnQkFDTixlQUFlLENBQUMsSUFBSSxDQUFDLGFBQWEsQ0FBQyxDQUFDO1lBQ3RDLENBQUM7WUFDRCxTQUFTO1FBQ1gsQ0FBQztRQUVELElBQUksT0FBTyxDQUFDLEtBQUssRUFBRSxDQUFDO1lBQ2xCLElBQUksT0FBTyxDQUFDLEtBQUssQ0FBQyxJQUFJLEtBQUssTUFBTSxFQUFFLENBQUM7Z0JBQ2xDLCtEQUErRDtnQkFDL0QsVUFBVSxDQUFDLGFBQWEsRUFBRSxPQUFPLENBQUMsS0FBSyxDQUFDLFFBQVEsRUFBRSxDQUFDLFdBQVcsRUFBRSxhQUFhLENBQUMsQ0FBQztZQUNqRixDQUFDO2lCQUFNLENBQUM7Z0JBQ04saURBQWlEO2dCQUNqRCxNQUFNLElBQUksR0FBRyxPQUFPLENBQUMsV0FBVyxLQUFLLE9BQU8sSUFBSSxPQUFPLENBQUMsV0FBVyxLQUFLLFNBQVMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDLENBQUMsQ0FBQztnQkFDM0YsVUFBVSxDQUFDLFlBQVksRUFBRSxPQUFPLENBQUMsS0FBSyxDQUFDLFFBQVEsRUFBRSxJQUFJLEdBQUcsV0FBVyxFQUFFLGFBQWEsQ0FBQyxDQUFDO1lBQ3RGLENBQUM7WUFDRCxTQUFTO1FBQ1gsQ0FBQztRQUVELElBQUksT0FBTyxDQUFDLFdBQVcsS0FBSyxTQUFTLElBQUksQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLGFBQWEsQ0FBQyxFQUFFLENBQUM7WUFDcEUsTUFBTSxDQUFDLElBQUksQ0FDVCxtQkFBbUIsYUFBYSxLQUFLLE9BQU8sQ0FBQyxXQUFXLDhFQUE4RSxDQUN2SSxDQUFDO1FBQ0osQ0FBQztJQUNILENBQUM7SUFFRCxJQUFJLGVBQWUsQ0FBQyxNQUFNLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDL0IsTUFBTSxDQUFDLElBQUksQ0FBQyxxREFBcUQsZUFBZSxDQUFDLElBQUksQ0FBQyxJQUFJLENBQUMsRUFBRSxDQUFDLENBQUM7SUFDakcsQ0FBQztJQUNELElBQUksd0JBQXdCLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDbkMsTUFBTSxDQUFDLElBQUksQ0FDVCwrQ0FBK0Msd0JBQXdCLDBFQUEwRSxDQUNsSixDQUFDO0lBQ0osQ0FBQztJQUVELDJFQUEyRTtJQUMzRSxNQUFNLFFBQVEsR0FBRyxLQUFLLENBQUMsYUFBYSxJQUFJLEVBQUUsQ0FBQztJQUMzQyxNQUFNLE9BQU8sR0FBYSxFQUFFLENBQUM7SUFFN0IsSUFBSSxTQUFTLEdBQUcsUUFBUSxDQUFDLCtCQUErQixJQUFJLENBQUMsQ0FBQztJQUM5RCxJQUFJLFVBQVUsR0FBRyxZQUFZLENBQUM7SUFDOUIsSUFBSSxRQUFRLENBQUMsK0JBQStCLEtBQUssU0FBUyxJQUFJLG9CQUFvQixLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ3pGLFNBQVMsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLENBQUMsb0JBQW9CLEdBQUcsR0FBRyxDQUFDLEdBQUcsRUFBRSxDQUFDLENBQUM7UUFDMUQsVUFBVSxHQUFHLFdBQVcsQ0FBQztRQUN6QixPQUFPLENBQUMsSUFBSSxDQUFDLCtDQUErQyxvQkFBb0IsZ0JBQWdCLENBQUMsQ0FBQztJQUNwRyxDQUFDO0lBQ0QsTUFBTSxTQUFTLEdBQUcsUUFBUSxDQUFDLDhCQUE4QixJQUFJLENBQUMsQ0FBQztJQUUvRCxJQUFJLFNBQVMsR0FBRyxRQUFRLENBQUMsNEJBQTRCLElBQUksQ0FBQyxDQUFDO0lBQzNELElBQUksVUFBVSxHQUFHLFlBQVksQ0FBQztJQUM5QixNQUFNLFNBQVMsR0FBRyxRQUFRLENBQUMsdUJBQXVCLElBQUksQ0FBQyxDQUFDO0lBQ3hELE1BQU0sYUFBYSxHQUNqQixRQUFRLENBQUMsNEJBQTRCLEtBQUssU0FBUztRQUNuRCxRQUFRLENBQUMsdUJBQXVCLEtBQUssU0FBUyxDQUFDO0lBQ2pELElBQUksQ0FBQyxhQUFhLElBQUksbUJBQW1CLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDaEQsU0FBUyxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsQ0FBQyxtQkFBbUIsR0FBRyxHQUFHLENBQUMsR0FBRyxFQUFFLENBQUMsQ0FBQztRQUN6RCxVQUFVLEdBQUcsV0FBVyxDQUFDO1FBQ3pCLE9BQU8sQ0FBQyxJQUFJLENBQ1YsZ0RBQWdELG1CQUFtQixnRUFBZ0UsQ0FDcEksQ0FBQztJQUNKLENBQUM7SUFFRCxrRUFBa0U7SUFDbEUsSUFBSSxTQUFTLEdBQUcsQ0FBQyxDQUFDO0lBQ2xCLElBQUksU0FBUyxHQUFHLENBQUMsQ0FBQztJQUNsQixJQUFJLFNBQVMsS0FBSyxDQUFDLElBQUksU0FBUyxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ3ZDLFNBQVMsR0FBRyxlQUFlLENBQUMsU0FBUyxFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBQzNDLFNBQVMsR0FBRyxtQkFBbUIsR0FBRyxTQUFTLENBQUM7SUFDOUMsQ0FBQztTQUFNLElBQUksU0FBUyxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQzNCLFNBQVMsR0FBRyxtQkFBbUIsQ0FBQztJQUNsQyxDQUFDO1NBQU0sSUFBSSxTQUFTLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDM0IsU0FBUyxHQUFHLG1CQUFtQixDQUFDO0lBQ2xDLENBQUM7U0FBTSxJQUFJLG1CQUFtQixLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ3JDLFNBQVMsR0FBRyxtQkFBbUIsQ0FBQyxDQUFDLCtCQUErQjtJQUNsRSxDQUFDO0lBRUQsbUVBQW1FO0lBQ25FLElBQUksVUFBVSxLQUFLLFlBQVksSUFBSSxTQUFTLEtBQUssQ0FBQyxFQUFFLENBQUM7UUFDbkQsTUFBTSxRQUFRLEdBQUcsZUFBZSxDQUFDLFNBQVMsRUFBRSxFQUFFLENBQUMsQ0FBQztRQUNoRCxNQUFNLElBQUksR0FBRyxvQkFBb0IsR0FBRyxRQUFRLENBQUM7UUFDN0MsTUFBTSxDQUFDLElBQUksQ0FBQywrQkFBK0Isb0JBQW9CLDZCQUE2QixRQUFRLFVBQVUsSUFBSSxHQUFHLENBQUMsQ0FBQztRQUN2SCxJQUFJLElBQUksQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLEdBQUcsU0FBUyxFQUFFLENBQUM7WUFDL0IsTUFBTSxDQUFDLElBQUksQ0FBQyxvRUFBb0UsSUFBSSxRQUFRLENBQUMsQ0FBQztRQUNoRyxDQUFDO0lBQ0gsQ0FBQztJQUNELElBQUksYUFBYSxFQUFFLENBQUM7UUFDbEIsTUFBTSxRQUFRLEdBQUcsZUFBZSxDQUFDLFNBQVMsRUFBRSxFQUFFLENBQUMsR0FBRyxlQUFlLENBQUMsU0FBUyxFQUFFLEVBQUUsQ0FBQyxDQUFDO1FBQ2pGLE1BQU0sSUFBSSxHQUFHLG1CQUFtQixHQUFHLFFBQVEsQ0FBQztRQUM1QyxNQUFNLENBQUMsSUFBSSxDQUFDLDJCQUEyQixtQkFBbUIsOEJBQThCLFFBQVEsVUFBVSxJQUFJLEdBQUcsQ0FBQyxDQUFDO1FBQ25ILElBQUksSUFBSSxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsR0FBRyxTQUFTLEVBQUUsQ0FBQztZQUMvQixNQUFNLENBQUMsSUFBSSxDQUFDLHVFQUF1RSxJQUFJLFFBQVEsQ0FBQyxDQUFDO1FBQ25HLENBQUM7SUFDSCxDQUFDO0lBQ0QsTUFBTSxDQUFDLElBQUksQ0FBQyxHQUFHLE9BQU8sQ0FBQyxDQUFDO0lBRXhCLDJFQUEyRTtJQUMzRSxNQUFNLE1BQU0sR0FBRyxJQUFJLEdBQUcsRUFBMEIsQ0FBQztJQUNqRCxNQUFNLEdBQUcsR0FBRyxDQUFDLFFBQWdCLEVBQUUsSUFBbUIsRUFBRSxLQUFhLEVBQUUsUUFBa0IsRUFBUSxFQUFFO1FBQzdGLElBQUksS0FBSyxLQUFLLENBQUMsSUFBSSxRQUFRLENBQUMsTUFBTSxLQUFLLENBQUM7WUFBRSxPQUFPO1FBQ2pELE1BQU0sQ0FBQyxHQUFHLENBQUMsUUFBUSxFQUFFO1lBQ25CLFFBQVE7WUFDUixJQUFJO1lBQ0osS0FBSztZQUNMLEtBQUssRUFBRSxlQUFlLENBQUMsUUFBUSxDQUFDLElBQUksWUFBWSxRQUFRLEVBQUU7WUFDMUQsUUFBUTtTQUNULENBQUMsQ0FBQztJQUNMLENBQUMsQ0FBQztJQUVGLEtBQUssTUFBTSxDQUFDLFFBQVEsRUFBRSxLQUFLLENBQUMsSUFBSSxhQUFhLEVBQUUsQ0FBQztRQUM5QyxHQUFHLENBQUMsUUFBUSxFQUFFLFNBQVMsRUFBRSxhQUFhLENBQUMsS0FBSyxDQUFDLEVBQUUsWUFBWSxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsSUFBSSxFQUFFLENBQUMsQ0FBQztJQUNuRixDQUFDO0lBQ0QsS0FBSyxNQUFNLENBQUMsUUFBUSxFQUFFLEtBQUssQ0FBQyxJQUFJLFlBQVksRUFBRSxDQUFDO1FBQzdDLEdBQUcsQ0FBQyxRQUFRLEVBQUUsVUFBVSxFQUFFLEtBQUssRUFBRSxZQUFZLENBQUMsR0FBRyxDQUFDLFFBQVEsQ0FBQyxJQUFJLEVBQUUsQ0FBQyxDQUFDO0lBQ3JFLENBQUM7SUFDRCxJQUFJLFNBQVMsS0FBSyxDQUFDO1FBQUUsR0FBRyxDQUFDLEVBQUUsRUFBRSxTQUFTLEVBQUUsYUFBYSxDQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQztJQUNoRixJQUFJLFNBQVMsS0FBSyxDQUFDO1FBQUUsR0FBRyxDQUFDLEVBQUUsRUFBRSxTQUFTLEVBQUUsYUFBYSxDQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUMsWUFBWSxDQUFDLENBQUMsQ0FBQztJQUNsRixJQUFJLFNBQVMsS0FBSyxDQUFDO1FBQUUsR0FBRyxDQUFDLEVBQUUsRUFBRSxTQUFTLEVBQUUsYUFBYSxDQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUMsVUFBVSxDQUFDLENBQUMsQ0FBQztJQUNoRixJQUFJLFNBQVMsS0FBSyxDQUFDO1FBQUUsR0FBRyxDQUFDLEVBQUUsRUFBRSxVQUFVLEVBQUUsU0FBUyxFQUFFLFlBQVksQ0FBQyxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUMsbUJBQW1CLENBQUMsQ0FBQztJQUNuRyxJQUFJLFNBQVMsS0FBSyxDQUFDO1FBQUUsR0FBRyxDQUFDLEVBQUUsRUFBRSxTQUFTLEVBQUUsYUFBYSxDQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUMsWUFBWSxDQUFDLENBQUMsQ0FBQztJQUNsRixJQUFJLFNBQVMsS0FBSyxDQUFDO1FBQUUsR0FBRyxDQUFDLEVBQUUsRUFBRSxVQUFVLEVBQUUsU0FBUyxFQUFFLFlBQVksQ0FBQyxLQUFLLENBQUMsS0FBSyxDQUFDLENBQUMsbUJBQW1CLENBQUMsQ0FBQztJQUNuRyxNQUFNLG1CQUFtQixHQUFHLEtBQUssQ0FBQyx3QkFBd0IsSUFBSSxDQUFDLENBQUM7SUFDaEUsSUFBSSxtQkFBbUIsS0FBSyxDQUFDO1FBQUUsR0FBRyxDQUFDLEVBQUUsRUFBRSxVQUFVLEVBQUUsbUJBQW1CLEVBQUUsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDO0lBRXJGLE1BQU0sT0FBTyxHQUFHLENBQUMsUUFBZ0IsRUFBVSxFQUFFLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUMsRUFBRSxLQUFLLElBQUksQ0FBQyxDQUFDO0lBRS9FLDRFQUE0RTtJQUM1RSxNQUFNLG9CQUFvQixHQUN4QixZQUFZLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQyxFQUFFLEVBQUUsQ0FBQyxHQUFHLFlBQVksQ0FBQyxPQUFPLENBQUMsRUFBRSxDQUFDLEVBQUUsQ0FBQyxDQUFDLENBQUM7SUFDL0QsTUFBTSxlQUFlLEdBQUcsWUFBWSxDQUFDLE9BQU8sQ0FBQyxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUMsR0FBRyxZQUFZLENBQUMsT0FBTyxDQUFDLEVBQUUsQ0FBQyxFQUFFLENBQUMsQ0FBQyxDQUFDO0lBQ3JGLE1BQU0sYUFBYSxHQUFHLE9BQU8sQ0FBQyxFQUFFLENBQUMsR0FBRyxPQUFPLENBQUMsRUFBRSxDQUFDLEdBQUcsT0FBTyxDQUFDLEVBQUUsQ0FBQyxHQUFHLE9BQU8sQ0FBQyxFQUFFLENBQUMsQ0FBQztJQUM1RSxNQUFNLGFBQWEsR0FDakIsb0JBQW9CO1FBQ3BCLGVBQWU7UUFDZixTQUFTO1FBQ1QsU0FBUztRQUNULGFBQWE7UUFDYixtQkFBbUIsQ0FBQztJQUN0QixHQUFHLENBQUMsRUFBRSxFQUFFLFVBQVUsRUFBRSxhQUFhLEVBQUUsQ0FBQyxZQUFZLENBQUMsQ0FBQyxDQUFDO0lBRW5ELDZFQUE2RTtJQUM3RSxNQUFNLG9CQUFvQixHQUN4Qix5QkFBeUIsR0FBRyx3QkFBd0IsR0FBRyx3QkFBd0IsQ0FBQztJQUNsRixNQUFNLHdCQUF3QixHQUFHLG9CQUFvQixHQUFHLG9CQUFvQixDQUFDO0lBQzdFLE1BQU0sQ0FBQyxJQUFJLENBQ1QsK0JBQStCLG9CQUFvQixZQUFZLG9CQUFvQixVQUFVLHdCQUF3QixHQUFHLENBQ3pILENBQUM7SUFDRixJQUFJLElBQUksQ0FBQyxHQUFHLENBQUMsd0JBQXdCLENBQUMsR0FBRyxTQUFTLEVBQUUsQ0FBQztRQUNuRCxNQUFNLENBQUMsSUFBSSxDQUNULDBFQUEwRSx3QkFBd0IscUJBQXFCLFNBQVMsa0NBQWtDLENBQ25LLENBQUM7SUFDSixDQUFDO0lBQ0QsTUFBTSxnQkFBZ0IsR0FBRyxPQUFPLENBQUMsRUFBRSxDQUFDLEdBQUcsb0JBQW9CLENBQUM7SUFDNUQsSUFBSSxPQUFPLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxJQUFJLG9CQUFvQixLQUFLLENBQUMsRUFBRSxDQUFDO1FBQ3BELE1BQU0sQ0FBQyxJQUFJLENBQ1Qsa0NBQWtDLE9BQU8sQ0FBQyxFQUFFLENBQUMseUJBQXlCLG9CQUFvQixVQUFVLGdCQUFnQixrREFBa0QsQ0FDdkssQ0FBQztJQUNKLENBQUM7SUFDRCxNQUFNLGVBQWUsR0FBRyxPQUFPLENBQUMsRUFBRSxDQUFDLEdBQUcsQ0FBQyxTQUFTLEdBQUcsU0FBUyxDQUFDLENBQUM7SUFDOUQsSUFBSSxPQUFPLENBQUMsRUFBRSxDQUFDLEtBQUssQ0FBQyxJQUFJLFNBQVMsS0FBSyxDQUFDLElBQUksU0FBUyxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQzVELE1BQU0sQ0FBQyxJQUFJLENBQ1QsbUNBQW1DLE9BQU8sQ0FBQyxFQUFFLENBQUMsZ0JBQWdCLFNBQVMsR0FBRyxTQUFTLFVBQVUsZUFBZSxrREFBa0QsQ0FDL0osQ0FBQztJQUNKLENBQUM7SUFFRCxNQUFNLFVBQVUsR0FBRyxjQUFjLENBQUMsTUFBTSxDQUFDLENBQUMsUUFBUSxFQUFFLEVBQUUsQ0FBQyxNQUFNLENBQUMsR0FBRyxDQUFDLFFBQVEsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUM5RSxDQUFDLFFBQVEsRUFBRSxFQUFFLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUUsQ0FDcEMsQ0FBQztJQUVGLE9BQU87UUFDTCxLQUFLLEVBQUUsS0FBSyxDQUFDLEtBQUs7UUFDbEIsSUFBSSxFQUFFLEtBQUssQ0FBQyxJQUFJO1FBQ2hCLE1BQU0sRUFBRSxLQUFLLENBQUMsTUFBTTtRQUNwQixjQUFjLEVBQUUsS0FBSyxDQUFDLGNBQWMsSUFBSSxNQUFNO1FBQzlDLFVBQVU7UUFDVixhQUFhO1FBQ2IsY0FBYyxFQUFFO1lBQ2Qsb0JBQW9CO1lBQ3BCLGtCQUFrQixFQUFFLG9CQUFvQjtZQUN4Qyx3QkFBd0I7WUFDeEIsTUFBTTtTQUNQO1FBQ0QsTUFBTTtLQUNQLENBQUM7QUFDSixDQUFDIn0=
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXN0dmEuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy91c3R2YS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQW1CRztBQUNILE9BQU8sRUFBRSxlQUFlLEVBQWUsTUFBTSxxQkFBcUIsQ0FBQztBQUNuRSxPQUFPLEVBQUUsUUFBUSxFQUFzQixNQUFNLG1CQUFtQixDQUFDO0FBQ2pFLE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQVNuRDs7OztHQUlHO0FBQ0gsTUFBTSxDQUFDLE1BQU0scUJBQXFCLEdBQXFDO0lBQ3JFLEVBQUUsRUFBRSwrQkFBK0I7SUFDbkMsRUFBRSxFQUFFLDhCQUE4QjtJQUNsQyxFQUFFLEVBQUUsNERBQTREO0lBQ2hFLEVBQUUsRUFBRSxxQ0FBcUM7SUFDekMsRUFBRSxFQUFFLG9DQUFvQztJQUN4QyxFQUFFLEVBQUUsZ0RBQWdEO0lBQ3BELEVBQUUsRUFBRSx3REFBd0Q7SUFDNUQsRUFBRSxFQUFFLHlDQUF5QztJQUM3QyxFQUFFLEVBQUUsZ0VBQWdFO0lBQ3BFLEVBQUUsRUFBRSx1QkFBdUI7SUFDM0IsRUFBRSxFQUFFLG1FQUFtRTtJQUN2RSxFQUFFLEVBQUUsdUJBQXVCO0lBQzNCLEVBQUUsRUFBRSxxRkFBcUY7SUFDekYsRUFBRSxFQUFFLG9EQUFvRDtJQUN4RCxFQUFFLEVBQUUsZ0VBQWdFO0lBQ3BFLEVBQUUsRUFBRSw4Q0FBOEM7SUFDbEQsRUFBRSxFQUFFLDhDQUE4QztJQUNsRCxFQUFFLEVBQUUsaUNBQWlDO0lBQ3JDLEVBQUUsRUFBRSxpREFBaUQ7SUFDckQsRUFBRSxFQUFFLDZEQUE2RDtJQUNqRSxFQUFFLEVBQUUsc0RBQXNEO0NBQzNELENBQUM7QUFFRjs7Ozs7Ozs7O0dBU0c7QUFDSCxNQUFNLENBQUMsTUFBTSxvQkFBb0IsR0FBc0IsQ0FBQyxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxFQUFFLEVBQUUsRUFBRSxF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

package/dist_ts/zm.d.ts

@@ -0,0 +1,92 @@
+/**
+ * The Zusammenfassende Meldung (§ 18a UStG): its lines, and the CSV the
+ * ELSTER (or BZSt-Online-Portal) online form imports. Pure; the caller
+ * decides which supplies of which period go in (§ 18a Abs. 1, 2, 8 UStG) and
+ * transmits the form itself, authenticated, as § 18a requires.
+ *
+ * Sources, read 2026-09-25:
+ * - ELSTER, "Import von Meldelisten zur Zusammenfassenden Meldung"
+ *   (helpGlobal `zmdo_import_eop`, CSV version 3.0) and the general
+ *   "Anleitung zur Erstellung von CSV-Dateien für die Importfunktion":
+ *   UTF-8; line 1 `#v3.0`; the form's example adds `#ve3.2.1`; one line of
+ *   field names; then the lines, one per record "Meldezeilen (Satzart 1)":
+ *   USt-IdNr. AN(7,14) beginning with a country code of the list; Summe
+ *   (Euro) N(11), "eine ganze Zahl", minus allowed; Art der Leistung A(1),
+ *   `L` innergemeinschaftliche Lieferung, `S` sonstige Leistung, `D`
+ *   Dreiecksgeschäft. At most 1 500 lines. The example separates its lines
+ *   with a line feed and its fields with `,`.
+ * - BZSt, "Zusammenfassende Meldung - Fragen und Antworten"
+ *   (bzst.de …/ZusammenfassendeMeldung/FAQ/faq_zm.html, read 2026-09-27),
+ *   Brexit: a Northern Irish business has a VAT ID with `XI`; the ZM states
+ *   the intra-Community supplies, triangular trades and § 6b transfers to it,
+ *   while services to recipients in Northern Ireland follow the rules for the
+ *   third-country territory and are not reported (Art. 8 of the Protocol on
+ *   Ireland/Northern Ireland covers goods only).
+ * - BZSt, "Anleitung zur Zusammenfassenden Meldung" (USt ZM 1/2021): one line
+ *   per recipient and kind in a period, the bases summed (Tz. 8, 11); a later
+ *   change of the base netted into the period of the change, possibly
+ *   negative (Tz. 10); no "Nullmeldungen" (III.1); a correction states the
+ *   correct totals, and `0` to storno a line (Tz. 12.2, 12.3).
+ */
+import type { TCents } from '@fin.cx/calculation';
+/** `L` innergemeinschaftliche Warenlieferung, `S` sonstige Leistung (§ 3a Abs. 2), `D` Dreiecksgeschäft (§ 25b Abs. 2) */
+export type TZmKind = 'L' | 'S' | 'D';
+/** One supply (or a later change of its base) of the period: the recipient's VAT ID, its kind, the base in euro cents */
+export interface IZmSupplyInput {
+    vatId: string;
+    kind: TZmKind;
+    /** signed: a later reduction of the base is negative */
+    baseCents: TCents;
+}
+/** One line of the report: the recipient, the kind, the summed base in euro cents */
+export interface IZmLine {
+    vatId: string;
+    kind: TZmKind;
+    baseCents: TCents;
+}
+export interface IZmCsv {
+    text: string;
+    /** the text as UTF-8, as the import requires */
+    bytes: Uint8Array;
+    lineCount: number;
+}
+/** The country codes the ZM takes (ELSTER, "Liste der Länderkennzeichen"); `GB` only for periods before 2021, so not here. */
+export declare const ZM_COUNTRY_CODES: readonly string[];
+export declare const ZM_MAX_LINES = 1500;
+/** The CSV version lines and the field names, as the form's example gives them. */
+export declare const ZM_CSV_HEAD: readonly string[];
+/**
+ * How a sum with cents becomes the whole euros the CSV's "Summe (Euro)"
+ * takes. No source read states it (ELSTER: "eine ganze Zahl"; ELMA5: "in Euro
+ * ohne Cent"; the paper form: "volle EUR | Ct"). The cents are dropped toward
+ * zero, as the UStVA drops those of its bases ("in vollen Euro (ohne
+ * Centbeträge)", Anleitung zur Umsatzsteuer-Voranmeldung 2026), so that the
+ * ZM and the UStVA's Kz 41 and Kz 21, which the BZSt compares, are cut alike.
+ * This is a recorded decision of 2026-09-27, pending the tax advisor's
+ * confirmation; it is not a rule a source states.
+ */
+export declare const ZM_EUROS_RULE = "the cents of each line's sum are dropped toward zero, as the UStVA drops those of its bases (a recorded decision of 2026-09-27, pending the tax advisor's confirmation; no source states the rule)";
+/**
+ * The whole euros of a sum in cents, as the CSV's "Summe (Euro)" takes them:
+ * the cents dropped toward zero (`ZM_EUROS_RULE`), so 2 000,50 € is 2000 and
+ * -2 000,50 € is -2000. At most 11 digits (N(11)).
+ */
+export declare function zmEurosOf(centsArg: TCents): number;
+/**
+ * A recipient's VAT ID as the form takes it: upper case, without spaces, the
+ * country code first (`GR` written `EL`, as the list has it); 7 to 14
+ * characters of letters, digits, `+` and `*`; a country code of the list.
+ */
+export declare function normalizeZmVatId(valueArg: string): string;
+/** The lines of a period: one per recipient VAT ID and kind, in the order they first appear, the bases summed. */
+export declare function aggregateZmLines(suppliesArg: readonly IZmSupplyInput[]): IZmLine[];
+/**
+ * The CSV of one report. An original report leaves out a line that nets to
+ * zero and refuses to be written with no line left (no "Nullmeldung"); a
+ * correction keeps a `0` line, which stornos what was reported under it.
+ * Each line's sum is cut to whole euros by `zmEurosOf`. Refused beyond 1 500
+ * lines.
+ */
+export declare function writeZmCsv(linesArg: readonly IZmLine[], optionsArg: {
+    purpose: 'original' | 'correction';
+}): IZmCsv;

package/dist_ts/zm.js

@@ -0,0 +1,100 @@
+/** The country codes the ZM takes (ELSTER, "Liste der Länderkennzeichen"); `GB` only for periods before 2021, so not here. */
+export const ZM_COUNTRY_CODES = [
+    'AT', 'BE', 'BG', 'CY', 'CZ', 'DK', 'EE', 'EL', 'ES', 'FI', 'FR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', 'MT', 'NL', 'PL', 'PT', 'RO', 'SE', 'SI', 'SK', 'XI',
+];
+export const ZM_MAX_LINES = 1500;
+/** The CSV version lines and the field names, as the form's example gives them. */
+export const ZM_CSV_HEAD = [
+    '#v3.0',
+    '#ve3.2.1',
+    'Umsatzsteuer-Identifikationsnummer (USt-IdNr.),Summe (Euro),Art der Leistung',
+];
+/**
+ * How a sum with cents becomes the whole euros the CSV's "Summe (Euro)"
+ * takes. No source read states it (ELSTER: "eine ganze Zahl"; ELMA5: "in Euro
+ * ohne Cent"; the paper form: "volle EUR | Ct"). The cents are dropped toward
+ * zero, as the UStVA drops those of its bases ("in vollen Euro (ohne
+ * Centbeträge)", Anleitung zur Umsatzsteuer-Voranmeldung 2026), so that the
+ * ZM and the UStVA's Kz 41 and Kz 21, which the BZSt compares, are cut alike.
+ * This is a recorded decision of 2026-09-27, pending the tax advisor's
+ * confirmation; it is not a rule a source states.
+ */
+export const ZM_EUROS_RULE = 'the cents of each line\'s sum are dropped toward zero, as the UStVA drops those of its bases (a recorded decision of 2026-09-27, pending the tax advisor\'s confirmation; no source states the rule)';
+/**
+ * The whole euros of a sum in cents, as the CSV's "Summe (Euro)" takes them:
+ * the cents dropped toward zero (`ZM_EUROS_RULE`), so 2 000,50 € is 2000 and
+ * -2 000,50 € is -2000. At most 11 digits (N(11)).
+ */
+export function zmEurosOf(centsArg) {
+    if (!Number.isSafeInteger(centsArg)) {
+        throw new Error(`the ZM sum must be an integer number of cents, got ${centsArg}`);
+    }
+    // Math.trunc of a small negative sum is -0, which is written "0"; `+ 0` makes it a plain 0
+    const euros = Math.trunc(centsArg / 100) + 0;
+    if (String(Math.abs(euros)).length > 11) {
+        throw new Error(`the ZM sum has at most 11 digits (N(11)), got ${euros} euros`);
+    }
+    return euros;
+}
+/**
+ * A recipient's VAT ID as the form takes it: upper case, without spaces, the
+ * country code first (`GR` written `EL`, as the list has it); 7 to 14
+ * characters of letters, digits, `+` and `*`; a country code of the list.
+ */
+export function normalizeZmVatId(valueArg) {
+    let id = String(valueArg ?? '').replace(/\s+/g, '').toUpperCase();
+    if (id.startsWith('GR')) {
+        id = `EL${id.slice(2)}`;
+    }
+    if (id.length < 7 || id.length > 14) {
+        throw new Error(`a ZM VAT ID has 7 to 14 characters, got '${id}'`);
+    }
+    if (!/^[A-Z]{2}[A-Z0-9+*]+$/.test(id)) {
+        throw new Error(`a ZM VAT ID has a country code and then letters, digits, + or *, got '${id}'`);
+    }
+    if (!ZM_COUNTRY_CODES.includes(id.slice(0, 2))) {
+        throw new Error(`'${id.slice(0, 2)}' is no country code the ZM takes (another member state's, or XI)`);
+    }
+    return id;
+}
+/** The lines of a period: one per recipient VAT ID and kind, in the order they first appear, the bases summed. */
+export function aggregateZmLines(suppliesArg) {
+    const lines = new Map();
+    for (const supply of suppliesArg) {
+        if (supply.kind !== 'L' && supply.kind !== 'S' && supply.kind !== 'D') {
+            throw new Error(`a ZM kind is L, S or D, got '${String(supply.kind)}'`);
+        }
+        if (!Number.isSafeInteger(supply.baseCents)) {
+            throw new Error(`a ZM base must be an integer number of cents, got ${supply.baseCents}`);
+        }
+        const vatId = normalizeZmVatId(supply.vatId);
+        if (vatId.startsWith('XI') && supply.kind === 'S') {
+            throw new Error(`'${vatId}' is a recipient in Northern Ireland, which is Community territory for goods only: a service to it follows the rules for the third-country territory and is not reported in the ZM (BZSt, Zusammenfassende Meldung - Fragen und Antworten, Brexit)`);
+        }
+        const key = `${vatId}|${supply.kind}`;
+        const line = lines.get(key) ?? { vatId, kind: supply.kind, baseCents: 0 };
+        line.baseCents += supply.baseCents;
+        lines.set(key, line);
+    }
+    return [...lines.values()];
+}
+/**
+ * The CSV of one report. An original report leaves out a line that nets to
+ * zero and refuses to be written with no line left (no "Nullmeldung"); a
+ * correction keeps a `0` line, which stornos what was reported under it.
+ * Each line's sum is cut to whole euros by `zmEurosOf`. Refused beyond 1 500
+ * lines.
+ */
+export function writeZmCsv(linesArg, optionsArg) {
+    const lines = aggregateZmLines(linesArg).filter((lineArg) => optionsArg.purpose === 'correction' || lineArg.baseCents !== 0);
+    if (lines.length === 0) {
+        throw new Error('a ZM with no line is no report: "Nullmeldungen" are not given (BZSt Anleitung III.1)');
+    }
+    if (lines.length > ZM_MAX_LINES) {
+        throw new Error(`the ZM online form imports at most ${ZM_MAX_LINES} lines, got ${lines.length}`);
+    }
+    const rows = lines.map((lineArg) => `${lineArg.vatId},${zmEurosOf(lineArg.baseCents)},${lineArg.kind}`);
+    const text = [...ZM_CSV_HEAD, ...rows].join('\n') + '\n';
+    return { text, bytes: new TextEncoder().encode(text), lineCount: rows.length };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiem0uanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi90cy96bS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUF5REEsOEhBQThIO0FBQzlILE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUFzQjtJQUNqRCxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUksRUFBRSxJQUFJLEVBQUUsSUFBSSxFQUFFLElBQUk7Q0FDakssQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLFlBQVksR0FBRyxJQUFJLENBQUM7QUFFakMsbUZBQW1GO0FBQ25GLE1BQU0sQ0FBQyxNQUFNLFdBQVcsR0FBc0I7SUFDNUMsT0FBTztJQUNQLFVBQVU7SUFDViw4RUFBOEU7Q0FDL0UsQ0FBQztBQUVGOzs7Ozs7Ozs7R0FTRztBQUNILE1BQU0sQ0FBQyxNQUFNLGFBQWEsR0FDeEIsc01BQXNNLENBQUM7QUFFek07Ozs7R0FJRztBQUNILE1BQU0sVUFBVSxTQUFTLENBQUMsUUFBZ0I7SUFDeEMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxhQUFhLENBQUMsUUFBUSxDQUFDLEVBQUUsQ0FBQztRQUNwQyxNQUFNLElBQUksS0FBSyxDQUFDLHNEQUFzRCxRQUFRLEVBQUUsQ0FBQyxDQUFDO0lBQ3BGLENBQUM7SUFDRCwyRkFBMkY7SUFDM0YsTUFBTSxLQUFLLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxRQUFRLEdBQUcsR0FBRyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQzdDLElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxHQUFH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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fin.cx/tax",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "private": false,
   "description": "German tax computation engine: UStVA Kennzahl aggregation from ledger balances with form rounding, Zahllast and reconciliation checks — exact cents",
   "main": "dist_ts/index.js",
@@ -29,12 +29,12 @@
   "homepage": "https://code.foss.global/fin.cx/tax#readme",
   "dependencies": {
     "@fin.cx/calculation": "^1.1.1",
-    "@fin.cx/chartdata": "^2.2.0"
+    "@fin.cx/chartdata": "^2.4.0"
   },
   "devDependencies": {
     "@git.zone/tsbuild": "^5.0.0",
-    "@git.zone/tsrun": "^3.0.0",
-    "@git.zone/tstest": "^6.3.0",
+    "@git.zone/tsrun": "^3.0.1",
+    "@git.zone/tstest": "^6.3.2",
     "@types/node": "^26.6.2"
   },
   "files": [

package/readme.md

@@ -12,7 +12,7 @@ pnpm install @fin.cx/tax
 
 `computeUstva()` turns one period's account movements into the UStVA figures:
 
-- **Account→Kennzahl mapping** comes from [@fin.cx/chartdata](https://code.foss.global/fin.cx/chartdata) (SKR03/SKR04, year-versioned). Revenue accounts feed the Bemessungsgrundlagen (Kz 81, 86, 41, 43, 48, 60); Vorsteuer accounts feed the tax fields (Kz 66, 61, 67, 62) cent-exact.
+- **Account→Kennzahl mapping** comes from [@fin.cx/chartdata](https://code.foss.global/fin.cx/chartdata) (SKR03/SKR04, year-versioned). Revenue accounts feed the Bemessungsgrundlagen (Kz 81, 86, 87, 41, 43, 48, 60, 21, 45); Vorsteuer accounts feed the tax fields (Kz 66, 61, 67, 62) cent-exact. `USTVA_KENNZAHL_ORDER` lists the fields in the order of the UStVA 2026 form, with their labels in `USTVA_KENNZAHL_LABELS`; a Kennzahl the chart data maps that has no place there is a filing issue, never dropped.
 - **Form rounding is applied correctly**: Bemessungsgrundlagen are declared in full euros with cents truncated toward zero — on the *period sum per Kennzahl*, not per booking. Tax amounts stay cent-exact. Output tax on domestic and igE bases is what the form computes from the truncated bases (`base EUR × 19` is an exact integer number of cents).
 - **Output-VAT accounts** (`VAT_ACCOUNTS`, overridable per call with `vatAccounts`) follow the DATEV Kontenrahmen 2026:
 
@@ -67,6 +67,18 @@ This module aggregates whatever movements you pass in — it does not decide *wh
 
 Set `taxationMethod` so the result records which mode the figures represent. If you are unsure which regime applies to your company, resolve that before filing — it materially changes the period selection.
 
+## Zusammenfassende Meldung (§ 18a UStG)
+
+`aggregateZmLines(supplies)` sums a period's intra-Community supplies (`L`), § 3a Abs. 2 services (`S`) and triangular trade (`D`) per recipient VAT ID and kind, a later change of the base netted in; a service to a Northern Irish VAT ID (`XI`) is refused, since Northern Ireland is Community territory for goods only (BZSt ZM FAQ, Brexit). `writeZmCsv(lines, { purpose })` writes the CSV that the ZM online form in ELSTER (or the BZSt-Online-Portal) imports: CSV version 3.0, UTF-8, `#v3.0`, `#ve3.2.1`, the field names, then one line per recipient and kind, at most 1 500 lines. An original report leaves out lines that net to zero and refuses to be empty (no "Nullmeldung"); a correction keeps `0` lines, which storno what was reported. `normalizeZmVatId` takes a VAT ID as the form does (`GR` as `EL`, no spaces, a country code of the list). Transmission stays with the person: § 18a requires it authenticated.
+
+**Whole euros:** the CSV takes "eine ganze Zahl" of euros, and no source read says how cents are treated. `zmEurosOf` drops the cents of each line's sum toward zero, as the UStVA drops those of its bases (2 000,50 € is 2000, -2 000,50 € is -2000). This is a recorded decision, pending the tax advisor's confirmation (`ZM_EUROS_RULE`), not a rule a source states.
+
+## German VAT rates, dated
+
+`GERMAN_VAT_RATES` lists the rates German law sets for a supply, each with the days it applies to, which rate it is (`provision`) and the provision and act that set it (`basis`): 19 % and 7 % (§ 12 Abs. 1, 2 UStG), 16 % and 5 % in their place from 2020-07-01 to 2020-12-31 (§ 28 Abs. 1, 2 UStG), 0 % from 2023-01-01 for the photovoltaic supplies of § 12 Abs. 3 UStG (`provision: 'zero'`, Art. 16 Nr. 5 Jahressteuergesetz 2022), and the average rates of § 24 Abs. 1 Satz 1 UStG: Nr. 1 (5,5 %), Nr. 2 (19 %, 16 % in the second half of 2020 by § 28 Abs. 3 UStG) and Nr. 3. `germanVatRatesOn(day)` answers the rates of a day of supply, each once (§ 27 Abs. 1 Satz 1 UStG: the rate in force when the supply is carried out), `undefined` before 2007-01-01, where the table begins.
+
+`GERMAN_VAT_RATE_CONCESSIONS` and `germanVatRateConcessionsOn(day)` hold what the BMF letters of 30 June 2020 and 4 November 2020 say about the rates around the changes of 2020 and 2021, each with its GZ, Rz., the supplies it covers and its standing: `required` where the letter says the rate is to be applied (Beherbergungen in the night of 30 June 2020, Rz. 22 of 4 November 2020), `accepted` where it allows it or does not object (Bewirtung in that night, Rz. 44; 19 % / 7 % on supplies to entrepreneurs in July 2020 with the deduction of the stated tax, Rz. 46; 16 % / 5 % in the night of 31 December 2020, Rz. 22). Whether a supply is one they cover is the caller's fact. No letter on the § 24 changes of 2022 to 2025 was found.
+
 ## Scope
 
 Transport to ELSTER is deliberately out of scope — this package computes figures; `@fin.cx/elster` (ERiC bridge) files them. KSt/GewSt/year-end tax computation will land here as further modules.

package/ts/00_commitinfo_data.ts

@@ -3,6 +3,6 @@
  */
 export const commitinfo = {
   name: '@fin.cx/tax',
-  version: '2.0.0',
+  version: '2.1.0',
   description: 'German tax computation engine: UStVA Kennzahl aggregation from ledger balances with form rounding, Zahllast and reconciliation checks — exact cents'
 }

package/ts/index.ts

@@ -1,3 +1,5 @@
 export * from './ustva.types.js';
 export * from './ustva.accounts.js';
 export * from './ustva.js';
+export * from './zm.js';
+export * from './rates.js';

package/ts/rates.ts

@@ -0,0 +1,180 @@
+/**
+ * The rates of German VAT, dated: which rates German law sets for a supply
+ * carried out on a day, and the transition rules the administration granted
+ * around the rate changes of 2020 and 2021. The rate in force when the supply
+ * is carried out applies (§ 27 Abs. 1 Satz 1 UStG).
+ */
+
+/** A rate German law sets for a supply, and the days it applies to: from `from`, until `to` inclusive when it ended. */
+export interface IGermanVatRate {
+  ratePercent: number;
+  /** `YYYY-MM-DD` */
+  from: string;
+  /** `YYYY-MM-DD`, inclusive; absent while the rate is in force */
+  to?: string;
+  /** the rate this is: the general rate, the reduced rate, the 0 % of § 12 Abs. 3 UStG, or an average rate of § 24 Abs. 1 Satz 1 UStG by its number */
+  provision: 'general' | 'reduced' | 'zero' | 'average_nr1' | 'average_nr2' | 'average_nr3';
+  /** the provision that sets the rate for these days, and the act that set it */
+  basis: string;
+}
+
+const GENERAL = '§ 12 Abs. 1 UStG (Art. 4 Nr. 1 Haushaltsbegleitgesetz 2006, BGBl. I S. 1402)';
+const REDUCED = '§ 12 Abs. 2 UStG';
+const TEMPORARY = '§ 28 Abs. 1, 2 UStG (Art. 3 Zweites Corona-Steuerhilfegesetz, BGBl. I 2020 S. 1512)';
+const SPECIAL_AVERAGE = '§ 24 Abs. 1 Satz 1 Nr. 2 UStG';
+const FORESTRY = '§ 24 Abs. 1 Satz 1 Nr. 1 UStG (Art. 4 Nr. 2 Buchst. a Doppelbuchst. aa Haushaltsbegleitgesetz 2006)';
+const AVERAGE_OTHER = '§ 24 Abs. 1 Satz 1 Nr. 3 UStG';
+const ZERO = '§ 12 Abs. 3 UStG (Art. 16 Nr. 5 Jahressteuergesetz 2022 vom 16.12.2022, BGBl. I S. 2294, in force 2023-01-01 by its Art. 43)';
+
+/**
+ * The rates of German VAT, dated. The table begins on 2007-01-01.
+ * - The general rate, 19 % (§ 12 Abs. 1 UStG, since Art. 4 Nr. 1
+ *   Haushaltsbegleitgesetz 2006, BGBl. I S. 1402, from 2007-01-01), and the
+ *   reduced rate, 7 % (§ 12 Abs. 2 UStG). From 2020-07-01 to 2020-12-31, 16 %
+ *   and 5 % in their place (§ 28 Abs. 1, 2 UStG, Art. 3 Zweites
+ *   Corona-Steuerhilfegesetz, BGBl. I 2020 S. 1512).
+ * - § 24 Abs. 1 Satz 1 Nr. 2 UStG (Sägewerkserzeugnisse, Getränke and
+ *   alkoholische Flüssigkeiten of a farmer or forester taxed by average
+ *   rates): 19 %, the rate it states as read on gesetze-im-internet.de on
+ *   2026-09-27; 16 % from 2020-07-01 to 2020-12-31 (§ 24 Abs. 1 Satz 1 Nr. 2
+ *   i. V. m. § 28 Abs. 3 UStG, Art. 3 Zweites Corona-Steuerhilfegesetz, BGBl. I
+ *   2020 S. 1512, as the BMF letter of 30 June 2020, Rz. 1, cites it; the act's
+ *   own text was not read). That 19 % applied from 2007-01-01 is not verified
+ *   from the amending act: the table starts it there with the general rate.
+ * - The average rates of § 24 Abs. 1 Satz 1 UStG, at which a farmer or
+ *   forester taxed by them charges VAT on the invoice; the recipient deducts
+ *   it as input tax (§ 15 Abs. 1 Satz 1 Nr. 1 UStG). Each from the amending
+ *   act's text:
+ *   - Nr. 1, forestry products: 5,5 % from 2007-01-01 (Art. 4 Nr. 2
+ *     Buchst. a Doppelbuchst. aa Haushaltsbegleitgesetz 2006, "5 Prozent"
+ *     replaced by "5,5 Prozent"); unchanged since.
+ *   - Nr. 3, the other supplies: 10,7 % from 2007-01-01 (the same, Doppelbuchst.
+ *     cc, "9 Prozent" by "10,7 Prozent"); 9,5 % from 2022-01-01 (Art. 1 Nr. 5
+ *     Gesetz zur Umsetzung unionsrechtlicher Vorgaben im Umsatzsteuerrecht of
+ *     21.12.2021, BGBl. I S. 5250); 9,0 % from 2023-01-01 (Art. 12 Nr. 3 Achtes
+ *     Gesetz zur Änderung von Verbrauchsteuergesetzen of 24.10.2022, BGBl. I
+ *     S. 1838); 8,4 % from 2024-12-06 (Art. 24 Nr. 13 Jahressteuergesetz 2024
+ *     of 02.12.2024, BGBl. 2024 I Nr. 387, in force the day after its
+ *     promulgation on 2024-12-05, Art. 56 Abs. 1); 7,8 % from 2025-01-01
+ *     (Art. 25 Nr. 21 of the same, Art. 56 Abs. 7), the rate § 24 Abs. 1 Satz 1
+ *     Nr. 3 UStG states as read on gesetze-im-internet.de on 2026-09-25.
+ * - 0 % for the supplies of § 12 Abs. 3 UStG (photovoltaic installations:
+ *   the modules and components delivered to their operator, their
+ *   intra-Community acquisition, import and installation) from 2023-01-01
+ *   (Art. 16 Nr. 5 Jahressteuergesetz 2022 of 16.12.2022, BGBl. I S. 2294,
+ *   in force on 2023-01-01 by its Art. 43; the amending text as read on
+ *   buzer.de on 2026-09-28, § 12 Abs. 3 as read on gesetze-im-internet.de).
+ */
+export const GERMAN_VAT_RATES: readonly IGermanVatRate[] = [
+  { ratePercent: 19, from: '2007-01-01', to: '2020-06-30', provision: 'general', basis: GENERAL },
+  { ratePercent: 19, from: '2021-01-01', provision: 'general', basis: GENERAL },
+  { ratePercent: 7, from: '2007-01-01', to: '2020-06-30', provision: 'reduced', basis: REDUCED },
+  { ratePercent: 7, from: '2021-01-01', provision: 'reduced', basis: REDUCED },
+  { ratePercent: 0, from: '2023-01-01', provision: 'zero', basis: ZERO },
+  { ratePercent: 16, from: '2020-07-01', to: '2020-12-31', provision: 'general', basis: `${TEMPORARY}, in place of the rate of § 12 Abs. 1 UStG` },
+  { ratePercent: 5, from: '2020-07-01', to: '2020-12-31', provision: 'reduced', basis: `${TEMPORARY}, in place of the rate of § 12 Abs. 2 UStG` },
+  { ratePercent: 19, from: '2007-01-01', to: '2020-06-30', provision: 'average_nr2', basis: `${SPECIAL_AVERAGE} (the act that set 19 % from 2007-01-01 not verified)` },
+  { ratePercent: 19, from: '2021-01-01', provision: 'average_nr2', basis: `${SPECIAL_AVERAGE} (19 % as read on gesetze-im-internet.de, 2026-09-27)` },
+  { ratePercent: 16, from: '2020-07-01', to: '2020-12-31', provision: 'average_nr2', basis: `${SPECIAL_AVERAGE} i. V. m. § 28 Abs. 3 UStG (Art. 3 Zweites Corona-Steuerhilfegesetz, BGBl. I 2020 S. 1512, as cited by BMF 30.06.2020 Rz. 1)` },
+  { ratePercent: 5.5, from: '2007-01-01', provision: 'average_nr1', basis: FORESTRY },
+  { ratePercent: 10.7, from: '2007-01-01', to: '2021-12-31', provision: 'average_nr3', basis: `${AVERAGE_OTHER} (Art. 4 Nr. 2 Buchst. a Doppelbuchst. cc Haushaltsbegleitgesetz 2006)` },
+  { ratePercent: 9.5, from: '2022-01-01', to: '2022-12-31', provision: 'average_nr3', basis: `${AVERAGE_OTHER} (Art. 1 Nr. 5 Gesetz zur Umsetzung unionsrechtlicher Vorgaben im Umsatzsteuerrecht, BGBl. I 2021 S. 5250)` },
+  { ratePercent: 9, from: '2023-01-01', to: '2024-12-05', provision: 'average_nr3', basis: `${AVERAGE_OTHER} (Art. 12 Nr. 3 Achtes Gesetz zur Änderung von Verbrauchsteuergesetzen, BGBl. I 2022 S. 1838)` },
+  { ratePercent: 8.4, from: '2024-12-06', to: '2024-12-31', provision: 'average_nr3', basis: `${AVERAGE_OTHER} (Art. 24 Nr. 13 Jahressteuergesetz 2024, BGBl. 2024 I Nr. 387)` },
+  { ratePercent: 7.8, from: '2025-01-01', provision: 'average_nr3', basis: `${AVERAGE_OTHER} (Art. 25 Nr. 21 Jahressteuergesetz 2024, BGBl. 2024 I Nr. 387)` },
+];
+
+const TABLE_BEGINS = '2007-01-01';
+
+const assertDay = (dayArg: string): void => {
+  const match = /^(\d{4})-(\d{2})-(\d{2})$/.exec(dayArg);
+  const date = match ? new Date(Date.UTC(Number(match[1]), Number(match[2]) - 1, Number(match[3]))) : undefined;
+  if (!date || date.toISOString().slice(0, 10) !== dayArg) {
+    throw new Error(`a day of supply is written YYYY-MM-DD, got '${dayArg}'`);
+  }
+};
+
+/**
+ * The rates of German VAT for a supply carried out on a day (`YYYY-MM-DD`),
+ * each once, in the order of `GERMAN_VAT_RATES`. `undefined` for a day before
+ * the table begins (2007-01-01): the table holds no law for it.
+ */
+export function germanVatRatesOn(dayArg: string): readonly number[] | undefined {
+  assertDay(dayArg);
+  if (dayArg < TABLE_BEGINS) {
+    return undefined;
+  }
+  return [...new Set(GERMAN_VAT_RATES
+    .filter((rateArg) => rateArg.from <= dayArg && (rateArg.to === undefined || dayArg <= rateArg.to))
+    .map((rateArg) => rateArg.ratePercent))];
+}
+
+/**
+ * A rate the administration names for some supplies of some days around a
+ * change of the rates, with its source and the supplies it covers. Whether a
+ * supply is one of them is a fact the caller states; this table cannot tell.
+ */
+export interface IGermanVatRateConcession {
+  ratePercent: number;
+  /**
+   * `required`: the letter says the rate is to be applied ("sind … anzuwenden");
+   * `accepted`: the letter allows it or does not object to it ("wird
+   * zugelassen", "wird nicht beanstandet"), and the law's rate of the day may be
+   * applied as well.
+   */
+  standing: 'required' | 'accepted';
+  /** `YYYY-MM-DD` */
+  from: string;
+  /** `YYYY-MM-DD`, inclusive */
+  to: string;
+  /** the BMF letter, its GZ and its Rz. */
+  source: string;
+  /** the supplies it covers, and what it allows */
+  covers: string;
+}
+
+const BMF_2020_06_30 = 'BMF-Schreiben vom 30. Juni 2020, III C 2 - S 7030/20/10009 :004, BStBl I S. 584';
+const BMF_2020_11_04 = 'BMF-Schreiben vom 4. November 2020, III C 2 - S 7030/20/10009 :016';
+const NIGHT_2020_06_30_BEWIRTUNG = 'Bewirtungsleistungen (food and drink for consumption on the spot, tobacco and the like) in the night of 30 June to 1 July 2020, at the rates in force from 1 July 2020 ("wird zugelassen")';
+const NIGHT_2020_06_30_BEHERBERGUNG = 'Beherbergungen and the services that go with them in the night of 30 June to 1 July 2020, at the rates in force from 1 July 2020 ("sind … anzuwenden"; the letter of 30 June 2020, Rz. 44, had left them out)';
+const JULY_2020 = '("wird es … nicht beanstandet") a supply to an entrepreneur carried out in July 2020 whose invoice states the rate in force before 1 July 2020 and whose supplier paid that tax: the invoice need not be corrected, and a recipient entitled to deduct input tax deducts the tax as stated (for § 13b supplies, the tax the recipient computed)';
+const NIGHT_2020_12_31 = 'Bewirtungsleistungen, and Beherbergungen with the services that go with them, in the night of 31 December 2020 to 1 January 2021, at the rates of 16 and 5 percent ("wird zugelassen")';
+
+/**
+ * The transition rules of the administration around the rate changes of
+ * 1 July 2020 and 1 January 2021, each read in the letter itself (the copies of
+ * 8 July 2020 and 5 November 2020 in the Internet Archive of the PDFs on
+ * bundesfinanzministerium.de, read 2026-09-27):
+ * - Rz. 44 of the letter of 30 June 2020 allows the new rates on
+ *   Bewirtungsleistungen in the night of 30 June to 1 July 2020 (accepted), and
+ *   Rz. 22 of the letter of 4 November 2020 requires them on Beherbergungen of
+ *   that night (required), which Rz. 44 had left out.
+ * - Rz. 46 of the letter of 30 June 2020 accepts the old rates, 19 and
+ *   7 percent, on supplies to entrepreneurs in July 2020, with the input tax
+ *   deduction of the stated tax.
+ * - Rz. 22 of the letter of 4 November 2020 allows 16 and 5 percent on
+ *   Bewirtungsleistungen and Beherbergungen in the night of 31 December 2020
+ *   to 1 January 2021.
+ * Not here: Rz. 47 of the letter of 30 June 2020 applies its rules "entsprechend"
+ * to the rise on 1 January 2021; the letters grant no deduction of 16 or
+ * 5 percent stated on a supply of January 2021 beyond the night above, except
+ * for advance payment invoices issued before 2021 (4 November 2020, Rz. 1 and
+ * 2), whose case needs the invoice's date. No letter on the § 24 changes of
+ * 2022, 2023, 2024-12-06 and 2025 was found.
+ */
+export const GERMAN_VAT_RATE_CONCESSIONS: readonly IGermanVatRateConcession[] = [
+  { ratePercent: 16, standing: 'accepted', from: '2020-06-30', to: '2020-06-30', source: `${BMF_2020_06_30}, Rz. 44; ${BMF_2020_11_04}, Rz. 22`, covers: NIGHT_2020_06_30_BEWIRTUNG },
+  { ratePercent: 5, standing: 'accepted', from: '2020-06-30', to: '2020-06-30', source: `${BMF_2020_06_30}, Rz. 44; ${BMF_2020_11_04}, Rz. 22`, covers: NIGHT_2020_06_30_BEWIRTUNG },
+  { ratePercent: 16, standing: 'required', from: '2020-06-30', to: '2020-06-30', source: `${BMF_2020_11_04}, Rz. 22`, covers: NIGHT_2020_06_30_BEHERBERGUNG },
+  { ratePercent: 5, standing: 'required', from: '2020-06-30', to: '2020-06-30', source: `${BMF_2020_11_04}, Rz. 22`, covers: NIGHT_2020_06_30_BEHERBERGUNG },
+  { ratePercent: 19, standing: 'accepted', from: '2020-07-01', to: '2020-07-31', source: `${BMF_2020_06_30}, Rz. 46`, covers: JULY_2020 },
+  { ratePercent: 7, standing: 'accepted', from: '2020-07-01', to: '2020-07-31', source: `${BMF_2020_06_30}, Rz. 46`, covers: JULY_2020 },
+  { ratePercent: 16, standing: 'accepted', from: '2021-01-01', to: '2021-01-01', source: `${BMF_2020_11_04}, Rz. 22`, covers: NIGHT_2020_12_31 },
+  { ratePercent: 5, standing: 'accepted', from: '2021-01-01', to: '2021-01-01', source: `${BMF_2020_11_04}, Rz. 22`, covers: NIGHT_2020_12_31 },
+];
+
+/** The transition rules that cover a day of supply (`YYYY-MM-DD`), in the order of `GERMAN_VAT_RATE_CONCESSIONS`. */
+export function germanVatRateConcessionsOn(dayArg: string): readonly IGermanVatRateConcession[] {
+  assertDay(dayArg);
+  return GERMAN_VAT_RATE_CONCESSIONS.filter((entryArg) => entryArg.from <= dayArg && dayArg <= entryArg.to);
+}

package/ts/ustva.ts

@@ -29,9 +29,15 @@ import type {
   TKennzahlKind,
 } from './ustva.types.js';
 
-const KENNZAHL_LABELS: Record<number, string> = {
+/**
+ * The labels of the Kennzahlen this module fills. Kz 21, 45 and 87 carry the
+ * titles of their fields in ELSTER's "Anleitung zur UStVA 2026" (read
+ * 2026-09-25).
+ */
+export const USTVA_KENNZAHL_LABELS: Readonly<Record<number, string>> = {
   81: 'Steuerpflichtige Umsätze 19 %',
   86: 'Steuerpflichtige Umsätze 7 %',
+  87: 'Steuerpflichtige Lieferungen und sonstige Leistungen (0 %)',
   89: 'Innergemeinschaftliche Erwerbe 19 %',
   93: 'Innergemeinschaftliche Erwerbe 7 %',
   41: 'Steuerfreie innergemeinschaftliche Lieferungen',
@@ -42,6 +48,8 @@ const KENNZAHL_LABELS: Record<number, string> = {
   84: 'Andere Leistungen eines im Ausland ansässigen Unternehmers (§13b)',
   85: 'Steuer zu Kennzahl 84',
   60: 'Steuerpflichtige Umsätze, für die der Leistungsempfänger die Steuer schuldet (§13b)',
+  21: 'Sonstige Leistungen im übrigen Gemeinschaftsgebiet',
+  45: 'Übrige nicht steuerbare Umsätze (Leistungsort nicht im Inland)',
   66: 'Vorsteuer aus Rechnungen anderer Unternehmer',
   61: 'Vorsteuer aus innergemeinschaftlichem Erwerb',
   62: 'Entrichtete Einfuhrumsatzsteuer',
@@ -50,8 +58,17 @@ const KENNZAHL_LABELS: Record<number, string> = {
   83: 'Verbleibende Umsatzsteuer-Vorauszahlung / Überschuss',
 };
 
-/** result order follows the form sections */
-const KENNZAHL_ORDER = [81, 86, 89, 93, 41, 43, 48, 46, 47, 84, 85, 60, 66, 61, 62, 67, 39, 83];
+/**
+ * The Kennzahlen this module fills, in the order of the UStVA 2026 form
+ * (ELSTER, "Anleitung zur UStVA 2026"): taxable supplies (81, 86, 87), tax-free
+ * supplies (41, 43, 48), intra-Community acquisitions (89, 93), the tax the
+ * recipient owes (46/47, 84/85), supplies whose recipient owes the tax (60),
+ * services in the rest of the Community (21), other non-taxable turnover (45),
+ * input tax (66, 61, 62, 67), the Sondervorauszahlung (39) and the result (83).
+ * A Kennzahl computed but not listed here is reported as an issue, never
+ * dropped.
+ */
+export const USTVA_KENNZAHL_ORDER: readonly number[] = [81, 86, 87, 41, 43, 48, 89, 93, 46, 47, 84, 85, 60, 21, 45, 66, 61, 62, 67, 39, 83];
 
 /** full euros, cents truncated toward zero (form rule for bases) */
 function truncateToEur(cents: TCents): number {
@@ -242,7 +259,7 @@ export function computeUstva(input: IUstvaInput): IUstvaResult {
       kennzahl,
       kind,
       value,
-      label: KENNZAHL_LABELS[kennzahl] ?? `Kennzahl ${kennzahl}`,
+      label: USTVA_KENNZAHL_LABELS[kennzahl] ?? `Kennzahl ${kennzahl}`,
       accounts,
     });
   };
@@ -303,9 +320,17 @@ export function computeUstva(input: IUstvaInput): IUstvaResult {
     );
   }
 
-  const kennzahlen = KENNZAHL_ORDER.filter((kennzahl) => values.has(kennzahl)).map(
+  const kennzahlen = USTVA_KENNZAHL_ORDER.filter((kennzahl) => values.has(kennzahl)).map(
     (kennzahl) => values.get(kennzahl)!,
   );
+  // a figure the form order does not place would be left out of the filing: say so instead
+  for (const [kennzahl, value] of values) {
+    if (!USTVA_KENNZAHL_ORDER.includes(kennzahl)) {
+      issues.push(
+        `Kennzahl ${kennzahl} (from ${value.accounts.join(', ')}) has no place in this module's form order — it cannot be filed; add it to USTVA_KENNZAHL_ORDER`,
+      );
+    }
+  }
 
   return {
     chart: input.chart,

package/ts/zm.ts

@@ -0,0 +1,166 @@
+/**
+ * The Zusammenfassende Meldung (§ 18a UStG): its lines, and the CSV the
+ * ELSTER (or BZSt-Online-Portal) online form imports. Pure; the caller
+ * decides which supplies of which period go in (§ 18a Abs. 1, 2, 8 UStG) and
+ * transmits the form itself, authenticated, as § 18a requires.
+ *
+ * Sources, read 2026-09-25:
+ * - ELSTER, "Import von Meldelisten zur Zusammenfassenden Meldung"
+ *   (helpGlobal `zmdo_import_eop`, CSV version 3.0) and the general
+ *   "Anleitung zur Erstellung von CSV-Dateien für die Importfunktion":
+ *   UTF-8; line 1 `#v3.0`; the form's example adds `#ve3.2.1`; one line of
+ *   field names; then the lines, one per record "Meldezeilen (Satzart 1)":
+ *   USt-IdNr. AN(7,14) beginning with a country code of the list; Summe
+ *   (Euro) N(11), "eine ganze Zahl", minus allowed; Art der Leistung A(1),
+ *   `L` innergemeinschaftliche Lieferung, `S` sonstige Leistung, `D`
+ *   Dreiecksgeschäft. At most 1 500 lines. The example separates its lines
+ *   with a line feed and its fields with `,`.
+ * - BZSt, "Zusammenfassende Meldung - Fragen und Antworten"
+ *   (bzst.de …/ZusammenfassendeMeldung/FAQ/faq_zm.html, read 2026-09-27),
+ *   Brexit: a Northern Irish business has a VAT ID with `XI`; the ZM states
+ *   the intra-Community supplies, triangular trades and § 6b transfers to it,
+ *   while services to recipients in Northern Ireland follow the rules for the
+ *   third-country territory and are not reported (Art. 8 of the Protocol on
+ *   Ireland/Northern Ireland covers goods only).
+ * - BZSt, "Anleitung zur Zusammenfassenden Meldung" (USt ZM 1/2021): one line
+ *   per recipient and kind in a period, the bases summed (Tz. 8, 11); a later
+ *   change of the base netted into the period of the change, possibly
+ *   negative (Tz. 10); no "Nullmeldungen" (III.1); a correction states the
+ *   correct totals, and `0` to storno a line (Tz. 12.2, 12.3).
+ */
+import type { TCents } from '@fin.cx/calculation';
+
+/** `L` innergemeinschaftliche Warenlieferung, `S` sonstige Leistung (§ 3a Abs. 2), `D` Dreiecksgeschäft (§ 25b Abs. 2) */
+export type TZmKind = 'L' | 'S' | 'D';
+
+/** One supply (or a later change of its base) of the period: the recipient's VAT ID, its kind, the base in euro cents */
+export interface IZmSupplyInput {
+  vatId: string;
+  kind: TZmKind;
+  /** signed: a later reduction of the base is negative */
+  baseCents: TCents;
+}
+
+/** One line of the report: the recipient, the kind, the summed base in euro cents */
+export interface IZmLine {
+  vatId: string;
+  kind: TZmKind;
+  baseCents: TCents;
+}
+
+export interface IZmCsv {
+  text: string;
+  /** the text as UTF-8, as the import requires */
+  bytes: Uint8Array;
+  lineCount: number;
+}
+
+/** The country codes the ZM takes (ELSTER, "Liste der Länderkennzeichen"); `GB` only for periods before 2021, so not here. */
+export const ZM_COUNTRY_CODES: readonly string[] = [
+  'AT', 'BE', 'BG', 'CY', 'CZ', 'DK', 'EE', 'EL', 'ES', 'FI', 'FR', 'HR', 'HU', 'IE', 'IT', 'LT', 'LU', 'LV', 'MT', 'NL', 'PL', 'PT', 'RO', 'SE', 'SI', 'SK', 'XI',
+];
+
+export const ZM_MAX_LINES = 1500;
+
+/** The CSV version lines and the field names, as the form's example gives them. */
+export const ZM_CSV_HEAD: readonly string[] = [
+  '#v3.0',
+  '#ve3.2.1',
+  'Umsatzsteuer-Identifikationsnummer (USt-IdNr.),Summe (Euro),Art der Leistung',
+];
+
+/**
+ * How a sum with cents becomes the whole euros the CSV's "Summe (Euro)"
+ * takes. No source read states it (ELSTER: "eine ganze Zahl"; ELMA5: "in Euro
+ * ohne Cent"; the paper form: "volle EUR | Ct"). The cents are dropped toward
+ * zero, as the UStVA drops those of its bases ("in vollen Euro (ohne
+ * Centbeträge)", Anleitung zur Umsatzsteuer-Voranmeldung 2026), so that the
+ * ZM and the UStVA's Kz 41 and Kz 21, which the BZSt compares, are cut alike.
+ * This is a recorded decision of 2026-09-27, pending the tax advisor's
+ * confirmation; it is not a rule a source states.
+ */
+export const ZM_EUROS_RULE =
+  'the cents of each line\'s sum are dropped toward zero, as the UStVA drops those of its bases (a recorded decision of 2026-09-27, pending the tax advisor\'s confirmation; no source states the rule)';
+
+/**
+ * The whole euros of a sum in cents, as the CSV's "Summe (Euro)" takes them:
+ * the cents dropped toward zero (`ZM_EUROS_RULE`), so 2 000,50 € is 2000 and
+ * -2 000,50 € is -2000. At most 11 digits (N(11)).
+ */
+export function zmEurosOf(centsArg: TCents): number {
+  if (!Number.isSafeInteger(centsArg)) {
+    throw new Error(`the ZM sum must be an integer number of cents, got ${centsArg}`);
+  }
+  // Math.trunc of a small negative sum is -0, which is written "0"; `+ 0` makes it a plain 0
+  const euros = Math.trunc(centsArg / 100) + 0;
+  if (String(Math.abs(euros)).length > 11) {
+    throw new Error(`the ZM sum has at most 11 digits (N(11)), got ${euros} euros`);
+  }
+  return euros;
+}
+
+/**
+ * A recipient's VAT ID as the form takes it: upper case, without spaces, the
+ * country code first (`GR` written `EL`, as the list has it); 7 to 14
+ * characters of letters, digits, `+` and `*`; a country code of the list.
+ */
+export function normalizeZmVatId(valueArg: string): string {
+  let id = String(valueArg ?? '').replace(/\s+/g, '').toUpperCase();
+  if (id.startsWith('GR')) {
+    id = `EL${id.slice(2)}`;
+  }
+  if (id.length < 7 || id.length > 14) {
+    throw new Error(`a ZM VAT ID has 7 to 14 characters, got '${id}'`);
+  }
+  if (!/^[A-Z]{2}[A-Z0-9+*]+$/.test(id)) {
+    throw new Error(`a ZM VAT ID has a country code and then letters, digits, + or *, got '${id}'`);
+  }
+  if (!ZM_COUNTRY_CODES.includes(id.slice(0, 2))) {
+    throw new Error(`'${id.slice(0, 2)}' is no country code the ZM takes (another member state's, or XI)`);
+  }
+  return id;
+}
+
+/** The lines of a period: one per recipient VAT ID and kind, in the order they first appear, the bases summed. */
+export function aggregateZmLines(suppliesArg: readonly IZmSupplyInput[]): IZmLine[] {
+  const lines = new Map<string, IZmLine>();
+  for (const supply of suppliesArg) {
+    if (supply.kind !== 'L' && supply.kind !== 'S' && supply.kind !== 'D') {
+      throw new Error(`a ZM kind is L, S or D, got '${String(supply.kind)}'`);
+    }
+    if (!Number.isSafeInteger(supply.baseCents)) {
+      throw new Error(`a ZM base must be an integer number of cents, got ${supply.baseCents}`);
+    }
+    const vatId = normalizeZmVatId(supply.vatId);
+    if (vatId.startsWith('XI') && supply.kind === 'S') {
+      throw new Error(
+        `'${vatId}' is a recipient in Northern Ireland, which is Community territory for goods only: a service to it follows the rules for the third-country territory and is not reported in the ZM (BZSt, Zusammenfassende Meldung - Fragen und Antworten, Brexit)`,
+      );
+    }
+    const key = `${vatId}|${supply.kind}`;
+    const line = lines.get(key) ?? { vatId, kind: supply.kind, baseCents: 0 };
+    line.baseCents += supply.baseCents;
+    lines.set(key, line);
+  }
+  return [...lines.values()];
+}
+
+/**
+ * The CSV of one report. An original report leaves out a line that nets to
+ * zero and refuses to be written with no line left (no "Nullmeldung"); a
+ * correction keeps a `0` line, which stornos what was reported under it.
+ * Each line's sum is cut to whole euros by `zmEurosOf`. Refused beyond 1 500
+ * lines.
+ */
+export function writeZmCsv(linesArg: readonly IZmLine[], optionsArg: { purpose: 'original' | 'correction' }): IZmCsv {
+  const lines = aggregateZmLines(linesArg).filter((lineArg) => optionsArg.purpose === 'correction' || lineArg.baseCents !== 0);
+  if (lines.length === 0) {
+    throw new Error('a ZM with no line is no report: "Nullmeldungen" are not given (BZSt Anleitung III.1)');
+  }
+  if (lines.length > ZM_MAX_LINES) {
+    throw new Error(`the ZM online form imports at most ${ZM_MAX_LINES} lines, got ${lines.length}`);
+  }
+  const rows = lines.map((lineArg) => `${lineArg.vatId},${zmEurosOf(lineArg.baseCents)},${lineArg.kind}`);
+  const text = [...ZM_CSV_HEAD, ...rows].join('\n') + '\n';
+  return { text, bytes: new TextEncoder().encode(text), lineCount: rows.length };
+}