QRBill+ E-Mail-Vorlagen und Tags¶

Wählen Sie eine Vorlage und Sprache aus der Bibliothek und passen Sie Nachricht und Gestaltung an. Ihre Kopie bleibt von späteren Bibliotheksänderungen unabhängig. Ordnen Sie die Vorlage in den E-Mail-Einstellungen der Integration dem gewünschten Ereignis und Empfängerkreis zu. Das Erstellen einer Vorlage aktiviert noch keinen Versand.

Gestaltung und automatische Vorschau¶

Der Editor bietet eine Markenkarte, eine schlichte Nachricht, einen farbigen Header und ein Brieflayout. Ordnen Sie Kopfbereich, Nachricht, Rechnungsübersicht und Fussbereich mit den Pfeiltasten oder per Drag-and-drop an. Einstellbar sind das Integrationslogo, dessen Grösse und Ausrichtung, Ausstellername und Überschrift, zusätzliche Kopf-/Fusstexte, Farben, Schrift, Breite und Abstände. Das Logo stammt aus der Integration, mit der die Rechnung versendet wird.

Die Rechnungsübersicht ist ein eigener optionaler Abschnitt. Übernehmen Sie den Integrationsstandard, blenden Sie die Übersicht ein oder aus und wählen Sie ihre Felder. Leere Fälligkeiten werden weggelassen. Ist nichts mehr offen, entfällt der Zahlungslink in der Übersicht. Diese Einstellungen steuern die Übersicht, nicht die Tags in Ihrem Nachrichtentext.

Die Vorschau aktualisiert sich nach Änderungen automatisch und versendet keine E-Mail. Wählen Sie Neue Rechnung, Zahlung eingegangen, Bezahlte Rechnung oder Mahnung sowie Desktop-/Mobilbreite. Die Werte sind Beispieldaten. Beim Versand gelten die tatsächliche Rechnung und der Versandanlass. E-Mail-Programme können Abstände und Schriften unterschiedlich darstellen; prüfen Sie ein Beispiel in Ihren verwendeten Programmen, bevor Sie ein neues Design übernehmen.

Tags verwenden¶

Schreiben Sie Tags in doppelte geschweifte Klammern, zum Beispiel {{invoice_number}}. Sie funktionieren in Betreff, Überschrift, Nachricht und zusätzlichen Kopf-/Fusstexten; E-Mail-Adress-Tags auch im Feld Empfänger. Werte werden als Text eingesetzt und können kein beliebiges HTML oder Skripte einfügen. Markieren Sie für einen Link den gewünschten Text im Editor und verwenden Sie einen URL-Tag wie {{invoice_url}} als Linkziel.

Fehlende optionale Werte bleiben leer, wenn der Tag im jeweiligen Kontext bekannt ist. Unbekannte Tags können sichtbar bleiben; kontrollieren Sie Schreibweise und Vorschau. Plugin-spezifische Tags benötigen die entsprechenden Daten und sind bei manuell erstellten Rechnungen nicht garantiert.

Rechnungs-, Kontakt- und Mahn-Tags¶

Die letzten fünf Mahnfelder (payment_deadline bis reminder_record_url) werden nur bei Mahnungen gefüllt. Sie erzeugen keine automatisch sichtbaren Felder: Text erscheint nur dort, wo Ihre Vorlage ihn enthält. Verwenden Sie eine Mahnvorlage aus der Bibliothek oder einen bedingten Abschnitt. Den Mahnversand konfigurieren Sie separat in der Integration.

