Bestellbestaetigung / Angebot

Diese Detailseite beschreibt die Vorlagen fuer Bestellbestaetigung, Angebot und Ankaufsmail inklusive Formularfeldern, Versandlogik, Anhaengen und nutzbaren Order-Variablen.

Wann welche Vorlage verwendet wird

Der Versandcode waehlt die Vorlage in sendByEmail anhand von Angebotskennzeichen und Auftragstyp. Damit ist wichtig, den richtigen internen Vorlagennamen zu bearbeiten und vor dem Speichern den aktiven Multishop zu pruefen.

• bestellbestaetigung_text: normale Verkaufsbestellung ohne Angebotskennzeichen.
• angebot_email: Auftrag mit Angebotskennzeichen. Betreff, Mailtext, Anhaenge und Zusatzdatei kommen aus dieser Vorlage.
• purchase_text: Ankaufauftrag. Diese Vorlage nutzt dieselbe Feldlogik wie Bestellbestaetigung und Angebot.

Die Mail wird an die Kundenadresse der Bestellung gesendet, sofern beim manuellen Versand keine abweichende Zieladresse uebergeben wird. Nach dem Versand schreibt das Backend einen Eintrag in die Bestellhistorie.

Bearbeitbare Felder

Die Felder werden im Bearbeiten-Dialog der E-Mail-Vorlagen gepflegt. Fuer diese drei Vorlagen sind neben Betreff und Text auch Anhaenge und eine zusaetzliche Druckvorlage relevant.

• subject: Betreff der Mail. Platzhalter wie {ORDER_BESTELL_NR} werden vor dem Versand ersetzt.
• value_html: HTML-Fassung des Mailtexts. Diese Fassung wird als Hauptinhalt der Mail verwendet.
• value: TXT-Fassung des Mailtexts. Das Backend erzeugt daraus den alternativen Textinhalt.
• value_detail_html und value_detail: alte Listenzeilen fuer Bestellpositionen. Der Dialog zeigt diese Felder nur, wenn bereits Inhalt vorhanden ist, und markiert den Bereich als veraltet.
• file_attach1 und file_attach2: optionale Dateianhaenge. Beim Upload werden Leerzeichen im Dateinamen durch Unterstriche ersetzt.
• remove_file_attach1 und remove_file_attach2: entfernen bereits gespeicherte Anhaenge.
• zusatzvorlage_id: haengt beim Versand eine zusaetzliche Druckvorlage als PDF an.
• sender_name, sender_email, replay_to, bcc_emails: optionale Absender-, Antwort- und BCC-Daten nur fuer diese Vorlage. Mehrere BCC-Adressen werden mit Semikolon getrennt.

Versand und Anhaenge

Beim Versand werden Kundendaten, Bestelldaten, Positionsdaten, Multishop-Daten und Zahlungsinformationen in das Template eingesetzt. Danach fuegt das Backend vorhandene Dateianhaenge hinzu.

• Direkte Anhaenge: file_attach1 und file_attach2 werden als Datei an die Mail angehaengt, wenn ein Dateiname gespeichert ist.
• Zusatz-PDF: Wenn zusatzvorlage_id gesetzt ist, wird aus der gewaehlten Druckvorlage ein PDF erzeugt und nach dem Versand wieder bereinigt.
• Giro-Code: Wenn der HTML-Text den Platzhalter GIRO_PAY_QR_CODE_EMAIL enthaelt, versucht das Backend einen eingebetteten Giro-Code zu erzeugen.
• BCC-Regel: Bei aktiven globalen Mailkopien werden vorhandene BCC-Empfaenger vor dem Versand geleert. Bei deaktivierten Bestellungen werden BCC-Empfaenger ebenfalls entfernt.
• Mailkopien: Wenn globale Mailkopien aktiv sind, speichert das Backend den gesendeten MIME-Inhalt als Systemmail-Eintrag zur Bestellung und zum Kunden.

Wichtige Variablengruppen

Die Vorlage nutzt die Bestell- und Kundendaten aus dem Auftrag. Alte Variablen ohne ORDER_-Prefix werden weiterhin geladen, neue Vorlagen sollten bevorzugt die aktuellen Namen verwenden.

• Auftrag: {ORDER_BESTELL_NR}, {ORDER_EXTERN_BESTELL_NR}, {ORDER_BESTELL_TYP}, Datum/Uhrzeit-Felder und {ORDER_BEMERKUNG_KUNDE}.
• Kunde: {KUNDEN_NR}, Name, Firma, Adresse, E-Mail und Kontaktdaten.
• Adressen: Lieferadresse mit {ORDER_SHIP_*} und Rechnungsadresse mit {ORDER_BILL_*}.
• Summen: {ORDER_SUMME_POSITIONEN}, Netto-/Brutto-Summen, {ORDER_GESAMTSUMME} und {ORDER_WAEHRUNG}.
• Versand und Zahlung: {ORDER_VERSAND_ART}, {ORDER_VERSAND_KOSTEN}, {ORDER_VERSAND_HINWEIS}, {ORDER_RECHNUNG_ART}, {ORDER_RECHNUNG_KOSTEN} und {ORDER_RECHNUNG_HINWEIS}.
• Signatur und Shop: {FIRMEN_LOGO}, {EMAIL_SIG_HTML}, {EMAIL_SIG_TXT} sowie Multishop-Variablen.

