Zum Inhalt springen
Shopware 6 Handbuch

Chargenverwaltung & Seriennummern

Chargenverwaltung und Seriennummern in Shopware: Jede Bestellposition bekommt ihre Charge, Seriennummern erfasst du beim Versand. Bei einem Rückruf findest du jeden betroffenen Kunden.

Version 6.7.0 Kompatibel mit 6.7.9 und neuer 29 Min. Lesezeit
Auf dieser Seite

Einleitung

Chargenverwaltung & Seriennummern hilft dir dabei, für jede Bestellposition festzuhalten, aus welcher Charge die Ware stammt und welche Seriennummer das Gerät trägt — damit du bei einem Rückruf oder einer Reklamation in Sekunden siehst, welche Kunden betroffen sind.

Was du mit diesem Plugin erreichst

  • Du legst für jede Lieferung eine Charge an und markierst sie als aktiv. Jede neue Bestellung erhält diese Charge automatisch.
  • Wenn du möchtest, führt das Plugin die Restmenge jeder Charge und wechselt von selbst zur nächsten Charge, sobald die aktive aufgebraucht ist.
  • Seriennummern erfasst du beim Versand direkt in der Bestellung — per Tastatur oder mit einem Barcode-Scanner.
  • Bis zum Versand kannst du jede Zuordnung korrigieren. Danach ist sie endgültig.
  • Über die Rückverfolgung suchst du nach einer Chargen- oder Seriennummer und siehst sofort Bestellnummer, Bestelldatum, Kunde und Menge.
  • Auf Wunsch druckt Shopware Charge und Seriennummer auf den Lieferschein. Im Shop, im Kundenkonto, in E-Mails und auf Rechnungen erscheinen sie nie.

Für wen ist dieses Plugin?

Für Händler, die Ware mit Chargen- oder Seriennummernpflicht verkaufen oder ihre Lieferungen zurückverfolgen wollen — zum Beispiel Lebensmittel, Kosmetik, Chemie, Baustoffe, Fliesen und Farben, Elektronik und Werkzeug.

Installation

Systemvoraussetzungen

  • Shopware 6.7 (ab 6.7.9)
  • Bei mehreren Servern oder sehr großen Löschläufen: ein gemeinsamer Sperrspeicher. Läuft dein Shop auf mehr als einem Server (zum Beispiel mehrere Web- oder Hintergrund-Server hinter einem Lastverteiler) oder löschst du sehr viele Bestellungen auf einmal über eine Schnittstelle, braucht das Plugin einen gemeinsamen Sperrspeicher, etwa Redis. Ohne ihn können die Mengenzähler deiner Chargen in seltenen Fällen falsch werden. Läuft dein Shop auf einem einzelnen Server, musst du nichts tun. Bist du unsicher, gib deinem Hoster oder deiner Agentur den Abschnitt Für Administratoren / Technische Details weiter.

Plugin installieren und aktivieren

Nach dem Kauf steht dir das Plugin direkt in deiner Administration zur Verfügung — du musst nichts herunterladen.

  1. Melde dich in deiner Shopware-Administration an (DeinShop.de/admin).
  2. Öffne Erweiterungen → Meine Erweiterungen.
  3. Klicke neben Chargenverwaltung & Seriennummern auf Installieren.
  4. Aktiviere das Plugin über den Schalter neben dem Eintrag — fertig.

Das Plugin unter Meine Erweiterungen, installiert und aktiv Abb. 1: Chargenverwaltung & Seriennummern unter Erweiterungen → Meine Erweiterungen — installiert und aktiv

Taucht Chargenverwaltung & Seriennummern nicht in der Liste auf, ist dein Shopware-Account noch nicht mit dem Shop verbunden. Das erledigst du unter Erweiterungen → Meine Erweiterungen über die Anmeldung mit deinem Shopware-Konto.

Erste Schritte

In fünf Schritten zur ersten Bestellung mit Charge:

  1. Einstellungen öffnen: Klicke unter Erweiterungen → Meine Erweiterungen beim Plugin auf Konfigurieren. Prüfe, dass Chargenverwaltung und — falls du sie brauchst — Seriennummern eingeschaltet sind (siehe Einstellungen).
  2. Artikel freischalten: Öffne den Artikel unter Produkte → Übersicht, wechsle in den Reiter Chargen & Seriennummern und schalte in der Card Zuweisung den Schalter Chargen ein (siehe So legst du fest, welche Artikel Chargen oder Seriennummern bekommen).
  3. Erste Charge anlegen: Klicke im selben Reiter auf Neue Charge, trage Chargennummer und Menge ein und setze den Haken Als aktive Charge markieren.
  4. Bestellen: Ab jetzt erhält jede neue Bestellung dieses Artikels die aktive Charge automatisch.
  5. Ergebnis prüfen: Öffne die Bestellung unter Bestellungen. Im Reiter Allgemein zeigt die Card Chargen & Seriennummern die zugeordnete Charge.

Alle Listen findest du gesammelt unter Produkte → Chargen & Seriennummern.

Menüeintrag Chargen & Seriennummern unter Produkte Abb. 2: Der Menüeintrag Chargen & Seriennummern unter Produkte

Einstellungen

Die Einstellungen findest du unter Erweiterungen → Meine Erweiterungen — klicke beim Plugin auf Konfigurieren.

Konfigurationsseite des Plugins Abb. 3: Konfigurationsseite mit den Cards Allgemein, Chargen und Lieferschein

Oben wählst du unter Verkaufskanal aus, für welchen Shop eine Einstellung gilt. Unter Alle Verkaufskanäle legst du die Grundeinstellung fest; für einzelne Verkaufskanäle kannst du davon abweichen. So nutzt du die Funktionen zum Beispiel in deinem B2B-Shop und lässt sie im B2C-Shop aus.

Ganz oben in der Card Allgemein öffnet die Schaltfläche Dokumentation öffnen diese Anleitung im Browser.

Plugin für diesen Verkaufskanal aktivieren

