Alexander LuftVon Alexander Luft
JTL Service Partner Gold · Ahrensfelde bei Berlin · 8. August 2025 · 6 Min. Lesezeit
JTL-Wawi Vorlagen-Editor mit DotLiquid-Code und Variablen-Übersicht

JTL-Wawi DotLiquid Variablen und Filter: Das Handbuch für alle Vorlagentypen von der Rechnung bis zur Mahnung

JTL-Wawi nutzt DotLiquid als Template-Engine für alle Ausgangs-Dokumente — Rechnungen, Lieferscheine, Auftragsbestätigungen, Mahnungen und über 20 weitere Vorlagentypen. Wer einmal verstanden hat, wie DotLiquid-Variablen und Filter funktionieren, kann Vorlagen präzise anpassen. Wer versucht, auf gut Glück Variablen einzusetzen, stößt auf leere Felder oder Fehlermeldungen im Vorschaumodus.

Du bearbeitest JTL-Wawi-Vorlagen und kommst mit DotLiquid-Variablen oder Filtern nicht weiter?

Dieser Beitrag erklärt die wichtigsten DotLiquid-Filter und Variablen aus der Praxis — und zeigt, worauf es bei den verschiedenen Vorlagentypen jeweils ankommt.

Auf einen Blick

  • ✓Vlarom E-Commerce Agentur arbeitet in nahezu jedem JTL-Einrichtungsprojekt an Wawi-Vorlagen — DotLiquid-Kenntnisse sind dafür unverzichtbar, damit Rechnungen, Lieferscheine und Mahnungen korrekt ausgehen.
  • ✓DotLiquid-Filter wie `date`, `formatPrice` und `upcase` transformieren Variablen-Werte direkt in der Vorlage — ohne separate Logik im Hintergrund.
  • ✓Nicht alle Variablen sind in allen Vorlagentypen verfügbar: Auftragsbestätigung und Rechnung teilen viele Variablen, aber Mahnungen haben eigene Objekte die in anderen Vorlagen nicht existieren.

Vlarom E-Commerce Agentur passt JTL-Wawi-Vorlagen in jedem Einrichtungsprojekt an — von der Rechnungsvorlage bis zu Dokumenten wie Pfandbelegen oder Retourenformularen. Der häufigste Fehler den wir dabei sehen: Variablen werden ohne Prüfung des Vorlagentyps eingesetzt. Was in einer Rechnungsvorlage funktioniert, kann in einer Mahnungsvorlage leer bleiben, weil das Objekt dort nicht existiert. Als JTL Service Partner Gold kennt Vlarom E-Commerce Agentur die JTL-spezifischen DotLiquid-Erweiterungen aus der täglichen Projektpraxis.

DotLiquid in JTL-Wawi einsetzen: 5 Schritte für saubere Vorlagen

Die folgende Struktur gilt für alle Vorlagentypen in JTL-Wawi. Wer die Grundprinzipien einmal verstanden hat, kann sie auf jeden der 26+ Vorlagentypen anwenden.

Vorlagentyp identifizieren und verfügbare Objekte kennen

Jeder Vorlagentyp in JTL-Wawi hat ein Root-Objekt, das alle verfügbaren Daten enthält. Bei Rechnungsvorlagen ist das zum Beispiel das `Rechnung`-Objekt mit Unterobjekten für `Kunde`, `Positionen`, `Summen` und mehr. Bei Mahnungsvorlagen gibt es das `Mahnung`-Objekt mit anderen Unterobjekten. Bevor du eine Variable einsetzt, prüfe im JTL-Guide welche Objekte für deinen Vorlagentyp verfügbar sind. Eine Variable die im Root-Objekt nicht existiert, gibt in DotLiquid keinen Fehler — sie bleibt einfach leer. Das macht Debugging schwieriger. Vollständige Variablen-Übersicht: JTL-Wawi Vorlagen im JTL-Guide.

