Repository navigation
Kontakte: USt-IdNr. beim BZSt bestätigen (#1385) - #1435
Conversation
Rumpf der einfachen und qualifizierten Abfrage, Schema der Antwort, Zeitpunkt mit Nanosekunden, Deutung der Status und wann nach dem Speichern eine neue Abfrage fällig ist. Abgefragt werden nur Nummern, die die Formprüfung aus #1413 bestehen. Quellen: OpenAPI-Beschreibung der eVatR-API v1.2.3 (https://api.evatr.vies.bzst.de/api-docs), GET /app/v1/info/statusmeldungen, FAQ des BZSt zur USt-IdNr. (einfache vor qualifizierter Bestätigung), gelesen 2026-11-18. Refs #1385 Co-Authored-By: Claude <noreply@anthropic.com>
…hern (#1385) Neue Tabelle ustid_bestaetigungen, nur anhängbar mit haben_append_only, Audit und Sperre gegen TRUNCATE (Sollbestand der Trigger neu erzeugt). Die Abfrage geht erst einfach, bei gültiger Nummer qualifiziert; jede Antwort zur Nummer wird sofort mit dem empfangenen Datensatz gespeichert. Fehler des Dienstes bleiben ein Hinweis ohne Wiederholung. HABEN_EVATR=off schaltet ab, EVATR_API_URL nur zum Testen. Das Jahresarchiv bekommt stammdaten/ustid-bestaetigungen.csv. Quellen: OpenAPI-Beschreibung der eVatR-API v1.2.3; UStAE 18e.1 Abs. 2, Stand 19.10.2026 (Nachweis über den empfangenen Datensatz); FAQ und Seite „Bestätigung ausländischer USt-IdNrn“ des BZSt (keine schriftliche Bestätigung, bei Zeitüberschreitung nicht sofort wiederholen). Refs #1385 Co-Authored-By: Claude <noreply@anthropic.com>
#1385) Die Kontaktseite zeigt die letzte Antwort mit dem Vergleich von Name und Anschrift, den Knopf „Beim BZSt bestätigen“ und alle Abfragen. Nach dem Anlegen und Speichern fragt sie einmal, wenn der Server es für fällig hält. In der E2E zeigen alle Server auf einen nachgebauten Dienst; eingeschaltet ist die Abfrage nur im Durchlauf belege-steuern. Refs #1385 Co-Authored-By: Claude <noreply@anthropic.com>
…1385) - Nach dem Speichern zählt nur die letzte qualifizierte Bestätigung; zurück auf einen früheren Namen fragt Haben neu (vorher reichte irgendeine frühere). - Eine Antwort ohne lesbaren Zeitpunkt oder ohne lesbares JSON meldet „ließ sich nicht lesen“ statt „Gültig“ oder „Keine Antwort“. - Die Karte zeigt oben die letzte Antwort zur aktuellen Nummer und lädt nach der Abfrage nur die Kontaktseite neu. - Die SSO-Tests schalten die Abfrage ab; Fundstelle UStAE 18e.1 Abs. 2 Sätze 3 bis 5; architektur.md nennt evatr.ts und ustid-bestaetigung, installation-konfiguration.md „unter Kontakte“. Refs #1385 Co-Authored-By: Claude <noreply@anthropic.com>
Selbstprüfung (beitrag-pruefen)Stand: 8888537, geprüft in einem frischen Agenten ohne den Verlauf der Entstehung; Nachträge unten. Wollen wir das?
Vollständig
Daher Quellen und fachlich heikel: ja (GoBD-Nachweis nach UStAE 18e.1, neue nur anhängbare Tabelle; keine Buchung, Steuer oder Meldung)
Einfachste Lösung?Jeder Teil dient einem Kriterium. Formprüfung aus Regeln
Rest ✓ (lokal: Weitere Vorschläge ohne Pflicht:
Offene Fragen an den Maintainer
Nachtrag d8cd9d6Beide ✗ und alle Vorschläge behoben; die zwei roten Tests der Selbstprüfung sind darauf grün, die neuen Testdateien 28 von 28, Typecheck grün.
Generated with Claude Code |
Doku-Prüfung (doku-pruefen)Stand: d8cd9d6, geprüft in einem frischen Agenten, unabhängig von der Selbstprüfung; nur die geänderten Befunde1. Fachliche Aussage ohne Quelle (
Der Link auf § 18e UStG im nächsten Satz belegt nur das Bestätigungsverfahren, nicht die Pflicht. Die Quellen dafür: § 6a Abs. 1 Satz 1 Nr. 4 UStG („eine ihm von einem anderen Mitgliedstaat erteilte gültige Umsatzsteuer-Identifikationsnummer verwendet“) für die Lieferung; für Reverse Charge UStAE 3a.2 Abs. 9 Sätze 4 und 5 (Stand 19.10.2026, S. 150): Mit der USt-IdNr. gilt der Kunde als Unternehmer, wenn der Leistende sich Gültigkeit, Name und Anschrift nach § 18e UStG hat bestätigen lassen. Vorschlag:
2. Ausnahmen unvollständig: REST-API fehlt (
3. Nummern mit falschem Aufbau: keine Abfrage, keine Karte, kein Wort dazu (
und in der Tabelle „Die Nummer eines anderen EU-Mitgliedstaats oder Nordirlands ( 4. Klingt, als bestätige Haben vor dem Festschreiben (
Vorher stand dort eine Handlung des Nutzers („klärst du vorher mit der Bestätigungsabfrage“). Jetzt liest es sich wie ein Schritt, den Haben vor dem Festschreiben erledigt. Das tut es nicht: Festschreiben prüft die Bestätigung nicht (
( 5. Vergessene Stelle (
Wie die geänderten Sätze in
6. Weiter als der Code, und die Regel zum zweiten Mal (
Ohne Beanstandung geprüft
Generated with Claude Code |
…1385) Pflicht zur gültigen USt-IdNr. mit § 6a Abs. 1 Satz 1 Nr. 4 UStG und UStAE 3a.2 Abs. 9 Sätze 4 und 5 belegt; Grenzen nennen den Aufbau je Land, Nordirland, REST-API und das Ändern anderswo; rechnungen.md und csv-import.md sagen, dass man die Bestätigung selbst anstößt; die Zeile zu HABEN_EVATR wiederholt die Regel aus kontakte.md nicht mehr. Refs #1385 Co-Authored-By: Claude <noreply@anthropic.com>
TDD-Review (tdd-review)Stand: d8cd9d6, unabhängig geprüft (Code, Tests, SQL, Konfiguration; die Markdown-Dateien prüft Befunde mit rotem Vitest- oder Postgres-TestKeine. Kein Verdacht in Nur mit Playwright prüfbar (im Container keine Browser), mit Nachstellung belegt1. Der neue E2E-Test wird in der CI rot – await page.getByRole("button", { name: "Speichern", exact: true }).click();
await expect(page.getByRole("status").filter({ hasText: "Gespeichert." })).toBeVisible();Direkt nach dem zweiten Klick stehen zwei Status-Banner auf der Seite: Das Formular zeigt weiter „Gespeichert. Die vorige Fassung bleibt als Version erhalten.“ ( Danach überspringt der serielle Durchlauf 2. Wer nach „Kontakt anlegen“ gleich weiterklickt, wird später auf eine kaputte Kontaktseite umgeleitet – if (bestaetigen) void navigate({ search: (s) => ({ ...s, bestaetigen: undefined }), replace: true });Das läuft über 3. Beim Wechsel zu einem anderen Kontakt fragt die Karte beim BZSt an, ohne dass gespeichert wurde – Beim Wechsel von Für 2 und 3 schlage ich einen Playwright-Test im Durchlauf Geprüft, ohne Befund
Lokal im Dev-Container mit PostgreSQL 18 (gezielt, die volle Suite läuft in der CI): Generated with Claude Code |
… Navigation (#1385) Befunde aus dem Review: Die Kontaktseite merkte sich „nach dem Speichern fragen“ als Boolean; beim Wechsel zu einem anderen Kontakt in derselben Seite fragte dessen Karte ohne Speichern beim BZSt an. Jetzt gilt das Merkzeichen je Kontakt-ID wie savedId, und die Karte entsteht je Kontakt neu (key). Den Suchparameter nach dem Anlegen nimmt die Seite gleich beim Laden weg; vorher geschah das erst nach der Antwort und ersetzte, wer schon auf „Rechnung schreiben“ war, durch /kontakte/undefined. Im E2E-Test grenzt der Selektor die Meldung „Gespeichert.“ auf das Formular ein, und ein zweiter Test spielt Wechsel über die Schnellsuche und Verlassen bei langsamer Antwort durch. Refs #1385 Co-Authored-By: Claude <noreply@anthropic.com>
Nachbesserungen nach Doku-Prüfung und TDD-ReviewTDD-Review (Kommentar), behoben in de1aa82:
Vor dem Fix mit playwright-core gegen die Dev-Instanz und einen nachgebauten Dienst mit 2,5 s Verzögerung nachgestellt: Wechsel über die Schnellsuche 2 Abfragen, „Rechnung schreiben“ endete auf Doku-Prüfung (Kommentar), behoben in 998d985:
Lokal danach: Biome, Typecheck, die drei neuen Testdateien grün. Die Beschreibung ist aktualisiert. Generated with Claude Code |
Beitragsprüfung (beitrag-pruefen, Maintainer)Danke, Thomas, das ist sauber nach dem abgestimmten Plan gebaut:
Stand: Geprüft
Zu deinen offenen Fragen: Die Abfrage läuft automatisch nur auf der Kontaktseite, sonst per Knopf. Das reicht, weil Teil 2 vor dem Festschreiben warnt. Das Zeitlimit von 20 s passt. Für die Versionshinweise nehmen wir einen Satz auf: Haben fragt jetzt Wir mergen, sobald die CI auf Generated by Claude Code |
Seit #1415 auf main heißt der Knopf der Befehlspalette „Suche“; der neue Test suchte noch „Schnellsuche“ und lief in der CI nach dem Merge mit main in die Zeitüberschreitung. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Y3rdfc4brdCss3uTQVHyAL
|
Nachtrag: Auf deinem Branch liegen jetzt zwei Commits von uns:
Biome und Typecheck sind grün. Den Test selbst prüft die CI. Wir mergen, wenn sie grün ist. Generated by Claude Code |
Erster Teil von #1385 nach dem Plan im Issue und der Antwort des Maintainers: Die USt-IdNr. eines Kontakts aus einem anderen EU-Mitgliedstaat bestätigt das BZSt über die eVatR-REST-API, und jede Antwort zur Nummer bleibt als Nachweis gespeichert. Die Prüfung vor dem Festschreiben und die ZM-Vorprüfung folgen im zweiten Pull Request.
Refs #1385
Was sich ändert
packages/core/src/evatr.ts,stammdaten/ustid-bestaetigung.ts): erst einfach, bei gültiger Nummer qualifiziert mit Name und Anschrift des Kontakts (ohne Ort nur einfach). Abgefragt werden nur Nummern, die die Formprüfung aus USt-IdNr. des Lieferanten: Format je Mitgliedstaat prüfen (ATU1234 lässt sich als § 1a buchen) #1413 bestehen (ustIdProblemundustIdAufbauProblem), deutsche nie; anfragend ist die eigene USt-IdNr. aus den Firmendaten mit gültiger Prüfziffer. Ausgewertet wirdstatus, nicht der HTTP-Code:evatr-0008steht in der OpenAPI unter 400, in den Statusmeldungen mit 403. Fehler des Dienstes, Zeitüberschreitung (20 s je Anfrage) und Antworten, die sich nicht lesen lassen (auch ohne lesbarenanfrageZeitpunkt), ergeben einen Hinweis, speichern nichts und werden nicht wiederholt; beievatr-0008bleibt es bei der einfachen Antwort.ustid_bestaetigungen(Migrationen 0289 und 0290, erzeugt auf596e23ba): je Antwort zur Nummer (evatr-0000,-2001,-2002,-2006,-2008) die gesendeten Angaben, Status, Zeitpunkt beim BZSt, Gültigkeit, Vergleich A bis D, technische ID und der empfangene Datensatz unverändert. Nur anhängbar (haben_append_only), Audit, gegenTRUNCATEgesperrt; Sollbestand der Trigger neu erzeugt.stammdaten/ustid-bestaetigungen.csvmit den Antworten des Jahres nach dem Zeitpunkt der Anfrage in deutscher Zeit, beschrieben inindex.xml.kontakt-versionen.csvund die neue Datei kommen ausarchiv/export-kontakte.ts, damityearFilesnicht weiter wächst; das Archiv bleibt sonst gleich.api.evatr.vies.bzst.de, nur vom Server.HABEN_EVATR=offschaltet sie ab; die Karte fehlt dann, außer es gibt schon Antworten.EVATR_API_URLnur zum Testen. In der E2E zeigen alle Server auf einen nachgebauten Dienst, eingeschaltet ist die Abfrage nur im Durchlaufbelege-steuern; die SSO-Tests schalten sie ab.kontakte.md(Pflicht nach § 6a Abs. 1 Satz 1 Nr. 4 UStG und UStAE 3a.2 Abs. 9 Sätze 4 und 5), Verbindungen nach außen und Module inarchitektur.md, Tabelle inarchitektur-datenmodell.md, beide Variablen ininstallation-konfiguration.md, Jahresarchiv inauswertungen.md, die Sätze zur Bestätigungsabfrage inumsatzsteuer.md,rechnungen.mdundcsv-import.md,ueberblick.md.Keine Buchung, kein Kontenrahmen und keine Versteuerungsart betroffen; SKR03/SKR04 und Ist/Soll spielen hier keine Rolle.
Quellen
GET /app/v1/info/statusmeldungen, gelesen am 2026-11-18. Eine Testabfrage mit den dort genannten Beispielwerten (DE123456789,ATU12345678) zeigte das Format der Antwort, etwaanfrageZeitpunktmit Nanosekunden; Fehler kommen in derselben Form.Geprüft
helm,cc, ERiC, Authelia, die ERiC-Doku und die Beispiele aus erica). 29 Tests in 5 Dateien schlagen fehl, die im Container ohne das Werkzeug nicht laufen:scripts/ci/doku-filter.test.tsundscripts/pr-regeln/pruefen.test.ts(keingit),deploy/backup/backup-status.test.ts(keinpsql) und die Zeitlimit-Tests inpackages/einvoice/src/render-client.test.tsundstammdaten/layouts.test.ts; die CI führt sie aus. Nach dem Rebase auf596e23badie betroffenen Dateien noch einmal: 65 von 65; nach den Nachbesserungen aus der Selbstprüfung die drei neuen Testdateien: 28 von 28.packages/core/src/evatr.test.ts(Anfrage, Antwort aus der Testabfrage, Zeitpunkt, Status, wann neu gefragt wird, auch zurück auf einen früheren Namen),stammdaten/ustid-bestaetigung.test.tsmit nachgebautem Dienst (einfach und qualifiziert gespeichert, nach dem Speichern nur bei Änderung, nicht vergebene Nummer, 503, kein Netz, unlesbare Antwort und unlesbarer Zeitpunkt ohne Speichern,evatr-0008, ohne Ort, abgeschaltet, ohne eigene USt-IdNr., deutsche Nummer, unbekannter Kontakt, nur anhängbar und im Änderungsprotokoll),archiv/export-ustid-bestaetigungen.test.ts(Jahresgrenze in deutscher Zeit, Antwort unverändert,index.xml).belege-steuern(e2e/ustid-bestaetigung.ts): (1) Anlegen fragt einfach und qualifiziert, Knopf bei Ausfall mit Hinweis ohne Speichern, Speichern mit neuer Anschrift fragt neu, ohne Änderung nicht, axe am Desktop, am Handy und in allen Themes; (2) nach dem Speichern eines Kontakts ohne USt-IdNr. fragt der Wechsel über die Schnellsuche zu einem nie bestätigten EU-Kontakt nichts an, und wer nach dem Anlegen gleich auf „Rechnung schreiben“ geht, bleibt dort, auch wenn das BZSt langsam antwortet. Lokal nicht mit dem Test-Runner gelaufen (keine Browser im Container), nur in der CI. Dieselben Abläufe habe ich mit playwright-core gegen die Dev-Instanz und einen verzögernden nachgebauten Dienst durchgespielt: vor dem Fix 2 Abfragen beim Wechsel und/kontakte/undefinedstatt/rechnungen/neu, danach 0 Abfragen und/rechnungen/neu; Anlegen und Speichern mit neuer Straße fragen weiter je zweimal.bun run lintals Ganzes meldet im Container eine lokale, git-ignorierte Datei), Typecheck aller Pakete, Doku mit Zensical--strict, PR-Regeln ohne Befund.de1aa823ohne Befund (Migrationen gegen frische Datenbank,drizzle-kit check, § 18e Nr. 1 UStG, gezielte Vitest- und E2E-Läufe). Danach Merge vonmainund der Locator im neuen E2E-Test auf „Suche“, weil Navigation: Suchfeld heißt „Suche“, alle Kürzel passen hinein (#1386) #1415 den Knopf umbenannt hat.Bilder
Rechte Spalte der Kontaktseite eines Kunden in Österreich, Testdaten; nachher nach Knopf und einem Speichern mit geänderter Straße gegen den nachgebauten Dienst.
Für den Merge
Der Pull Request bringt die Migrationen 0289 und 0290, erzeugt auf
596e23ba. Kommt vorher eine andere Migration aufmain, erzeuge ich sie neu, wenn er dran ist.Generated by Claude Code