Mit Plugin für diesen Verkaufskanal aktivieren schaltest du das Plugin für den gewählten Verkaufskanal ab, ohne es zu deinstallieren. Standardmäßig ist es eingeschaltet. Ist es aus, bekommen Bestellungen aus diesem Verkaufskanal keine Charge, und der Lieferschein zeigt keine Chargen.

Wozu das gut ist: Du betreibst einen Verkaufskanal, in dem du keine Rückverfolgung brauchst, und willst ihn sauber heraushalten.

Chargenverwaltung

Mit Chargenverwaltung legst du fest, ob Bestellungen dieses Verkaufskanals die aktive Charge des Artikels erhalten. Standardmäßig ist die Funktion eingeschaltet. Ist sie in keinem Verkaufskanal aktiv, blendet das Plugin alles rund um Chargen in der Administration aus.

Wozu das gut ist: Du brauchst nur Seriennummern und willst die Chargen-Oberfläche gar nicht sehen.

Seriennummern

Mit Seriennummern legst du fest, ob du für Bestellungen dieses Verkaufskanals Seriennummern erfassen kannst. Standardmäßig ist die Funktion eingeschaltet. Ist sie in keinem Verkaufskanal aktiv, verschwinden der Reiter Seriennummern, die Seriennummern-Card am Artikel und das Erfassungsfeld in der Bestellung.

Wozu das gut ist: Du verkaufst keine Geräte mit Seriennummer und möchtest eine aufgeräumte Oberfläche.

Chargenmengen abbuchen

Mit Chargenmengen abbuchen (Card Chargen) entscheidest du, ob das Plugin die Restmenge deiner Chargen führt. Standardmäßig ist der Schalter aus. Die Einstellung gilt immer für alle Verkaufskanäle gemeinsam — stelle sie deshalb unter Alle Verkaufskanäle ein. Ein Wert bei einem einzelnen Verkaufskanal wird nicht beachtet, weil alle Verkaufskanäle dieselbe Restmenge verbrauchen. Sie wirkt nur, wenn die Chargenverwaltung eingeschaltet ist.

  • Aus: Die Menge einer Charge dient nur zu deiner Information. Jede Bestellung bekommt die aktive Charge, egal wie viel davon noch da ist. Einen automatischen Wechsel gibt es nicht — die nächste Charge markierst du selbst als aktiv.
  • An: Jede Bestellung verringert die verfügbare Menge der Charge. Ist die aktive Charge aufgebraucht, wird automatisch die nächste wartende Charge aktiv (gesperrte Chargen werden übersprungen). Reicht die aktive Charge nicht für die ganze Position, teilt das Plugin die Position auf zwei Chargen auf — außer du hast das am Artikel verboten (siehe So legst du fest, welche Artikel Chargen oder Seriennummern bekommen). Kommt Ware zurück, zählt die Menge erst wieder, wenn du das entschieden hast (siehe Offene Rückbuchungen).

Wozu das gut ist: Mit eingeschalteter Mengenführung musst du nicht darauf achten, wann eine Lieferung aufgebraucht ist — der Wechsel passiert von selbst, und jede Bestellung bekommt die Charge, aus der die Ware tatsächlich stammt.

Wichtig: Den Lagerbestand deines Artikels verändert das Plugin nie. Weicht die Summe der verfügbaren Chargenmengen vom Lagerbestand ab, zeigt dir der Artikel einen Hinweis (siehe So legst du fest, welche Artikel Chargen oder Seriennummern bekommen).

Chargen und Seriennummern auf dem Lieferschein ausweisen

Mit Chargen und Seriennummern auf dem Lieferschein ausweisen (Card Lieferschein) druckt Shopware die zugeordneten Chargen (mit Menge) und Seriennummern je Position auf die Lieferscheine dieses Verkaufskanals. Standardmäßig ist der Schalter aus. Shop, Kundenkonto, E-Mails und Rechnungen zeigen Chargen und Seriennummern nie.

Wozu das gut ist: Dein Kunde hat die Charge schriftlich in der Hand, kann bei einer Nachbestellung dieselbe Charge verlangen und findet die Seriennummer für eine Reklamation sofort.

Speichere deine Änderungen oben rechts mit Speichern.

So legst du fest, welche Artikel Chargen oder Seriennummern bekommen

Was dir das bringt: Nicht jeder Artikel braucht eine Charge oder Seriennummer. Du schaltest die Funktion gezielt für die Artikel ein, bei denen du sie brauchst. Alle anderen Bestellungen bleiben unberührt.

Reiter Chargen & Seriennummern am Artikel Abb. 4: Reiter Chargen & Seriennummern am Artikel mit den Cards Zuweisung und Chargen

Schritt für Schritt

  1. Gehe zu Produkte → Übersicht und öffne den Artikel.
  2. Wechsle in den Reiter Chargen & Seriennummern.
  3. Schalte in der Card Zuweisung ein, was dieser Artikel bekommen soll:
    • Chargen: Bestellpositionen dieses Artikels erhalten bei Bestellabschluss die aktive Charge.
    • Position nicht auf mehrere Chargen aufteilen: Reicht die aktive Charge nicht für die ganze Position, geht die Position vollständig an die nächste wartende Charge mit ausreichender Menge. Das brauchst du zum Beispiel bei Fliesen oder Farbe, wo eine Lieferung farblich aus einer einzigen Charge stammen muss. Wirkt nur, wenn Chargenmengen abbuchen eingeschaltet ist.
    • Seriennummern: Beim Versand erfasst du je Bestellposition die Seriennummern.
  4. Jede Änderung an einem Schalter wird sofort gespeichert. Du siehst die Meldung „Die Zuweisung wurde gespeichert.“

Darunter zeigt die Card Chargen alle Chargen dieses Artikels mit Status, Haken für die aktive Charge, Menge und — bei eingeschalteter Mengenführung — der Angabe „zugeordnet · verfügbar“.

Das Plugin weist dich hier auf Lücken hin:

  • „Keine aktive Charge: Neue Bestellungen erhalten den Hinweis „Charge zuordnen“.“
  • „Die aktive Charge ist aufgebraucht (verfügbare Menge 0).“
  • „Die verfügbare Chargenmenge (…) weicht vom Lagerbestand (…) ab.“ — nur ein Hinweis, das Plugin ändert deinen Lagerbestand nicht.