DotLiquid-Grundsyntax und einfache Variablen einsetzen

DotLiquid-Variablen werden in doppelten geschweiften Klammern geschrieben: `` gibt den Firmennamen des Rechnungsempfängers aus. Für Schleifen über Positionen nutzt du `…`. Bedingte Ausgaben gehen mit `…`: zum Beispiel `FirmenkundePrivatkunde`. Diese drei Grundelemente decken 80% der typischen Vorlagen-Anforderungen ab. Wer komplexere Logik braucht, nutzt Variablen-Zuweisungen mit `` und Filter-Verkettung.

Die wichtigsten DotLiquid-Filter in JTL-Wawi nutzen

Filter transformieren den Wert einer Variable bei der Ausgabe. Die wichtigsten in JTL-Wawi: `date` formatiert Datumswerte (``), `formatPrice` formatiert Geldbeträge mit korrektem Dezimaltrennzeichen (``), `upcase` und `downcase` ändern die Groß-/Kleinschreibung, `truncate` kürzt lange Texte auf eine bestimmte Zeichenanzahl. Filter werden mit Pipe-Symbol `|` an die Variable angehängt und können verkettet werden: ``. Der vollständige Filter-Katalog ist im JTL-Wawi DotLiquid-Guide dokumentiert.

Vorlagentyp-spezifische Variablen für Rechnung, Lieferschein, Mahnung

Die Unterschiede zwischen Vorlagentypen sind entscheidend: Bei Rechnungsvorlagen sind Steuerbeträge, USt-ID und Skonto-Informationen verfügbar. Bei Lieferscheinvorlagen fehlen Preise — dafür gibt es Lagerplatz-Informationen. Mahnungsvorlagen haben Zugriff auf offene Posten, Mahngebühren und Fälligkeitsdaten. Auftragsbestätigungen haben den aktuellen Auftrags-Status aber noch keine Buchhaltungsdaten. Wer Variablen aus einer Vorlage in eine andere kopiert, ohne den Vorlagentyp zu prüfen, erzeugt leere Felder die erst beim echten Druck auffallen.

Vorlagen testen und häufige Fehler beheben

JTL-Wawi hat eine Vorschau-Funktion im Vorlagen-Editor — nutze sie mit echten Daten, nicht nur mit Testdaten. Häufige Fehler: (1) Variable ist leer: Vorlagentyp-Zugehörigkeit prüfen. (2) Datum erscheint als Zahl: `date`-Filter fehlt oder falsches Format. (3) Preise ohne Dezimaltrennzeichen: `formatPrice`-Filter prüfen. (4) Schleife gibt falsches Objekt aus: `for`-Schleife überprüfen ob das richtige Unter-Array angesprochen wird. Wir testen Vorlagen immer mit mindestens drei verschiedenen Belegtypen: Normalkunde ohne USt, EU-Firmenkunde mit USt-ID und Drittland-Auftrag.

Häufige Fragen zu JTL-Wawi DotLiquid Variablen und Filter

Wo finde ich alle DotLiquid-Variablen für JTL-Wawi-Vorlagen?

Die vollständige Variablen-Übersicht für alle JTL-Wawi-Vorlagentypen ist im offiziellen JTL-Guide dokumentiert — unter dem Bereich JTL-Wawi Vorlagen. Dort sind Variablen nach Vorlagentyp (Rechnung, Lieferschein, Mahnung etc.) gelistet, mit Erklärung was jede Variable zurückgibt. Zusätzlich gibt es im JTL-Guide eine Liste der verfügbaren DotLiquid-Filter speziell für JTL-Wawi. Wir nutzen diese Dokumentation als Primärquelle, weil die verfügbaren Variablen sich mit JTL-Wawi-Updates gelegentlich ändern und eine veraltete Variable-Liste zu leeren Ausgaben führt.

