B2B VAT - VIES validation & intra-EU reverse charge. B2B VAT validiert EU-USt-IdNrn. über den offiziellen MIAS (VIES)-Dienst, wendet automatisch die Steuerbefreiung für die innergemeinschaftliche Umkehrung der Steuerschuldnerschaft (Reverse-Charge) an und weist gültige B2B-Kunden einer konfigurierbaren Kundengruppe zu. Enthalten sind ein Validierungs-Cache, ein Verlauf im Backoffice mit manueller Überschreibung sowie ein manuelles USt-Prüfwerkzeug. Keine Programmierung, keine Theme-Änderungen.
B2B VAT validiert EU-USt-IdNrn. über den offiziellen MIAS (VIES)-Dienst, wendet automatisch die Steuerbefreiung für die innergemeinschaftliche Umkehrung der Steuerschuldnerschaft (Reverse-Charge) an und weist gültige B2B-Kunden einer konfigurierbaren Kundengruppe zu. Enthalten sind ein Validierungs-Cache, ein Verlauf im Backoffice mit manueller Überschreibung sowie ein manuelles USt-Prüfwerkzeug. Keine Programmierung, keine Theme-Änderungen.
1. Installation
- Gehen Sie im Backoffice zu Module → Modul-Manager → Modul hochladen und wählen Sie die Modul-ZIP-Datei aus.
- Klicken Sie nach der Installation auf Konfigurieren, um den Einrichtungsbildschirm zu öffnen.
.local, .test, localhost) sind immer zulässig. Sobald eine neue Version verfügbar ist, wird dies direkt im Modul angezeigt.2. Konfiguration · Schritt für Schritt
Das Backoffice des Moduls hat drei Reiter: Validierungsverlauf, USt-Prüfung und Konfigurieren. Alle Optionen befinden sich im Reiter Konfigurieren, gruppiert in Validierung, Befreiung & B2B-Gruppe, Verhalten und Daten.
Konfigurieren Reiter Konfigurieren
Legen Sie fest, wann und wie USt-IdNrn. geprüft werden, welcher Gruppe berechtigte B2B-Kunden beitreten und was passiert, wenn eine Nummer ungültig ist oder MIAS nicht erreichbar ist.
- USt-Validierung aktivieren: Hauptschalter für das gesamte Modul.
- Bei Registrierung validieren: prüft die USt-IdNr. bei der Kundenregistrierung.
- Bei Adresserstellung / -bearbeitung validieren: prüft die USt-IdNr., wenn eine Adresse gespeichert oder aktualisiert wird.
- Beim Checkout validieren: prüft die USt-IdNr. während des Bestellvorgangs.
- Übereinstimmung des von MIAS gemeldeten Namens verlangen: gewährt die Befreiung nur, wenn der von MIAS gemeldete Name mit dem Kunden-/Firmennamen übereinstimmt. Meldet MIAS keinen Namen, wird die Befreiung verweigert (Fail-Safe).
- B2B-Gruppe: Kunden mit einer laut MIAS gültigen innergemeinschaftlichen USt-IdNr. werden dieser Gruppe hinzugefügt. Stellen Sie deren Preisanzeigemethode auf netto, damit keine USt berechnet wird (Reverse-Charge).
- Steuerbefreiung für berechtigte Kunden anwenden: gewährt die Reverse-Charge-Befreiung (über die B2B-Gruppe), wenn die USt-IdNr. gültig ist, das Land in der EU liegt und sich vom Shopland unterscheidet.
- Ungültige USt-IdNr. als schwerwiegenden Fehler behandeln: ist diese Option deaktiviert (empfohlen), erzeugt eine ungültige USt-IdNr. nur eine Warnung und wird protokolliert; der Kunde wird nicht blockiert.
- Wenn MIAS nicht verfügbar ist: wählen Sie Zulassen (stumm): den Kunden niemals blockieren oder Zulassen, aber einen Hinweis „Prüfung nicht möglich, wird erneut versucht“ anzeigen. Die Nummer wird als „nicht überprüfbar“ markiert und später erneut geprüft.
- Cache-Gültigkeit (Tage): Ein gültiges/ungültiges Ergebnis wird für diese Anzahl von Tagen wiederverwendet, bevor MIAS erneut abgefragt wird (Schutz vor Ratenbegrenzung).
0deaktiviert den Cache. - Daten bei Deinstallation löschen: ist diese Option aktiviert, löscht die Deinstallation des Moduls den gesamten Validierungsverlauf. Lassen Sie sie deaktiviert, um die Datensätze über eine Neuinstallation hinweg zu erhalten.
Validierungsverlauf Reiter Verlauf
Hier wird jede USt-Prüfung protokolliert: die USt-IdNr., ihr Status (Gültig, Ungültig, Nicht überprüfbar oder Falsches Format), der von MIAS zurückgegebene Firmenname (sofern verfügbar), die Quelle (eine Live-MIAS-Abfrage oder der Cache) und der Zeitstempel. Verwenden Sie das Suchfeld und den Statusfilter, um einen Datensatz zu finden, und dann die Zeilenaktionen, um ihn live gegen MIAS erneut zu validieren, als gültig oder ungültig zu erzwingen oder zu löschen.
USt-Prüfung Reiter Prüfung
Ein manuelles Werkzeug, um jede beliebige EU-USt-IdNr. auf Anfrage zu validieren, ohne über eine Kundenregistrierung, eine Adresse oder eine Bestellung zu gehen. Wählen Sie ein Standardland (wird nur verwendet, wenn die USt-IdNr. ohne Länderpräfix eingegeben wird), geben Sie die Nummer ein und klicken Sie auf Prüfen: Das Ergebnis wird sofort angezeigt und zusätzlich im Validierungsverlauf gespeichert.
Wo der Kunde sie eingibt Shop-Frontend
Das Feld USt-IdNr. erscheint neben Firma im Registrierungsformular und im Adressformular (Mein Konto → Adressen), wie jedes andere PrestaShop-Adressfeld. Es ist optional: Kunden, die es leer lassen, werden einfach als normale Verbraucher behandelt, ohne dass eine Befreiung angewendet wird.
3. Prüfen, ob alles funktioniert
- Registrieren Sie sich (oder schließen Sie eine Bestellung ab) mit einer gültigen innergemeinschaftlichen USt-IdNr. aus einem anderen Land als dem Shopland, und prüfen Sie dann, dass die Bestellung keine USt ausweist (Reverse-Charge angewendet) und dass der Kunde der B2B-Gruppe beigetreten ist.
- Geben Sie eine ungültige USt-IdNr. ein und prüfen Sie, dass sie abgelehnt wird (oder, bei der weichen Einstellung, als Warnung protokolliert wird) und dass keine Befreiung gewährt wird.
- Öffnen Sie den Reiter Validierungsverlauf und prüfen Sie, dass jeder Versuch mit seinem Status aufgeführt ist (gültig / ungültig / nicht überprüfbar / falsches Format).
- Verwenden Sie den Reiter USt-Prüfung, um jede beliebige EU-USt-IdNr. auf Anfrage direkt gegen MIAS zu validieren.
4. Häufig gestellte Fragen
Was passiert, wenn MIAS vorübergehend nicht erreichbar ist?
Der Kunde wird niemals blockiert. Die Nummer wird als „nicht überprüfbar“ markiert und später erneut geprüft. In den Einstellungen legen Sie fest, ob stumm geblieben oder ein Hinweis „Prüfung nicht möglich, wird erneut versucht“ angezeigt wird.
Ist eine USt-IdNr. aus meinem eigenen Land befreit?
Nein. Die Reverse-Charge-Befreiung gilt nur für innergemeinschaftliche Verkäufe: eine gültige USt-IdNr. aus einem EU-Land, das sich vom Shopland unterscheidet. Inlandsverkäufe behalten ihre normale USt.
Muss ich mein Theme anpassen?
Nein. B2B VAT funktioniert über Standard-Hooks und ist mit jedem Theme kompatibel.
Kann ich eine Validierung manuell korrigieren?
Ja. Im Validierungsverlauf können Sie einen Datensatz live gegen MIAS erneut validieren, als gültig oder ungültig erzwingen oder löschen.