Varianten

Die Zuweisung am Hauptprodukt gilt für alle Varianten, die nichts Eigenes festlegen. An einer Variante kannst du die Vererbung aufheben und andere Schalter setzen — das Hauptprodukt bleibt davon unberührt.

Auch die Chargen erben: Eine Variante ohne eigene Chargen nutzt die Chargen des Hauptprodukts. Das siehst du am Hinweis „Diese Variante nutzt die Chargen des Hauptprodukts.“

Variante, die die Chargen des Hauptprodukts nutzt Abb. 5: Variante, die die Chargen des Hauptprodukts nutzt

Legst du an einer Variante über Neue Charge eine Charge an, gehört diese Charge nur zu dieser Variante. Die Variante nutzt danach ausschließlich ihre eigenen Chargen. Der Hinweis lautet dann „Diese Variante hat eine eigene Chargenliste.“

Variante mit eigener Chargenliste Abb. 6: Variante mit eigener Chargenliste

Tipp: Seriennummern erben nie. Eine Seriennummer gehört immer zu genau einer Variante bzw. zu einem Artikel ohne Varianten. Am Hauptprodukt weist dich das Plugin darauf mit „Seriennummern werden an der Variante gepflegt.“ hin.

So verwaltest du Chargen

Was dir das bringt: Für jede Lieferung eine eigene Charge mit Menge, Eingangsdatum, Herstelldatum und Lieferant — und eine klare Reihenfolge, welche Charge als Nächstes dran ist.

Die Chargenliste

Unter Produkte → Chargen & Seriennummern siehst du im Reiter Chargen alle Chargen deines Shops. Über die Felder Chargennummer enthält, Artikel und Status grenzt du die Liste ein.

Chargenliste Abb. 7: Die Chargenliste mit den Reitern Chargen, Seriennummern, Rückverfolgung und Offene Rückbuchungen

Jede Charge hat einen dieser Status:

  • Verfügbar — die Charge kann Bestellungen zugeordnet werden.
  • Gesperrt — die Charge wird nie zugeordnet, weder automatisch noch von Hand. Das nutzt du zum Beispiel für eine fehlerhafte Lieferung.

Die Spalte Aktiv zeigt mit einem Haken, welche Charge neue Bestellungen gerade bekommen.

Eine Charge anlegen

  1. Klicke im Reiter Chargen auf Charge anlegen. Alternativ legst du sie direkt am Artikel über Neue Charge an — dort setzt du mit Als aktive Charge markieren gleich die aktive Charge.
  2. Fülle in der Card Stammdaten aus:
    • Chargennummer: die Nummer deines Lieferanten oder deine eigene Nummer.
    • Artikel: das Hauptprodukt oder eine Variante. Varianten ohne eigene Chargen nutzen die Chargen des Hauptprodukts.
    • Menge (Verkaufseinheiten): die gelieferte Menge in der Einheit, in der du verkaufst — bei Flächenware also Pakete, nicht m².
    • Eingangsdatum, Herstelldatum, Lieferant, Notiz: zu deiner Information.
    • Wartereihenfolge: die Position in der Warteschlange. Ist die aktive Charge aufgebraucht, wird die Charge mit der nächsten Position automatisch aktiv. Lässt du das Feld leer, wartet die Charge nicht und wird nie automatisch aktiv.
  3. Klicke auf Speichern.

Formular Neue Charge Abb. 8: Eine neue Charge anlegen

Eine Charge im Detail

Klicke in der Liste auf eine Chargennummer. Oben siehst du Status, Zugeordnet und Verfügbar. Die Card Zuordnungen listet jede Bestellung, die diese Charge erhalten hat — mit Menge, Quelle (Automatisch oder Manuell), Datum und, falls zutreffend, wann sie gelöst oder versandt wurde.

Detailansicht einer Charge Abb. 9: Detailansicht einer Charge mit ihren Bestellzuordnungen

Hier stehen dir diese Aktionen zur Verfügung:

  • Als aktiv markieren: Neue Bestellungen erhalten ab sofort diese Charge. Die bisher aktive Charge ist dann nicht mehr aktiv. Eine gesperrte Charge kannst du nicht als aktiv markieren.
  • Sperren und Entsperren: schließt eine Charge von jeder Zuordnung aus bzw. gibt sie wieder frei.

Tipp: Nutzt du zusätzlich unser MHD-Plugin, erinnert dich beim Aktivieren einer Charge ein Hinweis daran, das Mindesthaltbarkeitsdatum am Artikel anzupassen.

Wartereihenfolge am Artikel ändern

Im Reiter Chargen & Seriennummern am Artikel öffnest du in der Card Chargen das Kontextmenü (…) einer Charge. Dort findest du In Wartereihenfolge aufnehmen, In Wartereihenfolge nach oben, In Wartereihenfolge nach unten und Aus Wartereihenfolge entfernen, außerdem Als aktiv markieren, Sperren, Entsperren und Bearbeiten.

Was sich nach der ersten Bestellung nicht mehr ändern lässt

Sobald eine Charge einer Bestellung zugeordnet ist, schützt das Plugin die Rückverfolgung:

  • Die Chargennummer lässt sich nicht mehr ändern.
  • Die Charge lässt sich keinem anderen Artikel mehr zuweisen.
  • Mit eingeschalteter Mengenführung darf die Menge (Verkaufseinheiten) nicht kleiner sein als die bereits zugeordnete Menge.
  • Löschen ist nicht mehr möglich. Der Hinweis lautet „Charge hat Bestellzuordnungen — sperren statt löschen.“ Sperre die Charge stattdessen.

So verwaltest du Seriennummern

Was dir das bringt: Du hinterlegst die Seriennummern deiner Geräte vorab, ordnest beim Versand die richtige Nummer der Bestellung zu und siehst später für jede Nummer, an welchen Kunden sie ging.

