Schnittstellen, API & Automationen › VIES-UID-Prüfung
VIES-UID-Prüfung
IntegrationLive✓ Geprüft am Sat Sep 05 2026 02:00:00 GMT+0200 (Mitteleuropäische Sommerzeit)Beim Anlegen eines Firmenkunden mit EU-Umsatzsteuer-ID kann das System live beim EU-Dienst VIES nachfragen, ob die UID gültig ist und welcher Firmenname dort hinterlegt ist. Rein informativ — jeder Fehler wird ignoriert, der Kunde wird trotzdem gespeichert.
Bild folgt
Trägt das Büro bei einem Firmenkunden eine EU-Umsatzsteuer-ID ein, kann das System diese Nummer beim europäischen VIES-Dienst nachschlagen: Land und Nummer werden zerlegt und live an die Europäische Kommission geschickt. Kommt eine Antwort, meldet sie zurück, ob die UID gültig ist und welcher Firmenname dort amtlich hinterlegt ist. Die Prüfung ist ausdrücklich nur ein Hinweis, kein Zwang — egal was passiert (falsches Format, kein Netz, der Dienst antwortet nicht innerhalb weniger Sekunden), der Kunde wird trotzdem gespeichert. Die UID selbst landet bei Kunden & Fahrzeuge und spielt bei den Rechnungspflichtangaben eine Rolle, sobald ein Betrag eine bestimmte Grenze übersteigt.
- Ohne Prüfung gespeicherte UID sieht man der Kundenkarte nicht an, ob sie gültig ist → das ist so vorgesehen, die Prüfung blockiert nichts und muss eigens angestoßen werden.
- Der EU-Dienst antwortet nicht rechtzeitig oder ist gerade nicht erreichbar → das Ergebnis gilt dann als ungültig mit Fehlerhinweis, nicht als bestätigt falsch; einfach später erneut prüfen.
- Kein expliziter Live-Nachweis in Memory gefunden — Status auf Code-Analyse gestützt, nicht auf einen bestätigten Produktivlauf.
- In der Büro-Oberfläche wurde kein Knopf oder Feld gefunden, der die Prüfung sichtbar auslöst — der Code-Weg existiert, ob und wo ihn jemand tatsächlich anstößt, bleibt unklar (zu prüfen).
- Ist die Europäische Kommission für diese Abfrage ein Auftragsverarbeiter im Sinne der DSGVO? Kein Vertrag dazu gefunden, rechtliche Einordnung nicht geprüft.
- lib/vies.ts
- app/api/admin/customers/[id]/route.ts
| richtung | ausgehend (Abfrage) + eingehend (Ergebnis) |
|---|---|
| ausloeser | user action (Kunde mit UID anlegen/bearbeiten) |
| envVars | keine |
| status_prod | vermutlich live (kein Feature-Flag, keine Zugangsdaten nötig), aber kein expliziter Prod-Beleg in Memory gefunden |
| kosten_vertrag | kostenloser öffentlicher EU-Dienst, kein Vertrag nötig |
| ohne | UID wird ungeprüft übernommen, kein Hinweis auf Gültigkeit |
| daten | UID-Nummer (Geschäftsdaten, keine Privatperson-PII) |
| anbieter | Europäische Kommission (VIES-REST-Dienst) |
| daten_die_das_haus_verlassen | ja — die eingegebene UID (Geschäftsdaten, keine Privatperson-PII) geht an den EU-Dienst |
| verarbeiter | unklar — öffentliche EU-Behörde ohne erkennbaren Auftragsverarbeitungsvertrag, rechtliche Einordnung nicht geprüft |
| zustaendig | Büro |
| kosten | keine — kostenloser öffentlicher EU-Dienst |
| vertrag | kein Vertrag nötig, öffentlicher EU-Dienst ohne Registrierung |
Beleg: lib/vies.ts:1-16 ('GAP-016 — Optionaler VIES-Check ... checkVies(uid) fragt den EU-VIES-REST-Dienst ab'); kein Env-Var nötig (öffentlicher EU-Dienst, keine Zugangsdaten)
Tiefer fragen
Kontext aus dem KFZ-Bozo-Handbuch
Knoten: int-vies (Integration · Schnittstellen, API & Automationen · live · geprüft Sat Sep 05 2026 02:00:00 GMT+0200 (Mitteleuropäische Sommerzeit) @ e62d1c00)
Kurz: Beim Anlegen eines Firmenkunden mit EU-Umsatzsteuer-ID kann das System live beim EU-Dienst VIES nachfragen, ob die UID gültig ist und welcher Firmenname dort hinterlegt ist. Rein informativ — jeder Fehler wird ignoriert, der Kunde wird trotzdem gespeichert.
Lies zuerst (Lesebereich, nicht der ganze Baum):
lib/vies.ts
app/api/admin/customers/[id]/route.ts
Hängt zusammen mit:
data-kunde-fahrzeug (lib/db/schema.ts) · comp-ustg11 (MEM:austria-billing-compliance.md)
Offene Fragen der Seite:
Kein expliziter Live-Nachweis in Memory gefunden — Status auf Code-Analyse gestützt, nicht auf einen bestätigten Produktivlauf.
In der Büro-Oberfläche wurde kein Knopf oder Feld gefunden, der die Prüfung sichtbar auslöst — der Code-Weg existiert, ob und wo ihn jemand tatsächlich anstößt, bleibt unklar (zu prüfen).
Ist die Europäische Kommission für diese Abfrage ein Auftragsverarbeiter im Sinne der DSGVO? Kein Vertrag dazu gefunden, rechtliche Einordnung nicht geprüft.
Hausregel 2: Vault-Daten sind für diese Session unsichtbar; Quellpfade auf Vault-Code sind keine Freigabe.
Frage: {{DEINE FRAGE}}
Antworte nur mit Belegen: nenne Datei und Zeile für jede Aussage.
Wenn die Quellen die Frage nicht beantworten, sag das und nenne, was du zusätzlich lesen müsstest.
Weicht die Seite vom Code ab, schlage den Seiten-Patch vor (wiki/seiten/schnittstellen-automation/int-vies.md).