Umsatzsteuer-ID/USTID-Validierung PRO
495,00 €*
Erhältlich im Shopware Community Store!
Icon: Self Hosted / Cloud
Icon: Shopware Version (5 / 6)
Kompatibilität: mind. SW 5.x.x
Video
Beschreibung
Feature-Request
Installationsanleitung
Changelog
Plugin Konfiguration
Aktuell keine Videos vorhanden
Mit unserem Plugin USTID Validierung PRO für B2B kannst Du USTIDs in Deinem Shop prüfen und dem Kunden eine steuerfreie Lieferung (ab v1.0.6) ermöglichen. Das Plugin bietet zahlreiche Funktionen, die für Dich wichtig sind, wenn Du häufig mit EU-Unternehmen handeln. Nachfolgend lernst Du das Plugin kennen:
Funktionen ab Shopware 6.4.0.0 :
- Prüft USTID von EU-Unternehmen.
- Jede Anfrage an eine Schnittstelle wird geloggt und in der Datenbank gespeichert. So kannst Du nachweisen, dass Du die USTID geprüft hast.
- Die Validierung erfolgt automatisch 1x pro Tag, wenn der Kunde im Onlineshop aktiv ist, oder bei Änderung der Adresse. Bei einer Adressänderung wird die neue Lieferadresse sofort überprüft.
- Eine Validierung der USTID bei der Registrierung ist optional möglich.
- Beim Hinterlegen der USTID im Kundenaccount wird diese validiert und auf ihre Gültigkeit überprüft.
- Deine Kunden bekommen auf der Bestellbestätigungsseite (Checkout) direkt angezeigt, ob die Validierung erfolgreich war und wenn nicht, werden die Validierungsfehler mit Lösungsvorschlägen in einer Übersicht direkt angezeigt.
- Die Validierung der USTID erfolgt für Deine Kunden, die ihren Sitz in Ländern haben, die als steuerfrei gekennzeichnet sind, beim Bestellabschluss. Ist die USTID korrekt wir die Bestellung ohne MwSt angezeigt.
- Zu Beachten gilt: Die Länder, die steuerfrei sind, müssen unter Einstellungen -> Shop -> Länder für jedes Land eingestellt werden. Dies war zuvor im Plugin möglich und ist jetzt in den Shopware Standard gewechselt.
- Zu Beachten gilt: Deutsche USTIDs werden nicht validiert.
- Hinweis: Bei der Registrierung wird unabhängig von den Plugin-Einstellungen immer die Rechnungsadresse geprüft.
- Für die Validierung von Unternehmen aus Nordirland muss Nordirland als eigenes Land angelegt werden und dort Steuerfrei für Unternehmen aktiviert werden. Als Länder-ISO für Nordirland muss GB oder XI hinterlegt werden.
- Ab Version 2.0.22: Im Kundenaccount kann über ein Zusatzfeld der Validierungstype für diesen Kunden individuell angepasst werden.
Hinweise zu APIs
- Bulgarien: API aktuell nicht erreichbar (Stand: 17.12.2018). Wird bei Abfrage der EU-API immer als validiert markiert.
- Estland: Keine Validierung der Stadt über EU-API möglich.
- Irland: Postleitzahl über EU-API nicht validierbar.
- Litauen: Postleitzahl über EU-API nicht validierbar.
- Rumänien: Postleitzahl über EU-API nicht validierbar.
- Spanien: Keine Validierung möglich, daher wird Spanien immer durchgelassen. Bitte prüfe spanische USTIDs manuell.
Voraussetzungen:
- php-soap
| Kompatibilität: | mind. 6.4.x.x |
|---|---|
| Nutzbar in: | Self-Managed |
| Shopware Version: | Shopware 6 |
Gib hier Deine Umsatzsteuer-ID ein, damit unser Plugin die Umsatzsteuer-IDs Deiner Kunden prüfen kann.
Du kannst festlegen welche Adresse als Grundlage für die Validierung dienen soll. Zur Auswahl stehen die Rechnungs- oder Lieferadresse. Wir empfehlen stets die Lieferadresse zu verwenden.
Die Validierung der UST-ID erfolgt bei der Registrierung. Unter den Validierungstypen "Keine", "Offline", "Einfach" und "Erweitert" kann gewählt werden. Bei "Offline" wird nur der Offline-Plausibilitätscheck (mehr als drei Zeichen und weniger als 15 Zeichen) durchgeführt. Bei "Einfach" wird geprüft, ob die Umsatzsteuer-ID gültig ist. Bei "Erweitert" wird geprüft, ob USTID und Adresse zueinander passen sowie passende Vorschläge zur Korrektur werden angezeigt.
Die Validierung der UST-ID erfolgt bei der Änderung der USTID im Profil Deines Kunden. Die Validierungstypen "Keine", "Offline" und "Einfach" stehen zur Auswahl. Bei "Offline" wird nur der Offline-Plausibilitätscheck (mehr als drei Zeichen und weniger als 15 Zeichen) durchgeführt. Bei "Einfach" wird geprüft, ob die Umsatzsteuer-ID gültig ist.
Du kannst festlegen, welcher Validierungstyp für Deine Kunden gewählt wird, die aufgrund ihres Landes steuerfrei bestellen können. Zur Auswahl stehen die Validierungstypen "Offline", "Einfach" und "Erweitert". Bei "Offline" wird nur der Offline-Plausibilitätscheck (mehr als drei Zeichen und weniger als 15 Zeichen) durchgeführt. Bei "Einfach" wird geprüft, ob die Umsatzsteuer-ID gültig ist. Bei "Erweitert" wird geprüft, ob USTID und Adresse zueinander passen sowie passende Vorschläge zur Korrektur werden angezeigt.
aktiv / inaktiv
Es gibt die Validierungstypen "Keine", "gleiche Adresse" und "Gleiches Land bei Rechnungs- und Lieferadresse". Das Plugin überprüft bei "Gleiche Adresse", ob die ausgewählte Adresse mit der Adresse der USTID übereinstimmt. So kannst Du verhindern, dass ausländische Kunden die USTID einer Firma angeben können und dann die Ware steuerfrei an ihre private Adresse geliefert bekommen. Bei "Gleiches Land bei Rechnungs- und Lieferadresse" wird überprüft ob das Lieferland von Liefer- und Rechnungsadresse identisch ist.
Hinweis auf /checkout/confirm anzeigen, wenn bei Land mit "Steuerfreiheit (B2B)" keine USTID hinterlegt istaktiv / inaktiv
aktiv / inaktiv
Mit dieser Funktion kannst Du verhindern, dass Bestellungen abgeschlossen werden können, wenn die USTID-Prüfung nicht gültig ist. Erst wenn die USTID-Prüfung valide ist, kann die Bestellung abgeschlossen werden.
- Installiere und aktiviere die Erweiterung.
- Konfiguriere die App. Folgende Einstellungen sind nötig, damit das Plugin korrekt funktioniert:
- Deine USTID muss eingetragen sein.
- Die Validierung bei Adressänderung muss aktiv sein.
- Die Validierung bevor Bestellung gespeichert wird muss aktiv sein. - Unter Einstellungen -> Shop -> Login/Registrierung muss die Option "Auswahl zwischen Firmen- und Kundenkonto anzeigen" aktiviert sein.
- Für Länder, die steuerfrei sind, muss unter Einstellungen -> Shop -> entsprechendes Land, die Option "Steuerfrei für Unternehmen" aktiviert werden.
- Fertig.
Konfigurationshinweise:
- Gib in den Einstellungen Ihre USTID ohne Leerzeichen ein, damit die Validierung funktioniert!
- Aktiviere die Validierung bei Adressänderung und bei Bestellabschluss. Sofern es Probleme bei der allgemeinen Adressvalidierung gibt, deaktiviere die Validierung bei Adressänderung. Wir raten davon ab die Validierung bei Bestellabschluss zu deaktivieren!
- Konfiguriere die Länder, für die Du eine steuerfreie Lieferung ermöglichen möchten!
BUGFIX | SE-Validierungsmuster für EU-API aktualisiert.
BUGFIX | SE-Validierungsmuster für EU-API aktualisiert.
IMPROVEMENT | API-Timeout zu Plugin-Konfiguration hinzugefügt.
IMPROVEMENT | API-Timeout zu Plugin-Konfiguration hinzugefügt.
IMPROVEMENT | HU-Regex aktualisiert.
IMPROVEMENT | HU-Regex aktualisiert.
TASK | nl_NL Übersetzung für Storefront hinzugefügt.
TASK | nl_NL Übersetzung für Storefront hinzugefügt.
BUGFIX | Verhindert einen Fehler bei nicht eingeloggten Kunden.
BUGFIX | Verhindert einen Fehler bei nicht eingeloggten Kunden.
BUGFIX | Blockierung von Bestellungen, konnte durch Ändern von HTML-Attribut umgangen werden.
IMPROVEMENT | Verbesserte Handhabung for Nicht-ASCII-Zeichen.
BUGFIX | Shopware 6.5 Admin JS Kompatibilität.
BUGFIX | Blockierung von Bestellungen, konnte durch Ändern von HTML-Attribut umgangen werden.
IMPROVEMENT | Verbesserte Handhabung for Nicht-ASCII-Zeichen.
TASK | Kompatibilität mit Shopware 6.5.
FEATURE | Abfragedaten zu Validierungslog-Entität hinzugefügt.
Anforderungen:
- Das Plugin erfordert nun mindestens Shopware Version 6.5.0.0.
- VOR DEM UPDATE AUF SHOPWARE 6.5.0.0 die App deaktivieren, dann aktualisieren, dann aktivieren.
FEATURE | Zusatzfeld hinzugefügt, um für bestimmte Kunden andere Validierungstypen zu verwenden.
BUGFIX | PL-USTIDs wurden teilweise nicht validiert.
BUGFIX | Verhindert Fehlermeldung bei leerer USTID.
BUGFIX | Verbessertes Handling von API-Fehlern.
IMPROVEMENT | Twig-Blöcke zu Bestellübersichtsseite hinzugefügt.
FEATURE | Zeige USTID in Bestell-Detailseite (Administration).
BUGFIX | Fehler bei Privatkunden-Registrierung behobe
TASK | Kompatibilität mit Shopware >= 6.4.12.0.
BUGFIX | Verhindert, dass falsche USTIDs mit den Zeichen , . - (Leerzeichen) als valide validiert werden.
IMPROVEMENT | Validierung für XI (Nord-Irland) hinzugefügt.
Hinweise:
- Wir empfehlen Nordirland als eigenes Land anzulegen und nur dort Steuerfrei für Unternehmen anzuhaken.
- Als Länder-ISO für Nord-Irland muss GB oder XI hinterlegt werden.
TASK | Fehlende Übersetzungen in englischen Snippets hinzugefügt.
BUGFIX | Steuerfreiheit wurde nicht korrekt ermittelt, bei Einstellung der Validierungsadresse auf Rechnungsadresse. (wenn Rechnungsadresse ohne Steuerfreiheit und Lieferadresse mit Steuerfreiheit für B2B eingestellt war.)
IMPROVEMENT | Option hinzugefügt, um Bestellungen bei ungültigem USTID-Check zu verhindern.
IMPROVEMENT | Option hinzugefügt, um Adressvorschläge ins lateinische Alphabet zu übersetzen.
BUGFIX | Verbessertes Handling für leere USTID.
IMPROVEMENT | Option auf /checkout/confirm-Seite hinzugefügt, um einen Hinweis anzuzeigen/zu verstecken, wenn ein steuerfreies Land gewählt ist, aber keine USTID eingegeben wurde.
TASK | Text von Snippet ``checkout.lenzVatIdValidation.header`` geändert.
IMPROVEMENT | Verbesserte Kompatibilität mit Third-Party-Plugins.
BUGFIX | Adressdatenerkennung für SI-Adressdaten aktualisiert.
IMPROVEMENT | Event beim Logging hinzugefügt.
IMPROVEMENT | Einstellung hinzugefügt, um Adresse für Validierung zu wählen (Rechnung oder Lieferung).
IMPROVEMENT | Benutze immer Rechnungsadresse, um die USTID bei der Registrierung zu prüfen.
TASK | Kompatibilität mit Shopware 6.5.x.x.
BUGFIX | Steuer wurde in manchen Fällen nicht korrekt berechnet, wenn eine private Adresse verwendet wurde.
BUGFIX | Validierungshinweis auf /checkout/confirm wurde angezeigt, auch wenn keine Validierung möglich war (z.B. Schweiz).
TASK | Code in TaxDetector aufgeräumt
BUGFIX | Behebt einen Bug (von Shopware), der die Registrierung verhindert hat, wenn ein Validierungsfehler bei einer Registrierungsadresse auftrat
IMPROVEMENT | PL Regex aktualisiert
IMPROVEMENT | Verhindert Validierung von Schweizer UIDs (CHE-XXX.XXX.XXX).
BUGFIX | Validierung für Privatkunden / Privatkunden-Adressen deaktiviert.
TASK | Neuentwicklung des Plugins für Shopware 6.4.0.0, da Shopware die USTID nun nicht mehr bei den Adressen speichert, sondern beim Kundenkonto.
ACHTUNG: Nach dem Update ist eine Neukonfiguration des Plugins notwendig. Bitte öffnen Sie die Konfiguration des Plugins und stellen Sie die Einstellungen wie gewünscht ein. Unsere Empfehlung:
- Validierung bei Registrierung: Erweitert
- Validierung bei Profil-Update: Einfach
- Validierung bei Steuerfreiheit + Bestellabschluss: Erweitert
- Validierung als "valide" durchgehen lassen, wenn von allen APIs ein Fehler zurückgegeben wird: aktiv
- Zusätzliche Validierung für steuerfreie Lieferung: Gleiches Land bei Rechnungs- und Lieferadresse
ACHTUNG: Nach dem Update müssen die Länder, die steuerfrei sind, unter Einstellungen -> Shop -> Länder für jedes Land eingestellt werden. Dies war davor im Plugin möglich und ist jetzt in den Shopware Standard gewechselt.
- Validierung wird nun 1x pro Tag automatisch ausgeführt, wenn Kunde im Shop ist.
- Validierungen werden nun so gespeichert und verarbeitet, dass nur noch bei Änderungen der Adresse oder max. 1x pro Tag bei gleichlautenden Adressdaten validiert wird. Ausnahme: Kunde wechselt die Lieferadresse. Dann wird die neue Lieferadresse sofort geprüft.
- Kunde bekommt auf Bestellbestätigungsseite (/checkout/confirm) eine Übersicht angezeigt, ob die Validierung der USTID funktioniert hat und sieht dort direkt, welche Validierungsfehler es gibt.
- Validierung bei Registrierung kann eingestellt werden.
- Validierung bei Hinterlegung der USTID im Kundenaccount kann auf Gültigkeit geprüft werden.
- Validierung vor Absenden der Bestellung, mit Hinweis auf innergemeinschaftliche Lieferung
- Steuerfrei für Firmen muss nun unter Einstellungen -> Shop -> Länder für jedes Land eingestellt werden, davor war dies auch im Plugin möglich. - Infos zur Validierung: https://www.frankfurt-main.ihk.de/recht/steuerrecht/umsatzsteuer_international/innergemeinschaftliche_lieferungen/
TASK | plugin.png aktualisiert.
IMPROVEMENT | Kompatibilität mit Shopware 6.5.3.x.
BUGFIX | Registrierung mit fehlerhafter Validierung führte zu einem kaputten Formular nach dem Absenden.
BUGFIX | Es wurde ein Fehler geworfen, wenn eine API eine leere Antwort zurückgab.
IMPROVEMENT | Option hinzugefügt, um die Validierung zu umgehen, wenn alle APIs nicht erreichbar sind.
TASK | Code aufgeräumt.
IMPROVEMENT | Neue API-Antwort zu den Antworten hinzugefügt, die als API nicht erreichbar gekennzeichnet werden.
BUGFIX | Registrierung mit fehlerhafter Validierung führte zu einem kaputten Formular nach dem Absenden.
TASK | GB wegen Brexit entfernt.
TASK | Option "Erweitert + Brief" entfernt, da nicht mehr möglich. Bitte die Option "Online-Validierungstyp" nach dem Update prüfen und neu einstellen.
IMPROVEMENT | Offline-Validierung prüft, ob Land zu USTID passt.
TASK | USTID-Validierung bei Ajaxx-Adress-Editor deaktiviert, da Shopware hier keine Fehlermeldungen ausgeben kann.
IMPROVEMENT | Eingebene Werte für Straße, PLZ und Stadt werden nun bei fehlerhafter Validierung gefüllt.
TASK | Fehlerbehebung für einen Shopware-Fehler ist nicht mehr notwendig und daher entfernt.
Hinweis: Bitte immer "Validierung bevor Bestellung gespeichert wird" aktivieren.
TASK | Behebt einen Fehler, der von Shopware kommt und dafür sorgt, dass nach einer falschen Validierung die Registrierung nicht abgeschickt werden kann.
IMPROVEMENT | EU-API-Validierung für französische Adressen ignoriert nun Teile der Adresse, die nicht relevant sind.
BUGFIX | Behebt einene Fehler, der aus v1.0.8 kommt.
TASK | Behebt einen Fehler, der von Shopware kommt und dafür sorgt, dass nach einer falschen Validierung die Registrierung nicht abgeschickt werden kann.
BUGFIX | Behebt einen Fehler, wenn kein Wert bei Plugin-Konfiguration "taxFreeCountriesWithVatId" gesetzt ist.
IMPROVEMENT | Optionen hinzugefügt, um wählen zu können, wo die Validierung aktiv ist (Adressänderung, bevor Bestellung gespeichert wird).
TASK | Code cleanup.
IMPROVEMENT | Option hinzugefügt, um steuerfrei in ausgewählte Länder zu versenden, wenn eine USTID eingegeben wurde.
Hinweis: Nach der Installation des Updates können in den Plugin-Einstellungen Länder definiert werden, die eine steuerfreie Lieferung erlauben. Wenn ein Kunde eine Bestellung mit USTID in der Lieferadresse und Lieferadresse in ein hinterlegtes Land tätigt, wird die Bestellung steuerfrei.
BUGFIX | Erlaubt HTML in bestimmten Datenbankfeldern.
TASK | Anpassungen für Shopware 6.3.0.0.
BUGFIX | Fehler im Account auf der "Personal"-Seite behoben.
BUGFIX | Behebt einen Fehler der durch einen falsch benannten block von Shopware entstand (component_address_personal_account_type).
IMPROVEMENT | Formluare behalten nun die Firmendaten, auch wenn die Validierung fehlschlägt.
BUGFIX | Behebt einen Tippfehler im Twig-Template.
BUGFIX | Debug code entfernt.
IMPROVEMENT | Behebt einen Fehler in Shopware, der das "Ich bin"-Feld auf der Registrierungsseite nicht korrekt ausgefüllt hat, wenn ein Validierungsfehler besteht.
BUGFIX | Problem auf der Registrierungsseite behoben, das auftrat, wenn eine alternative Lieferadresse mit USTID gewählt wurde.
BUGFIX | Debug-Ausgabe nach Checkout entfernt.
IMPROVEMENT | Offline-Validierung refaktoriert.