Tag	Bedeutung
`{{invoice_number}}`	Angezeigte Rechnungsnummer; bevorzugt gegenüber internen Kennungen verwenden.
`{{invoice_id}}`, `{{db_id}}`	Kennung der Rechnung bei mame.
`{{bill_id}}`, `{{id}}`	Kennung der Quellrechnung; kann von der angezeigten Rechnungsnummer abweichen.
`{{invoice_date}}`	Erstellungsdatum der Rechnung, formatiert.
`{{invoice_due_date}}`	Ursprüngliche Fälligkeit der Rechnung. Leer, wenn keine Zahlungsfrist gilt.
`{{due_date}}`, `{{due_date_formatted}}`	Bisherige Datumsfelder. Für neue Vorlagen invoice_due_date verwenden.
`{{amount}}`	Rechnungsbetrag mit zwei Dezimalstellen.
`{{amount_paid}}`	Zum Versandzeitpunkt bezahlter Betrag.
`{{amount_open}}`	Zum Versandzeitpunkt offener Betrag.
`{{currency}}`	Rechnungswährung, z. B. CHF.
`{{reference}}`	Zahlungsreferenz, sofern vorhanden.
`{{status}}`	Rechnungsstatus; das Plugin kann den übersetzten Anzeigetext liefern. In Bedingungen die is_*-Tags verwenden.
`{{is_paid}}`, `{{is_partially_paid}}`, `{{is_unpaid}}`	Statusmerkmale: 1 bei entsprechendem Rechnungsstatus, sonst 0.
`{{invoice_url}}`	Zahlungsseite oder PDF-Link, falls keine Zahlungsseite existiert.
`{{payment_url}}`	Zahlungsseite, sofern vorhanden. Eine geschlossene Rechnung kann nicht nochmals bezahlt werden.
`{{pdf_download_url}}`	PDF-Download-Link, falls für diese Rechnung vorhanden.
`{{invoice_admin_url}}`	Rechnungsseite im Händler-Dashboard mit Anmeldung. Für Händler-E-Mails vorgesehen.
`{{recipient_name}}`, `{{customer_name}}`	Anzeigename des Rechnungsempfängers.
`{{recipient_email}}`, `{{customer_email}}`	E-Mail-Adresse des Empfängers; auch im Feld Empfänger verwendbar.
`{{admin_email}}`	E-Mail-Adresse des mame-Kontoinhabers.
`{{merchant_company}}`	Name des Rechnungsausstellers; bevorzugt aus dem Zahlungsempfänger der ausgestellten Rechnung.
`{{merchant_address}}`	Adresse des Rechnungsausstellers.
`{{merchant_contact}}`	Kontakt-E-Mail-Adresse des Ausstellers.
`{{merchant_contact_person}}`	Ansprechperson beim Aussteller, sofern vorhanden.
`{{integration_name}}`, `{{integration_domain}}`	Name und Webadresse des Shops bzw. der Integration, sofern übermittelt.
`{{shop_id}}`	Kennung des Quellshops.
`{{wc_order_id}}`, `{{wc_order_number}}`	WooCommerce-Bestell-ID und angezeigte Bestellnummer.
`{{terms_url}}`	Vom Shop übermittelter AGB-Link; ersatzweise dessen Webadresse.
`{{collections_notice_enabled}}`	Bedingung für einen konfigurierten Inkassohinweis; normalerweise 0. Das Einfügen des Tags aktiviert kein Inkasso.
`{{sent_at_with_timezone}}`	Versandzeitpunkt bzw. geplanter Versandzeitpunkt mit Zeitzone.
`{{payment_deadline}}`	Zusätzliche Zahlungsfrist der aktuellen Mahnung; nicht identisch mit invoice_due_date.
`{{reminder_stage}}`, `{{reminder_stage_title}}`	Lokalisierte Bezeichnung und Überschrift der ersten bzw. zweiten Mahnung.
`{{first_reminder_date}}`	Datum der ersten Mahnung aus dem Mahnkontext. Fehlt es, gilt derzeit ersatzweise die ursprüngliche Fälligkeit plus sieben Tage; kein Nachweis eines erfolgten Versands.
`{{reminder_trigger}}`	Lokalisierte Angabe automatisch/manuell zur Mahnung.
`{{reminder_record_url}}`	Link zum Rechnungs-/Mahneintrag im Händler-Dashboard mit Anmeldung. Für Händler-E-Mails verwenden.

