Vorgangsanzeige

Das Plugin Vorgangsanzeige (LeopardenBusinessTransactions) zeigt Vorgänge aus einer Warenwirtschaft im Kundenkonto des Shops an: Angebote, Aufträge, Lieferscheine und Rechnungen, jeweils mit Positionen, Adressen, Lieferstatus und Dokumenten zum Herunterladen. Der Shop berechnet diese Vorgänge nicht selbst. Eine Fremdanwendung (laut Plugin-Beschreibung eine Büro+/Microplan-Anbindung) schreibt sie als eigene Entitäten in die Shopware-Datenbank, und das Plugin stellt sie dem angemeldeten Kunden dar.

Dieses Dokument beschreibt die Plugin-Linie für Shopware 6.7 (Version 6.7.6). Für Shopware 6.6 gibt es eine eigene Linie mit eigener Dokumentation; die Unterschiede stehen jeweils an der betroffenen Stelle.

Andere Plugins bauen auf ihm auf: BusinessCustomProducts nutzt das Twig-Gerüst und die Storefront-Bausteine für seine Artikelliste, BusinessSalesRepresentative erweitert die Abfragen der Store-API-Routen über Kriterien-Ereignisse. Siehe Frontend und Backend.

Auf einen Blick

Bereich	Kurzbeschreibung
Datenmodell	Sieben eigene Tabellen: Vorgang, Vorgangsposition, Download, Vorgangstyp und Vorgangsgruppe, die beiden Letzten mit Übersetzungen
Befüllung	Nicht über die Administration: Vorgänge kommen von außen in die Entität `leoparden_business_transactions_transaction`
Konto	Menüpunkt „Bisherige Vorgänge" mit Gruppen, Archiv und Detailseite
Routen	`/Transactions`, `/transactions/group/{groupId}`, `/transactions/group/{groupId}/archive`, `/Transactions/Archive`, `/transactions/detail/{transactionId}`
Store-API	`POST /store-api/transactions` und `POST /store-api/transaction-items`
CMS-Elemente	`transactions`, `processes`, `articles-on-order`, `recently-delivered`, `most-bought-by-customer`
Administration	Einstellungsmodul für Typen und Gruppen, Reiter „Bisherige Vorgänge" an jedem Kunden
Sichtbarkeit	Pro Kundengruppe wird festgelegt, welche Vorgangstypen der Kunde sieht
Benachrichtigung	Flow-Ereignisse `business_transaction.created` und `business_transaction.updated`, Mailvorlagentyp `business_transaction_mail`
SEO-URLs	Vorlagen für Vorgangsdetail, Gruppe und Gruppenarchiv
Zwischenspeicher	Die Store-API-Routen versehen ihre Antwort mit Cache-Tags je Kunde (Linie 6.7); die Zwischenspeicher-Dekoration der Linie 6.6 gibt es hier nicht

Begriffe

Vorgang (Transaction): Ein Beleg eines Kunden mit Nummer, Belegdatum, Beträgen, Adressen, Referenznummer (identifier), Betreff (description) und Positionen. Jeder Vorgang gehört genau einem Kunden und hat einen Typ.
Vorgangsposition (Transaction Item): Eine Zeile eines Vorgangs mit Position, Artikelnummer, Bezeichnung, Menge, Einzelpreis, Rabatt und Zeilenpreis. Sie kann auf einen Shop-Artikel verweisen (lineItemId); dann verlinkt die Detailseite den Artikel.
Vorgangstyp: Die Art eines Belegs, zum Beispiel Angebot oder Rechnung. Ein Typ hat einen übersetzbaren Namen, eine Zahl typeMatch für die Reihenfolge innerhalb seiner Gruppe und gehört zu einer Gruppe.
Vorgangsgruppe: Fasst Typen zusammen und bildet im Konto einen eigenen Bereich mit Überschrift, Archiv und eigener Adresse. Der Name ist übersetzbar.
Archiv: Das Kennzeichen archive am Vorgang. Archivierte Vorgänge erscheinen nur in den Archivlisten, nicht in den normalen Listen.
Status: Ein Zahlenwert, den das Plugin aus dem Lieferdatum (shippingDate) ableitet. Bestimmte Platzhalterdaten wie der 31.12.2500 stehen für einen Wartezustand. Die Tabelle steht unter [](backend.md).
Kundengruppen-Zuordnung: Die Plugin-Einstellung showCategoriesInTransactionsView: Sie legt je Kundengruppe fest, welche Vorgangstypen ein Kunde sieht. Ohne Zuordnung sieht er keine Vorgänge.

Wo geht es weiter?

Sie betreiben den Shop und wollen das Plugin einrichten: Installation und Administration
Sie wollen wissen, was Ihre Kunden im Shop sehen: Storefront
Sie entwickeln gegen das Plugin oder auf ihm aufbauend: Entwicklung, Backend und Frontend

Last modified: 08 November 2026