VAT OSS Autopilot — Vollständiger Leitfaden

Überblick

VAT OSS Autopilot automatisiert die innergemeinschaftliche USt-Verwaltung Ihres WooCommerce-Shops: Echtzeit-Berechnung des Satzes des Verbrauchslandes, VIES-Validierung von B2B-USt-IdNrn. mit Reverse Charge, Erzeugung der vierteljährlichen OSS-Meldung (Übersichts-CSV, Detail-CSV, DGFiP-XML) und vollständig konfigurierbare Umsatzschwellen-Überwachung.

Voraussetzungen

• WordPress 6.2 oder höher
• WooCommerce 7.0 oder höher (getestet bis 9.4)
• PHP 7.4 mindestens (kompatibel 8.0 bis 8.3)
• PHP-Erweiterungen: SOAP (VIES-Validierung), DOM (XML-Export), ZipArchive (ZIP-Paket)
• WooCommerce-Steuern müssen aktiviert sein (WooCommerce → Einstellungen → Allgemein → Steuern aktivieren)

Installation

1. Laden Sie vat-oss-autopilot.zip aus Ihrem DataFirefly-Konto herunter.
2. Gehen Sie im WordPress-Backend zu Plugins → Installieren → Plugin hochladen.
3. Wählen Sie die ZIP-Datei, klicken Sie auf Jetzt installieren, dann Aktivieren.
4. Ein neues Menü VAT OSS erscheint in der Admin-Seitenleiste.

Bei der Aktivierung erstellt das Plugin die Tabelle wp_vat_oss_sales (OSS-Verkaufserfassung) und legt drei französische Beispiel-Schwellen an, die frei bearbeitet oder gelöscht werden können.

Erstkonfiguration

1. Steuerliche Identifikation

Gehen Sie zu VAT OSS → Einstellungen und tragen Sie ein:

• Niederlassungsland — das Land Ihrer OSS-Registrierung. Verkäufe in dieses Land werden weiterhin von Ihrer üblichen WooCommerce-Konfiguration verarbeitet (außerhalb des OSS-Bereichs).
• USt-IdNr. — Ihre innergemeinschaftliche Nummer (z. B. DE123456789). Sie erscheint im Header des Meldungs-XML.
• Firmenname, E-Mail, Telefon, IBAN, BIC — Angaben für den Operator-Block des XML.

2. VIES-Validierung

• VIES-Validierung aktivieren — fragt den Dienst der Europäischen Kommission ab, sobald eine USt-IdNr. im Checkout eingegeben wird (8-Sekunden-Timeout).
• B2B Reverse Charge anwenden — setzt die USt auf 0 % für innergemeinschaftliche Geschäftskunden mit validierter Nummer.
• VIES-Cache-Dauer — in Sekunden, standardmäßig 30 Tage (2592000). Jede validierte Nummer wird gecacht, um VIES nicht unnötig zu belasten.

3. Standard-Tätigkeitsart

Wählen Sie Waren oder Dienstleistungen. Diese Art dient der Umsatzaufteilung in den Schwellen und der OSS-Meldung. Sie können sie pro Produkt überschreiben: in jedem WooCommerce-Produkt, Tab Steuer, Feld OSS-Typ.

EU-USt-Sätze

Die Seite VAT OSS → USt-Sätze listet die 27 Mitgliedstaaten mit drei Spalten: Regelsatz, ermäßigter und stark ermäßigter Satz. Die Standardwerte sind zum Veröffentlichungsdatum des Plugins aktuell.

Der im Checkout angewandte Satz hängt von der WooCommerce-Steuerklasse des Produkts ab: die Standardklasse nutzt den Regelsatz, eine Klasse mit „reduced“ den ermäßigten, eine Klasse mit „super“ den stark ermäßigten Satz.

Verhalten im Checkout

1. Der Kunde gibt sein Rechnungsland an; das Plugin wendet automatisch den Landessatz an, wenn es sich um einen innergemeinschaftlichen OSS-relevanten Verkauf handelt.
2. Ein optionales Feld USt-IdNr. (innergemeinschaftlich) erscheint bei den Rechnungsfeldern.
3. Bei der Eingabe (600 ms Debounce) fragt eine AJAX-Validierung VIES ab und zeigt das Ergebnis: grüner Haken mit Firmennamen oder rotes Kreuz.
4. Ist die Nummer gültig und Reverse Charge aktiviert, geht die USt auf 0 % mit dem Label „USt (Reverse Charge)“ und die Summen werden neu berechnet.
5. Nummer, Validierungsstatus und Firmenname werden in den Bestell-Metadaten gespeichert.

OSS-Verkaufserfassung

Jede Bestellung mit Status Abgeschlossen oder In Bearbeitung wird in der Erfassungstabelle registriert, aufgeteilt nach USt-Satz und Produktart. Versandkosten werden dem dominanten Satz der Bestellung zugeordnet. Rückerstattungen erzeugen automatisch negative Zeilen.

Von der OSS-Meldung ausgeschlossen: inländische Verkäufe (Niederlassungsland) und B2B-Verkäufe mit validierter VIES-Nummer (Reverse Charge).

