Actualize
Shopware-Plugin · Daten & Administration

Lagerbestand Importer. Bestände per CSV einspielen.

Das Plugin liest Lagerbestände aus CSV-Dateien und überträgt Bestand und Aktiv-Status auf Ihre Produkte. Die Dateien kommen aus einem Ordner auf dem Server oder von einem SFTP-Server.

Shopware
ab 6.7
PHP
ab 8.4
Sprachen
DE & EN
Preis
Kostenlos
Lizenz
MIT, Open SourceSupport über GitHub Issues

Was das Plugin kann

CSV mit drei Spalten

Produktnummer, Bestand und Aktiv-Status, getrennt durch Semikolon. Die erste Zeile gilt als Kopfzeile.

Lokaler Ordner oder SFTP

Die Dateien liegen in einem Import-Ordner auf dem Shop-Server oder werden von einem SFTP-Server abgeholt.

Zeitgesteuert oder von Hand

Eine geplante Aufgabe importiert im eingestellten Intervall. Ein Konsolenbefehl startet den Import sofort.

Nur echte Änderungen

Geschrieben werden nur Produkte, deren Bestand oder Aktiv-Status sich gegenüber dem Shop geändert hat.

Doppelte Nummern werden addiert

Steht eine Produktnummer mehrfach in der Datei, zählt die Summe der Bestände. Ist eine der Zeilen aktiv, bleibt das Produkt aktiv.

Backup verarbeiteter Dateien

Jede verarbeitete Datei wandert mit Zeitstempel in einen Backup-Ordner und wird dort nach der gewählten Frist gelöscht – Standard sind 30 Tage.

So funktioniert’s

Ein Importlauf in vier Schritten.

  1. Dateien einsammeln

    Das Plugin nimmt alle CSV-Dateien aus dem Import-Ordner – oder lädt sie vom SFTP-Server herunter und löscht sie dort.

  2. Zeilen zusammenfassen

    Die älteste Datei kommt zuerst. Mehrfach genannte Produktnummern werden zu einem Bestand addiert.

  3. Abgleichen und schreiben

    Produkte werden über die Produktnummer gefunden. Geschrieben wird nur, wenn Bestand oder Aktiv-Status abweichen.

  4. Protokollieren und sichern

    Das Shopware-Log hält jede Änderung mit dem vorherigen Wert und eine Zusammenfassung je Datei fest. Die Datei wandert in den Backup-Ordner.

Geschrieben wird nur, was sich geändert hat.

Bestandsdateien wiederholen meist dieselben Werte. Ein Import, der trotzdem jede Zeile schreibt, stößt bei jedem Lauf Indexierung und Cache-Leerung an. Das Plugin vergleicht vorher.

Abgleich vor dem Schreiben

Bestand und Aktiv-Status jeder Zeile werden mit dem aktuellen Stand im Shop verglichen. Unveränderte Produkte bleiben unberührt.

Kein Leerlauf

Eine Datei, die nur bekannte Werte wiederholt, löst keinen einzigen Schreibvorgang aus.

Verarbeitung in Blöcken

Produkte werden in Blöcken von 500 nachgeschlagen und geschrieben – nicht einzeln je Zeile.

Unbekannte Produktnummern

Nummern, die der Shop nicht kennt, werden übersprungen und als Warnung protokolliert. Der Import läuft weiter.

Zusammenfassung je Datei

Das Log nennt für jede Datei, wie viele Produkte geprüft, geändert, unverändert und nicht gefunden wurden.

Wann es passt

Warenwirtschaft liefert Bestandsdateien

Ihr ERP oder Lagersystem exportiert regelmäßig eine CSV-Datei. Das Plugin gleicht den Shop damit ab.

Dateien per SFTP abholen

Das exportierende System legt die Dateien auf einem SFTP-Server ab. Das Plugin holt sie ab und verarbeitet sie auf dem Shop-Server.

Artikel ohne Bestand abschalten

Über die dritte Spalte schaltet die Datei Produkte inaktiv und später wieder aktiv – ohne Handarbeit im Admin.

In wenigen Schritten startklar

  1. Per Composer installieren

    Paket laden, Plugin installieren und aktivieren, Cache leeren – die vier Befehle stehen unten.

  2. Quelle wählen

    „Lokales Verzeichnis“ oder „SFTP Server“. Für SFTP tragen Sie Host, Port, Benutzername, Passwort und Pfad ein.

  3. Automatischen Import einschalten

    Den Schalter „Automatischen Import aktivieren“ setzen und das Intervall in Minuten festlegen. Voreingestellt sind 2 Minuten.

  4. Erste Datei testen

    Eine Datei bereitstellen und den Import einmal über die Konsole starten. Das Ergebnis steht im Shopware-Log.

