USt-IdNr. prüfen – Konfigurationsanleitung
==========================================
Wichtiger Hinweis
Die Prüfung erfolgt über einen externen Dienst. Für die Richtigkeit der Ergebnisse können wir daher
keine Garantie übernehmen. Die App unterstützt Sie bei der Prüfung, ersetzt aber nicht Ihre eigene
Sorgfaltspflicht: Bitte prüfen Sie USt-IdNr., Firmendaten und Adressen – insbesondere vor einer
steuerfreien Lieferung – zusätzlich sorgfältig selbst.
1. Voraussetzungen
------------------
- Shopware 6.6 oder 6.7. In-App-Käufe (Plus/Premium) ab Shopware 6.6.9.
- Unter Einstellungen → Login/Registrierung die Option „Auswahl zwischen Geschäfts- und Kundenkonto
anzeigen“ aktivieren. Nur so gibt es bei der Registrierung ein Geschäftskonto mit USt-IdNr.
- Beim Installieren bzw. Aktualisieren der App den angefragten Berechtigungen zustimmen. Ohne sie
können Prüfvermerk, Status-Tags und der Button „USt-Id jetzt prüfen“ nicht arbeiten.
Die Konfiguration finden Sie unter Erweiterungen → Meine Erweiterungen → USt ID prüfen → Konfigurieren.
2. Karte „Einstellungen“
------------------------
Aktiv
Schaltet die Prüfung ein. Ohne diese Option prüft die App weder bei der Registrierung noch im Checkout.
Anmeldung/Profil bearbeiten nur mit gültiger USt-Id
Geschäftskunden können sich nur mit gültiger USt-IdNr. registrieren bzw. ihr Profil speichern.
Ist die Option aus, wird bei Registrierung und Profil nicht blockiert.
Bestellung nur mit gültiger USt-Id
Geschäftskunden können nur mit gültiger USt-IdNr. bestellen. Als Geschäftskunde gilt, wer den
Kontotyp „Geschäftlich“, einen Firmennamen oder eine USt-IdNr. im Kundenkonto hat.
Bestellungen automatisch nachprüfen (Premium)
War der Prüfdienst beim Bestellen nicht erreichbar, wird die USt-IdNr. stündlich automatisch
nachgeprüft und der Prüfvermerk an der Bestellung ergänzt. Nur mit dem Tarif Premium wirksam.
USt-Id bei der Eingabe in Großbuchstaben umwandeln
Wandelt z. B. „se123…“ beim Tippen in „SE123…“ um. Empfohlen, wenn Sie in den Ländereinstellungen
das Prüfmuster für USt-IdNrn. nutzen, da Shopware dort Groß- und Kleinschreibung unterscheidet.
Anmeldung mit keiner USt-Id erlauben / Bestellung mit keiner USt-Id erlauben
Geschäftskunden dürfen sich ohne USt-IdNr. registrieren bzw. ohne USt-IdNr. bestellen.
Ist eine USt-IdNr. eingetragen, wird sie trotzdem geprüft.
Prüfung für folgende Länder ignorieren
Für diese Länder findet keine Prüfung statt, z. B. für Nicht-EU-Länder wie Schweiz oder Norwegen.
Maßgeblich ist bei der Registrierung das Land der Adresse, im Checkout das Lieferland.
Steuerfreie Bestellung Checkout Hinweis anzeigen außer bei folgenden Lieferländern
Zeigt im Checkout den Hinweis zur steuerfreien Bestellung an, außer bei den gewählten Lieferländern
(typischerweise Ihr eigenes Land).
Steuerfreie Bestellung Checkout Hinweis anzeigen in css Klasse
Stelle im Checkout, an der der Hinweis erscheint. Standard: .checkout-container .checkout-aside-action
Nur ändern, wenn Ihr Theme einen anderen Aufbau hat.
Service anfrage timeout ms
So lange wartet der Shop auf das Prüfergebnis (Standard 5000 = 5 Sekunden). Danach gilt der
Prüfdienst als nicht erreichbar.
3. Karte „Meldungen“
--------------------
Alle Hinweise, die Ihre Kunden sehen, sind Textbausteine und pro Sprache anpassbar.
Platzhalter, die erhalten bleiben sollten:
- %company%, %street%, %zipcode%, %city%, %country%: Wert aus der Prüfung
- %buttonJa% (Deutsch) bzw. %buttonYes% (Englisch): Button, mit dem der Kunde den Wert übernimmt
- in „Fehlermeldung, wenn Lieferadresse nicht zu USt-Id Adresse passt“ zusätzlich die Platzhalter
der Lieferadresse wie %companyShipping% und %countryShipping%
Besonders wichtig:
- „Hinweis, wenn Service nicht erreichbar“: erscheint, wenn der Prüfdienst nicht antwortet und die
Anmeldung bzw. Bestellung in diesem Fall nicht erlaubt ist.
4. Karte „Erweiterte Einstellungen“
-----------------------------------
Ausfüllen, wenn Felder leer mit USt-Id Daten
Füllt bei der Registrierung leere Felder (Firma, Straße, PLZ, Ort, Land) mit den Daten aus der
Prüfung, sofern der Prüfdienst sie liefert.
Anmeldung mit unterschiedlicher Lieferadresse zu USt-Id Adresse ermöglichen
Bei der Registrierung wird die Adresse nicht mit den Firmendaten verglichen.
Anmeldung erlauben, wenn USt-Id Adresse leer ist
Registrierung zulassen, wenn der Prüfdienst keine Adresse liefert. Empfohlen, da das bei vielen
Ländern (z. B. Deutschland) der Fall ist.
Anmeldung Lieferland muss mit USt-Id Land übereinstimmen
Das Land der Adresse muss zum Land der USt-IdNr. passen.
Anmeldung erlauben, wenn Service nicht erreichbar
Ist der Prüfdienst nicht erreichbar, kann sich der Kunde trotzdem registrieren. Sonst erscheint
der Hinweis aus der Karte „Meldungen“.
Bestellung erlauben wenn Lieferadresse von USt-Id Adresse abweicht
Im Checkout wird die Lieferadresse nicht mit den Firmendaten verglichen.
Bestellung erlauben wenn USt-Id Adresse leer ist
Bestellung zulassen, wenn der Prüfdienst keine Adresse liefert. Empfohlen (siehe oben).
Lieferland muss mit USt-Id Land übereinstimmen
Im Checkout muss das Lieferland zum Land der USt-IdNr. passen.
Adresscheck bei Bestellung ignorieren, wenn Steuern bezahlt werden
Fällt Mehrwertsteuer an (keine steuerfreie Lieferung), wird die Adresse im Checkout nicht verglichen.
Bestellung erlauben, wenn Service nicht erreichbar
Ist der Prüfdienst nicht erreichbar, kann trotzdem bestellt werden. Die Bestellung wird dann als
„ungeprüft“ markiert und kann später geprüft werden: über den Button „USt-Id jetzt prüfen“ oder
mit Premium automatisch.
5. Empfohlene Einstellungen
---------------------------
Typischer B2B-Shop (sicher, ohne Kunden unnötig abzuweisen)
- Aktiv: an
- Anmeldung/Profil nur mit gültiger USt-Id: an
- Bestellung nur mit gültiger USt-Id: an
- Prüfung ignorieren für: Nicht-EU-Länder
- Anmeldung erlauben, wenn USt-Id Adresse leer ist: an
- Bestellung erlauben, wenn USt-Id Adresse leer ist: an
- Bestellung erlauben, wenn Service nicht erreichbar: an (mit Premium automatisch nachgeprüft)
- Ausfüllen, wenn Felder leer mit USt-Id Daten: an
Streng (nur geprüfte Kunden und Bestellungen)
- wie oben, aber „Anmeldung erlauben, wenn Service nicht erreichbar“ und
„Bestellung erlauben, wenn Service nicht erreichbar“ aus
- zusätzlich „Lieferland muss mit USt-Id Land übereinstimmen“ an
6. Im Shopware-Admin
--------------------
Bestellungen → USt-Id-Prüfung
Ihr Tarif, Prüfungen in diesem Monat, Status der automatischen Nachprüfung, ungeprüfte Bestellungen
und die letzten Bestellungen mit USt-IdNr. (grün gültig, gelb Adresse abweichend, rot ungültig,
grau ungeprüft). Hier buchen Sie auch Plus und Premium. Nach einem Kauf das Modul neu öffnen.
In der Bestellung
- Zusatzfeld „USt-Id-Status“: Ergebnis, Zeitpunkt und Verlauf in lesbarer Form
- Tags, z. B. „USt-Id gültig / VAT ID valid“ oder „USt-Id ungeprüft / VAT ID unverified“,
in der Bestellübersicht filterbar
- Button „USt-Id jetzt prüfen“: zeigt das gespeicherte Ergebnis mit Verlauf. Mit „Jetzt prüfen“
wird erneut geprüft und die Bestellung aktualisiert.
7. Prüfkontingent
-----------------
- Kostenlos 300, Plus 1.000, Premium 5.000 Prüfungen pro Monat, höhere Kontingente auf Anfrage.
- Jede Prüfung zählt, auch eine erneute Prüfung derselben USt-IdNr.
- Ist das Monatslimit erreicht, werden weitere Prüfungen bis Monatsende behandelt, als wäre der
Prüfdienst nicht erreichbar. Es gelten dann die Optionen „… erlauben, wenn Service nicht erreichbar“.
8. Häufige Fragen
-----------------
Die Prüfung startet im Checkout nicht.
Prüfen Sie, ob „Aktiv“ und „Bestellung nur mit gültiger USt-Id“ eingeschaltet sind und der Kunde als
Geschäftskunde gilt (Kontotyp „Geschäftlich“, Firmenname oder USt-IdNr. im Kundenkonto).
Nach einem Update der App den Shop-Cache leeren.
Eine gültige deutsche USt-IdNr. wird mit „Adresse weicht ab“ markiert.
Für deutsche USt-IdNrn. liefert der Prüfdienst meist keine Adresse. Aktivieren Sie
„… erlauben, wenn USt-Id Adresse leer ist“.
Kunden können die USt-IdNr. in Kleinbuchstaben nicht speichern.
Aktivieren Sie „USt-Id bei der Eingabe in Großbuchstaben umwandeln“.