Übersicht

Die Seite VAT OSS → Übersicht zeigt für das laufende Quartal: die OSS-Nettobasis, die abzuführende USt, den Vergleich zum Vorquartal, die Anzahl der beteiligten Länder, die detaillierte Aufschlüsselung nach Land und Satz sowie den Fortschritt jeder konfigurierten Schwelle.

OSS-Meldung erzeugen

Wählen Sie in VAT OSS → OSS-Meldung Jahr und Quartal (das Vorquartal ist vorausgewählt) und klicken Sie auf das gewünschte Format:

• Übersichts-CSV — aggregiert nach Land und Satz, UTF-8 mit BOM und Semikolon-Trennung. Diese Datei dient der manuellen Portal-Erfassung.
• Detail-CSV — eine Zeile pro Bestellung und Satz, mit Bestellnummer, Kundentyp und USt-IdNr. Dient als Buchprüfungs-Audit-Trail.
• XML FR-Format — konform zum OSS-Union-Schema der DGFiP (Namespace urn:dgfip:oss:union:v1), mit Header-, Operator-, Supplies- (pro Verbrauchsland) und Totals-Blöcken. Bereit zum Hochladen auf impots.gouv.fr.
• Alles als ZIP — alle drei Dateien in einem Archiv.

Konfigurierbare Schwellen

Die Seite VAT OSS → Schwellen ermöglicht beliebig viele Schwellen. Jede Zeile umfasst:

• Bezeichnung — Freitext (z. B. „Warenverkauf“)
• Betrag und Währung — die zu überwachende Jahresgrenze
• Art — Waren, Dienstleistungen oder Alles (Gesamtumsatz)
• Warnungen (%) — kommagetrennte Stufen (z. B. 80,90,100)

Bei jeder Bestellung berechnet das Plugin den Jahresumsatz der betreffenden Art neu. Wird eine Stufe überschritten, geht eine E-Mail an die Admin-Adresse der Website und ein dauerhafter Hinweis erscheint im Backend. Jede Stufe löst nur eine Warnung pro Geschäftsjahr aus.

Drei Beispiel-Schwellen (französisches Kleinunternehmer-Regime) sind bei der Installation vorbelegt: 85.000 € Waren, 37.500 € Dienstleistungen, 25.000 € USt-Befreiung. Passen Sie sie an Ihre Situation an oder löschen Sie sie.

Wartung

• VIES-Cache leeren — Button in VAT OSS → Einstellungen, erzwingt die Neuvalidierung aller Nummern beim nächsten Checkout.
• Deaktivierung — behält alle Daten (Tabelle, Optionen, Historie).
• Deinstallation — entfernt die Tabelle wp_vat_oss_sales, alle Optionen, den VIES-Cache und die Bestell-Metadaten (einschließlich der HPOS-Tabelle wc_orders_meta).

Fehlerbehebung

Die VIES-Validierung wird nicht ausgelöst

• Prüfen Sie, ob die PHP-SOAP-Erweiterung auf dem Server installiert ist.
• Prüfen Sie, ob die Validierung in VAT OSS → Einstellungen aktiviert ist.
• VIES hat regelmäßige Wartungen seitens der Europäischen Kommission — versuchen Sie es später erneut; der Fallback mit angewandter USt schützt Ihre Bestellungen.

Der angewandte Satz entspricht nicht dem erwarteten

• Verkäufe in Ihr Niederlassungsland nutzen Ihre native WooCommerce-Konfiguration, nicht das Plugin-Verzeichnis.
• Prüfen Sie die Steuerklasse des Produkts: Sie bestimmt, ob Regelsatz, ermäßigter oder stark ermäßigter Satz verwendet wird.
• Prüfen Sie den Satz des Ziellandes in VAT OSS → USt-Sätze.

Eine Bestellung erscheint nicht in der Meldung

• Nur Bestellungen mit Status Abgeschlossen oder In Bearbeitung werden erfasst.
• B2B-Verkäufe mit validierter VIES-Nummer sind bewusst ausgeschlossen (Reverse Charge, außerhalb OSS).
• Inländische Verkäufe liegen außerhalb des OSS-Bereichs.

FAQ

Kann ich das Plugin außerhalb Frankreichs verwenden?

Ja. Das Niederlassungsland ist konfigurierbar, die Schwellen sind vollständig anpassbar und die Oberfläche gibt es in 5 Sprachen. Nur der XML-Export folgt dem französischen DGFiP-Schema; für andere nationale Portale verwenden Sie die Übersichts-CSV.

Unterstützt das Plugin das IOSS-Regime (Importe)?

Nein, diese Version deckt das OSS-Union-Regime ab (innergemeinschaftliche Verkäufe). Das IOSS-Regime für Importe unter 150 € ist nicht enthalten.

Sind die Daten DSGVO-konform?

Das Plugin speichert nur die für die Steuermeldung erforderlichen Daten: Land, Beträge, Sätze und USt-IdNr. (Geschäftsdaten). Keine Daten werden an Dritte übermittelt, abgesehen vom offiziellen VIES-Aufruf der Europäischen Kommission.