Rohstoffberechnung Kursimport Goldmarkt | Kurse nicht mehr von Hand eintragen

Auf einen Blick

• Kurse kommen automatisch, du tippst keinen Wert mehr von Hand ab
• Ungültige Kurse ändern nichts, dein gespeicherter Kurs bleibt stehen
• Ein Kurs landet in jedem Kundentyp, du pflegst nichts doppelt
• Abruf alle 5 Minuten bis einmal am Tag, du wählst den Takt
• Ausgeschaltet nimmt das Plugin keinen Kontakt zu Goldmarkt auf

Kursliste öffnen, Werte abschreiben, in die Rohstoffberechnung eintragen, speichern. Am Nachmittag das Ganze noch einmal, weil sich der Markt bewegt hat. Wer Artikelpreise aus Rohstoffkursen rechnet, kennt diese Routine. Das frisst jeden Tag Zeit, und ein vertippter Kurs landet direkt im Preis.

Das Problem

Die Rohstoffberechnung macht aus hinterlegten Kursen deine Artikelpreise. Die Kurse selbst muss aber jemand pflegen. Von Hand heißt das: Deine Preise sind genau so aktuell wie der letzte Mensch, der Zeit zum Abtippen hatte. Ein Zahlendreher fällt oft erst auf, wenn ein Kunde schon zum falschen Preis bestellt hat.

Die Lösung

Dieses Plugin holt die XML-Kursliste von Goldmarkt mit deinen Zugangsdaten ab und schreibt die Kurse über die Import-Schnittstelle der Rohstoffberechnung in deren Kursdaten. Das läuft automatisch im Abstand, den du einstellst, oder auf Befehl. Du trägst einmal Schnittstellen-URL, Benutzername und Passwort ein, schaltest den Abruf ein. Fertig.

Was du davon hast

Kein Abtippen mehr. Die geplante Aufgabe holt die Kurse im eingestellten Abrufintervall. Du kontrollierst Ergebnisse, statt Zahlen zu übertragen.

Ein kaputter Wert wird kein kaputter Preis. Kurse von 0, negative und nicht numerische Werte verwirft der Import. Der zuletzt gespeicherte Kurs bleibt stehen, bis ein gültiger kommt.

Ein Kurs, jeder Kundentyp. Führst du denselben Kurscode in mehreren Kundentypen der Rohstoffberechnung, bekommt jede dieser Zeilen den neuen Kurs. Du pflegst nichts doppelt.

Du bestimmst den Takt. Das Abrufintervall stellst du zwischen 5 und 1440 Minuten ein, Standard sind 15 Minuten. Wer nur einmal am Tag neue Kurse braucht, stellt 1440 ein.

Keine Verbindung ohne dein Okay. Nach der Installation ist „Kurse bei Goldmarkt abrufen“ ausgeschaltet. Erst wenn du den Schalter umlegst, nimmt das Plugin Kontakt zu Goldmarkt auf.

Ankaufpreise ziehen mit. Nutzt du zusätzlich unser Plugin Artikelankauf, folgt auch der Ankaufpreis dem importierten Kurs. Der Kursimport selbst läuft auch ohne den Artikelankauf.

So arbeitet das Plugin

• Die geplante Aufgabe läuft im eingestellten Abrufintervall. Alternativ startest du den Abruf auf der Konsole mit bin/console resourcecalc:goldmarkt:import, zum Beispiel aus einem eigenen Cronjob.
• Das Plugin ruft die eingetragene Schnittstellen-URL auf und hängt Benutzername und Passwort als Parameter an. Steht in der URL kein Protokoll, verwendet es https://.
• Aus jedem Eintrag der Kursliste bildet es den Kurscode aus Code und Währung, zum Beispiel AU_EUR. Einträge ohne Code oder Währung überspringt es.
• Die Import-Schnittstelle der Rohstoffberechnung setzt den Kurs in jeder Kursdaten-Zeile mit diesem Kurscode, in jedem Kundentyp. Einen unbekannten Kurscode legt sie einmal im Standard-Kundentyp an, mit dem Namen aus der Kursliste.
• Die in den Artikeln gespeicherten Preise aktualisiert wie gewohnt der Befehl resourcecalc:cron der Rohstoffberechnung.
• Jeder Abruf hinterlässt eine Zusammenfassung in der eigenen Logdatei: aktualisierte, neu angelegte und verworfene Kurscodes.

Typische Einsatzszenarien

Handpflege ablösen. Du verkaufst Artikel, deren Preis die Rohstoffberechnung aus einem Kurs ableitet, und hast die Kurse bisher morgens selbst eingetragen. Mit dem Standardintervall holt das Plugin sie alle 15 Minuten, resourcecalc:cron aktualisiert anschließend die gespeicherten Artikelpreise.

Ankauf aus demselben Kurs. Du kaufst über den Artikelankauf Ware von deinen Kunden an. Nach jedem Import richtet sich der Ankaufpreis nach dem neuen Kurs, du pflegst den Kurs an genau einer Stelle.

Vorhandener Cronjob. Du nutzt den Goldmarkt-Import schon länger mit dem Befehl resourcecalcgoldmarkt:cron. Der alte Name funktioniert weiter, dein Crontab-Eintrag muss nicht angepasst werden. Beim Update von einer älteren Version bleiben deine Zugangsdaten erhalten, und war eine Schnittstellen-URL eingetragen, ist der Abruf danach eingeschaltet.

Erst prüfen, dann laufen lassen. Du trägst die Zugangsdaten ein, schaltest den Abruf ein und startest den Befehl einmal von Hand. Die Ausgabe zeigt dir, welche Kurscodes aktualisiert, neu angelegt oder verworfen wurden. Passt alles, übernimmt ab dann die geplante Aufgabe.

