Ersetzungsvariablen – GSALES Support

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} Die letzten 4 Stellen werden durch "xxxx" ersetzt. Beispielsweise {c.bank_iban.xxx} verwenden um die IBAN des Kunden unkenntlich zu machen. Nicht auf Datum-Felder anwendbar.

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. (jeweils im Präfix und Suffix)
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