Rechenregeln wie V70: halbe Tage, Ziele 14/7, Ist-Versteuerung, Pauschale minus Einzelposten

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01AmyPfuNc4sCRfaF3oURXZz
This commit is contained in:
Claude
2026-10-19 05:16:20 +00:00
parent d6e0ee2270
commit 639980a4d1
6 changed files with 182 additions and 65 deletions

View File

@@ -1,7 +1,8 @@
// Umrechnung geplanter Stunden in Arbeitstage (Arbeitszeitkalkulation aus V70).
// Die genaue V70-Rundung wird mit der V70-Datei abgeglichen, sobald sie vorliegt.
// Umrechnung geplanter Stunden in Arbeitstage (Arbeitszeitkalkulation wie V70, calcWith):
// Tage = Stunden ÷ (Stunden pro Tag × Personen × Produktivität), danach gerundet.
export type Rundung = "auf" | "kaufmaennisch" | "halbe";
/** ganz: auf volle Tage aufrunden; halb: auf halbe Tage aufrunden; keine: auf 2 Stellen runden */
export type Rundung = "ganz" | "halb" | "keine";
export interface Arbeitszeitkalkulation {
stundenProTag: number;
@@ -10,31 +11,27 @@ export interface Arbeitszeitkalkulation {
rundung: Rundung;
}
/** Vorgabe aus V70 (AZK): 8 Std./Tag, 100 %, halbe Tage */
export const STANDARD_KALKULATION: Arbeitszeitkalkulation = {
stundenProTag: 8,
produktivitaet: 1,
rundung: "auf",
rundung: "halb",
};
const EPS = 1e-9;
/** Stunden (Dezimalzahl) in Arbeitstage; mindestens 1 Tag, sobald Stunden > 0 sind. */
export function stundenZuArbeitstagen(stunden: number, k: Arbeitszeitkalkulation = STANDARD_KALKULATION): number {
/** Stunden in Arbeitstage; 0, wenn keine Stunden geplant sind. Personen unter 1 zählen als 1. */
export function stundenZuArbeitstagen(stunden: number, k: Arbeitszeitkalkulation = STANDARD_KALKULATION, personen = 1): number {
if (!(stunden >= 0)) throw new Error(`Ungültige Stunden: ${stunden}`);
if (!(k.stundenProTag > 0) || !(k.produktivitaet > 0)) throw new Error("Ungültige Arbeitszeitkalkulation");
if (stunden === 0) return 0;
const roh = stunden / (k.stundenProTag * k.produktivitaet);
let tage: number;
const roh = stunden / (k.stundenProTag * (personen > 0 ? personen : 1) * k.produktivitaet);
switch (k.rundung) {
case "auf":
tage = Math.ceil(roh - EPS);
break;
case "kaufmaennisch":
tage = Math.floor(roh + 0.5 + EPS);
break;
case "halbe":
tage = Math.ceil(roh * 2 - EPS) / 2;
break;
case "ganz":
return Math.ceil(roh - EPS);
case "halb":
return Math.ceil(roh * 2 - EPS) / 2;
case "keine":
return Math.round(roh * 100) / 100;
}
return Math.max(tage, k.rundung === "halbe" ? 0.5 : 1);
}

View File

@@ -1,10 +1,14 @@
// Liquiditätsvorschau je Woche oder Monat.
// Grundregeln aus V70: Zahlungsziele für Kunden und Material, Umsatzsteuer, laufende Kosten.
// Offene V70-Details (Projektpauschale minus Einzelzahlungen, Freitagsregel bei
// Zahlungsterminen) werden mit der V70-Datei abgeglichen und hier ergänzt.
// Liquiditätsvorschau je Woche oder Monat, Regeln wie V70 (lqEvents):
// - Abschläge sind am Vorgangsende fällig, plus Zahlungsziel; der nicht über Abschläge
// abgerechnete Rest des Umsatzes kommt als Schlussrechnung am Projektende plus Zahlungsziel.
// - Pauschale Projektkosten fallen am Projektstart plus Zahlungsziel an; einzeln erfasste
// Kosten mindern die Pauschale anteilig und zählen zu ihrem eigenen Termin.
// - Zahlungstermine sind Kalendertage, die Freitagsregel gilt dafür nicht.
// - Umsatzsteuer: Zahllast je Zeitraum aus der Summe der Nettobeträge, einmal gerundet.
// Laufende Kosten und Startsaldo kommen neu hinzu (in V70 nicht in der Liquidität).
import { type Datum, plusTage, plusMonate, montagDerWoche, monatsErster } from "./datum.js";
import { type Cent, ustAusNetto, summe } from "./geld.js";
import { type Cent, ustAusNetto, summe, prozentVon } from "./geld.js";
import { type UstEinstellungen, STANDARD_UST, zeitraumVon, faelligkeit } from "./umsatzsteuer.js";
export type Gruppe = "Projekteinnahmen" | "Projektkosten" | "Laufende Kosten" | "Umsatzsteuer";
@@ -49,7 +53,8 @@ export interface Zahlungsziele {
sonstigeTage: number;
}
export const STANDARD_ZIELE: Zahlungsziele = { kundenTage: 14, materialTage: 30, fremdTage: 14, sonstigeTage: 0 };
/** Vorgaben aus V70: Kunden 14 Tage, Projektkosten 7 Tage ab Projektstart */
export const STANDARD_ZIELE: Zahlungsziele = { kundenTage: 14, materialTage: 7, fremdTage: 7, sonstigeTage: 7 };
export interface Vorschau {
ansicht: "woche" | "monat";
@@ -125,27 +130,29 @@ export function bewegungen(d: Daten, v: Vorschau, bis: Datum): Posten[] {
const ziele = v.ziele ?? STANDARD_ZIELE;
const ust = v.ust ?? STANDARD_UST;
const posten: Posten[] = [];
const ustJeZeitraum = new Map<string, Cent>();
const buche = (zeitraum: string, betrag: Cent) => ustJeZeitraum.set(zeitraum, (ustJeZeitraum.get(zeitraum) ?? 0) + betrag);
// Nettobasis der Zahllast je Voranmeldungszeitraum: Einnahmen minus Kosten mit Vorsteuer
const basisJeZeitraum = new Map<string, Cent>();
const buche = (zeitraum: string, netto: Cent) => basisJeZeitraum.set(zeitraum, (basisJeZeitraum.get(zeitraum) ?? 0) + netto);
for (const e of d.einnahmen) {
const steuer = ustAusNetto(e.netto, ust.satz);
const zahltag = e.bezahltAm ?? plusTage(e.termin, e.zahlungszielTage ?? ziele.kundenTage);
posten.push({ datum: zahltag, gruppe: "Projekteinnahmen", projekt: e.projekt, bezeichnung: e.bezeichnung, betrag: e.netto + steuer });
buche(zeitraumVon(ust.versteuerung === "ist" ? zahltag : e.termin, ust.voranmeldung), steuer);
buche(zeitraumVon(ust.versteuerung === "ist" ? zahltag : e.termin, ust.voranmeldung), e.netto);
}
for (const a of d.ausgaben) {
const vorsteuer = a.mitVorsteuer === false ? 0 : ustAusNetto(a.netto, ust.satz);
const zahltag = plusTage(a.termin, a.zahlungszielTage ?? zielFuer(a.art, ziele));
posten.push({ datum: zahltag, gruppe: "Projektkosten", projekt: a.projekt, bezeichnung: a.bezeichnung, betrag: -(a.netto + vorsteuer) });
if (vorsteuer) buche(zeitraumVon(a.termin, ust.voranmeldung), -vorsteuer);
if (a.mitVorsteuer !== false) buche(zeitraumVon(ust.versteuerung === "ist" ? zahltag : a.termin, ust.voranmeldung), -a.netto);
}
for (const k of d.laufend) {
for (const t of termineLaufend(k, v.start < k.start ? v.start : k.start, bis)) {
posten.push({ datum: t, gruppe: "Laufende Kosten", bezeichnung: k.bezeichnung, betrag: -k.betrag });
}
}
for (const [zeitraum, zahllast] of [...ustJeZeitraum].sort()) {
for (const [zeitraum, basis] of [...basisJeZeitraum].sort()) {
const zahllast = prozentVon(basis, ust.satz);
if (zahllast === 0) continue;
posten.push({
datum: faelligkeit(zeitraum, ust),
@@ -157,6 +164,55 @@ export function bewegungen(d: Daten, v: Vorschau, bis: Datum): Posten[] {
return posten;
}
/** Ein Projekt mit seinen Pauschalen, Zahlungen und einzeln erfassten Kosten. */
export interface ProjektPlan {
projekt: string;
umsatz: Cent;
material: Cent;
fremd: Cent;
sonstiges: Cent;
/** erster Start und letztes Ende aller Vorgänge und Meilensteine; ohne Termine fließt das Projekt nicht ein */
zeitraum?: { start: Datum; ende: Datum };
/** Abschläge (Termin = Vorgangsende) und einzeln erfasste Einnahmen */
zahlungen: Einnahme[];
/** einzeln erfasste Kosten, Termin = Zahlungstermin */
kosten: Ausgabe[];
}
function anteilig(betrag: Cent, zaehler: Cent, nenner: Cent): Cent {
if (zaehler === nenner) return betrag;
const z = BigInt(betrag) * BigInt(zaehler);
const n = BigInt(nenner);
return Number((2n * z + n) / (2n * n)); // kaufmännisch, alle Werte ≥ 0
}
/**
* Einnahmen und Ausgaben eines Projekts nach den V70-Regeln (Pauschale minus Einzelposten).
* Liefert undefined, wenn das Projekt noch keine Termine hat.
*/
export function projektBewegungen(p: ProjektPlan): { einnahmen: Einnahme[]; ausgaben: Ausgabe[] } | undefined {
if (!p.zeitraum) return undefined;
const einnahmen = [...p.zahlungen];
const rest = p.umsatz - summe(p.zahlungen.map((z) => z.netto));
if (rest > 0) einnahmen.push({ projekt: p.projekt, bezeichnung: "Schlussrechnung (Rest)", netto: rest, termin: p.zeitraum.ende });
const ausgaben = [...p.kosten];
const pauschal = p.material + p.fremd + p.sonstiges;
if (pauschal > 0) {
const bleibt = Math.max(0, pauschal - summe(p.kosten.map((k) => k.netto)));
const teile: [Kostenart, Cent, string, boolean][] = [
["material", p.material, "Material (Pauschale)", true],
["fremd", p.fremd, "Fremdleistung (Pauschale)", false],
["sonstiges", p.sonstiges, "Sonstiges (Pauschale)", false],
];
for (const [art, betrag, bezeichnung, mitVorsteuer] of teile) {
const netto = anteilig(betrag, bleibt, pauschal);
if (netto > 0) ausgaben.push({ projekt: p.projekt, bezeichnung, art, netto, termin: p.zeitraum.start, mitVorsteuer });
}
}
return { einnahmen, ausgaben };
}
export function liquiditaet(d: Daten, v: Vorschau): Periode[] {
const grenzen = periodenGrenzen(v);
if (grenzen.length === 0) return [];

View File

@@ -13,15 +13,16 @@ export interface UstEinstellungen {
satz: number;
voranmeldung: Voranmeldung;
dauerfristverlaengerung: boolean;
/** Soll: nach Rechnungsdatum. Ist: nach Zahlungseingang (offene Entscheidung E5). */
/** Soll: nach Rechnungsdatum. Ist: nach Zahlungseingang (E5: Ist-Versteuerung). */
versteuerung: Versteuerung;
}
/** Ist-Versteuerung (E5), Dauerfristverlängerung wie in V70 */
export const STANDARD_UST: UstEinstellungen = {
satz: 19,
voranmeldung: "monatlich",
dauerfristverlaengerung: false,
versteuerung: "soll",
dauerfristverlaengerung: true,
versteuerung: "ist",
};
/** Schlüssel des Voranmeldungszeitraums, z. B. "2026-03" oder "2026-Q1". */

View File

@@ -4,21 +4,24 @@ export const EinstellungenSchema = z.object({
arbeitstage: z.array(z.number().int().min(1).max(7)).default([1, 2, 3, 4]),
stundenProTag: z.number().positive().default(8),
produktivitaet: z.number().positive().max(1).default(1),
rundung: z.enum(["auf", "kaufmaennisch", "halbe"]).default("auf"),
// ältere Werte aus dem Grundgerüst werden übernommen
rundung: z
.preprocess((v) => ({ auf: "ganz", halbe: "halb", kaufmaennisch: "keine" })[v as string] ?? v, z.enum(["ganz", "halb", "keine"]))
.default("halb"),
zahlungsziele: z
.object({
kundenTage: z.number().int().min(0).default(14),
materialTage: z.number().int().min(0).default(30),
fremdTage: z.number().int().min(0).default(14),
sonstigeTage: z.number().int().min(0).default(0),
materialTage: z.number().int().min(0).default(7),
fremdTage: z.number().int().min(0).default(7),
sonstigeTage: z.number().int().min(0).default(7),
})
.prefault({}),
ust: z
.object({
satz: z.number().min(0).default(19),
voranmeldung: z.enum(["monatlich", "vierteljaehrlich"]).default("monatlich"),
dauerfristverlaengerung: z.boolean().default(false),
versteuerung: z.enum(["soll", "ist"]).default("soll"),
dauerfristverlaengerung: z.boolean().default(true),
versteuerung: z.enum(["soll", "ist"]).default("ist"),
})
.prefault({}),
startsaldo: z.number().int().default(0),

View File

@@ -53,21 +53,23 @@ describe("Zahlungsplan P9", () => {
});
});
describe("Stunden in Arbeitstage", () => {
it("rundet auf ganze Tage", () => {
describe("Stunden in Arbeitstage (wie V70)", () => {
const k = (rundung: "ganz" | "halb" | "keine", produktivitaet = 1) => ({ stundenProTag: 8, produktivitaet, rundung });
it("Vorgabe: halbe Tage, wie die Projekte in der V70-Sicherung", () => {
expect(stundenZuArbeitstagen(0)).toBe(0);
expect(stundenZuArbeitstagen(1)).toBe(1);
expect(stundenZuArbeitstagen(8)).toBe(1);
expect(stundenZuArbeitstagen(8.5)).toBe(2);
expect(stundenZuArbeitstagen(24)).toBe(3);
expect(stundenZuArbeitstagen(17)).toBe(2.5); // Staubschutzmaßnahme
expect(stundenZuArbeitstagen(60)).toBe(7.5); // Aufstockung
expect(stundenZuArbeitstagen(225)).toBe(28.5); // Fassade EFH
expect(stundenZuArbeitstagen(144, undefined, 2)).toBe(9); // Trockenbau, 2 Personen
expect(stundenZuArbeitstagen(110, undefined, 2)).toBe(7); // Unterstellplatz, 2 Personen
});
it("Produktivität verlängert", () => {
expect(stundenZuArbeitstagen(24, { stundenProTag: 8, produktivitaet: 0.75, rundung: "auf" })).toBe(4);
expect(stundenZuArbeitstagen(0.3 * 8 * 10, { stundenProTag: 8, produktivitaet: 0.3, rundung: "auf" })).toBe(10);
it("ganze Tage und Produktivität", () => {
expect(stundenZuArbeitstagen(8.5, k("ganz"))).toBe(2);
expect(stundenZuArbeitstagen(24, k("ganz", 0.75))).toBe(4);
expect(stundenZuArbeitstagen(0.3 * 8 * 10, k("ganz", 0.3))).toBe(10);
});
it("halbe Tage und kaufmännisch", () => {
expect(stundenZuArbeitstagen(10, { stundenProTag: 8, produktivitaet: 1, rundung: "halbe" })).toBe(1.5);
expect(stundenZuArbeitstagen(11, { stundenProTag: 8, produktivitaet: 1, rundung: "kaufmaennisch" })).toBe(1);
expect(stundenZuArbeitstagen(12, { stundenProTag: 8, produktivitaet: 1, rundung: "kaufmaennisch" })).toBe(2);
it("keine Rundung: zwei Nachkommastellen", () => {
expect(stundenZuArbeitstagen(10, k("keine"))).toBe(1.25);
expect(stundenZuArbeitstagen(10, k("keine"), 3)).toBe(0.42);
});
});

View File

@@ -1,5 +1,5 @@
import { describe, it, expect } from "vitest";
import { liquiditaet, periodenGrenzen, termineLaufend } from "../src/domain/liquiditaet.js";
import { liquiditaet, periodenGrenzen, termineLaufend, projektBewegungen, type ProjektPlan } from "../src/domain/liquiditaet.js";
import { faelligkeit, zeitraumVon } from "../src/domain/umsatzsteuer.js";
describe("Umsatzsteuer-Fälligkeit", () => {
@@ -41,26 +41,46 @@ describe("Perioden", () => {
describe("Liquiditätsvorschau", () => {
const vorschau = { ansicht: "monat" as const, start: "2026-11-01", anzahl: 3, startsaldo: 1_000_000 };
it("rechnet Einnahmen, Kosten, laufende Kosten und USt centgenau", () => {
const p = liquiditaet(
{
einnahmen: [{ projekt: "26-01", bezeichnung: "Anzahlung", netto: 3_000_000, termin: "2026-11-02" }],
ausgaben: [{ projekt: "26-01", bezeichnung: "KVH", art: "material", netto: 1_000_000, termin: "2026-11-05" }],
laufend: [{ bezeichnung: "Miete", betrag: 80_000, rhythmus: "monatlich", start: "2026-01-03" }],
},
vorschau,
);
// November: Anzahlung 35.700 € (Ziel 14 Tage), Miete -800 €
const daten = {
einnahmen: [{ projekt: "26-01", bezeichnung: "Anzahlung", netto: 3_000_000, termin: "2026-11-02" }],
ausgaben: [{ projekt: "26-01", bezeichnung: "KVH", art: "material" as const, netto: 1_000_000, termin: "2026-11-05" }],
laufend: [{ bezeichnung: "Miete", betrag: 80_000, rhythmus: "monatlich" as const, start: "2026-01-03" }],
};
it("Vorgaben wie V70: Ziele 14/7 Tage, Ist-Versteuerung mit Dauerfristverlängerung", () => {
const p = liquiditaet(daten, vorschau);
// November: Anzahlung 35.700 € am 16.11., Material 11.900 € am 12.11., Miete -800 €
expect(p[0]!.einnahmen).toBe(3_570_000);
expect(p[0]!.ausgaben).toBe(-80_000 - 1_190_000);
expect(p[1]!.posten.map((x) => [x.datum, x.gruppe, x.betrag])).toEqual([["2026-12-03", "Laufende Kosten", -80_000]]);
// USt November (5.700 - 1.900 = 3.800) mit Dauerfrist am 10.01.27, Sonntag -> 11.01.
expect(p[2]!.posten.map((x) => [x.datum, x.gruppe, x.betrag])).toEqual([
["2027-01-03", "Laufende Kosten", -80_000],
["2027-01-11", "Umsatzsteuer", -380_000],
]);
expect(p[2]!.kontostand).toBe(1_000_000 + 3_570_000 - 1_190_000 - 380_000 - 3 * 80_000);
});
it("Soll-Versteuerung ohne Dauerfrist, eigene Zahlungsziele", () => {
const p = liquiditaet(daten, {
...vorschau,
ziele: { kundenTage: 14, materialTage: 30, fremdTage: 14, sonstigeTage: 0 },
ust: { satz: 19, voranmeldung: "monatlich", dauerfristverlaengerung: false, versteuerung: "soll" },
});
expect(p[0]!.ausgaben).toBe(-80_000);
expect(p[0]!.kontostand).toBe(1_000_000 + 3_570_000 - 80_000);
// Dezember: Material 11.900 € (Ziel 30 Tage -> 05.12.), Miete, USt Nov (5.700 - 1.900 = 3.800) am 10.12.
expect(p[1]!.posten.map((x) => [x.datum, x.gruppe, x.betrag])).toEqual([
["2026-12-03", "Laufende Kosten", -80_000],
["2026-12-05", "Projektkosten", -1_190_000],
["2026-12-10", "Umsatzsteuer", -380_000],
]);
expect(p[2]!.kontostand).toBe(1_000_000 + 3_570_000 - 1_190_000 - 380_000 - 3 * 80_000);
});
it("Zahllast je Monat aus der Nettosumme, nur einmal gerundet", () => {
// 3 x 0,05 € netto: je Posten gerundet wären es 3 x 0,01 €, richtig sind 0,0285 € -> 0,03 €
const e = (t: string) => ({ bezeichnung: "x", netto: 5, termin: t, zahlungszielTage: 0 });
const ust = { satz: 19, voranmeldung: "monatlich" as const, dauerfristverlaengerung: false, versteuerung: "ist" as const };
const p = liquiditaet({ einnahmen: [e("2026-11-02"), e("2026-11-03"), e("2026-11-04")], ausgaben: [], laufend: [] }, { ...vorschau, ust });
expect(p[1]!.posten.filter((x) => x.gruppe === "Umsatzsteuer").map((x) => x.betrag)).toEqual([-3]);
});
it("Ist-Versteuerung verschiebt die USt in den Zahlungsmonat", () => {
@@ -80,3 +100,41 @@ describe("Liquiditätsvorschau", () => {
expect(p[0]!.einnahmen).toBe(119);
});
});
describe("Projekt nach V70-Regeln", () => {
const plan: ProjektPlan = {
projekt: "P-26-001", umsatz: 10_000_000, material: 2_000_000, fremd: 1_000_000, sonstiges: 0,
zeitraum: { start: "2026-11-02", ende: "2026-11-20" },
zahlungen: [{ projekt: "P-26-001", bezeichnung: "Abschlag Abbund", netto: 4_000_000, termin: "2026-11-10" }],
kosten: [{ projekt: "P-26-001", bezeichnung: "Leimbinder", art: "material", netto: 600_000, termin: "2026-11-15", mitVorsteuer: false }],
};
it("Rest als Schlussrechnung am Projektende, Pauschale anteilig gemindert am Projektstart", () => {
const b = projektBewegungen(plan)!;
expect(b.einnahmen.map((e) => [e.bezeichnung, e.netto, e.termin])).toEqual([
["Abschlag Abbund", 4_000_000, "2026-11-10"],
["Schlussrechnung (Rest)", 6_000_000, "2026-11-20"],
]);
// 30.000 € Pauschale - 6.000 € Einzelkosten = 80 %
expect(b.ausgaben.map((a) => [a.bezeichnung, a.netto, a.termin, a.mitVorsteuer])).toEqual([
["Leimbinder", 600_000, "2026-11-15", false],
["Material (Pauschale)", 1_600_000, "2026-11-02", true],
["Fremdleistung (Pauschale)", 800_000, "2026-11-02", false],
]);
});
it("Anteile kaufmännisch gerundet, Summe bleibt exakt", () => {
const b = projektBewegungen({ ...plan, material: 33_333, fremd: 66_667, kosten: [{ ...plan.kosten[0]!, netto: 100 }] })!;
expect(b.ausgaben.slice(1).map((a) => a.netto)).toEqual([33_300, 66_600]);
});
it("Einzelkosten über der Pauschale: keine Pauschale mehr; voll abgerechnet: kein Rest", () => {
const b = projektBewegungen({ ...plan, zahlungen: [{ ...plan.zahlungen[0]!, netto: 10_000_000 }], kosten: [{ ...plan.kosten[0]!, netto: 4_000_000 }] })!;
expect(b.einnahmen).toHaveLength(1);
expect(b.ausgaben).toHaveLength(1);
});
it("ohne Termine fließt das Projekt nicht ein", () => {
expect(projektBewegungen({ ...plan, zeitraum: undefined })).toBeUndefined();
});
});