Bestandsaktualisierung automatisieren

Über die Erweiterung

Zweck dieses Plugins

Dieses Plugin hilft Ihnen dabei Ihren Bestand aktuell zu halten indem es einen
Cronjob zum automatisierten Import von CSV-Dateien bereitstellt. Zum Beispiel
falls Sie auf mehreren Platformen verkaufen und Ihren Bestand regelmäßig mit
Ihrer Warenwirtschaft abgleichen müssen.

Der Cronjob des Plugin prüft in frei wählbaren Intervallen ob sich die konfigurierte
Datei geändert hat, und importiert sie gegebenenfalls.

(De-)Installation

Über den Plugin-Manager, siehe Shopware-Dokumentation für Details.

Bitte leeren Sie nach Installation den Shopware-Cache, andernfalls könnte es
dazu kommen das der Cronjob nicht ausgeführt werden kann da benötigte
Komponenten nicht gefunden werden können. Nach der Installation erscheint eine
Abfrage mit der Sie dies direkt erledigen können.

Nutzung

Wie Sie den Cronjob letztendlich aufrufen, ist absolut egal. Das kann über den
Browser, die Crontab oder auch bin/console erfolgen. Details entnehmen Sie
bitte der Shopware-Dokumentation https://community.shopware.com/Cronjobs_detail_1102.html#Wie_starte_ich_einen_Cronjob.3F.
Um die Häufigkeit/das Interval des Imports zu konfigurieren, können Sie das
Interval des Cronjobs bearbeiten.

Der “Action name” für die Ausführung über bin/console lautet
Shopware_CronJob_pixe2SimpleStockUpdateCron. Der komplette Befehl zum starten
des Cronjobs lautet also bin/console sw:cron:run Shopware_CronJob_pixe2SimpleStockUpdateCron.

Je nach Artikelanzahl kann die Ausführung durchaus etwas länger dauern, die
Ausführung über den Browser ist daher ungeeignet.

Konfiguration

Das Plugin bietet Optionen um den Prozess anzupassen. Passen Sie diese
zuerst Ihren Erfordernissen an und aktivieren Sie anschließend den Cronjob
des Plugins unter Grundeinstellungen > System > Cronjobs. Bitte beachten Sie
das dass Shopware eigene “Cron” Plugin aktiviert sein muss.

Dateipfad

Geben Sie hier den Namen der zu importierenden Datei ein. Das Plugin geht davon
aus das diese Datei im Pluginverzeichnis liegt. Das Pluginverzeichnis finden Sie
unter <ihrshopverzeichnis>/custom/plugins/pixe2SimpleStockUpdate. Sie können
aber auch einen relativen Pfad hier eingeben, solange er für den Webserver bzw.
PHP-Benutzer lesbar ist. Wenn Ihre Datei z.B im Hauptordner des Shops liegt,
würde der relative Pfad ../../../dateiname.csv lauten. Bitte beachten Sie,
nicht nur der Pfad selbst muss für den Webserver lesbar sein - natürlich auch
die Datei selbst.

Alternativ ist es auch möglich eine HTTP(S) oder FTP URL anzugeben, die Datei
wird dann für den Import heruntergeladen und nach Import wieder gelöscht.

Spalten-Trennzeichen

Geben Sie das Spalten-Trennzeichen hier ein. Es sind beliebige Zeichenketten
möglich, üblicherweise z. B. “,” oder “;”. Um [TAB] als Trennzeichen zu
verwenden, bitte “\t” eingeben.

Identifizierungs-Spalte

Numerischer Index der Spalte die den Zuordnungswert enthält.
(Hinweis: Zählung beginnt bei 0!)

Wert Spalte

Numerischer Index der Spalte mit dem neuen Bestand
(Hinweis: Zählung beginnt bei 0!)

Erste Zeile überspringen

Falls die erste Zeile in der Datei Spaltenköpfe enthält, können Sie diese Option
aktivieren um Sie beim Import zu ignorieren.

Rückgabewert

Hier mit können Sie konfigurieren welche Art von Rückmeldung erfolgen soll. Es
gibt die Möglichkeit das Ergebnis als Klartext, JSON oder in serialisierter Form
zurückzugeben,oder auch auszugeben. Alternativ ist es auch möglich eine Aus- bzw.
Rückgabe komplett zu unterdrücken.

Artikel (de-)aktivieren

Wenn aktiviert, werden die Artikel automatisch de-/aktiviert, je nach dem ob
der importierte Bestand größer 0 ist.

