Bedienung für Shop-Betreiber
Diese Anleitung richtet sich an Shop-Betreiber und Mitarbeitende im OXID-Admin. Sie setzt keinen Server- oder Programmierzugriff voraus. Installation, Update, Datenbankprüfung und vollständige Löschung der Prüfdaten sind unter Installation für Agenturen beschrieben.
Schnellstart
Öffnen Sie .
Lassen Sie für den ersten Test alle drei Einstellungen ausgeschaltet. Dies entspricht den Modul-Standardwerten.
Prüfen Sie unter den Shop-Stammdaten, ob die deutsche Shop-USt-IdNr. korrekt hinterlegt ist. Lassen Sie die technische Einrichtung bei Bedarf von Ihrer Agentur kontrollieren.
Legen Sie einen freigegebenen Testkunden aus einem anderen EU-Land mit Firma, Rechnungsadresse und USt-IdNr. an.
Prüfen Sie Anzeige und Steuerberechnung im Kundenkonto und im Checkout.
Schließen Sie eine Testbestellung ab und kontrollieren Sie anschließend Prüfzeitpunkt und Bemerkung im Admin.
Tipp
Übernehmen Sie Firmenname und Anschrift genau in der Schreibweise, unter der das Unternehmen zur USt-IdNr. geführt wird. Schon abweichende Namen, Rechtsformen oder Ortsangaben können die qualifizierte Prüfung scheitern lassen.
Wer wird geprüft?
Das Modul prüft Kunden, wenn eine USt-IdNr. vorhanden und das Rechnungsland nicht Deutschland ist. Es greift sowohl bei angemeldeten Kunden als auch im Gast-Checkout. Die Prüfung erscheint außerdem beim Öffnen eines entsprechenden Kundendatensatzes im Admin.
Für ein ausländisches EU-Land gilt:
Eine akzeptierte Prüfung ermöglicht die umsatzsteuerfreie Berechnung.
Ohne USt-IdNr., bei einer ungültigen Antwort, bei abweichenden Pflichtdaten oder bei einem technischen Ausfall wird keine Umsatzsteuerbefreiung erteilt.
Deutsche Kunden werden vom Modul nicht online geprüft. Bei Kunden aus einem Nicht-EU-Land bleibt die reguläre OXID-Auslandsbesteuerung maßgeblich; das Modul verlangt dort keine erfolgreiche EU-USt-ID-Prüfung.
Welche Angaben werden verglichen?
Das Modul sendet folgende Daten an den Prüfdienst:
die deutsche USt-IdNr. des aktiven Shops,
die ausländische USt-IdNr. des Kunden,
Firmenname,
Ort,
Postleitzahl sowie
Straße und Hausnummer der Rechnungsadresse.
Leerzeichen und Satzzeichen in USt-IdNrn. werden für die Anfrage entfernt; die Buchstaben werden in Großschreibung übermittelt. Bei der Entscheidung müssen der Status der USt-IdNr. und der Firmenname bestätigt sein. Der Ort muss bestätigt oder vom Prüfdienst als nicht prüfbar gekennzeichnet sein. Straße und PLZ hängen von der ersten Moduleinstellung ab.
Alle Moduleinstellungen
Alle drei Schalter sind nach der Erstinstallation standardmäßig aus.
Einstellung |
Standard |
Wirkung |
|---|---|---|
Ermögliche USt-freie Bestellungen auch dann, wenn PLZ und Straße nicht korrekt sind. |
Aus |
Bei Aus müssen Straße und PLZ vom Prüfdienst bestätigt oder als nicht prüfbar gemeldet werden. Bei Ein entscheidet das Modul nur anhand von gültigem Status, bestätigtem Firmennamen und bestätigtem beziehungsweise nicht prüfbarem Ort; Abweichungen bei Straße und PLZ verhindern dann die Umsatzsteuerbefreiung nicht. |
Bei ungültiger UST-ID den Weiter-Button ausgrauen. |
Aus |
Wählt bei einer fehlgeschlagenen Prüfung einen zweiten Meldungsschlüssel. In den aktuell untersuchten deutschen und englischen Paketen haben beide Meldungsschlüssel denselben Inhalt; das Modul implementiert damit derzeit keine zuverlässige Buttonsperre. Unabhängig davon verhindert eine ungültige Prüfung die umsatzsteuerfreie Berechnung. |
Zeige Link für amtl. Bestätigung per Post im Adminbereich (Obsolet, da die neue REST API keinen direkten Druck-Link unterstützt). |
Aus |
Blendet bei erfolgreich geprüften Bestellungen einen Bestätigung-Link ein. Das Modul erzeugt dafür noch eine URL zur alten XML-Schnittstelle und übergibt die Prüfdaten als URL-Parameter. Die aktuelle REST-Schnittstelle stellt keinen direkten Druck-Link bereit; der Modulschalter ist als veraltet gekennzeichnet, der alte Link kann wirkungslos sein und sollte ausgeschaltet bleiben. |
Achtung
Die tolerantere Prüfung von Straße und PLZ korrigiert keine Kundendaten und ersetzt keine fachliche Entscheidung. Aktivieren Sie sie nur nach Abstimmung mit der für Umsatzsteuerfragen verantwortlichen Stelle.
Ablauf aus Kundensicht
Der Kunde trägt Rechnungsland, Firma, Anschrift und USt-IdNr. ein.
Im Kundenkonto beziehungsweise beim Laden des Adressschritts im Checkout fragt das Modul den externen Prüfdienst ab.
Die Seite zeigt den Status und – soweit geliefert – die Einzelresultate für Firma, Straße, PLZ und Ort mit
OKoderFehler.OXID berechnet für einen Kunden aus einem anderen EU-Land nur nach einer akzeptierten Prüfung ohne Umsatzsteuer.
Innerhalb derselben Sitzung verwendet das Modul das vorhandene Ergebnis erneut. Nach einer Änderung und Speicherung der relevanten Kundendaten wird es verworfen und neu abgefragt.
Beim Bestellabschluss erfolgt die Prüfung für den Nachweis erneut beziehungsweise wird das aktuelle Sitzungsergebnis verwendet. Ist sie erfolgreich, speichert das Modul Prüfzeitpunkt und API-Antwort.
Der externe Aufruf kann bis zu 30 Sekunden dauern. Fehlt eine verwertbare Antwort, erscheint sinngemäß, dass die Onlineprüfung momentan nicht verfügbar ist. Der Shop gewährt in diesem Fall nicht vorsorglich eine Umsatzsteuerbefreiung.
Prüfungen im Admin
Kundendaten kontrollieren
Öffnen Sie , wählen Sie den Kunden und öffnen Sie dessen Stammdaten. Bei einer vorhandenen ausländischen USt-IdNr. zeigt das Modul das aktuelle detaillierte Prüfergebnis im Formular. Da dies eine Onlineabfrage ist, kann sich das Resultat von einem historischen Bestellnachweis unterscheiden.
Bestellung kontrollieren
Öffnen Sie , wählen Sie die Bestellung und öffnen Sie die Übersicht. Im Bereich der Rechnungsadresse zeigt das Modul bei ausländischer USt-IdNr. entweder:
USt-ID Prüfung erfolgreich am: mit Datum und Uhrzeit oder
Keine erfolgreiche USt-ID Prüfung zum Bestellzeitpunkt.
Der Zeitstempel dokumentiert, dass das Modul die Prüfung akzeptiert hat. Die vollständige Antwort wird zusätzlich als Bemerkung beim Kunden gespeichert. Sie ist nicht mit einer eigenen Bestellnummer gekennzeichnet. Bei mehreren Bestellungen desselben Kunden ordnen Sie Bemerkung und Zeitpunkt daher sorgfältig zu.
Bestellung neu berechnen
Bei der Neuberechnung prüft das Modul erneut. Besitzt die Bestellung bereits einen gespeicherten erfolgreichen Prüfzeitpunkt, bewahrt es im Admin die umsatzsteuerfreie Behandlung. Verändern Sie einen solchen Nachweis nicht ohne fachliche Freigabe.
Empfohlene Grundeinstellung
Lassen Sie die Prüfung von Straße und PLZ zunächst streng, also den ersten Schalter aus.
Lassen Sie den veralteten Bestätigungslink aus.
Verlassen Sie sich nicht auf die Einstellung zum Ausgrauen des Weiter-Buttons; die aktuellen Pakete setzen damit keine zuverlässige Buttonsperre um.
Legen Sie fest, wer abweichende Firmennamen und Anschriften mit dem Kunden klärt und wer über die steuerliche Behandlung entscheidet.
Kontrollieren Sie regelmäßig, ob die deutsche Shop-USt-IdNr. für jeden Subshop korrekt ist.
Vereinbaren Sie Aufbewahrungsdauer und Löschprozess für Prüfzeitpunkte und JSON-Bemerkungen mit Buchhaltung, Datenschutz und Agentur.
Was das Modul nicht automatisch erledigt
Das Modul:
korrigiert keine USt-IdNr., Firma oder Rechnungsadresse,
trifft keine verbindliche steuerliche oder rechtliche Einzelfallentscheidung,
erstellt keine Rechnungskorrektur, Gutschrift oder Rückzahlung,
ändert keine bereits an externe Systeme übertragenen Daten,
versendet keine E-Mail an Kunden oder Mitarbeitende,
fordert über die aktuelle REST-Schnittstelle keine amtliche Bestätigung per Post an,
ordnet die gespeicherte JSON-Bemerkung nicht mit einer eigenen Bestell-ID zu und
löscht alte Prüfantworten oder Zeitstempel nicht automatisch.
Prüfung vor dem Live-Betrieb
Testen Sie gemeinsam mit Ihrer Agentur:
Gastbestellung und angemeldeten Kunden,
deutsche, EU- und Nicht-EU-Rechnungsadressen,
gültige und ungültige USt-IdNrn.,
abweichende Firma, Ort, Straße und PLZ,
beide Varianten der Straße-/PLZ-Einstellung,
das verwendete Theme mit ein- und ausgeschalteter Checkout-Sperre,
Steueranzeige in Warenkorb, Checkout, Bestellung, Rechnung und Admin,
Bestellzeitpunkt, Kundenbemerkung und Neuberechnung sowie
das Verhalten bei einem absichtlich unterbrochenen Zugang zum Prüfdienst.
Warnung
Verwenden Sie im Test nur dafür freigegebene Daten. Prüfantworten bleiben nach erfolgreicher Testbestellung in Bestellung und Kundenbemerkung gespeichert, bis sie nach dem vereinbarten Verfahren bereinigt werden.
Häufige Fehler und Lösungen
Onlineprüfung momentan nicht verfügbar
Versuchen Sie es später erneut. Bleibt die Meldung bestehen, geben Sie Zeitpunkt, Shop, Kundennummer und betroffenen Checkout-Schritt an die Agentur weiter. Sie prüft Erreichbarkeit und Serverkonfiguration. Gewähren Sie die Umsatzsteuerbefreiung nicht allein aufgrund eines technischen Ausfalls.
USt-IdNr. ist gültig, aber die Prüfung wird nicht akzeptiert
Kontrollieren Sie Firmenname einschließlich Rechtsform, Ort, PLZ, Straße und Hausnummer der Rechnungsadresse. Die Nummer kann gültig sein, während einzelne Adresswerte abweichen. Prüfen Sie außerdem, ob die richtige deutsche Shop-USt-IdNr. hinterlegt ist.
Straße oder PLZ wird als Fehler angezeigt
Korrigieren Sie zuerst die Rechnungsadresse. Soll eine ansonsten bestätigte Prüfung solche Abweichungen tolerieren, darf der erste Modulschalter nur nach betrieblicher Freigabe aktiviert werden. Die sichtbare Einzelanzeige kann die Abweichung weiterhin nennen, auch wenn sie für die Steuerentscheidung ignoriert wird.
Prüfergebnis scheint veraltet
Speichern Sie die korrigierten Kundendaten und laden Sie den Checkout neu. Das Modul verwirft dabei normalerweise das Sitzungsergebnis. Besteht die Anzeige fort, starten Sie eine neue Kundensitzung oder lassen Sie Cache und Session durch die Agentur prüfen.
Bestellung zeigt keinen erfolgreichen Prüfzeitpunkt
Dann wurde beim Bestellabschluss keine vom Modul akzeptierte Prüfung gespeichert. Prüfen Sie Steuerberechnung, Rechnungsadresse und Kundenbemerkungen und geben Sie den Fall an die fachlich verantwortliche Stelle weiter. Ein aktueller erfolgreicher Test im Kunden-Admin ersetzt den fehlenden historischen Bestellnachweis nicht.