StartseiteDokumentationMulti-Warehouse

    Multi-Warehouse

    Mehrlagerverwaltung mit Click & Collect und Abholsystem

    Zur Plugin-Seite →Anleitung & Konfiguration →

    Überblick

    Das Plugin BronnMultiWarehouse erweitert Shopware 6 um vollständige Mehrlagerverwaltung mit Click & Collect und integriertem Abholsystem.

    Standard-Shopware kennt nur einen globalen Produktbestand. Dieses Plugin führt eigene Lager-Entities ein und verknüpft Lagerbestände pro Artikel. Kunden sehen auf der Produktseite, in welcher Filiale ihr Produkt verfügbar ist. Im Warenkorb wählen sie ihre Abholfiliale. Der Shopbetreiber markiert Bestellungen als abholbereit, der Kunde wird per E-Mail benachrichtigt.

    Aktuelle Version: 2.2.0

  1. •Shopware: ~6.7.0
  2. •PHP: 8.1+
  3. •Entwickler: Daniel Bronner / Bronner Consulting

    4. Systemvoraussetzungen

  4. •Shopware 6.7 oder höher
  5. •PHP 8.1 oder höher
  6. •MySQL 8.0 oder höher
  7. •Empfohlen: mindestens 256 MB PHP Memory Limit

    8. Installation

  8. 1.Plugin über den Shopware Admin installieren (Erweiterungen > Meine Erweiterungen)
  9. 2.Plugin aktivieren
  10. 3.Cache leeren:
    11. php bin/console cache:clear
  11. 4.Datenbank-Migrationen werden automatisch bei der Installation ausgeführt

    12. Konfiguration

    Die Plugin-Konfiguration befindet sich unter Erweiterungen > Meine Erweiterungen > BronnMultiWarehouse > Konfiguration.

    Allgemeine Einstellungen:

  12. •**Plugin aktiv:** Schaltet alle Funktionen ein/aus
  13. •**Bestandsanzeige:** Wählen Sie "Summe aller Lager" oder "Einzeln pro Lager"
  14. •**Lagerzuordnungsstrategie:** "Nach Priorität" (Hauptlager zuerst) oder "Gleichmäßig verteilen"

    15. Warenkorb & Bestellung:

  15. •**Warenkorb nach Lager unterteilen:** Gruppiert Positionen nach Lager
  16. •**Eigene Versandkosten pro Lager:** Berechnet separate Versandkosten
  17. •**Bestellungen pro Lager aufteilen:** Erstellt Teilbestellungen

    18. Click & Collect:

  18. •**Click & Collect aktivieren:** Erlaubt Abholung in Filialen
  19. •**Bestand pro Filiale auf Produktseite:** Zeigt Verfügbarkeit pro Standort
  20. •**Filialauswahl im Warenkorb:** Kunden wählen ihre Abholfiliale
  21. •**Filialadresse anzeigen:** Zeigt Adresse und Öffnungszeiten

    22. Architektur

    Datenbank (5 Tabellen):

    | Tabelle | Zweck |

    |---|---|

    | bronn_warehouse | Lager mit Name, Code, Priorität, Adresse, Pickup-Flag, Öffnungszeiten |

    | bronn_warehouse_translation | Übersetzbare Felder (Name, Beschreibung) |

    | bronn_warehouse_stock | Bestand pro Produkt und Lager (min: 0) |

    | bronn_warehouse_sales_channel | M:N Zuordnung Lager ↔ Verkaufskanal |

    | bronn_warehouse_order | Zuordnung Lager ↔ Bestellposition |

    Entity-Extensions:

  22. •`ProductExtension` → `warehouseStocks` (OneToMany)
  23. •`SalesChannelExtension` → `warehouses` (ManyToMany)
  24. •`OrderExtension` → `warehouseOrders` (OneToMany)

    25. Custom Fields (Order):

    | Feld | Typ | Zweck |

    |---|---|---|

    | bronn_pickup_order | bool | Bestellung ist Abholbestellung |

    | bronn_pickup_status | string | "pending" oder "ready" |

    | bronn_pickup_warehouse_id | string | UUID der Abholfiliale |

    | bronn_pickup_warehouse_name | string | Name der Abholfiliale |

    Services & Controller

    WarehouseStockService:

  25. •`getAvailableStock()` – Gesamtbestand aus aktiven Lagern
  26. •`getStockPerWarehouse()` – Bestand pro Lager mit Filialdaten
  27. •`allocateStockForOrder()` – Verteilt Bestellmengen auf Lager
  28. •`deductStock()` – Zieht Bestand ab (SQL mit `GREATEST(0, stock - qty)`)
  29. •`getWarehousesForSalesChannel()` – Aktive Lager für Verkaufskanal
  30. •`getPickupStoresForSalesChannel()` – Aktive Pickup-Filialen

    31. WarehouseCartProcessor (Priority 4400):

  31. •Enriches Cart Line Items mit `bronnWarehouseId` / `bronnWarehouseName`
  32. •Optionale separate Versandkosten pro Lager
  33. •Speichert Allokation als Cart Extension

    34. PickupController (Admin API):

  34. •`POST /api/bronn/pickup/mark-ready/{orderId}` – Markiert als abholbereit, dispatched PickupReadyEvent
  35. •`GET /api/bronn/pickup/status/{orderId}` – Liest Abholstatus

    36. ClickAndCollectController (Storefront):

  36. •`POST /bronn/click-and-collect/select` – Filialauswahl im Warenkorb

    37. Event-Subscriber

    | Subscriber | Event | Funktion |

    |---|---|---|

    | OrderPlacedSubscriber | CheckoutOrderPlacedEvent | Allokation + Bestandsabzug + Pickup-Custom-Fields setzen |

    | WarehouseStockSyncSubscriber | bronn_warehouse_stock.written/deleted, bronn_warehouse.written | product.stock = Summe aktiver Lager |

    | ProductPageSubscriber | ProductPageLoadedEvent | PDP mit Lagerbestand anreichern |

    | CartPageSubscriber | Cart/Confirm Page Events | Click & Collect Daten bereitstellen |

    Bestandssynchronisation

    product.stock wird automatisch aktualisiert bei:

  37. •Erstellen/Ändern/Löschen von Warehouse-Stock-Einträgen
  38. •Aktivieren/Deaktivieren eines Lagers

    39. SQL-Abfrage:

    SELECT COALESCE(SUM(ws.stock), 0)