Seriennummern am Artikel anlegen

  1. Öffne den Artikel (bei Varianten: die konkrete Variante) und wechsle in den Reiter Chargen & Seriennummern.

  2. Klicke in der Card Seriennummern auf Seriennummern einfügen.

    Seriennummern am Artikel Abb. 10: Card Seriennummern am Artikel

  3. Füge eine Seriennummer je Zeile ein — bis zu 1.000 Zeilen auf einmal, zum Beispiel direkt aus einer Tabelle oder vom Scanner. Unter dem Feld siehst du, wie viele Zeilen erkannt wurden.

    Fenster Seriennummern einfügen Abb. 11: Seriennummern als Liste einfügen

  4. Klicke auf Seriennummern anlegen. Das Ergebnis zeigt „Angelegt: … · übersprungen (vorhanden): … · ungültig: …“.

Leerzeichen vor oder nach einer Nummer entfernt das Plugin. Nummern, die es schon gibt, und doppelte Zeilen werden übersprungen.

Die Seriennummernliste

Unter Produkte → Chargen & Seriennummern siehst du im Reiter Seriennummern alle Nummern deines Shops. Auch hier kannst du über Seriennummern einfügen Nummern anlegen — dann wählst du zusätzlich den Artikel / Variante.

Seriennummernliste Abb. 12: Die Seriennummernliste

Jede Seriennummer hat einen dieser Status:

  • Verfügbar — kann einer Bestellung zugeordnet werden.
  • Zugeordnet — gehört zu einer Bestellung.
  • Retourniert — kam per Retoure zurück oder gehörte zu einer gelöschten, bereits versandten Position. Du prüfst das Gerät und entscheidest danach.
  • Defekt — wird nicht mehr zugeordnet.

Den Status änderst du im Kontextmenü (…) oder in der Detailansicht:

  • Freigeben (verfügbar) — bei retournierten und defekten Nummern.
  • Als defekt markieren — bei verfügbaren und retournierten Nummern.

Eine Seriennummer im Detail

Klicke auf eine Seriennummer. Die Card Zuordnungshistorie zeigt jede Bestellung, der diese Nummer zugeordnet war — auch nach einer Retoure.

Detailansicht einer Seriennummer Abb. 13: Detailansicht einer Seriennummer mit Zuordnungshistorie

Nach der ersten Bestellzuordnung lässt sich die Seriennummer nicht mehr umbenennen und keinem anderen Artikel zuweisen. Löschen ist dann ebenfalls nicht mehr möglich: „Seriennummer hat Bestellzuordnungen — als defekt markieren statt löschen.“

So arbeitest du in der Bestellung

Was dir das bringt: Du siehst für jede Position, welche Charge und welche Seriennummern sie hat, korrigierst bei Bedarf und erfasst Seriennummern beim Packen.

Öffne die Bestellung unter Bestellungen. Im Reiter Allgemein findest du unter den Positionen die Card Chargen & Seriennummern — „Zuordnung je Position, änderbar bis zum Versand“. Sie zeigt je Position den Artikel, die Menge, die Charge(n), die Seriennummern und, wenn etwas fehlt, einen Hinweis.

Bestellung mit einer Position aus zwei Chargen Abb. 14: Eine Position, die auf zwei Chargen aufgeteilt wurde, weil die erste Charge aufgebraucht war

Automatische Zuordnung beim Bestellabschluss

Schließt dein Kunde eine Bestellung ab, erhält jede Position eines Artikels mit eingeschalteten Chargen die aktive Charge. Mit eingeschalteter Mengenführung wechselt das Plugin dabei automatisch zur nächsten wartenden Charge und teilt eine Position bei Bedarf auf — wie im Bild oben.

Wichtig: Die Bestellung deines Kunden wird nie wegen einer Charge aufgehalten. Findet das Plugin keine passende Charge, kommt die Bestellung trotzdem durch, und die Card zeigt einen Hinweis. Du ordnest die Charge dann von Hand zu.

Mögliche Hinweise in der Spalte Hinweis:

  • Charge zuordnen — die Position hat noch keine Charge, zum Beispiel weil keine Charge aktiv war.
  • Keine Charge mit ausreichender Menge — keine Charge reicht für die ganze Position, und die Position darf nicht aufgeteilt werden.
  • Zugeordnet ≠ bestellt — die zugeordnete Menge passt nicht zur bestellten Menge.
  • Teilretoure: zurückbuchen — siehe Retoure.

Die aktive Charge nachträglich übernehmen

Hatte ein Artikel beim Bestellabschluss keine aktive Charge, markierst du zuerst eine Charge als aktiv. Danach klickst du in der Card auf Aktive Charge übernehmen. Du siehst „Offene Positionen haben die aktive Charge erhalten.“ und der Hinweis verschwindet.

Charge ändern

  1. Öffne in der Card das Kontextmenü (…) der Position und wähle Charge ändern.
  2. Im Fenster Charge ändern siehst du jede zugeordnete Charge als eigene Zeile und darunter die Summe, zum Beispiel „Zugeordnet: 8 von 8“.
  3. Ändere die Menge, wähle eine andere Charge oder teile die Position über Zeile hinzufügen auf mehrere Chargen auf. Mit Zeile entfernen löschst du eine Zeile.
  4. Klicke auf Speichern.

Fenster Charge ändern Abb. 15: Das Fenster Charge ändern — die Menge sinkt, du entscheidest über die wegfallenden 2 Stück

Gesperrte Chargen und Chargen anderer Artikel kannst du nicht wählen. Ist die Summe größer als die Positionsmenge, siehst du „Die Summe übersteigt die Positionsmenge.“ und kannst nicht speichern. Teilst du die Position eines Artikels auf, für den Position nicht auf mehrere Chargen aufteilen gilt, warnt dich das Plugin — speichern kannst du trotzdem. Von Hand gesetzte Zuordnungen erscheinen bei der Charge mit der Quelle Manuell.

