Innergemeinschaftliche USt. VIES-Prüfung & B2B Reverse-Charge

Dieses Modul prüft innergemeinschaftliche USt-IdNrn. gegen die VIES-Datenbank der Europäischen Kommission, wendet automatisch das Reverse-Charge-Verfahren (Rechnung mit 0 % USt.) für Ihre Geschäftskunden aus einem anderen EU-Land an und führt ein zeitgestempeltes Nachweisprotokoll — den Nachweis, den die Finanzverwaltung bei einer Prüfung verlangt.

Voraussetzungen

• PrestaShop 8.0 bis 9.x, Einzel- oder Multishop.
• PHP 7.4 bis 8.3. Die SOAP-Erweiterung wird empfohlen; andernfalls weicht das Modul automatisch auf die VIES-REST-API aus.
• Ausgehender HTTPS-Zugriff auf ec.europa.eu von Ihrem Server.

Installation

1. Gehen Sie im Back-Office zu Module > Modul-Manager > Ein Modul hochladen.
2. Wählen Sie die ZIP-Datei des Moduls aus und starten Sie die Installation.
3. Klicken Sie nach Abschluss der Installation auf Konfigurieren.

Die Installation erstellt die Protokolltabelle und einen Reiter VIES-Protokoll im Menü Bestellungen.

Konfiguration

Ihre Händler-USt-IdNr.

Tragen Sie die USt-IdNr. Ihres Unternehmens in das vorgesehene Feld ein. Sobald sie vorhanden ist, fragt jede Prüfung VIES mit einer Anforderer-Kennung ab: Die Datenbank gibt dann eine offizielle, zeitgestempelte Konsultationsnummer zurück, die gegenüber der Verwaltung belastbar ist. Dies ist die wichtigste Einstellung auf der Seite.

Niederlassungsland

Geben Sie das Land an, aus dem Sie fakturieren. Das Reverse-Charge gilt nur für Kunden, die in einem anderen EU-Land ansässig sind: Eine Bestellung in Ihr eigenes Land wird normal besteuert.

Befreiung aktivieren (Reverse-Charge)

Schaltet den automatischen Wechsel auf 0 % USt. ein oder aus. Ausgeschaltet arbeiten Prüfung und Protokoll weiter, aber die Steuer wird nie geändert — nützlich für eine Beobachtungsphase.

Echtzeitprüfung

Aktiviert den sofortigen Validierungs-Badge im Adressformular und, wenn Sie es einschalten, im Registrierungsfeld. Die Prüfung wird bei der Eingabe ausgelöst, mit einer kurzen Entprellverzögerung.

Verhalten bei VIES-Ausfall

Zwei Optionen:

• Annehmen (Standard): Die Bestellung läuft ohne Anwendung der Befreiung durch. Dies ist die wirtschaftlich sicherste Option — Sie verlieren den Verkauf nicht.
• Blockieren: Die Validierung schlägt fehl, bis VIES die Nummer bestätigt.

In beiden Fällen wird der Ausfall protokolliert und kann später per Cron erneut geprüft werden.

Gültigkeits-, Cache- und Neuprüfungsfenster

• Gültigkeit: wie lange ein gültiger Protokolleintrag die Befreiung ohne neuen Aufruf erlaubt.
• Cache: wie lange eine kürzliche Prüfung wiederverwendet wird, statt VIES erneut aufzurufen.
• Neuprüfung: das Alter, ab dem der Cron eine Nummer erneut prüft.

B2B-Kundengruppe (optional)

Wenn Sie eine Gruppe wählen, wird jeder Kunde, dessen USt-IdNr. validiert wurde, automatisch hinzugefügt — praktisch, um B2B-Preise oder -Regeln anzuwenden.

Text des Rechtshinweises auf der Rechnung

Der auf 0 %-Rechnungen gedruckte Reverse-Charge-Hinweis ist in allen fünf Sprachen anpassbar. Sie können die Variablen %vat% (USt-IdNr. des Kunden), %date% (Prüfdatum), %consultation% (Konsultationsnummer) und %name% (Firmenname) verwenden.

Die Prüfung auf Kundenseite

Wenn ein Kunde seine USt-IdNr. an der Kasse oder bei der Registrierung eingibt, erscheint ein Badge: gültig (mit dem von VIES zurückgegebenen Firmennamen), ungültig, falsches Format oder VIES nicht verfügbar. Ist die Nummer gültig und der Kunde in einem anderen EU-Land ansässig, wird seine Bestellung steuerfrei fakturiert.

Das Nachweisprotokoll

Jede Konsultation wird unter Bestellungen > VIES-Protokoll erfasst: Datum und Uhrzeit, Land, USt-IdNr., Ergebnis, Firmenname, offizielle Konsultationsnummer, Kanal (Adresse, Registrierung, Bestellung, Cron, manuell) und IP-Adresse.

Bei der Validierung einer Bestellung wird ein Nachweis-Snapshot gespeichert und mit der Bestellnummer verknüpft, wodurch jede steuerfreie Rechnung mit ihrem Nachweis verbunden wird. Das VIES-Panel auf der Bestellseite zeigt diesen Status auf einen Blick.

CSV-Export

Auf dem Protokollbildschirm erzeugt die Export-Schaltfläche eine CSV-Datei aller Konsultationen, bereit zur Übergabe an Ihren Steuerberater oder die Verwaltung.

Automatische Neuprüfung (Cron)

Die Konfigurationsseite zeigt eine token-gesicherte Cron-URL. Rufen Sie sie einmal täglich auf, um USt-IdNrn. erneut zu prüfen, deren letzte Konsultation älter wird. Jeder Durchlauf verarbeitet bis zu 25 Nummern.

Beispiel-Crontab-Eintrag:

0 4 * * * curl -s "https://ihr-shop/index.php?fc=module&module=dfviesb2b&controller=cron&token=IHR_TOKEN" > /dev/null

Der Rechtshinweis auf der Rechnung

Der Reverse-Charge-Hinweis wird automatisch auf der PDF-Rechnung in der Sprache des Kunden gedruckt, nur wenn die Rechnung tatsächlich mit 0 % USt. ausgestellt wird und ein gültiger Nachweis im Protokoll vorliegt. Auf einer normal besteuerten Rechnung wird kein Hinweis hinzugefügt.

Fehlerbehebung

Es erscheint keine Konsultationsnummer

Prüfen Sie, ob Ihre Händler-USt-IdNr. eingetragen ist: Ohne sie antwortet VIES, gibt aber keine offizielle Konsultationsnummer aus.

Der Badge bleibt auf „VIES nicht verfügbar“

Der VIES-Dienst hat auf Seiten der Europäischen Kommission regelmäßige Ausfälle. Prüfen Sie außerdem, ob Ihr Server ec.europa.eu über HTTPS erreichen kann. Der Cron holt nicht geprüfte Nummern nach.

Die Befreiung wird nicht angewendet

Stellen Sie sicher, dass der Kunde in einem anderen EU-Land als Ihrem ansässig ist, dass seine Nummer gültig und aktuell im Protokoll ist und dass die Befreiung in der Konfiguration aktiviert ist.