composer require actualizer/stock-importer
bin/console plugin:refresh
bin/console plugin:install --activate ActStockImporter
bin/console cache:clear

Das sollten Sie vorher wissen

Die Datei liefert den verfügbaren Bestand

Der Wert aus der Datei ersetzt den Bestand im Shop. Shopware zieht offene Bestellungen dort bereits ab – die Datei sollte deshalb den verfügbaren, nicht den physischen Lagerbestand enthalten.

Die dritte Spalte ist Pflicht

Zeilen mit weniger als drei Spalten werden übersprungen. Eine 0 in der dritten Spalte schaltet das Produkt inaktiv und nimmt es damit aus dem Shop.

SFTP mit Benutzername und Passwort

Die Anmeldung am SFTP-Server erfolgt mit Benutzername und Passwort, nicht mit Schlüsseldatei. Abgeholte Dateien löscht das Plugin auf dem SFTP-Server.

Für alle, die es genau wissen wollen

Shopware
ab 6.7
PHP
8.4 oder neuer
Paket

actualizer/stock-importer, bringt phpseclib/phpseclib für SFTP mit.

Dateiformat

CSV mit Semikolon: Produktnummer; Bestand als ganze Zahl; Aktiv als 1 oder 0. Die erste Zeile wird immer übersprungen.

Import-Ordner

_act_stockimporter im Shopware-Hauptverzeichnis, verarbeitete Dateien im Unterordner backup mit Zeitstempel im Dateinamen.

Geplante Aufgabe

act_stock.import – importiert nur, wenn der automatische Import eingeschaltet ist und die geplanten Aufgaben des Shops ausgeführt werden.

Konsole

bin/console act:stock:import startet den Import sofort, unabhängig vom Zeitplan.

Geschriebene Felder

Bestand und Aktiv-Status des Produkts. Andere Produktdaten ändert der Import nicht.

Aufbewahrung

Backup-Dateien bleiben 7, 14, 30, 90, 180 oder 365 Tage; Standard sind 30 Tage.

Protokoll

Shopware-Log: jede Änderung mit altem und neuem Wert, unbekannte Produktnummern als Warnung, Zusammenfassung je Datei.

Häufige Fragen

Wie muss die CSV-Datei aussehen?

Drei Spalten, getrennt durch Semikolon: Produktnummer, Bestand als ganze Zahl, Aktiv-Status als 1 oder 0. Die erste Zeile wird als Kopfzeile übersprungen – auch wenn sie Daten enthält.

Was passiert mit Produkten, die nicht in der Datei stehen?

Nichts. Der Import ändert nur Produkte, deren Produktnummer in der Datei vorkommt.

Was passiert bei unbekannten Produktnummern?

Sie werden übersprungen und als Warnung im Shopware-Log vermerkt. Die Zusammenfassung je Datei nennt ihre Anzahl.

Funktioniert der Import auch für Varianten?

Ja. Der Import sucht über die Produktnummer, und Varianten haben in Shopware eigene Produktnummern.

Wie oft läuft der Import?

Im eingestellten Intervall, sofern der automatische Import eingeschaltet ist und die geplanten Aufgaben Ihres Shops laufen. Voreingestellt sind 2 Minuten. Über die Konsole starten Sie den Import jederzeit von Hand.

Was kostet das Plugin?

Nichts. Lagerbestand Importer steht unter der MIT-Lizenz und ist frei auf GitHub verfügbar.

Bekomme ich Support?

Fragen und Fehler melden Sie über den Issue Tracker auf GitHub. Wir lesen dort mit und beheben Fehler, eine feste Reaktionszeit können wir bei einem kostenlosen Plugin aber nicht zusagen. Wenn Sie Hilfe bei Einrichtung oder Anpassung möchten oder eine verbindliche Betreuung brauchen, übernehmen wir das gern als Auftrag.

Unterstützung

Lagerbestand Importer mit uns einrichten?

Das Plugin ist kostenlos. Wenn Sie Hilfe bei der Einrichtung oder eine Anpassung brauchen, sprechen Sie uns an.