EU VAT

Über

Das Plugin berechnet die EU-Mehrwertsteuer fuer Shops, die `@payloadcms/plugin-ecommerce` einsetzen, und schreibt die Aufschluesselung auf jede Bestellung. Dazu gehoeren der angewendete Steuersatz, die Bemessungsgrundlage, der Steuerbetrag, das Bestimmungsland, der Ort der Lieferung und ein Kennzeichen fuer das Reverse-Charge-Verfahren. Damit lassen sich monatelang spaeter die Betraege nachvollziehen, die einem Kunden in Rechnung gestellt wurden. Die Zahlen liegen direkt auf der Bestellung. Die Integration erfolgt ueber einen `beforeChange`-Hook auf der Orders-Collection und ein schreibgeschuetztes `tax`-Feld, das an die Bestellung angehaengt wird. Der Hook laeuft bei der Bestellerstellung, liest Bestellsumme und Versandland aus konfigurierbaren Dot-Paths und fuellt das Feld. Die Zahlung wird vom Plugin nicht beruehrt. Der Betrag, der beim Zahlungsanbieter ankommt, wird vom Checkout bestimmt. Zwei REST-Endpunkte sind enthalten. `POST /api/tax/quote` liefiert Vorab-Schaetzungen vor dem Kauf. `GET /api/tax/oss-report` erzeugt die viertjaehrlichen OSS-Summen fuer die Steuererklaerung. Die Rechnung arbeitet durchgaengig in Integer-Minoreinheiten, wie das offizielle Ecommerce-Plugin es vorgibt, und ohne Float-Konvertierung. Die Konfiguration erfordert `sellerCountry` ohne Standardwert. Dazu kommen die Wahl zwischen inklusiver und exklusiver Preisberechnung sowie die Rundung pro Position oder pro Gesamtsumme. Eine eingebaute Steuertabelle deckt alle Mitgliedstaaten ab. Eigene Steueransaetze ueberschreiben sie. Mehrwertsteuernummern werden zunaechst offline auf ihr Format geprueft. Ist `vies.enabled` aktiviert, erfolgt zusaetzlich ein Abruf beim VIES-Dienst der Europaeischen Kommission. Bei Timeout oder Fehler schlaegt das Fails-Open-Verhalten zu. Das Plugin benoetigt Payload 3.88 oder neuer mit installiertem `@payloadcms/plugin-ecommerce`. Es enthaelt keine Admin-UI-Komponenten, sondern nur Felder, weshalb es bei kleineren Payload-Releases unwahrscheinlich ist, dass es kaputtgeht. Griechenland wird mit den beiden Codes `GR` und `EL` abgebildet. `EL` geht an VIES. Der OSS-Report beruecksichtigt konfigurierbare Bestellstatus und durchlaeuft die Collection mit Pagination.

Paketinformationen

Paketname

payload-tax-eu

Neueste Version

1.0.0

Entpackte Größe

67 kB

Lizenz

MIT

Wöchentliche Downloads

3

Zuletzt veröffentlicht

21. Aug. 2026