Aktualisierung der NBP Pro-Wechselkurse — Währungskurse in PrestaShop

Wichtigste Merkmale und Funktionen des Moduls

• Daten aus der API der Polnischen Nationalbank: Abruf der Kurstabellen über HTTPS mit Prüfung der Antwortkorrektheit und der Veröffentlichungsdaten.
• Vier Varianten der Kursquelle: Tabelle A, kombinierte Tabellen A und B, Ankaufskurs aus Tabelle C oder Verkaufskurs aus Tabelle C.
• Auswahl der zu aktualisierenden Währungen: Auswahl vorhandener, aktiver Fremdwährungen, die dem ausgewählten Shop in PrestaShop zugeordnet sind.
• Preisaufschlag für jede Währung: separater Prozentwert von 0 bis 50%, der bei der Berechnung des Shop-Kurses berücksichtigt wird.
• Unterstützung verschiedener Basiswährungen: Umrechnung über Referenzwerte in PLN, sofern die Basiswährung und die ausgewählten Währungen in der verwendeten Quelle verfügbar sind.
• Vorschau vor manueller Bestätigung: Vergleich des aktuellen Kurses mit dem vorgeschlagenen, der prozentualen Differenz, des Datums und der Nummer der NBP-Tabelle sowie der Umrechnung von 100 Einheiten der Basiswährung.
• Gültigkeit der Vorschau für 10 Minuten: Bestätigung durch den Mitarbeiter, der sie erstellt hat, nach erneuter Prüfung der Kurse, Einstellungen und der Basiswährung.
• Maximal zulässige Kursänderung: Überschreitet eine der ausgewählten Währungen den festgelegten Schwellenwert, wird die Speicherung des gesamten Pakets blockiert.
• Überspringen kleiner Änderungen: Schwellenwert für die minimale Änderung von 0 bis 5%, der es ermöglicht, den Kurs bei kleineren Abweichungen ohne Speicherung beizubehalten.
• Kontrolle des Veröffentlichungsalters: Limit von 1 bis 30 Kalendertagen unter Berücksichtigung der Daten, die für die Umrechnung verwendet werden.
• Gemeinsame Speicherung von Kursen und Verlauf: Datenbanktransaktion sowie Sperrung der Operationen dieses Moduls für den jeweiligen Shop verringern das Risiko einer teilweisen Speicherung und paralleler Aktualisierungen.
• Verlauf mit Zugriff auf Details: Datum der Operation, manueller Modus oder CRON, Status, Ursache der gespeicherten Sperre oder des Fehlers sowie Details der erstellten Vorschau oder Änderung.
• Wiederherstellung früherer Kurse: Das Zurücksetzen einer gespeicherten Aktualisierung ist verfügbar, wenn die davon betroffenen Kurse weiterhin dem Ergebnis dieser Operation entsprechen.
• Automatisierung per CRON: private Adresse für den Shop, Mindestabstand zwischen Versuchen von 15 bis 1440 Minuten sowie Möglichkeit zur Änderung des Zugriffsschlüssels.
• Simulation der automatischen Aufgabe: Der Parameter dry_run=1 prüft den Aktualisierungsplan, ohne die Shop-Kurse zu ändern.
• Aktualisierung einer Teilmenge von Währungen per CRON: Der Parameter currencies beschränkt den Aufruf auf die angegebenen Währungen unter den zuvor im Modul aktivierten.
• Information zur Umrechnung für den Kunden: Eine optionale Mitteilung auf der Produktseite und im Warenkorb zeigt den tatsächlichen Shop-Kurs für die ausgewählte Fremdwährung an.
• Konfiguration getrennt für Shops: Im Multistore beziehen sich Einstellungen, Verlauf, CRON-Schlüssel und Kursspeicherungen auf den jeweiligen Shop.
• Panel mit sechs Registerkarten: Übersicht, Währungen, Einstellungen, Automatisierung, Verlauf und Hilfe strukturieren die Konfiguration und die Verwaltung der Aktualisierungen.
• Aufbewahrungszeitraum des Verlaufs: Einstellung von 7 bis 365 Tagen, mit Bereinigung älterer Einträge nach korrekt verarbeiteten CRON-Aktualisierungen; die Simulation startet keine Bereinigung.

Welche NBP-Kurse können im Shop verwendet werden?

Die ausgewählte Quelle muss die Basiswährung des Shops sowie die aktualisierten Währungen enthalten. PLN dient als Referenz mit dem Wert 1. Die Tabellen A und B können unterschiedliche Veröffentlichungsdaten haben, daher prüft das Modul das Alter der Daten, die für die jeweilige Umrechnung benötigt werden.

Wie funktionieren die Kursumrechnung und der Preisaufschlag?

PrestaShop speichert die Anzahl der Einheiten der Zielwährung, die auf eine Einheit der Basiswährung des Shops entfallen. Das Modul berechnet diesen Kurs als: Wert der Basiswährung in PLN ÷ Wert der Zielwährung in PLN × (1 + prozentualer Aufschlag ÷ 100). Das Ergebnis wird mit einer Genauigkeit von sechs Nachkommastellen gespeichert.

