Zusatzfelder für Bestellung, Produkte & Checkout
Technische Informationen
Highlights
-
Individuelle Zusatzfelder für Bestellungen und einzelne Produkte erstellen
-
Flexible Feldtypen, Pflichtfelder und bedingte Sichtbarkeit konfigurieren
-
Kundeneingaben automatisch in Bestellungen, E-Mails und PDF-Dokumente
Funktionen
-
Kundenspezifische Auftragsfelder auf Bestell- oder Produktebene
-
Verschiedene Feldtypen: einzeiliger Text, mehrzeiliger Text, E-Mail, Checkbox, Schalter, Radiobutton, Auswahlfeld und Datumsfeld
-
Individuelle Titel, Inhalte und Platzhaltertexte
-
Felder wahlweise als Pflichtfelder definierbar
-
Anzeige abhängig von Regeln aus dem Shopware Rule Builder
-
Bedingte Sichtbarkeit einzelner Felder anhand der Eingaben in anderen Auftragsfeldern
-
Flexible Anzeige auf der Produktdetailseite, im Warenkorb und auf der Bestellabschlussseite
-
Validierung von Texteingaben über reguläre Ausdrücke
-
Individuelle Fehlermeldung bei ungültigen Eingaben
-
Verwendung einer eingegebenen E-Mail-Adresse als CC-Empfänger der Bestellbestätigung
-
Anzeige der erfassten Werte in der Bestelldetailansicht der Administration
-
Anzeige der Eingaben im Kundenkonto und auf der Bestellbestätigungsseite
-
Übernahme in die Bestellbestätigungs-E-Mail
-
Flexible Anzeige in Rechnung, Lieferschein, Gutschrift und Stornorechnung
Zweck des Plugins
Mit diesem Plugin können individuelle Zusatzfelder für Bestellungen und einzelne Produkte erstellt werden. Kunden können dadurch bereits auf der Produktdetailseite, im Warenkorb oder während des Bestellabschlusses zusätzliche Angaben wie Bestellnummern, Lieferhinweise, Wunschtermine oder weitere Informationen hinterlegen.
Individuelle Auftragsfelder erstellen
Für unterschiedliche Anwendungsfälle stehen verschiedene Feldtypen zur Verfügung:
- Textfeld (einzeilig)
- Textfeld (mehrzeilig)
- E-Mail-Feld
- Checkbox
- Schalter
- Radiobutton
- Auswahlfeld
- Datumsfeld
Für jedes Feld können unter anderem Titel, Inhalt, Platzhaltertext und Pflichtfeldstatus individuell festgelegt werden. Optionswerte für Radio- und Auswahlfelder lassen sich inklusive Reihenfolge und Vorauswahl konfigurieren.
Flexible Anzeige im Storefront
Die Auftragsfelder können auf Bestell- oder Produktebene verwendet und an unterschiedlichen Positionen im Storefront angezeigt werden:
- Auf der Produktdetailseite
- Im Warenkorb
- Auf der Bestellabschlussseite
- Auf der Bestellbestätigungsseite
- Im Kundenkonto
Je nach Bereich stehen mehrere Anzeigepositionen zur Auswahl. So können die Felder passend zum jeweiligen Einsatzzweck in den Bestellprozess integriert werden.
Regeln und Sichtbarkeitseinschränkungen
Über den Shopware Rule Builder kann gesteuert werden, unter welchen Bedingungen ein Auftragsfeld angezeigt wird. Zusätzlich lassen sich Abhängigkeiten zwischen den einzelnen Feldern erstellen. Dadurch wird ein Feld beispielsweise erst sichtbar, wenn zuvor eine bestimmte Option ausgewählt oder eine Checkbox aktiviert wurde.
Über Prioritäten kann außerdem festgelegt werden, in welcher Reihenfolge die Felder angezeigt werden. Auftragsfelder mit geringerer Priorität können bei Bedarf ausgeschlossen werden.
Validierung und Datumsfelder
Für ein- und mehrzeilige Textfelder können Zeichenbegrenzungen sowie individuelle Validierungen über reguläre Ausdrücke definiert werden. Bei einer ungültigen Eingabe lässt sich eine eigene Fehlermeldung anzeigen.
Datumsfelder können wahlweise nur ein Datum oder zusätzlich eine Uhrzeit erfassen. Die Auswahl kann auf zukünftige Zeitpunkte beschränkt oder für Vergangenheit und Zukunft freigegeben werden.
Übernahme in Bestellungen, E-Mails und Dokumente
Die eingegebenen Werte werden mit der Bestellung gespeichert und in der Bestelldetailansicht der Administration angezeigt. Dort können Auftragsfelder auch nachträglich hinzugefügt oder bearbeitet werden.
Zusätzlich können die Angaben in der Bestellbestätigungs-E-Mail sowie in folgenden PDF-Dokumenten ausgegeben werden:
- Rechnung
- Lieferschein
- Gutschrift
- Stornorechnung
Die Position der Angaben innerhalb der Dokumente kann individuell festgelegt werden. Auch Zusatzfelder auf Produktebene werden unterstützt.
Bestellbestätigung an zusätzliche E-Mail-Adresse senden
Bei einem Auftragsfeld vom Typ E-Mail kann die vom Kunden eingegebene Adresse automatisch als CC-Empfänger für die Bestellbestätigung verwendet werden.
- Plugin Manager: Über Erweiterungen > Meine Erweiterungen aufrufen
- Plugin: Hochladen, installieren und aktivieren
Auftragsfelder verwalten
Einstellungen > Erweiterungen > Kundenspezifische Auftragsfelder > Kundenspezifische Auftragsfelder
Grundeinstellungen
- Interne ID: Eindeutige technische ID des Auftragsfeldes
- Interner Name: Bezeichnung zur internen Verwaltung des Auftragsfeldes
- Aktiv: Aktiviert oder deaktiviert das Auftragsfeld
- Zugewiesene Regel: Zeigt das Auftragsfeld an, wenn mindestens eine der ausgewählten Rule-Builder-Regeln zutrifft. Ohne zugewiesene Regel ist das Feld immer aktiv
- Priorität: Bestimmt die Reihenfolge der angezeigten Auftragsfelder. Felder mit höherer Priorität werden zuerst angezeigt
- Auftragsfelder mit geringerer Priorität ausschließen: Blendet zutreffende Auftragsfelder mit einer niedrigeren Priorität aus
Anzeigeeinstellungen
- Anzeigeebene: Legt fest, ob das Auftragsfeld für die gesamte Bestellung oder für einzelne Produkte verwendet wird
- Anzeigeposition Warenkorb: Blendet das Feld im Warenkorb aus oder zeigt es unterhalb der Produktnummerneingabe an
- Anzeigeposition Produktdetailseite: Legt bei Feldern auf Produktebene die Position auf der Produktdetailseite fest
- Anzeigeposition Bestellabschlussseite: Zeigt das Feld links neben der Zusammenfassung, unter dem Produkt oder unter der ausgewählten Lieferung an. Alternativ kann die Anzeige deaktiviert werden
- Anzeigeposition Bestellbestätigungsseite: Zeigt das Feld unterhalb der Zahlungs- und Versandart oder zwischen dem Adressenblock und den Bestellpositionen an
- Titel: Sichtbare Bezeichnung des Auftragsfeldes im Storefront
- Platzhalter-Text: Hinterlegt einen Hinweis innerhalb des Eingabefeldes
Auftragsfeld konfigurieren
- Auftragsfeld-Typ: Text (einzeilig), Text (mehrzeilig), E-Mail, Checkbox, Schalter, Radiobutton, Auswahlfeld oder Datumsfeld auswählen
- Ist ein Pflichtfeld: Kunden müssen das Feld vor dem Fortsetzen ausfüllen oder auswählen
- Auftragsfeld-Label: Beschriftung für Checkboxen und Schalter festlegen
Textfelder konfigurieren
- Zeichenbeschränkung: Maximale Anzahl der erlaubten Zeichen festlegen
- Expertenmodus aktivieren: Zusätzliche Validierungsmöglichkeiten für ein- und mehrzeilige Textfelder anzeigen
- Textvalidierung mit Regular Expression: Erlaubte Zeichen oder Eingabeformate mithilfe eines regulären Ausdrucks definieren
- Fehlermeldung: Individuellen Hinweis bei einer ungültigen Eingabe hinterlegen. Ohne eigenen Text wird der Textbaustein acrisCustomOrderFields.inputError verwendet
E-Mail-Feld konfigurieren
- Bestell-E-Mails auch an diese E-Mail-Adresse schicken: Legt fest, ob die eingegebene E-Mail-Adresse als CC-Empfänger der Bestellbestätigung verwendet wird
Datumsfeld konfigurieren
- Datumsfeld-Anzeige: Wahlweise nur das Datum oder Datum und Uhrzeit anzeigen
- Datumsfeld-Zeitauswahl: Auswahl nur in der Zukunft oder in Vergangenheit und Zukunft erlauben
- Eingabe X Jahre in der Vergangenheit ermöglichen: Legt fest, wie viele Jahre Kunden bei der Datumsauswahl zurückgehen können
Optionswerte hinzufügen
Für Auftragsfelder vom Typ Radiobutton oder Auswahlfeld können individuelle Optionswerte angelegt werden.
- Auftragsfeld-Option-ID: Eindeutige interne ID des Optionswertes
- Auftragsfeld-Option: Sichtbare Bezeichnung der Auswahlmöglichkeit
- Position: Bestimmt die Reihenfolge der Optionen. Je kleiner der Wert, desto weiter vorne wird die Option angezeigt
- Vorausgewählt: Legt fest, ob die Option standardmäßig ausgewählt ist
Sichtbarkeitseinschränkungen hinzufügen
Mit Sichtbarkeitseinschränkungen kann ein Auftragsfeld abhängig von der Eingabe in einem anderen Auftragsfeld angezeigt werden. Treffen mehrere hinterlegte Einschränkungen zu, genügt eine davon für die Anzeige. Ohne Einschränkung wird das Feld immer angezeigt.
- Feld zur Einschränkung der Sichtbarkeit: Auftragsfeld auswählen, dessen Eingabe geprüft werden soll
- Operator: Ist gleich, ist größer als, ist kleiner als oder ist nicht gleich auswählen
- Feldwert: Wert festlegen, bei dem das eingeschränkte Auftragsfeld angezeigt wird
- Checkbox und Schalter: Den Wert 0 für inaktiv oder 1 für aktiv verwenden
- Radio- und Auswahlfelder: Die interne ID des gewünschten Optionswertes eintragen
Anzeige in PDF-Dokumenten
- Gutschrift: Anzeige und Position des Auftragsfeldes in der Gutschrift festlegen
- Lieferschein: Anzeige und Position des Auftragsfeldes im Lieferschein festlegen
- Rechnung: Anzeige und Position des Auftragsfeldes in der Rechnung festlegen
- Stornorechnung: Anzeige und Position des Auftragsfeldes in der Stornorechnung festlegen
- Je nach Dokument kann das Feld ausgeblendet, unter der Adresse, unter der Auflistung oder am Ende des Dokuments angezeigt werden
Weitere Einstellungen
Einstellungen > Erweiterungen > Kundenspezifische Auftragsfelder > Weitere Einstellungen
- Text des ausgewählten Auftragsfeldes: Text festlegen, der für eine aktivierte Checkbox oder einen aktivierten Schalter ausgegeben wird
- Text des nicht ausgewählten Auftragsfeldes: Text festlegen, der für eine deaktivierte Checkbox oder einen deaktivierten Schalter ausgegeben wird
Auftragsfelder in Bestellungen verwalten
Bestellungen > Übersicht > Bestellung öffnen
- Die vom Kunden eingegebenen Werte werden in der Bestelldetailansicht angezeigt
- Auftragsfelder können einer Bestellung nachträglich hinzugefügt werden
- Bereits gespeicherte Werte können in der Administration bearbeitet werden
Frequently Asked Questions
Erweiterungen für andere Anwendungszwecke (wie Checkboxen, Single Select oder Multi Select, Datumsfeld) sind technisch möglich und können gerne bei uns angefragt werden.
Bestelldaten können über die URL "/api/search/order" abgefragt werden. Der Request Body beinhaltet dabei einen Filter auf die UUID der Bestellung. Im Response befinden sich die Auftragsfelder unter "customFields.acrisCustomOrderFields". Darin ist ein Array mit kundenspezifischen Auftragsfeldern enthalten. Das jeweilige Auftragsfeld kann über das Feld "internalId" (Admin Konfiguration "Interne ID") identifiziert werden. Im Feld "content" steht der vom Kunden angegebene Wert des Auftragsfeldes. Beispiel Request:
{
"page": 1,
"limit": 1,
"total-count-mode": 1,
"filter": [
{ "type": "equals", "field": "id", "value": "0194b5c6cb9171569dd1cb7886d346b9" }
]
}
| Version | Datum | Shopware Kompatibilität | Changelog |
|---|---|---|---|
| 4.4.1 | 27. August 2026 | >=6.7.0.0 <6.8.0.0 |
|
| 4.4.0 | 25. August 2026 | >=6.7.0.0 <6.8.0.0 |
|
| 4.3.0 | 9. Juni 2026 | >=6.7.0.0 <6.8.0.0 |
|
| 4.2.2 | 17. März 2026 | >=6.7.0.0 <6.8.0.0 |
|
| 4.2.1 | 7. Januar 2026 | >=6.7.0.0 <6.8.0.0 |
|
| 4.2.0 | 11. Dezember 2025 | >=6.7.0.0 <6.8.0.0 |
|
| 4.1.1 | 13. November 2025 | >=6.7.0.0 <6.8.0.0 |
|
| 4.1.0 | 30. September 2025 | >=6.7.0.0 <6.8.0.0 |
|
| 4.0.8 | 19. September 2025 | >=6.7.0.0 <6.8.0.0 |
|
| 4.0.7 | 17. September 2025 | >=6.7.0.0 <6.8.0.0 |
|
| 4.0.6 | 17. September 2025 | >=6.7.0.0 <6.8.0.0 |
|
| 4.0.5 | 25. August 2025 | >=6.7.0.0 <6.8.0.0 |
|
| 4.0.4 | 30. Juli 2025 | >=6.7.0.0 <6.8.0.0 |
|
| 4.0.3 | 11. Juli 2025 | >=6.7.0.0 <6.8.0.0 |
|
| 4.0.2 | 3. Juli 2025 | >=6.7.0.0 <6.8.0.0 |
|
| 4.0.1 | 13. Juni 2025 | >=6.7.0.0 <6.8.0.0 |
|
| 4.0.0 | 19. Mai 2025 | >=6.7.0.0 <6.8.0.0 |
|
| 3.5.1 | 31. August 2026 | >=6.6.0.0 <6.7.0.0 |
|
| 3.5.0 | 11. Dezember 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.4.6 | 28. November 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.4.5 | 25. August 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.4.4 | 13. Juni 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.4.3 | 28. Mai 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.4.2 | 23. Mai 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.4.1 | 5. Mai 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.4.0 | 30. April 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.3.7 | 31. März 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.3.6 | 27. März 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.3.5 | 24. März 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.3.4 | 18. März 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.3.3 | 18. März 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.3.2 | 10. Januar 2025 | >=6.6.0.0 <6.7.0.0 |
|
| 3.3.1 | 11. November 2024 | >=6.6.0.0 <6.7.0.0 |
|
| 3.3.0 | 31. Oktober 2024 | >=6.6.0.0 <6.7.0.0 |
|
| 3.2.4 | 21. Oktober 2024 | >=6.6.0.0 <6.7.0.0 |
|
| 3.2.3 | 23. September 2024 | >=6.6.0.0 <6.7.0.0 |
|
| 3.2.2 | 22. August 2024 | >=6.6.0.0 <6.7.0.0 |
|
| 3.2.1 | 21. August 2024 | >=6.6.0.0 <6.7.0.0 |
|
| 3.2.0 | 20. August 2024 | >=6.6.0.0 <6.7.0.0 |
|
| 3.1.3 | 23. Juli 2024 | >=6.6.0.0 <6.7.0.0 |
|
| 3.1.2 | 27. Juni 2024 | >=6.6.0.0 <6.7.0.0 |
|
| 3.1.1 | 24. Juni 2024 | >=6.6.0.0 <6.7.0.0 |
|
| 3.1.0 | 7. Mai 2024 | >=6.6.0.0 <6.7.0.0 |
|
| 3.0.1 | 25. März 2024 | >=6.6.0.0 |
|
| 3.0.0 | 7. März 2024 | >=6.6.0.0 |
|
| 2.6.5 | 23. Juli 2024 | >=6.5.0.0 <6.6.0.0 |
|
| 2.6.4 | 27. Juni 2024 | >=6.5.0.0 <6.6.0.0 |
|
| 2.6.3 | 7. Mai 2024 | >=6.5.0.0 <6.6.0.0 |
|
| 2.6.2 | 6. Mai 2024 | >=6.5.0.0 <6.6.0.0 |
|
| 2.6.1 | 2. Mai 2024 | >=6.5.0.0 <6.6.0.0 |
|
| 2.6.0 | 2. Mai 2024 | >=6.5.0.0 <6.6.0.0 |
|
| 2.5.10 | 16. April 2024 | >=6.5.0.0 |
|
| 2.5.9 | 1. März 2024 | >=6.5.0.0 |
|
| 2.5.8 | 29. Februar 2024 | >=6.5.0.0 |
|
| 2.5.7 | 14. Februar 2024 | >=6.5.0.0 |
|
| 2.5.6 | 13. Februar 2024 | >=6.5.0.0 |
|
| 2.5.5 | 12. Februar 2024 | >=6.5.0.0 |
|
| 2.5.4 | 12. Februar 2024 | >=6.5.0.0 |
|
| 2.5.3 | 12. Februar 2024 | >=6.5.0.0 |
|
| 2.5.2 | 12. Februar 2024 | >=6.5.0.0 |
|
| 2.5.1 | 12. Februar 2024 | >=6.5.0.0 |
|
| 2.5.0 | 9. Februar 2024 | >=6.5.0.0 |
|
| 2.4.1 | 7. Februar 2024 | >=6.5.0.0 |
|
| 2.4.0 | 5. Februar 2024 | >=6.5.0.0 |
|
| 2.3.0 | 15. Januar 2024 | >=6.5.0.0 |
|
| 2.2.4 | 23. Oktober 2023 | >=6.5.0.0 |
|
| 2.2.3 | 18. Oktober 2023 | >=6.5.0.0 |
|
| 2.2.2 | 17. Oktober 2023 | >=6.5.0.0 |
|
| 2.2.1 | 17. Oktober 2023 | >=6.5.0.0 |
|
| 2.2.0 | 16. Oktober 2023 | >=6.5.0.0 |
|
| 2.1.0 | 27. September 2023 | >=6.5.0.0 |
|
| 2.0.2 | 16. Juni 2023 | >=6.5.0.0 |
|
| 2.0.1 | 13. April 2023 | >=6.5.0.0 |
|
| 2.0.0 | 13. April 2023 | >=6.5.0.0 |
|
| 1.4.2 | 10. Februar 2023 | >=6.4.0.0 |
|
| 1.4.1 | 6. Februar 2023 | >=6.4.0.0 |
|
| 1.4.0 | 6. Februar 2023 | >=6.4.0.0 |
|
| 1.3.2 | 20. Dezember 2022 | >=6.4.0.0 |
|
| 1.3.1 | 16. Dezember 2022 | >=6.4.0.0 |
|
| 1.3.0 | 6. Dezember 2022 | >=6.4.0.0 |
|
| 1.2.0 | 1. Dezember 2022 | >=6.4.0.0 |
|
| 1.1.2 | 26. November 2022 | >=6.4.0.0 |
|
| 1.1.1 | 26. November 2022 | >=6.4.0.0 |
|
| 1.1.0 | 26. November 2022 | >=6.4.0.0 |
|
| 1.0.0 | 26. November 2022 | >=6.4.0.0 |
|