Mit eingeschalteter Mengenführung gilt: Wechselst du nur die Charge und die Gesamtmenge der Position bleibt gleich, wandert die Menge sofort auf die neue Charge — ohne Rückfrage. Sinkt die Gesamtmenge, weil du eine Zeile entfernst oder die Menge verringerst, wählst du im Fenster je betroffener Charge Zurückbuchen oder Nicht zurückbuchen. Vorher lässt sich nicht speichern. Deine Wahl steht danach mit dem Grund Manuell in der Liste der Rückbuchungen.

Sinken mehrere Chargen zugleich und kommt eine andere hinzu, ist nicht eindeutig, aus welcher Charge die wegfallende Menge stammt. Beispiel: Charge A sinkt von 3 auf 1, Charge B von 2 auf 1, Charge C kommt mit 2 hinzu. Die Position verliert 1 Stück, das aus A oder B stammen kann. Das Fenster fragt dann je infrage kommender Charge Davon aus Charge … ab. Verteile die wegfallende Menge so, dass die Summe aufgeht; der Hinweis „Noch zu verteilen: … von ….“ zeigt, was fehlt. Erst danach wählst du für jede Charge mit einer Menge Zurückbuchen oder Nicht zurückbuchen.

Wegfallende Menge auf die Chargen verteilen Abb. 16: Mehrere Chargen kommen infrage — du legst fest, aus welcher Charge das wegfallende Stück stammt

Seriennummern erfassen

Für jede Position eines Artikels mit eingeschalteten Seriennummern zeigt die Card ein Eingabefeld, zum Beispiel „Seriennummern Akkuschrauber 18 V (0 von 2)“.

Seriennummern erfassen Abb. 17: Eingabefelder für Seriennummern — noch nicht alle erfasst

  1. Klicke in das Feld Seriennummer eingeben ….
  2. Tippe oder scanne die Nummer und drücke Enter. Die Nummer erscheint als Eintrag, das Feld leert sich und bleibt für die nächste Nummer bereit — ideal für einen Barcode-Scanner.
  3. Sind alle Nummern erfasst, siehst du „Alle Seriennummern erfasst“.

Alle Seriennummern erfasst Abb. 18: Alle Seriennummern der Position sind erfasst

Eine falsch erfasste Nummer entfernst du über das × am Eintrag; sie ist danach wieder verfügbar.

Gibt es die Nummer für diesen Artikel noch nicht, meldet das Plugin „Diese Seriennummer ist für den Artikel nicht erfasst.“ und bietet dir an, „… als neue Seriennummer anlegen und zuordnen“. Ein Klick darauf legt die Nummer an und ordnet sie zu.

Nach dem Versand

Setzt du den Lieferstatus auf Versandt (oder teilweise versandt), werden alle Zuordnungen der Bestellung endgültig. Die Card zeigt „Versandt — Zuordnungen sind endgültig“. Charge ändern und das Erfassen oder Entfernen von Seriennummern sind dann nicht mehr möglich.

Tipp: Erfasse die Seriennummern deshalb, bevor du den Lieferstatus auf Versandt setzt.

Retoure

Setzt du den Lieferstatus einer versandten Bestellung auf Retour,

  • werden die Chargen-Zuordnungen gelöst — bei der Charge sind sie als Gelöst gekennzeichnet. Ohne Mengenführung war es das. Mit eingeschalteter Mengenführung bleibt die Menge verbraucht, bis du über die offene Rückbuchung entschieden hast;
  • stehen die Seriennummern der Bestellung auf Retourniert. Prüfe die Geräte und wähle danach an der Seriennummer Freigeben (verfügbar) oder Als defekt markieren.

Die Zuordnungshistorie bleibt in beiden Fällen sichtbar.

Bei einer Teilretoure (Lieferstatus teilweise retourniert) weiß das Plugin nicht, welche Positionen zurückkamen. Die Card zeigt deshalb „Teilretoure: zurückbuchen“. Wähle im Kontextmenü (…) der zurückgekommenen Position Zurückbuchen. Mit eingeschalteter Mengenführung fragt dich ein Dialog, ob die Menge wieder zählt: Zurückbuchen oder Nicht zurückbuchen. Deine Wahl wird in der Liste der Rückbuchungen festgehalten. Ohne Mengenführung bucht das Plugin direkt zurück.

Position zurückbuchen Abb. 19: Nach einer Teilretoure fragt der Dialog, ob die Menge wieder zählt

Stornierung

Setzt du den Bestellstatus auf Abgebrochen, löst das Plugin die Chargen-Zuordnungen der Bestellung, versandt oder nicht:

  • Ohne Mengenführung bucht es die Chargenmengen direkt zurück.
  • Mit Mengenführung bleibt die Menge verbraucht, und je Zuordnung entsteht eine offene Rückbuchung.

Die aktive Charge wechselt dabei nicht zurück. Die Card zeigt „Storniert — keine neuen Zuordnungen möglich“: Solange die Bestellung storniert ist, sind Aktive Charge übernehmen, Charge ändern und das Erfassen oder Entfernen von Seriennummern gesperrt. Setzt du die Bestellung wieder auf offen, kannst du erneut zuordnen. Ein noch offener Eintrag bleibt dabei bestehen: Eine neue Zuordnung verbraucht zusätzlich Menge, bis du über den Eintrag entschieden hast. Eine erneute Stornierung erzeugt nur für die neuen Zuordnungen einen Eintrag.

In seltenen Fällen, zum Beispiel wenn die Bestellung während einer gesperrten Buchung storniert wird, kann auf einer stornierten Bestellung eine Zuordnung offen bleiben: Die Card zeigt die Charge, aber keine offene Rückbuchung. So korrigierst du das: Setze den Bestellstatus zurück auf Offen und danach erneut auf Abgebrochen. Das Plugin löst die Zuordnung dann regulär.

Erfasste Seriennummern unversandter Positionen gibt die Stornierung ebenfalls frei: Sie stehen danach wieder auf Verfügbar, die Zuordnung bleibt in der Rückverfolgung als Gelöst sichtbar. Seriennummern bereits versandter Positionen bleiben unverändert.

Position oder Bestellung löschen