Identitätsfeld

Erlaubt Ihnen festzulegen anhand welcher Eigenschaft die Daten zugeordnet werden.
Standardmäßig wird die Bestellnummer genutzt.

Sperr-Mechanismus deaktivieren

Normalerweise legt das Plugin sobald der Import startet eine Datei “.lockfile”
im Pluginverzeichnis an. Wenn diese existiert, kann kein Import gestartet werden.
Gedacht ist dieser Mechanismus um mehrere laufende Imports zu unterbinden.

Falls der letzte Import aber abgebrochen wurde, in der Regel wegen Ausführung über
den Browser und max_execution_time, verbleibt diese Sperrdatei und verhindert einen
neuerlichen Importlauf. Mit dieser Option können Sie diesen Sperrmechanismus komplett
aushebeln ohne die Datei zu entfernen.

WICHTIG: Diese Option ist als Workaround gedacht, nicht für den Dauerbetrieb. Wenn
nach dem Import die Sperrdatei nicht entfernt wurde, wurde der Import auch nicht
erfolgreich beendet!

Änderungscheck deaktivieren

Normalerweise führt das Plugin den Import nur durch, falls sich die Importdatei
seit dem letzten Lauf verändert hat. Diese Prüfung kann hiermit deaktiviert werden,
so das der Import immer ausgeführt wird.

Zeichensatz konvertieren

Falls die Importdatei nicht im UTF-8 Format vorliegt, können Sie diese Option
aktivieren für eine automatische Umwandlung.

Hinweis: Dies funktioniert nur für die Zeichensätze Latin1 (ISO 8859-1) und Windows-1252.

Zeilenumbrüche normalisieren

Falls die Importdatei “\r” Zeilenumbrüche, oder einen Mix, nutzt können Sie mit
dieser Option einen Workaround aktivieren.

Nicht importierte Artikel deaktivieren

Falls aktiviert, werden alle Artikel die nicht in der importierten Datei enthalten
waren deaktiviert. Um dies einzugrenzen kann die Option ““Nicht importiert” Prefix”
genutzt werden.

Hinweis: Dies funktioniert nur wenn die Bestellnummer als Identitätsfeld genutzt
wird!

Wenn gesetzt, betrifft die Option “Nicht importierte Artikel deaktivieren” nur
Artikel deren Bestellnummer mit diesem Wert beginnt.

Falls aktiv, wird zusätzlich zur Deaktivierung der Bestand auf 0 gesetzt.

Pickware-Unterstützung

Wenn aktiviert, werden die Bestandsänderungen “nativ” in Pickware importiert und
nicht einfach nur der Lagerbestand am Artikel aktualisiert.

Wenn Sie das Plugin vor diesem Update bereits in Kombination mit Pickware genutzt
haben, wurden die Bestandsänderungen bislang direkt auf dem “reservierten Bestand”
ausgeführt. Mit aktiven Pickware-Support erfolgen die Buchungen auf den “physischen
Bestand”, daher kann es zu falschen (bzw. doppelten) Gesamtbeständen kommen. Bitte
kontrollieren Sie daher nach dem ersten Import mit aktivierter Pickware-Unterstützung
den Bestand der betroffenen Artikel!

Wenn die Importdatei relative Bestandsangaben, also Ab-/Zugänge statt
Gesamtwert, liefert, aktivieren Sie diese Option. Ohne diese Option
werden absolute Gesamtwerte in der Datei erwartet.

Geben Sie hier den Namen des Lagers ein auf dem die Änderungen gebucht werden sollen.

Mit dieser Option können Sie einen Lagerplatz für die Buchungen vorgeben (Standard:
pickware_null_bin_location).

Anmerkungen

Nicht existierende Artikel werden als Fehler geloggt, ansonsten wird der Import
aber weiter ausgeführt.

Sollte für einen Artikel ein nicht numerischer Bestand in der Importdatei
enthalten sein, so führt dies dazu das der entsprechende Artikel nach Import
einen Bestand von 0 hat.

Die Ergebnisse des Import sind im konfigurierten Format in der Cronjob
Konfiguration ersichtlich. Alternativ bietet sich die Umleitung der Ausgabe in
eine Datei an.

Alle Spalten in der Importdatei, außer die konfigurierten Spalten für
Artikelnummer und Bestand, werden ignoriert. Sie müssen aber dennoch in den
Speicher geladen werden, je nach Dateigröße kann es Sinn machen die Datei
vorher zu reduzieren.