Konfigurationsreferenz
Alle Plugin-Einstellungen finden Sie unter Erweiterungen > Meine Erweiterungen > PackGuard > Konfiguration. Die folgenden Tabellen werden aus der config.xml des Plugins generiert und entsprechen daher immer dem Einstellungsbildschirm der installierten Version.
Allgemeine Einstellungen
| Setting | Type | Default | Description |
|---|---|---|---|
trackingThreshold — Erfassungsschwelle (%) | int | 30 | Bestellungen mit Leerraum unterhalb dieses Wertes werden nicht erfasst. Hält Dashboards auf auffällige Verpackungen fokussiert. |
warningThreshold — Warnschwelle (%) | int | 50 | Bestellungen ab diesem Leerraumverhältnis werden als Warnung markiert. |
blockThreshold — Blockierschwelle (%) | int | 70 | Bestellungen ab diesem Leerraumverhältnis werden als Verstoß markiert und die Boxauswahl wird abgelehnt. |
autoCalculate — Automatische Berechnung bei Bestelleingang | bool | true | Speichert für jede neue Bestellung die beste Box. Ältere Bestellungen werden beim nächsten Statuswechsel erfasst. Die Erfassung läuft über die Message Queue, die Box erscheint daher kurz nach Bestelleingang. |
companyName — Firmenname (für den Verpackungseffizienz-Bericht) | text | `` | Wird auf dem Verpackungseffizienz-Bericht (PDF) als Ersteller angezeigt. Leer lassen, um stattdessen den Shop-Namen zu verwenden. |
declarationTitle — Titel des Berichts | text | Packaging Efficiency Report | Hauptüberschrift oben auf dem Verpackungseffizienz-Bericht (PDF). |
declarationSubtitle — Untertitel des Berichts | text | Regulation (EU) 2025/40, Article 24 | Untertitel unterhalb der Hauptüberschrift des Verpackungseffizienz-Berichts (PDF). Leer lassen, um ihn auszublenden. |
Die Grenzwerte werden mit dem Leerraumverhältnis der gewählten (oder vorgeschlagenen) Box einer Bestellung verglichen — wie der Anteil berechnet wird, erklärt Konzepte.
Entitäten
PackGuard legt fünf Entitäten in Ihrer Datenbank an. Bei einer Deinstallation ohne die Option "Daten behalten" werden sie samt Daten entfernt.
| Entität | Zweck |
|---|---|
ssd_packguard_box | Ein Verpackungstyp im Katalog: Innenmaße (mm), berechnetes Innenvolumen, Gewicht, Kosten, Material, Typ, Isolierungs-Kennzeichen, Aktiv-Status. Der Name ist übersetzbar. |
ssd_packguard_packaging_profile | Ein benanntes Regelset fürs Packen (z. B. "Zerbrechlich"). Name und Beschreibung sind übersetzbar. |
ssd_packguard_profile_constraint | Eine Regel innerhalb eines Profils: Typ (padding, orientation, insulated, allowed_box_types) plus Konfiguration. |
ssd_packguard_product_packaging | Weist einem Produkt ein Verpackungsprofil zu (auf der Produktseite oder per Massenbearbeitung). |
ssd_packguard_order_packaging | Der Datensatz je Bestellung: die erfasste Box (automatisch berechnet oder gewählt), Produktvolumen, Boxvolumen, Leerraumverhältnis, Status (compliant / warning / violation) und Ersparnis. Grundlage des Dashboards. Freigabe-Begründungen werden ins System-Log geschrieben, nicht in diese Tabelle. |
ACL-Berechtigungen
Das Plugin registriert einen Eintrag PackGuard unter Berechtigungen > Inhalte in der Rollenverwaltung:
| Rolle | Umfang | Setzt voraus |
|---|---|---|
ssd_packguard.viewer | Lesezugriff auf alle PackGuard-Entitäten, Bestellungen, Produkte und die Plugin-Konfiguration. Voraussetzung, um Modul und Bestellkarte zu sehen. | — |
ssd_packguard.editor | Bearbeiten (Boxen, Profile, Zuweisungen ändern; Boxen auf Bestellungen wählen). | viewer |
ssd_packguard.creator | Anlegen (neue Boxen, Profile, Regeln; Vorlagen-Import). | viewer, editor |
ssd_packguard.deleter | Löschen von Boxen, Profilen, Regeln und Produkt-Zuweisungen. | viewer |
Die Karte Verpackungsprofil auf der Produktdetailseite sehen Nutzer mit ssd_packguard.viewer. Eine bestehende Zuweisung zu ändern erfordert ssd_packguard.editor; einem Produkt erstmals ein Profil zuzuweisen erfordert ssd_packguard.creator. Nutzer ohne PackGuard-Rolle können Produkte weiterhin öffnen und speichern.
Admin-API-Routen
Für Automatisierung und Integrationen. Alle Routen erfordern einen authentifizierten Admin-API-Client, dessen Rolle die passende PackGuard-Berechtigung hat: Leserouten brauchen ssd_packguard.viewer, die Boxauswahl ssd_packguard.editor, der Vorlagen-Import ssd_packguard.creator. Sonst antwortet die Route mit HTTP 403.
| Route | Methode | Zweck |
|---|---|---|
/api/ssd-packguard/box-suggestion/{orderId} | GET | Live-Vorschlag für eine Bestellung: Produktvolumen, sortierte Boxliste, Ausschlüsse. |
/api/ssd-packguard/select-box | POST | Wählt eine Box für eine Bestellung. Liefert HTTP 422 mit error: blocked oberhalb der Blockierschwelle. |
/api/ssd-packguard/select-box/override | POST | Wählt eine blockierte Box mit Pflicht-Begründung (auditiert). |
/api/ssd-packguard/dashboard-stats | GET | Aggregierte Kennzahlen, Verteilung und aktuelle Verstöße. |
/api/ssd-packguard/declaration/{boxId} | GET | Daten des Verpackungseffizienz-Berichts für eine Box (JSON). |
/api/ssd-packguard/declaration/{boxId}/pdf | GET | Der Bericht als PDF-Dokument. |
/api/ssd-packguard/preset-boxes | GET | Liste importierbarer Verpackungs-Vorlagen. |
/api/ssd-packguard/preset-boxes/import | POST | Importiert ausgewählte Vorlagen in den Boxkatalog. |
Editionen
PackGuard erscheint als eine Edition — jede in diesem Handbuch dokumentierte Funktion ist in jedem Abonnement enthalten. Es gibt kein Feature-Gating.