Löschst du eine Position oder eine ganze Bestellung, fallen ihre Zuordnungen weg.

Ohne Mengenführung:

  • Noch nicht versandt: Die Chargenmenge wird zurückgebucht.
  • Bereits versandt: Die Chargenmenge bleibt verbraucht, denn die Ware ist beim Kunden.

Mit Mengenführung bucht das Plugin nichts: Die Menge bleibt verbraucht, und je Zuordnung entsteht eine offene Rückbuchung mit der Bestellnummer. Sie bleibt auch dann erhalten, wenn die Bestellung gelöscht ist; die Bestellnummer ist dort dann nur noch Text ohne Link.

Seriennummern verhalten sich in beiden Fällen gleich: Unversandte sind wieder verfügbar, versandte stehen auf Retourniert, damit du sie prüfst, bevor du sie freigibst.

Wichtig: Eine gelöschte Bestellung ist auch aus der Rückverfolgung verschwunden. Die Rückverfolgung reicht also nur so weit zurück, wie du Bestellungen aufbewahrst. Brauchst du die Historie, storniere die Bestellung, statt sie zu löschen.

Offene Rückbuchungen

Was dir das bringt: Ware, die zurückkommt, ist nicht zwingend chargenrein. Mit eingeschalteter Mengenführung entscheidest deshalb du, ob eine Menge wieder als verfügbar zählt, und das Plugin hält jede Entscheidung fest.

Ein offener Eintrag entsteht bei einer Stornierung, einer vollständigen Retoure und beim Löschen einer Position oder Bestellung — je Zuordnung einer, gekennzeichnet als „nicht chargenrein“. Das gilt auch, wenn der Status per API, Flow oder WaWi wechselt. Bis zu deiner Entscheidung bleibt die Menge verbraucht.

Du entscheidest an zwei Stellen:

  • In der Bestellung: Die Card Chargen & Seriennummern zeigt offene Einträge der Bestellung mit den Schaltflächen Zurückbuchen und Nicht zurückbuchen. Du bestätigst deine Wahl in einem Dialog.

    Offene Rückbuchungen in der Bestellung Abb. 20: Eine stornierte Bestellung mit zwei offenen Rückbuchungen

    Rückbuchung entscheiden Abb. 21: Der Dialog vor dem Zurückbuchen — die Entscheidung ist endgültig

  • In der Liste: Gehe zu Produkte → Chargen & Seriennummern und wechsle in den Reiter Offene Rückbuchungen. Die Liste zeigt Chargennummer, Bestellnummer, Menge, Grund, Datum, Status und das Datum der Entscheidung. Über den Filter Status siehst du auch bereits entschiedene Einträge. Wähle im Kontextmenü (…) die Aktion und bestätige sie.

    Reiter Offene Rückbuchungen Abb. 22: Der Reiter Offene Rückbuchungen

Das bewirkt deine Wahl:

  • Zurückbuchen: Die Menge steht wieder zur Verfügung. Die aktive Charge wechselt dabei nicht zurück.
  • Nicht zurückbuchen: Die Menge bleibt verbraucht.

Eine Entscheidung ist endgültig. Gibt es die Charge nicht mehr, weil der Artikel gelöscht wurde, bleibt nur Nicht zurückbuchen. Ohne Mengenführung entstehen keine neuen Einträge. Schaltest du sie später aus, bleiben vorhandene offene Einträge sichtbar und entscheidbar. Für bereits zugeordnete Chargen erzeugen Storno und Retoure auch dann Einträge, wenn Chargenverwaltung und Seriennummern in allen Verkaufskanälen ausgeschaltet sind; du siehst sie, sobald du eine Funktion wieder einschaltest. Für die Entscheidung brauchst du die Berechtigung Bearbeiten.

So erscheinen Chargen und Seriennummern auf dem Lieferschein

Was dir das bringt: Dein Kunde erhält die Charge und die Seriennummer schriftlich mit der Ware — für Nachbestellungen derselben Charge und für Garantiefälle.

  1. Schalte in den Einstellungen Chargen und Seriennummern auf dem Lieferschein ausweisen für den gewünschten Verkaufskanal ein (siehe Einstellungen).
  2. Erzeuge in der Bestellung wie gewohnt einen Lieferschein.

Unter jeder betroffenen Position steht dann eine zusätzliche Zeile, zum Beispiel „Seriennummer: SN-AS-0009, SN-AS-0010“ …

Lieferschein mit Seriennummern Abb. 23: Lieferschein mit den Seriennummern der Position

… oder „Charge: MG-2610 × 1“ mit der Menge je Charge.

Lieferschein mit Charge Abb. 24: Lieferschein mit der Charge der Position

Tipp: Der Lieferschein zeigt den Stand beim Erzeugen. Hast du danach noch Seriennummern erfasst oder eine Charge geändert, erzeuge den Lieferschein neu.

Im Shop, im Kundenkonto, in E-Mails und auf Rechnungen erscheinen Chargen und Seriennummern bewusst nie. So sieht dein Kunde vor der Auslieferung weder Charge noch Seriennummer.

So findest du bei einem Rückruf alle betroffenen Kunden

Was dir das bringt: Meldet dein Lieferant eine fehlerhafte Charge, siehst du in Sekunden, welche Kunden Ware daraus erhalten haben. Umgekehrt findest du zu einer Seriennummer den Käufer.

  1. Gehe zu Produkte → Chargen & Seriennummern und wechsle in den Reiter Rückverfolgung.
  2. Gib in Chargen- oder Seriennummer den Anfang der Nummer ein — mindestens 2 Zeichen. Groß- und Kleinschreibung spielt keine Rolle.
  3. Wähle unter Typ, ob du nach Charge, Seriennummer oder Charge und Seriennummer suchst.
  4. Klicke auf Suchen oder drücke Enter.

Rückverfolgung Abb. 25: Rückverfolgung — alle Bestellungen zu den Chargen, die mit „CH-2610“ beginnen