FROM bronn_warehouse_stock ws
INNER JOIN bronn_warehouse w ON ws.warehouse_id = w.id
WHERE ws.product_id = UNHEX(:productId)
  AND w.active = 1

    Besonderheit: Beim Update eines Stock-Eintrags (nur stock-Feld geändert) ist die productId nicht im DAL-Event-Payload. Der Subscriber löst die productId per DB-Lookup über die Stock-Entry-ID auf.

    Allokationsstrategien

    Priority (Standard):

    Füllt Bestellmenge vom höchstpriorisierten Lager (niedrigster Prioritätswert) auf. Cascade zum nächsten bei Unterbestand.

    Equal Distribution:

    Verteilt gleichmäßig über alle Lager mit Bestand. baseShare = floor(qty / warehouseCount), Remainder auf erste Lager. Fallback auf Priority bei Unterbestand.

    Abholsystem (Pickup)

    Workflow:

  39. 1.Kunde wählt Click & Collect → ClickAndCollectController speichert bronnClickAndCollect in Cart Extension
  40. 2.Bestellung wird erstellt → OrderPlacedSubscriber.setPickupCustomFields() setzt Custom Fields
  41. 3.Admin sieht Pickup-Card → sw-order-detail-general Override
  42. 4.Admin klickt "Abholbereit" → PickupController.markReady() → setzt Status auf "ready" → dispatched PickupReadyEvent
  43. 5.Flow Builder reagiert auf Event → E-Mail an Kunde

    44. PickupReadyEvent:

  44. •Implements: `FlowEventAware`, `OrderAware`, `CustomerAware`, `MailAware`
  45. •Name: `bronn_multi_warehouse.pickup_ready`
  46. •Stellt Order-Entity für E-Mail-Template bereit

    47. E-Mail-Templates (via Migration):

  47. •`bronn_pickup_ready` – Kundenbenachrichtigung mit Bestelldetails und Abholort (DE/EN)
  48. •`bronn_new_pickup_order` – Shopbetreiber-Info mit Handlungsanweisung (DE/EN)

    49. Admin-UI

    Modul: bronn-warehouse unter Kataloge > Lagerverwaltung

  49. •Lagerliste mit Filter (Alle/Aktive/Inaktive)
  50. •Detailseite mit Stammdaten, Adresse, Click & Collect, Verkaufskanäle, Bestände

    51. Extensions:

  51. •`sw-product-deliverability-form` Override – Lagerbestände im Produkt pflegen
  52. •`sw-order-detail-general` Override – Pickup-Card mit Status und Abholbereit-Button

    53. Storefront-Templates

    | Template | Block | Funktion |

    |---|---|---|

    | buy-widget.html.twig | buy_widget_buy_form | Bestandsanzeige pro Lager auf PDP |

    | cart/index.html.twig | page_checkout_cart_add_product_and_shipping | Click & Collect Filialauswahl |

    | confirm/index.html.twig | page_checkout_confirm_shipping | Ausgewählte Filiale + Abholhinweis |

    Bekannte Grenzen

  53. •Die `equalDistribution`-Strategie wird aktuell nur im CartProcessor berechnet. Der OrderPlacedSubscriber nutzt die Cart-Allokation aus den Line-Item-Payloads. Wenn keine Payload vorhanden, wird Fallback auf Priority verwendet.
  54. •Öffnungszeiten werden als JSON-Objekt gespeichert. Die Eingabe im Admin erfolgt als Freitext-Textarea, keine strukturierte UI.
  55. •Das Plugin setzt keine eigene State Machine. Der Abholstatus wird über Custom Fields verwaltet.

    56. Kompatibilität

  56. •Kompatibel mit der B2B Plattform (Firmenkonto-basierte Lagersteuerung)
  57. •Kompatibel mit dem Plugin Bestelllisten
  58. •Kompatibel mit Standard-Shopware-Themes
  59. •Getestet mit Shopware 6.7.x
  60. •Unterstützt Multi-Sales-Channel
  61. •Unterstützt Multi-Language (DE/EN)
  62. •Reine DAL-Nutzung, keine Core-Hacks
  63. •Negative Bestände durch Validierung verhindert

    64. FAQ

    Weitere Plugin-Dokumentationen

    B2B PlattformPreise ausblendenMindermengenzuschlagAngebotsanfragen