# 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… - Seite: - Sprache: de - Aktualisiert am: 2026-07-16 - Weitere Sprachen: [fr](https://www.datafirefly.com/documentation/validation-tva-intracommunautaire-vies/index.md), [en](https://www.datafirefly.com/en/documentation/validation-tva-intracommunautaire-vies/index.md), [es](https://www.datafirefly.com/es/documentation/validation-tva-intracommunautaire-vies/index.md), [it](https://www.datafirefly.com/it/documentation/validation-tva-intracommunautaire-vies/index.md), [pl](https://www.datafirefly.com/pl/documentation/validation-tva-intracommunautaire-vies/index.md), [pt](https://www.datafirefly.com/pt/documentation/validation-tva-intracommunautaire-vies/index.md), [nl](https://www.datafirefly.com/nl/documentation/validation-tva-intracommunautaire-vies/index.md) - Index: 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. Die wichtigste Einstellung ist **Ihre eigene USt-IdNr.**: Ohne sie gibt VIES keine offizielle Konsultationsnummer aus, die der stärkste Nachweis bei einer Prüfung ist. ## 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. Das Protokoll ist **schreibgeschützt**: Keine Löschung ist möglich, und die Tabelle bleibt **auch nach der Deinstallation** des Moduls erhalten. Ein Prüfpfad ist nur dann wertvoll, wenn er manipulationssicher ist. 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. Dieses Modul automatisiert Prüfung, Befreiung und Nachweisführung. Es ersetzt nicht Ihren Steuerberater: Sie bleiben für Ihre steuerlichen Pflichten verantwortlich.