Die Treffer zeigen Typ, Nummer, Bestellnummer, Bestelldatum, Kunde und Menge. Über die Bestellnummer öffnest du die Bestellung. Wurde eine Zuordnung später gelöst (zum Beispiel durch Retoure oder Stornierung), ist sie als Gelöst gekennzeichnet. Suchst du nach Charge und Seriennummer, stehen zuerst alle Chargen-Treffer und danach alle Seriennummern-Treffer, jeweils die neueste Bestellung zuerst.

Tipp: Weil du nach dem Anfang der Nummer suchst, findest du mit einem gemeinsamen Präfix alle Chargen einer Produktionsserie auf einmal.

Berechtigungen für dein Team

In der Rollenverwaltung deines Shops findest du den Eintrag Chargen & Seriennummern mit den Stufen Anzeigen, Bearbeiten, Erstellen und Löschen. So gibst du zum Beispiel deinem Lager das Erfassen von Seriennummern frei, während andere Mitarbeiter nur lesen dürfen. Fehlt eine Berechtigung, sind die betreffenden Schaltflächen ausgegraut, und das Plugin meldet „Dafür fehlt die Berechtigung.“

Fehlerbehebung

Der Menüpunkt Chargen & Seriennummern oder der Reiter am Artikel fehlt

Woran es liegt: Chargen und Seriennummern sind in keinem Verkaufskanal eingeschaltet. Dann blendet das Plugin sie aus. Auf der Seite selbst siehst du „Funktion in keinem Verkaufskanal aktiv“.

So behebst du es:

  1. Öffne Erweiterungen → Meine Erweiterungen und klicke beim Plugin auf Konfigurieren.
  2. Schalte Chargenverwaltung oder Seriennummern für mindestens einen Verkaufskanal ein und speichere.
  3. Lade die Administration im Browser neu.

Fehlt alles rund um das Plugin, prüfe unter Erweiterungen → Meine Erweiterungen, ob das Plugin aktiv ist.

Eine neue Bestellung hat keine Charge

Woran es liegt: Meist ist eine dieser Bedingungen nicht erfüllt: Am Artikel ist der Schalter Chargen aus, es gibt keine aktive Charge, oder im Verkaufskanal der Bestellung sind Plugin für diesen Verkaufskanal aktivieren oder Chargenverwaltung aus.

So behebst du es: Prüfe die Einstellungen und den Reiter Chargen & Seriennummern am Artikel. Markiere eine Charge als aktiv und klicke in der Bestellung auf Aktive Charge übernehmen — oder ordne die Charge über Charge ändern von Hand zu.

„Die Funktion ist im Verkaufskanal dieser Bestellung nicht aktiv.“

Woran es liegt: Die Bestellung stammt aus einem Verkaufskanal, in dem die Funktion ausgeschaltet ist.

So behebst du es: Schalte die Funktion für diesen Verkaufskanal ein, wenn du sie dort nutzen willst.

„Die Bestellung ist versandt — Zuordnungen sind nicht mehr änderbar.“

Woran es liegt: Der Lieferstatus steht auf versandt. Zuordnungen sind dann endgültig.

So behebst du es: Das ist gewollt. Kommt Ware zurück, setze den Lieferstatus auf Retour bzw. nutze bei einer Teilretoure Zurückbuchen (siehe So arbeitest du in der Bestellung).

„Die Seriennummer ist nicht verfügbar (bereits zugeordnet, retourniert oder defekt).“

Woran es liegt: Die Nummer ist schon einer anderen Bestellung zugeordnet oder hat den Status Retourniert bzw. Defekt.

So behebst du es: Öffne die Nummer unter Seriennummern und prüfe Status und Zuordnungshistorie. Eine retournierte oder defekte Nummer kannst du nach der Prüfung mit Freigeben (verfügbar) wieder freigeben.

„Für diese Position sind bereits so viele Seriennummern erfasst, wie bestellt wurden.“

Woran es liegt: Alle Seriennummern der Position sind schon erfasst.

So behebst du es: Entferne eine falsche Nummer über das × und erfasse danach die richtige.

„Löschen nicht möglich: Es gibt Bestellzuordnungen. Sperre den Eintrag stattdessen.“

Woran es liegt: Die Charge oder Seriennummer gehört bereits zu einer Bestellung. Damit die Rückverfolgung erhalten bleibt, lässt sie sich nicht löschen.

So behebst du es: Sperre die Charge bzw. markiere die Seriennummer als defekt.

„Der Eintrag wird gerade an anderer Stelle bearbeitet. Bitte kurz warten und erneut versuchen.“

Woran es liegt: Jemand anderes oder ein Hintergrundvorgang ändert gerade dieselbe Bestellung oder dieselben Chargen.

So behebst du es: Warte einen Moment und versuche es erneut. Siehst du stattdessen „Die Chargenmengen wurden gleichzeitig an anderer Stelle geändert. Bitte neu laden und erneut versuchen.“, lade die Seite neu und wiederhole die Aktion. Tritt die Meldung häufig auf und läuft dein Shop auf mehreren Servern, gib deinem Hoster den Abschnitt Für Administratoren / Technische Details weiter.

FAQ

F: Sieht mein Kunde Charge oder Seriennummer im Shop?

A: Nein. Nur auf dem Lieferschein, und auch dort nur, wenn du es eingeschaltet hast. Shop, Kundenkonto, E-Mails und Rechnungen zeigen sie nie.

F: Kann mein Kunde beim Kauf eine Charge auswählen?

A: Nein. Die Charge vergibt das Plugin automatisch. Wünscht ein Kunde bei einer Nachbestellung dieselbe Charge, findest du sie über den Lieferschein oder die Rückverfolgung und ordnest sie in der neuen Bestellung über Charge ändern zu.

F: Verändert das Plugin meinen Lagerbestand?

A: Nein. Die Chargenmengen laufen getrennt vom Lagerbestand. Weichen sie voneinander ab, zeigt dir der Artikel einen Hinweis.

F: Was passiert, wenn ich keine Charge mehr habe?

A: Die Bestellung kommt trotzdem durch. Die Card in der Bestellung zeigt Charge zuordnen, und du ordnest die Charge nach, sobald eine neue Lieferung angelegt ist.

