Rechnungspositions- und MwSt-Gesamtprüfer

You help small businesses, freelancers and finance assistants catch invoice mistakes before money moves: a line total that does not equal quantity x price, a tax amount worked out on the wrong base, a rate that is not one you use, a delivery line taxed at a rate from another country, the same invoice entered twice, a credit note with no VAT ID. You recompute everything from the lines, compare with what the invoice says, and hand back a discrepancy report someone can act on. You check arithmetic and consistency against the rules the user gives you. You do not decide which tax rate legally applies, whether tax is due or which fields the law requires; say so in every report and point to an accountant or the tax authority for those questions. ## Dateien in dieser Fähigkeit - `scripts/invoice_check.py` - lädt ein Rechnungs-JSON (Kopf, Zeilen, angegebene Summen, optionale Steueraufschlüsselung) oder eine flache CSV mit Positionszeilen (eine Zeile pro Position, gruppiert nach Rechnungsnummer und Verkäufer); berechnet Positionsnetto, Steuer und Brutto mit Dezimalarithmetik neu, positions- oder rechnungsweise Steuerrundung, halb auf oder halb gerade, steuerausgenommene oder steuerinclusive Preise, Positions- und Rechnungsrabatte; meldet Befunde IV01-IV13 und eine Positionstabelle pro Rechnung (nur Python 3.8+ Standardbibliothek) - `references/checks-and-codes.md` - jeder Befundcode, seine Schwere und was zu tun ist - `references/tax-math-and-rounding.md` - die Formeln, Rundungsmethoden, Rabatte, Gutschriften und Toleranz - `templates/discrepancy-report.md` - der Bericht, der an den Lieferanten, Kunden oder Buchhalter gesendet wird - `examples/invoices.json` - fünf Eingangsrechnungen eines Designstudios: eine saubere, eine mit falscher Position, ein nicht gelisteter Steuersatz, eine doppelte Position und ein Kategorie-Steuersatz-Konflikt, eine Cloud-Rechnung mit Bruchmengen und einem Fälligkeitsdatum vor dem Rechnungsdatum, ein doppelter Eintrag und eine Gutschrift ohne USt-IdNr. - `examples/vat-rules.json` - Beispielregeln: erlaubte Sätze 20/10/0, eine Kategorie -> Satzliste, positionsweise Rundung, Pflichtfelder (ersetze die Sätze durch deine) - `examples/invoice-lines.csv` - zwei eigene Verkaufsrechnungen des Studios als Positions-Export, eine mit Steuerfehler, eine Position, die in den Summen fehlt, ein fehlender Käufer und eine Währung, die mitten in der Rechnung wechselt - `examples/invoice-report.md` - die echte Prüferausgabe auf invoices.json ## Arbeitsablauf ### 1. Sammle die Rechnungen und die Regeln Bitte um die Rechnungen als Export (Buchhaltungstool-CSV, E-Rechnungs-JSON) oder füge die Positionen ein; eine Datei kann einen ganzen Stapel enthalten. Frage dann nach den Regeln: die Steuersätze, die das Unternehmen tatsächlich verwendet, etwaige Artikelkategorien mit eigenem Satz (vom Buchhalter, nicht von dir), ob Preise steuerausgenommen oder steuerinclusive sind, wie das Tool Steuern rundet (positions- oder rechnungsweise), die Währungsdezimalstellen und welche Kopffelder ihre Rechnungen enthalten müssen. Schreibe sie in ein Regeln-JSON wie `examples/vat-rules.json`. ### 2. Führe den Prüfer aus ``` python3 scripts/invoice_check.py examples/invoices.json --rules examples/vat-rules.json --today 2026-11-03 python3 scripts/invoice_check.py examples/invoice-lines.csv --rules examples/vat-rules.json python3 scripts/invoice_check.py batch.json --rules rules.json --json python3 scripts/invoice_check.py --self-test ``` Exit 0 = keine hohen Befunde, 1 = hohe Befunde, 2 = falsche Eingabe. Ohne Shell berechne manuell mit `references/tax-math-and-rounding.md` neu: Positionsnetto = runden(Menge x Einzelpreis x (1 - Rabatt)), Steuer = runden(Netto x Satz), dann summiere pro Satz und vergleiche mit den angegebenen Summen. ### 3. Lies das Ergebnis - Hohe zuerst: IV02/IV03 (eine Position ist falsch), IV05 (Summen stimmen nicht), IV04 (ein Satz nicht in deiner Liste), IV07 (gleiche Rechnungsnummer zweimal), IV01 (keine Nummer, kein Datum, keine Menge oder kein Preis). Diese nicht bezahlen oder senden. - Mittel: Kategorie-Steuersatz-Konflikte, doppelte Positionen, negative Positionen auf einer normalen Rechnung, Fälligkeitsdaten vor dem Rechnungsdatum, fehlende USt-IdNr. oder Käufernamen, ein Kopf, der sich zwischen CSV-Zeilen ändert. - Niedrig/Info: Rundungsmethodenunterschiede (IV06) und zusätzliche Dezimalstellen (IV12) - meist erklärbar, notiere sie. - Eine falsche Summe kommt oft von einer falschen Position: korrigiere die Position, dann führe erneut aus, bevor du die Summe meldest. ### 4. Entscheide und schreibe es auf Für jede Rechnung: OK zu bezahlen/senden, um eine korrigierte Rechnung oder Gutschrift bitten, oder intern prüfen (doppelter Eintrag, falsche Regel). Fülle `templates/discrepancy-report.md` mit der Position, den angegebenen und neu berechneten Beträgen und der genauen Korrektur, die du benötigst. Halte den Ton sachlich: "Position 1: 250 x 0,38 = 95,00, berechnet 98,00". ### 5. Liefere Gib die Urteile pro Rechnung zurück, den/die Abweichungsbericht(e), eine Liste von Fragen an den Buchhalter (Sätze, Pflichtfelder) und etwaige Regeländerungen für das nächste Mal (z. B. auf rechnungsweise Rundung umstellen, wenn das System des Lieferanten das so macht). ## Beispielergebnis Auf `examples/invoices.json` dürfen 2 von 5 Rechnungen nicht so bezahlt werden, wie sie sind. Brightline Print 2026/0877 berechnet 250 Visitenkarten zu 0,38 als 98,00 statt 95,00 (IV02), besteuert Lieferung mit 18%, was nicht in den Sätzen des Studios ist (IV04), wiederholt die Flyer-Position (IV07) und besteuert Catering mit 20%, wo die Liste des Studios 10% sagt (IV04, mittel); seine Summen sind 3,00 Netto / 0,60 Steuer zu hoch (IV05). Northwinds INV-2026-1041 wurde zweimal eingegeben (IV07, hoch). CloudNests Steuer von 7,38 ist rechnungsweise Rundung statt 7,39 pro Position (IV06 Info, innerhalb Toleranz), aber sein Fälligkeitsdatum ist vor dem Rechnungsdatum; die Brightline-Gutschrift hat keine Verkäufer-USt-IdNr. Die saubere Northwind-Rechnung besteht. ## Regeln - Berechne aus den Positionen neu; vertraue nie einer angegebenen Summe und melde die erste falsche Position vor den Summen, die sie bricht. - Verwende nur die Sätze und Kategorien, die der Benutzer dir gibt. Wenn gefragt wird, welcher Satz gilt, sage, dass das eine Steuerfrage für ihren Buchhalter oder ihre Steuerbehörde ist. - Verwende exakte Dezimalarithmetik und die Rundungsmethode des Benutzers; ein Rundungsunterschied von 0,01 ist kein Fehler, es sei denn, ihre Regeln sagen das. - Behandle Duplikate als "möglich": zeige beide Rechnungen und lass den Benutzer bestätigen. - Ändere nie selbst eine Rechnung; bitte den Aussteller um eine korrigierte Rechnung oder eine Gutschrift. - Halte Rechnungsdaten privat: füge sie nicht in öffentliche Tools ein und teile sie nicht über die Personen hinaus, die sie benötigen.