Ersetzungsvariablen
- Gökhan Sirin
Programm
In einigen Programmbereichen, können in bestimmten Feldern Variablen verwendet werden:
Programmbereiche: | Rechnungen, Angebote, Gutschriften |
Felder: | Einleitungs-, Abschluss- und Positionstexte |
Variablen: | {x} |
| {faellig} aus älteren Versionen wird weiterhin unterstützt |
| {c.y} |
| {c.y.xxx} |
x = alle Felder der Datenbank-Tabelle 'invoices', 'offers' bzw. 'refunds'
y = alle Felder der Datenbank-Tabelle 'customers'
Programmbereiche: | Mahnwesen |
Felder: | Einleitungs- und Abschlusstext |
Variablen: | {datum_m1} = Generierungsdatum der 1. Mahnstufe |
| {datum_m2} = Generierungsdatum der 2. Mahnstufe |
| {+x} = Datum x Tage in der Zukunft |
Programmbereich: | Serienvorlagen |
Felder: | Positionstexte |
Variablen: | {x} |
| [zeitraum] |
x = alle Felder der Datenbank-Tabelle 'customers'
Programmbereich: | Konfiguration |
Felder: | Auftrags-Nr., Lieferschein-Nr., Rechnungs-Nr., Angebots-Nr., Gutschrifts-Nr. |
Variablen: | {YYYY} = aktuelles Jahr, vierstellig |
| {YY} = aktuelles Jahr, zweistellig |
| {MM} = aktueller Monat, zweistellig |
Programmbereich: | Konfiguration |
Felder: | Sonstiges > Empfängertext |
Variablen: | {br} = Zeilenumbruch |
PDF-Templates
In den PDF Templates stehen Variablen aus unterschiedlichen Bereichen zur Verfügung:
Konfiguration
Zugriff auf alle Werte der g*Sales-Konfiguration über die Methode:$this->refCore->cfg->v('x');
x = alle Werte des 'id'-Feldes in der Datenbank-Tabelle 'configuration'
Allgemein
Variable | Beschreibung |
z['type'] | Dokumentenart (offers, invoices, contracts, refunds) |
z = $this->pdfData innerhalb der Klasse, $var_array außerhalb
Kundendaten
Variable | Beschreibung |
z['customerdata']['x'] | Kundendetails (verwendbar, wenn Dokument mit Kunde verknüpft ist und dieser noch vorhanden ist) |
x = alle Felder der Datenbank-Tabelle 'customers'
z = $this->pdfData innerhalb der Klasse, $var_array außerhalb
Rechnungsdaten
Variable | Beschreibung |
z['base']['x'] | Rechnungsdetails |
z['base']['recipient_txt'] | zusammengesetzte Anschrift |
z['base']['rounded_amount'] | Rechnungsbetrag gerundet auf 2 Nachkommastellen |
x = alle Felder der Datenbank-Tabelle 'invoices'
z = $this->pdfData innerhalb der Klasse, $var_array außerhalb
Rechnungspositionen
Variable | Beschreibung |
z['pos']['key']['x'] | Rechnungspositionsdetails |
z['pos']['key']['tprice'] | Gesamtpreis (Menge*Einzelpreis abzgl. Rabatt) |
z['pos']['key']['rounded_tprice'] | Gesamtpreis gerundet auf 2 Nachkommastellen |
z['pos']['key']['tax_value'] | MwSt.-Betrag |
z['pos']['key']['discount_value'] | Rabatt-Betrag |
x = alle Felder der Datenbank-Tabelle 'invoices_pos'
z = $this->pdfData innerhalb der Klasse, $var_array außerhalb
Rechnungssummen
Variable | Beschreibung |
z['summ']['net_calc'] | Nettobetrag |
z['summ']['discount'] | Rabatt-Betrag |
z['summ']['tax'] | MwSt.-Betrag |
z['summ']['gross'] | Bruttobetrag gerundet auf 2 Nachkommastellen |
z['summ']['rounded_net_calc'] | Nettobetrag gerundet auf 2 Nachkommastellen |
z['summ']['rounded_discount'] | Rabatt-Betrag gerundet auf 2 Nachkommastellen |
z['summ']['rounded_tax'] | MwSt.-Betrag gerundet auf 2 Nachkommastellen |
z['summ']['rounded_gross'] | Bruttobetrag gerundet auf 2 Nachkommastellen |
z = $this->pdfData innerhalb der Klasse, $var_array außerhalb
E-Mail-Templates
Allgemeiner Aufbau der E-Mail-Templates:
Betreffzeile
[MAIL-NEXT-PART]Plain-Text-Version
[MAIL-NEXT-PART]HTML-Version
In den Inhaltsbereichen können folgende Variablen verwendet werden:
Variable | Beschreibung |
{$mail.titel} | Rechnung, Angebot, Gutschrift |
{$mail.anredepronomen_plus_titel} | Ihre Rechnung, Ihr Angebot, Ihre Gutschrift |
{$customer.x} | Kundendaten |
{$invoice.base} | vgl. PDF-Templates |
{$invoice.pos} | vgl. PDF-Templates |
{$invoice.summ} | vgl. PDF-Templates |
x = alle Felder der Datenbank-Tabelle 'customers'
Smarty Modifier
Die sogenannten Modifier des Templatesystems Smarty wurden erweitert um: gsalescurrency, gsalesdateformat, gsalesdatetimeformat, gsalesfloat. Diese können ebenfalls auf die Variablen angewendet werden.