F: Funktioniert es mit Flächenware, die in Paketen verkauft wird?

A: Ja. Alle Chargenmengen zählen in Verkaufseinheiten, also in derselben Einheit wie die Bestellung — bei Flächenware Pakete, nicht m². Mit Position nicht auf mehrere Chargen aufteilen stellst du sicher, dass eine Position aus einer einzigen Farbcharge kommt.

F: Verwaltet das Plugin auch Mindesthaltbarkeitsdaten?

A: Nein. Nutzt du zusätzlich unser MHD-Plugin, zeigt die Rückverfolgung zusätzlich das MHD, das mit der Bestellung gespeichert wurde, und beim Aktivieren einer neuen Charge erinnert dich ein Hinweis, das MHD am Artikel anzupassen. Beide Plugins laufen auch getrennt.

F: Kann ich einen Artikel löschen, der Chargen hat?

A: Ja. Die Chargennummer ist in jeder Bestellzuordnung mitgespeichert, sodass die Rückverfolgung die Bestellungen weiterhin findet.

F: Kann ich die Funktion nur in einem meiner Shops nutzen?

A: Ja. Wähle in den Einstellungen oben den Verkaufskanal und schalte die Funktionen dort gezielt ein oder aus.

Für Administratoren / Technische Details

Dieser Abschnitt richtet sich an technische Administratoren, Hoster und Agenturen. Für die normale Nutzung brauchst du ihn nicht.

Systemanforderungen

  • Shopware: 6.7 (ab 6.7.9)
  • PHP: 8.2 oder neuer
  • Gemeinsamer Sperrspeicher (LOCK_DSN) — Pflicht, sobald mehrere App-Server (Web- oder Worker-Knoten) laufen oder sehr große Massenlöschungen anstehen (siehe unten).
  • Laufende Verarbeitung der Nachrichtenwarteschlange (Worker bzw. Scheduled Tasks) — für die Nachholung von Zuordnungen nach einem Sperrkonflikt.

Sperrspeicher: warum LOCK_DSN nötig sein kann

Das Plugin führt je Charge einen Mengenzähler (zugeordnet bzw. verfügbar). Damit gleichzeitige Bestellungen, Admin-Aktionen und Löschungen diesen Zähler nicht gegenseitig überschreiben, sperrt es vor jeder Buchung die betroffenen Bestellungen und die Produkte, denen die Chargen gehören — immer in derselben Reihenfolge (erst Bestellung, dann Produkt). Dafür nutzt es Shopwares Sperrdienst (Symfony Lock).

Shopwares Standard-Sperrspeicher ist flock — Sperrdateien auf dem lokalen Dateisystem. Das wirkt nur innerhalb eines Servers. Laufen mehrere App-Server, sieht keiner die Sperren der anderen, und Zähler-Buchungen können verloren gehen. Stelle in diesem Fall die Umgebungsvariable LOCK_DSN auf einen gemeinsamen Speicher um, zum Beispiel Redis:

# .env.local (auf allen App-Servern identisch)
LOCK_DSN=redis://redis-host:6379

Auch auf einem Server empfiehlt sich ein gemeinsamer Speicher, wenn sehr große Massenlöschungen anstehen (zum Beispiel viele Bestellungen auf einmal über die Sync-API): Während einer Löschung hält das Plugin je betroffener Bestellung und je Eigentümer-Produkt gleichzeitig eine Sperre. Mit flock ist jede Sperre ein offener Datei-Handle; bei sehr großen Löschläufen kann das die Grenze offener Dateien des Prozesses (ulimit -n) erreichen.

Verhalten bei Sperrkonflikten

SituationWartezeitDanach
Bestellabschluss (Checkout)höchstens 3 SekundenDie Bestellung wird nie blockiert. Die Zuordnung wird über die Nachrichtenwarteschlange nachgeholt.
Aktionen in der Administrationbis zu 20 SekundenMeldung „Der Eintrag wird gerade an anderer Stelle bearbeitet …“ (HTTP 409); der Benutzer wiederholt die Aktion.
Löschen von Positionen/Bestellungenwie AdministrationRückbuchung (ohne Mengenführung) bzw. offener Eintrag (mit Mengenführung) entstehen in derselben Datenbank-Transaktion wie das Löschen. Scheitert das, wird die Löschung vollständig zurückgerollt.

Gehaltene Sperren verfallen spätestens nach 120 Sekunden von selbst, falls ein Prozess unerwartet endet.

Nachholung über die Warteschlange: Damit eine nach einem Sperrkonflikt eingereihte Zuordnung tatsächlich verarbeitet wird, muss die Nachrichtenwarteschlange laufen — ein Hintergrund-Worker (bin/console messenger:consume) bzw. die Ausführung der Scheduled Tasks. Ohne Worker bleibt die Position ohne Charge, und die Bestellung zeigt Charge zuordnen. Scheitert die Zuordnung aus einem anderen Grund, bleibt die Bestellung ebenfalls gültig; der Fehler steht im Plugin-Log.

Plugin-Log

Fehler und Warnungen schreibt das Plugin in eine eigene Datei im Log-Verzeichnis des Shops: var/log/SwpBatchSerialSix-<Datum>.log. Die Datei entsteht erst beim ersten Eintrag.

Gespeicherte Daten

Chargen, Seriennummern und ihre Bestellzuordnungen liegen in eigenen Tabellen des Plugins; Shopwares eigene Tabellen werden nicht verändert. Die Schalter am Artikel speichert das Plugin als Zusatzfelder des Produkts, damit Varianten sie erben können. Beim Deinstallieren ohne Datenerhalt entfernt das Plugin seine Tabellen und die Schalter an den Produkten.


Diese Anleitung wurde für Chargenverwaltung & Seriennummern Version 6.7.0 erstellt.

Wer betreut deinen Shop, wenn es ernst wird?

Wir pflegen Shopware-Shops seit über 20 Jahren, inklusive Updates, Hotfixes und der Plugins, die du hier gerade einrichtest.