Tägliche Währungsupdates: EZB-Kurse automatisch im Shop

Über die Erweiterung

Der Dollar steht heute anders als gestern, der Franken auch. In deinem Shop steht er noch auf dem Wert von letzter Woche. Wer international verkauft, pflegt die Umrechnungsfaktoren entweder regelmäßig von Hand nach oder lebt damit, dass die Preise in Fremdwährung schief liegen.

Das Problem

Shopware rechnet Fremdwährungen über einen festen Umrechnungsfaktor pro Währung. Den trägt einmal jemand ein. Danach altert er still vor sich hin. Ein paar Wochen alte Kurse bedeuten je nach Marktlage ein paar Prozent weniger Marge oder Preise, die deutlich über dem Wettbewerb liegen. Auffallen tut das meistens erst, wenn ein Kunde nachfragt oder die Buchhaltung stutzt.

Die Lösung

Das Plugin holt die offiziellen Euro-Referenzkurse der Europäischen Zentralbank und schreibt sie in den Umrechnungsfaktor jeder Währung deines Shops, deren ISO-Code in der EZB-Liste steht. Einmal am Tag, zu einer Uhrzeit, die du selbst festlegst. Der Euro bleibt die Basis mit dem Faktor 1,0. Installieren, aktivieren, fertig: Der erste Kursabruf läuft schon beim Aktivieren.

Was du davon hast

Du pflegst keine Kurse mehr von Hand. Kein Blick auf ein Kursportal, kein Übertragen von Zahlen in die Währungsverwaltung, keine vergessene Woche. Das Plugin macht das jeden Tag, auch wenn niemand daran denkt.

Deine Preise beruhen auf einer Quelle, die niemand anzweifelt. Die EZB veröffentlicht ihre Euro-Referenzkurse an jedem Bankarbeitstag öffentlich. Wenn ein Kunde oder dein Steuerberater fragt, woher der Kurs kommt, hast du eine Antwort in einem Satz.

Du bestimmst, wann aktualisiert wird. Wähle eine volle Stunde zwischen 00:00 und 23:00 Uhr Serverzeit. Standard ist 06:00 Uhr, also früh genug vor dem Verkaufstag. Wenn nachts mehr Ruhe auf deinem System herrscht, leg es dorthin.

Fremdwährungen sind sofort da. Bei der Installation legt das Plugin 29 international gehandelte Währungen an, sofern sie im Shop noch fehlen: USD, GBP, CHF, JPY, SEK, PLN und weitere, jeweils mit ISO-Code und Symbol. Vorhandene Währungen bleiben unangetastet, Dubletten entstehen keine.

Ein Klick, wenn es schnell gehen muss. In der Konfiguration sitzt der Button "Währungen aktualisieren". Er stößt den Abruf sofort an, ohne auf den nächsten Tageslauf zu warten. Praktisch vor einer Preisprüfung oder direkt nach der Installation.

Für die IT ist es ein kleines Plugin. Ein ausgehender Aufruf pro Update, keine personenbezogenen Daten, keine eigene Datenbanktabelle und kein zusätzlicher Query im Checkout.

So arbeitet das Plugin

Ein geplanter Task wacht einmal pro Stunde auf und prüft, ob deine eingestellte Uhrzeit erreicht ist. Ist sie es und lief heute noch kein Update, lädt er die EZB-Datei eurofxref-daily.xml, liest die Kurse aus und schreibt den Faktor auf jede Währung mit passendem ISO-Code. Jeder weitere Aufruf an diesem Tag tut nichts und kostet keine Verbindung nach außen. Währungen, die die EZB nicht führt, bleiben unverändert stehen.

Zusätzlich zum Tageslauf gibt es zwei manuelle Wege: den Button in der Plugin-Konfiguration und den Konsolenbefehl "bin/console swp-ecb:currency", den du in einen eigenen Cronjob oder ein Deployment hängen kannst. Alle drei Wege benutzen dieselbe Logik, es gibt also keine zweite Wahrheit im System.

Typische Einsatzszenarien

Shop mit Schweizer und britischen Kunden. CHF und GBP schwanken gegenüber dem Euro spürbar. Statt einmal im Quartal nachzujustieren, laufen beide Kurse jede Nacht mit.

B2B-Händler mit USD-Preisliste. Deine Kunden in den USA sehen Preise, die auf dem Kurs von heute Morgen beruhen, nicht auf dem aus dem letzten Katalog.

Shop mit skandinavischen Verkaufskanälen. SEK, NOK und DKK werden gemeinsam mit allen anderen Währungen im selben Lauf aktualisiert, ohne dass jemand drei Kurse einzeln abschreibt.

Händler mit eigenem Deployment-Rhythmus. Der Konsolenbefehl hängt sich an deinen bestehenden Cronjob, wenn du den Shopware-Scheduler nicht dafür nutzen willst.

Technische Fakten für deine IT

Shopware 6.7, PHP 8.2 oder neuer, benötigt die PHP-Erweiterung SimpleXML. Das Plugin legt keine eigene Datenbanktabelle an und verändert keine Shopware-Tabellenstruktur. Es schreibt ausschließlich das Standardfeld "Faktor" der Währung über die Data Abstraction Layer und legt bei der Installation fehlende Währungen als reguläre Shopware-Datensätze an.

Externe Verbindungen: genau eine, ein HTTPS-GET auf die öffentliche Kursdatei der EZB unter www.ecb.europa.eu, ohne Zugangsdaten und mit einem Timeout von 20 Sekunden. Es werden keine Daten an die EZB gesendet und keine personenbezogenen Daten verarbeitet, gespeichert oder geloggt. Wer den Abruf ganz unterbinden will, schaltet den Hauptschalter oder die tägliche Aktualisierung aus, dann geht kein Aufruf mehr nach außen.

Kursdaten aus der Quelle werden geprüft, bevor sie im Shop landen: negative, nicht endliche und unplausibel große Werte werden verworfen. Ein Ausfall der EZB-Seite wird abgefangen und protokolliert, weder der Message-Worker noch der Shop stoppen deswegen. Das manuelle Update hängt an einem eigenen Recht in der Rechteverwaltung, ohne dieses Recht bleibt der Button gesperrt. Storefront-Templates werden nicht überschrieben, es gibt keine zusätzliche Abfrage im Checkout, und der Kursabruf läuft im Hintergrund, nicht im Kundenrequest.

Ehrlich gesagt

Die EZB veröffentlicht ihre Referenzkurse nur an Bankarbeitstagen. Am Wochenende und an Feiertagen bleibt der Kurs vom letzten Werktag stehen, das ist so gewollt und lässt sich nicht beschleunigen. Wer handelsgenaue Kurse im Sekundentakt oder eigene Auf- und Abschläge pro Währung braucht, ist mit diesem Plugin nicht gut bedient: Es schreibt den Referenzkurs, nichts anderes.

Die automatische Aktualisierung setzt einen laufenden Scheduled-Task-Worker voraus. Läuft keiner, bleibt der Button oder der Konsolenbefehl. Und die 29 mitgelieferten Währungen tragen englische Bezeichnungen wie "US Dollar" in der Systemsprache deines Shops. Wenn dir das nicht passt, benennst du sie in der Währungsverwaltung um, das Plugin fasst den Namen danach nicht mehr an.

Wenn du Wechselkurse heute noch von Hand pflegst, probier es einfach aus.

Rechtlicher Hinweis

Wir übernehmen keine Haftung für rechtliche Vorgaben. Bitte prüfe die Nutzung in Abstimmung mit einem qualifizierten Rechtsbeistand.