Ein Änderungsparameter ist ein spezieller Code, der das Feldformat ändert. Er wird innerhalb eines symbolischen Codes nach dem Tilde-Zeichen (~) platziert. Beispielsweise ist in {DocumentCreateTime~F j, Y, g:i a} DocumentCreateTime der Feldcode und F j, Y, g:i a der Änderungsparameter.

Bevor Sie Ihre Arbeit mit den Änderungsparametern beginnen, empfehlen wir Ihnen, zuerst den Beitrag über symbolische Codes zu lesen, denn die Änderungsparameter funktionieren ohne Codes nicht.
Symbolische Codes: was ist das und wie werden sie verwendet?

Änderungsparameter können nur für Felder eines bestimmten Datentyps verwendet werden.

Typen der Änderungsparameter

Änderungsparameter können für Datumsangaben, Namen, Adressen, Beträge und Textfall verwendet werden. Hier sind die Änderungsparameter für jeden Typ.

Datum und Uhrzeit. Standardmäßig hat ein Datum immer das Format des jeweiligen Landes, je nachdem, aus welcher Vorlage das Dokument erstellt wird. Welches Land angegeben ist, können Sie in den Einstellungen der Vorlage nachschlagen
Dokumentvorlagen

Änderungsparameter für das Datum:

• d.m.y — 28.08.25
• d.m.Y — 28.08.2025
• j, n, Y — 28, 08, 2025
• j F, Y — August 28, 2025

Änderungsparameter für die Uhrzeit:

• H:i:s — 10:24:18
• g:i a — 10:24 am

Die Änderungsparameter für das Datum und die Uhrzeit können kombiniert werden:

• Y-m-d H:i:s — 2023-08-28 10:24:18
• F j, Y, g:i a — August 28, 2025, 10:24 am

Eine vollständige Liste von Datum- und Uhrzeit-Änderungsparametern finden Sie in der Dokumentation für Entwickler.
Weitere Parameter für Datum und Uhrzeit

Um das Feld Erstellt am zu formatieren, fügen Sie den Änderungsparameter ~F j, Y, g:i a zum Code {DocumentCreateTime} hinzu. Das ergibt den Code {DocumentCreateTime~F j, Y, H:i:s}.

Name. Mit den Änderungsparametern kann man die Reihenfolge vom Namen, Vornamen und anderen Elementen angeben. Um die Reihenfolge zu ändern, verwenden Sie den Parameter ~Format=. Die Änderungsparameter für den Namen funktionieren nur mit Standardfeldern.
Systemfelder im CRM

Änderungsparameter für den Namen:

• #TITLE# — Anrede
• #NAME# — Vorname
• #LAST_NAME# — Nachname
• #SECOND_NAME# — Zweiter Vorname
• #NAME_SHORT# — der erste Buchstabe des Vornamens mit dem Punkt
• #LAST_NAME_SHORT# — der erste Buchstabe des Nachnamens mit dem Punkt
• #SECOND_NAME_SHORT# — der erste Buchstabe des zweiten Vornamens mit dem Punkt