Die häufigste Ursache: Die Variable gehört nicht zum Root-Objekt des verwendeten Vorlagentyps. DotLiquid gibt bei nicht existierenden Variablen keinen Fehler — die Ausgabe bleibt einfach leer. Prüfe zuerst, ob die Variable im Variablen-Katalog für deinen Vorlagentyp gelistet ist. Zweite mögliche Ursache: Das Objekt-Pfad stimmt nicht — `` funktioniert, aber `` (ohne Rechnung-Präfix) nicht. Dritte Ursache: Der Wert ist im System tatsächlich nicht gefüllt — zum Beispiel wenn ein Pflichtfeld beim Kunden leer ist.

Datumsfelder werden mit dem `date`-Filter formatiert: `` gibt das Datum im deutschen Format aus. Ohne den `date`-Filter erscheint ein Datum oft als numerischer Timestamp oder in einem nicht lesbaren Format. Gängige Formate: `dd.MM.yyyy` für deutsches Datum, `MM/dd/yyyy` für US-Format, `yyyy-MM-dd` für ISO-Format. Wenn du Uhrzeit mit ausgeben willst: ``. Achte auf die Groß-/Kleinschreibung im Format-String — `dd` steht für Tag, `MM` für Monat, `yyyy` für Jahr.

JTL-Wawi stellt Freie Felder (auch Custom-Attribute) zur Verfügung, die auf Kunden, Artikeln und Aufträgen gepflegt werden können. Diese Felder sind in Vorlagen über spezifische Variablen-Pfade zugänglich — zum Beispiel `` oder über entsprechende Unter-Objekte. Die genauen Variablen-Namen für freie Felder sind im JTL-Guide dokumentiert. Wir nutzen diese Felder regelmäßig für kundenspezifische Informationen auf Rechnungen, die JTL-Wawi standardmäßig nicht enthält — zum Beispiel interne Kundennummern oder Kostenstellen.

JTL-Wawi verwendet eine modifizierte DotLiquid-Implementierung mit zusätzlichen Filtern und Objekten, die es im Standard-DotLiquid nicht gibt. Filter wie `formatPrice` oder JTL-spezifische Datums-Formate sind JTL-Erweiterungen. Das bedeutet: Dokumentation aus dem allgemeinen DotLiquid-Bereich (GitHub, Shopify-Liquid) ist nur teilweise übertragbar. Der JTL-Guide listet die JTL-spezifischen Erweiterungen. Standard-DotLiquid-Konstrukte wie ``, ``, `` und Basis-Filter funktionieren in JTL-Wawi-Vorlagen genauso wie im Standard.

JTL-Wawi hat im Vorlagen-Editor eine integrierte Vorschau-Funktion — dort kannst du eine Vorlage mit realen Daten aus deinem System testen, ohne einen Beleg zu drucken oder zu versenden. Wähle im Vorschau-Modus einen echten Kunden und einen echten Auftrag aus, um realistische Testdaten zu bekommen. Reine Testdaten ohne echte Auftrags-Daten zeigen oft leere Felder, weil viele Variablen erst mit echten Daten befüllt werden. Vlarom E-Commerce Agentur testet immer mit zwei bis drei verschiedenen Auftrags-Konstellationen: Normalkunde, EU-Firmenkunde und falls relevant auch Rechnungen mit Teillieferungen.

Als JTL Service Partner Gold in Ahrensfelde bei Berlin — deutschlandweit tätig.

JTL-Wawi-Vorlagen professionell einrichten — wir übernehmen Anpassung und Test

Vlarom E-Commerce Agentur in Ahrensfelde bei Berlin passt JTL-Wawi-Vorlagen für Rechnungen, Lieferscheine, Mahnungen und alle weiteren Vorlagentypen an. Wir übernehmen DotLiquid-Implementierung, Variablen-Mapping und Test mit echten Daten — damit deine Dokumente von Anfang an korrekt ausgehen.

Autor

Alexander Luft

JTL Service Partner Gold · Vlarom E-Commerce Agentur · Ahrensfelde bei Berlin