Mandatsreferenz automatisch vergeben

Jedes SEPA-Mandat braucht eine eindeutige Referenz, mit der du es gegenüber deiner Bank identifizierst. Der Shop kann sie automatisch vergeben — über einen Shopware-Nummernkreis, genau wie bei Bestell- oder Kundennummern.

Einschalten

1. Aktiviere in der Plugin-Konfiguration die Einstellung Mandatsreferenz automatisch vergeben.
2. Öffne Einstellungen › Nummernkreise und wähle den Eintrag SEPA-Mandatsreferenz.
3. Lege dort Muster und Startwert fest.

Bei der Installation wird der Nummernkreis mit dem Muster {n} und dem Startwert 10000 angelegt. Ein fortlaufendes Mandat bekommt damit die Referenzen 10000, 10001 und so weiter.

Eigenes Format festlegen

Im Muster kombinierst du festen Text mit den Platzhaltern, die Shopware anbietet — etwa {n} für die laufende Nummer. Ein Muster wie MANDAT/{n} erzeugt Referenzen der Form MANDAT/10000.

Wann die Referenz vergeben wird

Die Referenz wird einmalig vergeben, sobald ein Mandat zum ersten Mal gespeichert wird und noch keine Referenz besitzt — also beim Bestellabschluss im Checkout oder beim Anlegen einer Bankverbindung im Kundenkonto. Bearbeitet dein Kunde die Bankverbindung später, bleibt die einmal vergebene Referenz erhalten.

Jede Referenz darf im Shop nur ein einziges Mal vorkommen. Ein Speichervorgang, der eine bereits vergebene Referenz verwenden würde, wird abgewiesen.

Wo die Referenz auftaucht

• auf der Kachel der Bankverbindung im Kundenkonto
• auf der Bestellabschluss-Seite und in den Bestelldetails im Kundenkonto
• als Zusatzfeld Mandatsreferenz an der Bestellung im Admin, siehe SEPA-Daten an der Bestellung

Wenn keine Referenz vergeben werden kann

Passt das Muster nicht zum erlaubten Zeichensatz oder ist der Nummernkreis nicht erreichbar, wird keine Referenz vergeben. Die Bestellung läuft trotzdem normal durch und die Bankverbindung wird gespeichert — sie bleibt lediglich ohne Referenz. Ein entsprechender Hinweis landet im Shop-Log.