Beispiel: Um den vollständigen Namen des Kontakts in der Druckform so anzuzeigen, dass die Anrede, der Vorname, der erste Buchstabe des Zweitnamens und der Nachname erscheinen, verwenden Sie den Code: {ContactFormattedName~Format=#TITLE# #NAME# #SECOND_NAME_SHORT# #LAST_NAME#}.

Adresse. Standardmäßig verwendet Bitrix24 das Adressformat des aktuellen Landes der Vorlage.
Dokumentvorlagen

Sie können das Adressformat ändern und bei Bedarf einen Zeilenumbruch hinzufügen. Verwenden Sie den Parameter ~Format=, um das Format zu ändern, und ~Separator=, um Zeilen zu trennen.

Änderungsparameter für das Format- und Trennzeichen:

Format:

• 1 — Europa
• 2 — Großbritannien
• 3 — Nordamerika

Separator:

• 1 — Komma
• 2 — ohne Trennzeichen
• 3 — Zeilenvorschub

Beispiel: Der Änderungsparameter {Address~Format=1,Separator=1} fügt die Adresse im europäischen Format ein, wobei jedes Teil der Adresse in der neuen Zeile angegeben wird.

Geldbeträge. Für Geldbeträge können Sie symbolische Codes modifizieren, um Nullen nach dem Dezimalpunkt und das Währungssymbol in der Druckform anzuzeigen oder auszublenden.

Verfügbare Parameter:

• WZ (With zeros). Standardmäßig zeigt Bitrix24 zusätzliche Nullen für Geldbeträge an. Mit WZ=N wird der Betrag ohne Nullen am Ende angezeigt. Beispielswese wird 120,00 zu 120. Standardmäßig werden Nullen in Feldern wie {TotalRaw} (Gesamtbetrag ohne Steuern), {TaxesTaxRate} (Steuersatz) und {TotalSum} (Gesamtbetrag) angezeigt. In tabellarischen Feldern wie {ProductsProductPriceRawNetto} (Vollpreis ohne Steuern) und {ProductsProductPriceRawSum} (Gesamtvollpreis ohne Steuern) werden Nullen nur angezeigt, wenn Sie den Änderungsparameter WZ=Y verwenden.
• NS (No sign). Wenn der Wert NS=Y ist, wird das Währungssymbol nicht angezeigt, und wenn der Wert NS=N ist, wird das Währungssymbol angegeben.
• W (Words). Wenn der Wert W=Y ist, wird der Betrag in Worten ausgeschrieben.
• SN (Show No VAT). Wenn der Wert SN=Y ist, wird der Steuersatz ohne den Hinweis auf die Mehrwertsteuer angezeigt, also nur der numerische Wert des Satzes. Beispiel: {TaxesTaxRate~SN=Y} gibt 20 statt 20 % MwSt. aus.
• WP (With Percent). Wenn der Wert WP=Y ist, wird dem Steuersatz ein Prozentzeichen hinzugefügt. Beispiel: {TaxesTaxRate~WP=Y} gibt 20 % aus. Wenn WP=N angegeben wird, wird das Prozentzeichen nicht angezeigt.

Um den Auftragsbetrag dem mit Währungssymbol und Nullen am Ende anzuzeigen, verwenden Sie den Code: {TotalSum~WZ=Y,NS=N}.

Telefonnummer. Sie können das Format der Telefonnummer mithilfe des Änderungsparameter ~format= bearbeiten.

Verfügbare Formate umfassen:

• E.164 — +4915712345678
• International — +49 30 123456 01
• National — (030) 123456 01

Um die Telefonnummer eines Kontakts im vertrauten Format ohne Leerzeichen anzuzeigen, verwenden Sie den Code {ContactPhone~format=E.164}, wobei {ContactPhone} der symbolische Code für das Feld Telefon im Kontaktformular ist.

Textfall. Verwenden Sie den Änderungsparameter ~letterCase=, um den Textfall zu ändern.

Der Änderungsparameter kann folgende Werte annehmen:

• upper — GROSSBUCHSTABEN
• lower — kleinbuchstaben
• title — der 1. Buchstabe jedes Wortes wird großgeschrieben

Um zum Beispiel einen Kommentar aus dem Auftragsformular in einen Titel zu formatieren, verwenden Sie den Code: {Comments~letterCase=title}.

Änderungsparameter können verwendet werden, um die ursprünglichen Werte von CRM-Feldern zu ändern. Passen Sie das Datums- und Uhrzeitformat an, ändern Sie die Reihenfolge von Namen und modifizieren Sie das Adressformat.

Änderungsparameter zum Anzeigen mehrerer Feldwerte verwenden

CRM-Felder, die als mehrfach festgelegt sind, können mehrere Werte auf einmal haben, wie beispielsweise die Systemfelder Telefon, E-Mail und Messenger.

Verwenden Sie den Parameter ~mfirst=, um anzugeben, wie diese mehrfachen Felder angezeigt werden:

• mfirst=y — zeigt nur den ersten Wert an
• mfirst=n — zeigt alle Werte an

Wenn Sie beispielsweise das Feld Telefon mit mehreren Werten haben und alle anzeigen möchten, verwenden Sie den Code {ContactPhone~mfirst=n}. Standardmäßig trennen Kommas die Werte. Der Änderungsparameter ~mseparator= erlaubt Ihnen, ein Trennzeichen auszuwählen: Komma (1) oder Zeilenumbruch (2) — {ContactPhone~mseparator=2}. Um alle Telefonnummern mit Zeilenumbrüchen anzuzeigen, verwenden Sie den Code {ContactPhone~mfirst=n,mseparator=2}.

Um Listenpunkte in einem Dokument anzuzeigen, verwenden Sie den Parameter ~index=. Die Liste beginnt mit der Nummer 0, also ist ein Produkt mit Index 1 tatsächlich der zweite Listenpunkt. Beispielhaft zeigt der Code {ProductsProductName~index=2} das dritte Produkt in der Liste an.

Um alle Werte des mehrfachen Felds Bind to CRM items anzuzeigen, verwenden Sie den Änderungsparameter ~all=y.