Technische Fakten für deine IT

• Shopware 6.7.7 oder höher, PHP ab 8.2. Voraussetzung: Plugin Rohstoffberechnung (SwpResourceCalcSix), installiert und aktiv.
• Keine eigenen Tabellen, keine Änderung am Datenbankschema. Die Kurse schreibt ausschließlich die Import-Schnittstelle der Rohstoffberechnung. Sonst schreibt das Plugin nur das Intervall seiner eigenen geplanten Aufgabe.
• Externer Aufruf: ein HTTP-GET an die eingetragene Schnittstellen-URL, nur bei eingeschaltetem Abruf. Gesendet werden Benutzername und Passwort als Parameter g und i sowie page=resources und t=xml. Keine Kunden-, Bestell- oder Artikeldaten.
• Benutzername und Passwort sind Teil der aufgerufenen Adresse. Mit https:// ist die Übertragung verschlüsselt, in Zugriffsprotokollen der Gegenstelle oder eines Proxys können sie trotzdem auftauchen.
• Passwort: in der Administration maskiert, in der Systemkonfiguration im Klartext gespeichert, nie in der Logdatei. Fehlermeldungen enthalten die Parameter der Adresse nicht.
• Zeitlimits: Abbruch nach 10 Sekunden ohne Antwort, höchstens 30 Sekunden je Abruf, Antworten über 5 MB bricht das Plugin ab. Das XML wird ohne Netzwerkzugriff und ohne externe Entitäten gelesen.
• Eigene Logdatei unter var/log, eine Datei pro Tag, Dateiname beginnt mit SwpResourceCalcGoldmarktSix.
• Kein Code in der Storefront, keine Cookies, kein Einfluss auf die Ladezeit der Storefront. Das Plugin arbeitet nur in der geplanten Aufgabe und auf der Konsole.
• Konfiguration shopweit, die Kurse gelten für alle Verkaufskanäle. Shop-Währungen verändert der Import nicht.
• Deinstallation: Shopware entfernt die geplante Aufgabe und, wenn du die Daten nicht behältst, die Konfiguration samt Zugangsdaten. Bereits importierte Kurse bleiben in der Rohstoffberechnung.

Ehrlich gesagt

Das Plugin ist ein Zubringer, kein eigenes Preissystem. Ohne die Rohstoffberechnung kann es nichts, und ohne Zugangsdaten für die Goldmarkt-Schnittstelle auch nicht. Die bekommst du von Goldmarkt, ein Zugang ist im Plugin nicht enthalten. Welche Kurse in der Liste stehen, bestimmt dein Zugang, nicht das Plugin. Für den automatischen Abruf braucht dein Shop einen laufenden Worker für geplante Aufgaben, und die gespeicherten Artikelpreise aktualisiert erst resourcecalc:cron. Die Kurse gelten shopweit, eine Trennung je Verkaufskanal gibt es nicht. Passt das zu deinem Setup, probier es aus.

Häufige Fragen

Brauche ich dafür die Rohstoffberechnung?

Ja. Das Plugin Rohstoffberechnung muss installiert und aktiv sein. Der Kursimport schreibt die Kurse über deren Import-Schnittstelle und hat ohne sie kein Ziel.

Woher bekomme ich die Zugangsdaten?

Von Goldmarkt. Du brauchst Schnittstellen-URL, Benutzername und Passwort für die Goldmarkt-Schnittstelle. Ein Zugang ist im Plugin nicht enthalten.

Welche Kurse übernimmt das Plugin?

Alle Einträge der Kursliste, die einen Code und eine Währung tragen. Welche das sind, hängt von deinem Goldmarkt-Zugang ab. Einträge ohne Code oder Währung überspringt das Plugin und vermerkt das in der Logdatei.

Schreibt der Import auch die Artikelpreise?

Nein. Er schreibt nur die Kurse in die Kursdaten. Die in den Artikeln gespeicherten Preise aktualisiert der Befehl resourcecalc:cron der Rohstoffberechnung.

Was passiert, wenn ein Kurs fehlerhaft ankommt oder die Verbindung scheitert?

Ein Kurs von 0, ein negativer oder ein nicht numerischer Wert wird verworfen, der gespeicherte Kurs bleibt. Scheitert die Verbindung, schreibt das Plugin gar nichts und vermerkt den Fehler ohne Zugangsdaten in der Logdatei.

Kann ich die Kurse je Verkaufskanal unterschiedlich steuern?

Nein. Die Kurse gelten shopweit für alle Verkaufskanäle, genau wie in der Rohstoffberechnung selbst. Unterschiedliche Kurse je Kanal kann das Plugin nicht abbilden.

Was braucht mein Server für den automatischen Abruf?

Einen laufenden Worker für geplante Aufgaben. Ohne ihn startest du den Abruf per Befehl bin/console resourcecalc:goldmarkt:import, zum Beispiel aus einem Cronjob.

Welche Daten verlassen meinen Shop?

Nur Benutzername und Passwort für die Goldmarkt-Schnittstelle, gesendet an die Schnittstellen-URL, die du einträgst. Kunden-, Bestell- und Artikeldaten bleiben im Shop. Ist der Abruf ausgeschaltet, baut das Plugin keine Verbindung auf.

Merkt meine Storefront etwas davon?

Nein. Das Plugin bringt keinen Code in die Storefront und funktioniert mit jedem Theme. Es arbeitet nur in der geplanten Aufgabe und auf der Konsole.

Was passiert bei der Deinstallation mit meinen Daten?

Das Plugin hat keine eigenen Tabellen. Shopware entfernt die geplante Aufgabe und, wenn du die Daten nicht behältst, die Konfiguration samt Zugangsdaten. Bereits importierte Kurse bleiben in der Rohstoffberechnung stehen.