Bedingte Abschnitte¶

Mit Bedingungen blenden Sie eine ganze Zeile aus, wenn ihr Wert fehlt. So bleibt auch keine Beschriftung wie «Zahlungsfrist:» ohne Datum stehen.

{{#if invoice_due_date}}Fälligkeit: {{invoice_due_date}}{{/if}}
{{#if payment_deadline}}Bitte bezahlen Sie bis {{payment_deadline}}.{{/if}}
{{#if_not is_paid}}Offener Betrag: {{amount_open}} {{currency}}{{/if_not}}
{{#if_eq subscription_status "active"}}Ihr Abo ist aktiv.{{/if_eq}}
{{#if_ne currency "CHF"}}Rechnungswährung: {{currency}}{{/if_ne}}

Schliessen Sie jede Bedingung mit ihrem passenden End-Tag. Bedingungen können verschachtelt werden. Statusmerkmale verwenden 1/0; nutzen Sie für Zahlungsbedingungen is_paid, statt übersetzte Statusbezeichnungen zu vergleichen.

Zusätzliche WooCommerce- und Abo-Tags¶

Diese Werte hängen vom verbundenen Shop und den bei der Rechnung gespeicherten Daten ab. Abo-Tags benötigen WooCommerce Subscriptions und ein zugehöriges Abo; bei mehreren Abos beschreiben sie das primäre Abo. In der allgemeinen Vorschau sind nicht alle diese Tags gefüllt.

Tags	Bedeutung
`{{payer_first_name}}`, `{{payer_last_name}}`, `{{payer_full_name}}`, `{{payer_company}}`, `{{payer_company_or_name}}`	Namens- und Firmenfelder des Empfängers.
`{{payer_street}}`, `{{payer_house_number}}`, `{{payer_zip}}`, `{{payer_city}}`, `{{payer_country}}`, `{{payer_email}}`	Empfängeradresse, Länderbezeichnung und E-Mail.
`{{payer_formatted_address_first_line}}`, `{{payer_formatted_address_rest}}`	Erste und weitere Zeilen der formatierten Rechnungsadresse.
`{{beneficiary_name}}`, `{{beneficiary_addition}}`, `{{beneficiary_street}}`, `{{beneficiary_house_nr}}`, `{{beneficiary_zip}}`, `{{beneficiary_city}}`, `{{beneficiary_country}}`	Zahlungsempfängerfelder des Plugins, sofern übermittelt. Für den Aussteller der ausgestellten Rechnung merchant_company und merchant_address bevorzugen.
`{{time}}`, `{{date}}`, `{{payment_due_date}}`	Uhrzeit, Datum und formatierte Fälligkeit der Quellrechnung.
`{{reference_add_order_id}}`, `{{reference_context_source}}`, `{{reference_context_custom_numeric}}`	Quellwerte zur Bildung der Zahlungsreferenz.
`{{billing_company}}`, `{{billing_name}}`, `{{shipping_company}}`, `{{shipping_name}}`	Firma und Name für Rechnungs- und Lieferadresse.
`{{payment_method}}`, `{{payment_method_title}}`	Kennung und Bezeichnung der WooCommerce-Zahlungsart.
`{{shipping_method}}`, `{{shipping_method_title}}`	Bezeichnung der Versandart.
`{{order_created_at}}`, `{{order_created_date}}`, `{{order_date}}`	Zeitstempel und formatiertes Erstellungsdatum der Bestellung.
`{{order_paid_at}}`, `{{order_paid_date}}`, `{{order_completed_at}}`, `{{order_completed_date}}`	Zeitstempel und formatierte Daten der Bezahlung bzw. des Abschlusses, sofern vorhanden.
`{{order_total}}`, `{{order_total_tax}}`, `{{order_subtotal}}`, `{{order_discount_total}}`	Gesamtbetrag, Steuer, Zwischensumme und Rabatt der Bestellung aus WooCommerce. Für aktuelle Rechnungsbeträge amount/amount_paid/amount_open verwenden.
`{{template_name}}`, `{{template_additional_information}}`, `{{payment_slip}}`	Kompatibilitätsfelder; Vorlagenfelder und payment_slip können leer sein. Der Zahlungsabschnitt-Tag fügt kein QR-Bild in die E-Mail ein.
`{{subscription_count}}`, `{{subscription_id}}`, `{{subscription_status}}`	Anzahl der Abos sowie Kennung und Status des primären Abos.
`{{subscription_is_subscription_order}}`, `{{subscription_contains_subscription}}`, `{{subscription_is_renewal_order}}`, `{{subscription_is_resubscribe_order}}`, `{{subscription_is_switch_order}}`	Statusmerkmale zum Abo-Kontext der Bestellung.
`{{subscription_billing_period}}`, `{{subscription_billing_interval}}`	Abrechnungsperiode und Intervall des primären Abos.
`{{subscription_start_date}}`, `{{subscription_trial_end_date}}`, `{{subscription_next_payment_date}}`, `{{subscription_last_payment_date}}`, `{{subscription_end_date}}`, `{{subscription_cancelled_date}}`	Datumswerte des primären Abos, sofern vorhanden.
`{{subscription_parent_order_id}}`, `{{subscription_customer_id}}`	Kennungen der übergeordneten Bestellung und des Abo-Kunden.
`{{subscription_payment_method}}`, `{{subscription_payment_method_title}}`, `{{subscription_currency}}`, `{{subscription_total}}`	Zahlungsart, Währung und Betrag des primären Abos.
`{{subscription_requires_manual_renewal}}`, `{{subscription_renewal_order_count}}`, `{{subscription_product_names}}`	Merkmal für manuelle Verlängerung, Anzahl Verlängerungsbestellungen und Produktnamen.

Bisherige deutsche Alias-Tags¶

Bestehende Vorlagen unterstützen weiterhin diese Alias-Tags. Verwenden Sie für neue Vorlagen in jeder Sprache die englischen Namen.

Bisheriger Tag	Empfohlener Tag
`{{rechnungsnummer}}`	`{{invoice_number}}`
`{{rechnungs_id}}`	`{{invoice_id}}`
`{{rechnungsdatum}}`	`{{invoice_date}}`
`{{faelligkeitsdatum}}`	`{{invoice_due_date}}`
`{{offener_betrag}}`	`{{amount_open}}`
`{{zahlungsfrist}}`	`{{payment_deadline}}`
`{{rechnungslink}}`	`{{invoice_url}}`
`{{empfaenger_anrede}}`	`{{recipient_name}}`
`{{empfaenger_email}}`	`{{recipient_email}}`
`{{merchant_firma}}`	`{{merchant_company}}`
`{{merchant_adresse}}`	`{{merchant_address}}`
`{{merchant_kontakt}}`	`{{merchant_contact}}`
`{{merchant_ansprechperson}}`	`{{merchant_contact_person}}`
`{{mahnstufe}}`	`{{reminder_stage}}`
`{{mahnstufe_titel}}`	`{{reminder_stage_title}}`
`{{erste_mahnung_datum}}`	`{{first_reminder_date}}`
`{{versandzeitpunkt_mit_zeitzone}}`	`{{sent_at_with_timezone}}`
`{{automatisch_oder_manuell}}`	`{{reminder_trigger}}`
`{{mahnnachweis_link}}`	`{{reminder_record_url}}`
`{{agb_link}}`	`{{terms_url}}`
`{{inkasso_hinweis_aktiv}}`	`{{collections_notice_enabled}}`

Weitere einfache Werte Ihrer Integration können über ihre Punktpfade angesprochen werden, zum Beispiel {{order_data.number}}. Die Verfügbarkeit hängt von der Integration ab; bevorzugen Sie die oben dokumentierten festen Tags.