Beispiel: Bei PLN als Basiswährung und einem Kurs von 1 EUR = 4 PLN beträgt der Shop-Kurs 0,25 EUR für 1 PLN. Ein Aufschlag von 2% erhöht ihn auf 0,255, sodass ein Betrag von 100 PLN, der nach diesem Kurs umgerechnet wird, 25,50 EUR ergibt. Der Aufschlag beeinflusst die standardmäßige Preisumrechnung, ist jedoch weder eine Bankgebühr noch eine Garantie für eine Marge.

Was gewinnt das Shop-Team?

• Weniger manuelles Übertragen von Kursen: Die Daten stammen aus der ausgewählten NBP-Quelle, und nach Hinzufügen eines Zeitplans kann CRON die Aktualisierungen ausführen.
• Kontrolle vor der Preisänderung in Fremdwährungen: Die Vorschau ermöglicht die Bewertung der vorgeschlagenen Umrechnung, und Aufschläge sowie Änderungsschwellen können an die Regeln des Shops angepasst werden.
• Zugriff auf frühere Werte: Die Details der gespeicherten Aktualisierung erleichtern die Prüfung der Differenz und gegebenenfalls die Wiederherstellung der Kurse.
• Separate Multistore-Verwaltung: Für einzelne Shops können unterschiedliche Quellen, Aufschläge und Automatisierungsregeln verwendet werden.

Welche Information erhält der Kunde?

Nach Aktivierung der Mitteilung kann ein Kunde, der eine Fremdwährung verwendet, auf der Produktseite und im Warenkorb eine Umrechnung in der Form „1 Einheit der Basiswährung = Kurs in der Währung des Kunden“ sehen. Die Mitteilung informiert außerdem darüber, dass die Preise den Shop-Kurs verwenden, der einen Preisaufschlag enthalten kann. Der Zeitpunkt der gespeicherten Aktualisierung und das Veröffentlichungsdatum der NBP erscheinen, wenn der Eintrag aus dem gelesenen letzten Verlauf der aktuellen Basiswährung und dem Kurs des Kunden entspricht; nach der Wiederherstellung der Kurse wird kein neues NBP-Datum hinzugefügt.

Die Mitteilung ist für die Basiswährung ausgeblendet und kann in den Einstellungen deaktiviert werden. Die Anzeige setzt voraus, dass das Theme die unterstützten Stellen auf der Produktseite und im Warenkorb bereitstellt. Beim Anzeigen dieser Seiten liest das Modul den gespeicherten Shop-Kurs aus, ohne die NBP-Tabellen abzurufen.

Wie startet man die Aktualisierung der NBP-Kurse in PrestaShop?

1. Wählen Sie den Shop aus und markieren Sie auf der Registerkarte Währungen die aktiven Fremdwährungen und legen Sie deren Aufschläge fest.
2. Wählen Sie in den Einstellungen die NBP-Quelle, die maximale und minimale Kursänderung sowie das zulässige Veröffentlichungsalter aus.
3. Rufen Sie in der Übersicht die Vorschau ab und vergleichen Sie die vorgeschlagenen Werte. Die Vorschau selbst ändert die Kurse nicht.
4. Bestätigen Sie die korrekte Vorschau und prüfen Sie das Ergebnis im Verlauf.
5. Wenn Sie Automatisierung benötigen, aktivieren Sie sie auf der Registerkarte Automatisierung und fügen Sie auf dem Server eine Aufgabe hinzu, die die generierte CRON-Adresse aufruft. Die verfügbare Simulation ermöglicht es, das Ergebnis vorab ohne Speicherung der Kurse zu prüfen.

Bedingungen für den Betrieb und Umfang der Aktualisierung

Das Modul ist für PrestaShop 1.7.x, 8.x und 9.x vorgesehen. Es erfordert PHP in einer von der jeweiligen Shop-Version unterstützten Version, die cURL-Erweiterung, eine korrekte Verarbeitung von HTTPS-Zertifikaten und den Zugriff des Servers auf die NBP-API. Die Tabellen, die die Währungskurse des Shops und den Modulverlauf speichern, müssen die InnoDB-Engine verwenden. Die Basiswährung muss aktiv sein und einen Kurs von 1 haben; das Modul ändert sie nicht in eine andere.

Aktualisiert werden die Währungskurse des jeweiligen Shops, nicht die Preisdatensätze der Produkte oder frühere Bestellungen. Sonderpreise, feste Beträge in Fremdwährungen, Gutscheine und Rundungen behalten das native Verhalten von PrestaShop bei. In einem Shop sollte ein Mechanismus zur automatischen Aktualisierung der Kurse verwendet werden.

Die Installation ändert die aktuellen Kurse nicht und lässt CRON deaktiviert. Der Standardaufschlag beträgt 0%, die maximale Änderung 10%, die minimale Änderung 0,05%, das zulässige Veröffentlichungsalter 10 Tage, der Mindestabstand zwischen automatischen Versuchen 60 Minuten und der Verlaufszeitraum 90 Tage. Die Wiederherstellung erfordert einen erhaltenen Verlaufseintrag, weiterhin übereinstimmende Kurse und dieselbe Basiswährung; sie dient nicht dazu, spätere Änderungen zu überschreiben.