Vorgangsanzeige Vertretererweiterung (Büro+)

Das Plugin Vorgangsanzeige Vertretererweiterung (Büro+) (LeopardenBusinessSalesRepresentative) erweitert die Vorgangsanzeige des Plugins LeopardenBusinessTransactions. Ein Vorgang gehört dort genau einem Kunden und ist nur in dessen Kundenkonto sichtbar. Mit dieser Erweiterung kann an einem Vorgang zusätzlich ein oder mehrere Kunden als Vertreter hinterlegt werden. Ein Vertreter sieht dann in seinem eigenen Kundenkonto neben seinen eigenen Vorgängen auch die Vorgänge und Positionen der Kunden, die ihm am jeweiligen Vorgang zugewiesen wurden.

Das Plugin hat keine eigene Oberfläche, keine eigene Konfiguration und keine eigenen Tabellen. Es legt bei der Installation ein Zusatzfeld am Vorgang an, erweitert die Suchkriterien der beiden Store-API-Routen des Basis-Plugins und ergänzt zwei Storefront-Templates um die Angabe, von welchem Kunden ein Vorgang stammt.

Auf einen Blick

Bereich	Kurzbeschreibung
Datenmodell	Keine eigenen Tabellen. Ein Zusatzfeldset `leoparden_business_sales_representative` mit dem Feld `leoparden_business_sales_representative_field` am Vorgang
Zuweisung	Mehrfachauswahl von Kunden (`sw-entity-multi-id-select`) im Vorgang in der Administration
Sichtbarkeit	`TransactionCriteriaSubscriber` erweitert den Kundenfilter beider Routen um eine ODER-Bedingung auf das Zusatzfeld
Storefront	Vorgangsliste: Hinweis „Von Kunde …“ bei fremden Vorgängen. Positionsliste: zusätzliche Spalte „Von Kunde“
Snippet	`plugin.leoparden.BusinessSalesRepresentative.transactionFromCustomer` (de-DE und en-GB)
JavaScript	`main.ts` ergänzt die Anfrage der Listen um die Assoziation `customer`
Deinstallation	Entfernt Feldset und Feld, sofern die Nutzerdaten nicht behalten werden
Abhängigkeit	Setzt `LeopardenBusinessTransactions` (`leoparden/business-transactions`, `~6.7.0`) voraus

Begriffe

Vorgang: Ein Beleg im Plugin `LeopardenBusinessTransactions` (Entität `leoparden_business_transactions_transaction`), zum Beispiel ein Auftrag oder eine Rechnung aus der Warenwirtschaft. Er gehört über `customerId` genau einem Kunden und hat Positionen.
Vertreter: Ein Kunde, der am Vorgang eines anderen Kunden im Zusatzfeld „Vertreter“ eingetragen ist. Es gibt keine eigene Rolle und keine eigene Kundengruppe: Vertreter ist ein Kunde, der in mindestens einem Vorgang als solcher eingetragen ist.
Zusatzfeld „Vertreter“: Das Zusatzfeld `leoparden_business_sales_representative_field` im Feldset „Vertreter (Vorgänge)“ (`leoparden_business_sales_representative`). Es ist eine Mehrfachauswahl von Kunden. Pro Vorgang sind daher mehrere Vertreter möglich.
Eigener Vorgang: Ein Vorgang, dessen `customerId` die ID des angemeldeten Kunden ist. Diese Vorgänge sieht der Kunde schon ohne dieses Plugin.
Zugewiesener Vorgang: Ein Vorgang eines anderen Kunden, in dessen Zusatzfeld die ID des angemeldeten Kunden steht.

Weiterführend nach Zielgruppe

Betreiber: Installation beschreibt Voraussetzungen und Installation, Vertreter in der Administration zuweisen die Zuweisung eines Vertreters am Vorgang.
Besucher (Vertreter im Shop): Vertreter im Kundenkonto beschreibt, was ein angemeldeter Vertreter zusätzlich sieht.
Entwickler: Entwickler beschreibt Aufbau und Abhängigkeit, Backend den Subscriber und Frontend die erweiterten Templates.

Last modified: 08 November 2026