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 Leerraum-Anteil werden als Warnung markiert. |
blockThreshold — Blockierschwelle (%) | int | 70 | Bestellungen ab diesem Leerraum-Anteil werden als Verstoß markiert und die Boxauswahl wird abgelehnt. |
autoCalculate — Automatische Berechnung bei Bestelleingang | bool | true | — |
companyName — Firmenname (für Konformitätserklärung) | text | `` | Wird auf der Konformitätserklärung (PDF) als erklärende Instanz angezeigt. Leer lassen, um stattdessen den Shop-Namen zu verwenden. |
declarationTitle — Titel der Erklärung | text | Declaration of Conformity | Hauptüberschrift oben auf der Konformitätserklärung (PDF). |
declarationSubtitle — Untertitel der Erklärung | text | PPWR Article 11 | Untertitel unterhalb der Hauptüberschrift der Konformitätserklärung (PDF). Bezieht sich typischerweise auf die anzuwendende Verordnung. |
Die Grenzwerte werden mit dem Leerraum-Anteil 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: Innen-/Außenmaße (mm), berechnete Volumina, Kosten, maximale Traglast, 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: vorgeschlagene und gewählte Box, Produktvolumen, Boxvolumen, Leerraum-Anteil, 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 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 |
Admin-API-Routen
Für Automatisierung und Integrationen. Alle Routen erfordern einen authentifizierten Admin-API-Client.
| 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 der Konformitätserklärung für eine Box (JSON). |
/api/ssd-packguard/declaration/{boxId}/pdf | GET | Die Erklärung 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.