Schleifen in der Vorlage

Mehrfachdaten werden ueber Template-Schleifen ausgegeben. Die wichtigste Schleife fuer diese Vorlage ist details fuer Bestellpositionen.

• details: liefert Position, Artikelnummer, Lieferbarkeit, Menge, Name, Preis, Gesamtpreis, Beschreibung, EAN, Produktlink, Bild, Varianten und Zusatzfelder.
• details.alle_auswahlfelder: listet Varianten, Zusatzoptionen, Bundle-Bestandteile und formularbasierte Auswahlwerte je Position.
• details.show_einzelpreis, details.show_mengenpreis, details.show_gesamtpreis: optionale Preisbereiche, die nur bei passenden Preiswerten gefuellt werden.
• rabattgutscheine, wertgutscheine und rabatt: geben Gutscheine und Rabatte aus.
• steuern: gibt Steuerhinweis, Steuersatz und Steuerbetrag aus.
• show_pui_data: erscheint bei Zahlungsarten mit Pay-upon-invoice-Daten und stellt Empfaenger, Bank, IBAN, BIC, Verwendungszweck und Faelligkeitsdatum bereit.

Variablen-Snippets

Die folgenden Snippets liefern die bestehende Platzhalterreferenz fuer allgemeine Maildaten, Kundendaten, Bestelldaten und Positionsdaten.

---

Shopvariablen

Kundenvariablen

Variablen zum Benutzerkonto

Bestellvariablen

Schleife: rabattgutscheine

Schleife: wertgutscheine

Schleife: rabatt

Schleife: steuern

Schleife: custgroup_X

X ist mit der jeweiligen Kundengruppen Id zu ersetzen.

Mit dieser Schleife kannst du bestimmte Inhalte für eine Kundengruppe hinterlegen.

Schleife: country_X

X ist mit dem entsprechenden Iso2 Code (in Kleinbuchstaben) des Rechnungslandes zu ersetzen.

Mit dieser Schleife kannst du bestimmte Inhalte für ein bestimmtes Rechnungsland hinterlegen.

Schleife: rechnungsart_X

X ist mit dem entsprechenden Modulnamen der Zahlungsart zu ersetzen.

Mit dieser Schleife kannst du bestimmte Inhalte für eine bestimmte Zahlart hinterlegen.

Schleife: switch_tax_country

Diese Schleife ist gesetzt, sobald die Steuerberechnung aufgrund der Lieferschwelle erfolgt ist.

Schleife: switch_tax_country_oss

Diese Schleife ist gesetzt, sobald die Steuerberechnung aufgrund der Lieferschwelle erfolgt ist und das Versandland am OSS Verfahren teilnimmt, sowie der Kunde einer Kundengruppe angehört, die das OSS Verfahren anwendet.

Schleife: switch_tax_country_no_oss

Diese Schleife ist gesetzt, sobald die Steuerberechnung aufgrund der Lieferschwelle erfolgt ist und die Schleife switch_tax_country_oss nicht aktiv ist.

Schleife: details

Schleife: details.gratisartikel

Die Schleife ist gesetzt, wenn es sich um ein Gratisprodukt handelt

Schleife: details.amazon_is_prime

Die Schleife ist gesetzt, wenn es sich um ein Amazon Prime Bestellung handelt

Schleife: details.ebay

Die Schleife ist gesetzt, wenn es eine ebay-Bestellung ist

Schleife: details.bundle

Schleife: details.show_if_price_null

Diese Schleife wird gesetzt, wenn der Verkaufspreis 0 ist

Schleife: details.show_einzelpreis

Schleife: details.show_mengenpreis

Schleife: details.show_gesamtpreis

Schleife: details.alle_auswahlfelder

beinhaltet Varianten, Bundles, und Bestellmerkmale

Schleife: details.auswahlfelder

beinhaltet Bestellmerkmale vom Typ Auswahlfeld

Schleife: details.auswahlfelder2

beinhaltet Varianten, Bundles, und Bestellmerkmale außer vom Typ Auswahfeld

Innerhalb der Schleife details stehen zusaetzlich Produktvariablen im Format {details.VARIABLE} bereit.

Produktvariablen

---

Bilder INDEX ist mit der jeweiligen Bildnummer zu ersetzen: 1, 2, 3 etc

---

Variantendaten, sofern es sich um eine spezielle Variante handelt.

Sicher arbeiten

1. Richtigen Multishop waehlen und den internen Vorlagennamen kontrollieren.
2. Betreff, HTML-Text und TXT-Text gemeinsam aktualisieren.
3. Bei Anhaengen pruefen, ob der Dateiname fuer alle Datensaetze mit gleichem internen Namen im Multishop gelten soll.
4. Zusatz-PDF nur verwenden, wenn die gewaehlte Druckvorlage zur Mail passt.
5. Nach dem Speichern eine Testbestellung, ein Angebot oder einen Ankaufsvorgang ausloesen und empfangene Mail, Anhaenge, Systemmail-Protokoll und Bestellhistorie pruefen.