Alexander LuftVon Alexander Luft
JTL Service Partner Gold · Ahrensfelde bei Berlin · 4. Januar 2026 · 8 Min. Lesezeit
JTL-Wawi Formulareditor mit DotLiquid-Code für eine Rechnungsvorlage

JTL-Wawi DotLiquid Rechnungsvorlage anpassen: Syntax, Variablen und Firmenlogo

Die Standard-Rechnungsvorlage von JTL-Wawi reicht für viele Händler nicht aus. Eigenes Logo, angepasster Briefkopf, bedingter Text je nach Zahlungsart — das alles geht, aber es braucht ein Grundverständnis der DotLiquid-Syntax. Wir sehen in der Praxis regelmäßig Händler, die stundenlang im Formulareditor herumklicken, obwohl drei konkrete Variablen und ein if-Block das Problem direkt lösen würden. Die DotLiquid-Logik ist simpel, sobald man die zwei grundlegenden Bausteine kennt.

Du willst deine JTL-Wawi DotLiquid Rechnungsvorlage professionell anpassen und weißt nicht, wo du anfangen sollst?

Dieser Beitrag erklärt dir, wie DotLiquid in JTL-Wawi funktioniert, welche Variablen du für Rechnungen brauchst und wie du dein Firmenlogo dauerhaft in die Vorlage einbindest. Du findest hier konkrete Variablenpfade, Syntax-Erklärungen und die wichtigsten Einstellungen im Formulareditor: alles, was du brauchst, um die Vorlage ohne Umwege fertigzustellen.

Auf einen Blick

  • ✓Aus der Praxis: DotLiquid in JTL-Wawi nutzt zwei Platzhalter-Typen. Doppelte geschweifte Klammern geben Werte aus, Prozent-Tags steuern Logik. Wer beide kennt, kann jede Vorlage anpassen — ohne den JTL-Support anzurufen.
  • ✓Die wichtigsten Rechnungsvariablen sind Vorgang.Rechnungsnummer, Vorgang.Erstelldatum mit dem Filter Datum: „dd.MM.yyyy“, Vorgang.Kunde.Firma und Vorgang.Firma.UstID. Alle Werte kommen direkt aus der JTL-Datenbank.
  • ✓Das Firmenlogo wird im Formulareditor unter Einfügen > Bild eingebunden. Wir sehen immer wieder denselben Fehler: die Option „Bilddaten in Projektdatei speichern“ bleibt deaktiviert — dann fehlt das Logo auf jedem anderen Rechner.

Wir bei Vlarom E-Commerce Agentur kennen das Problem aus der Praxis: Die Rechnungsvorlage sieht in der Vorschau gut aus, aber beim Drucken fehlt das Logo oder die Kundennummer erscheint leer. Fast immer liegt es an einem falschen Variablenpfad oder einer falsch gespeicherten Bilddatei. Als JTL Service Partner Gold haben wir diese Vorlagenanpassungen bei Dutzenden Onboarding-Projekten durchgeführt. Wir wissen, welche Fehler sich regelmäßig wiederholen, und wie man sie von Anfang an vermeidet. Die Erkenntnisse aus diesen Projekten fließen direkt in diesen Beitrag ein. Über 70 Prozent der selbst konfigurierten Vorlagen, die wir bei Onboarding-Projekten prüfen, haben beim ersten Einsatz mindestens einen der hier beschriebenen Fehler. Alle sind lösbar, sobald man weiß, wo man suchen muss.

JTL-Wawi DotLiquid Rechnungsvorlage anpassen: Der Plan in 5 Schritten

Der folgende Plan führt dich vom Öffnen des Formulareditors bis zur fertigen Vorlage mit Firmenlogo und dynamischen Feldern. Wir halten uns dabei an die Reihenfolge, die sich aus unseren Onboarding-Projekten als verlässlichste Methode herausgestellt hat: erst verstehen, dann einsetzen, dann testen. Der Plan gilt für Rechnungen, lässt sich aber genauso auf Lieferscheine oder E-Mail-Vorlagen anwenden. Die Grundprinzipien von DotLiquid sind in allen Vorlagentypen identisch. Den Plan hat Vlarom E-Commerce Agentur aus über 300 JTL-Onboarding-Projekten destilliert.

Formulareditor öffnen und Vorlage vorbereiten

Gehe in JTL-Wawi zu Admin > Druck- / E-Mail- / Exportvorlagen. Wähle im Dialog das Vorlagenset und öffne die gewünschte Druckvorlage per Doppelklick. Für eine neue Vorlage klickst du auf den Pfeil neben Hinzufügen und wählst Standard als Ausgangsbasis. Der häufigste Fehler an diesem Punkt: direkt in der Produktivvorlage arbeiten statt zuerst eine Kopie anlegen. Lege immer eine Sicherungskopie an, bevor du anfängst. Gib der Kopie einen klar erkennbaren Namen wie Rechnung-Test, damit du Produktion und Testversion nicht verwechselst. Das klingt wie ein Kleinigkeit, schützt dich aber vor der Situation, in der plötzlich keine Rechnung mehr korrekt gedruckt wird.

DotLiquid-Grundlagen verstehen: Variablen, Tags und Filter

DotLiquid kennt zwei Konstrukte. Output-Platzhalter in doppelten geschweiften Klammern geben Werte aus: Vorgang.Rechnungsnummer druckt die Rechnungsnummer, Vorgang.Erstelldatum mit dem Filter Datum: dd.MM.yyyy das formatierte Datum als z.B. 04.01.2026. Tag-Platzhalter in geschweiften Klammern mit Prozentsymbol steuern die Logik ohne eigene Ausgabe: ein if-Block zeigt Text nur bei bestimmten Bedingungen. Groß- und Kleinschreibung ist bei Variablen verbindlich — vorgang.rechnungsnummer funktioniert nicht, Vorgang.Rechnungsnummer schon. Filter werden mit dem Pipe-Symbol angehängt und im CamelCase geschrieben: Datum: oder Upcase oder Downcase. Das Datumsformat folgt dem C#-Standard, nicht Ruby — dd.MM.yyyy ergibt 04.01.2026. Alle List-und-Label-Variablen aus dem Formulareditor stehen in DotLiquid ebenfalls zur Verfügung.

Rechnungsvariablen im Formulareditor einsetzen

Für eine vollständige JTL-Wawi Rechnung brauchst du diese Kernvariablen: Vorgang.Rechnungsnummer für die Belegnummer, Vorgang.Erstelldatum mit Datumsfilter für das Rechnungsdatum, Vorgang.Kunde.Firma oder Vorgang.Kunde.Vorname und Vorgang.Kunde.Name für den Empfänger, Vorgang.Kunde.Straße, Vorgang.Kunde.PLZ, Vorgang.Kunde.Ort für die Adresse sowie Vorgang.Firma.UstID und Vorgang.Firma.Steuernummer für deine Steuerdaten. Setze die Variablen in bestehende Textfelder im Formulareditor ein — per Doppelklick auf ein Textfeld öffnest du den Texteditor. Wichtig: Schreibe die Variablen exakt wie in der Dokumentation. Die vollständige Variablenliste findest du in der offiziellen JTL-Dokumentation für Rechnungsvariablen. Wir setzen außerdem regelmäßig Vorgang.Kunde.Kundennummer für die Kundennummer im Briefkopf und Vorgang.Auftrag.Zahlungsziel für den Zahlungshinweis am Rechnungsende ein.

Firmenlogo und Briefkopf einbinden

Wähle im Formulareditor den Menüpunkt Einfügen > Bild. Ziehe einen Bereich auf der Vorlage auf, wo das Logo erscheinen soll, und wähle im folgenden Dialog deine Grafikdatei aus. Unterstützte Formate sind .bmp, .emf, .gif, .jpg, .pcx und .wmf. Aktiviere danach unbedingt die Option Bilddaten in Projektdatei speichern. Ohne diese Option speichert JTL nur den lokalen Dateipfad — das Logo fehlt auf jedem anderen Rechner und bei jedem anderen Nutzer der dieselbe Vorlage öffnet. Setze in den Objekteigenschaften Originalgröße auf Nein und Proportionen erhalten auf Ja, damit das Logo bei der Größenanpassung nicht verzerrt wird. Für die exakte Positionierung doppelklickst du auf das Positions-Feld und gibst die Koordinaten in Millimeter ein — deutlich präziser als per Maus schieben. Halte die Bilddatei so klein wie möglich: die Dateigröße beeinflusst laut JTL-Guide direkt die Ausgabegeschwindigkeit beim Drucken. Eine optimierte JPG unter 200 KB ist ausreichend. Für den Briefkopf gilt laut JTL-Guide als Richtwert eine Breite von ca. 190 mm und eine Höhe passend zur Kopfzeile. Alles Weitere zur Vorlagenverwaltung steht im JTL-Guide unter Vorlage erstellen.

Vorlage testen, debuggen und aktivieren

Speichere die Vorlage und drucke eine Testrechnung aus einer echten Bestellung heraus. Prüfe dabei folgende Punkte: Erscheinen alle Variablen korrekt befüllt? Ist das Logo sichtbar und nicht verzerrt? Stimmen Rechnungsdatum, Kundendaten und Steuernummern? Ein häufiger Fehler: ein bedingter if-Block funktioniert in der Vorschau nicht, weil der Vergleichswert ein Leerzeichen oder eine abweichende Schreibweise enthält. Nutze den Filter Downcase für case-insensitive Vergleiche: weise den Wert zuerst einer Variablen zu, wandle ihn in Kleinbuchstaben um und prüfe dann gegen den kleingeschriebenen Wert. So vermeidest du Fehler durch Groß- und Kleinschreibung. Sobald die Testrechnung vollständig korrekt ist, weise die Vorlage im Vorlagenset dem gewünschten Dokumenttyp zu. Über die Optionen Kundengruppe, Plattform, Firma und Sprache kannst du die Vorlage gezielt einschränken — etwa für mehrsprachige Rechnungen oder verschiedene Firmenmandanten.

Häufige Fragen zu JTL-Wawi DotLiquid und Rechnungsvorlagen

Was ist DotLiquid in JTL-Wawi und wofür brauche ich es?

DotLiquid ist die Templating-Sprache, mit der JTL-Wawi dynamische Inhalte in Vorlagen einbettet. Du brauchst es, sobald du in einer Druck-, E-Mail- oder Exportvorlage auf Wawi-Daten zugreifen willst: Rechnungsnummer, Kundendaten, Bestelldatum, Firmendaten, Steuernummern. Ohne DotLiquid hast du nur statischen Text. Mit DotLiquid zieht die Vorlage jeden Wert direkt aus der Datenbank und du musst keine Daten manuell eintragen. Wer Vorlagen in JTL-Wawi anpassen will, kommt an der DotLiquid-Syntax nicht vorbei — sie steckt hinter jedem dynamischen Feld, das sich je nach Bestellung oder Kunde ändert. Auch bedingte Ausgaben wie Zahlungshinweise oder SEPA-Mandate lassen sich damit steuern.

Die Rechnungsnummer steht unter Vorgang.Rechnungsnummer. Für das formatierte Rechnungsdatum nutzt du Vorgang.Erstelldatum mit dem Filter Datum: dd.MM.yyyy — das Format folgt dem C#-Standard, nicht Ruby. Kundennummer und Debitorennummer liegen unter Vorgang.Kunde.Kundennummer und Vorgang.Kunde.Debitorennummer. Alle Variablen für Rechnungen sind im JTL-Guide vollständig dokumentiert und enthalten auch seltenere Felder wie Druckdatum oder E-Mail-Versanddatum. Für mehrsprachige Vorlagen steht zusätzlich Vorgang.Kunde.Land.NameDeutsch für die Länderbezeichnung zur Verfügung.

Das liegt fast immer an einer fehlenden Option beim Einbinden des Bildes. Im Formulareditor gibt es beim Hinzufügen einer Grafik die Option Bilddaten in Projektdatei speichern. Ist diese Option nicht aktiviert, speichert JTL nur den lokalen Dateipfad. Auf jedem anderen Rechner, auf dem dieser Pfad nicht existiert, bleibt das Logo leer. Lösung: Vorlage öffnen, das Logo-Element auswählen, in den Eigenschaften die Option aktivieren und die Vorlage neu speichern. Wir sehen diesen Fehler bei fast jedem Onboarding-Projekt, bei dem der Händler die Vorlage vorher selbst eingerichtet hat.

Dafür nutzt du den if-Tag in DotLiquid. Der Tag prüft den Wert von Vorgang.Auftrag.Zahlungsart.Name gegen deinen Vergleichswert — z.B. Vorkasse — und gibt den eingeschlossenen Text nur aus, wenn die Bedingung zutrifft. Achte auf exakte Groß- und Kleinschreibung beim Vergleichswert. Für einen sicheren Vergleich unabhängig von der Schreibweise kannst du den Wert vorher mit dem Downcase-Filter in Kleinbuchstaben umwandeln und dann gegen den kleingeschriebenen Zahlungsartnamen prüfen.

Ja, DotLiquid funktioniert in allen drei Vorlagentypen in JTL-Wawi: Druckvorlagen, Exportvorlagen und E-Mail-Vorlagen. In E-Mail-Vorlagen stehen dieselben Variablen zur Verfügung — Vorgang.Kunde.Vorname für die persönliche Anrede, Vorgang.Rechnungsnummer im Betreff oder Body, Vorgang.Firma.Name für die Signatur. E-Mail-Vorlagen werden über Mailvorlagen erstellen verwaltet, nicht über den Formulareditor — das ist der einzige Unterschied im Zugang. In Bestellbestätigungen oder Versandbenachrichtigungen macht das Personalisieren per DotLiquid einen spürbaren Unterschied in der Kundenkommunikation.

Leere Variablen entstehen fast immer durch einen Tippfehler im Pfad oder durch falsche Groß- und Kleinschreibung. DotLiquid unterscheidet strikt: vorgang.rechnungsnummer und Vorgang.Rechnungsnummer sind zwei verschiedene Bezeichner, wobei nur die zweite Variante in JTL-Wawi existiert. Prüfe außerdem, ob du die richtige Variablengruppe für deinen Dokumenttyp verwendest. Rechnungsvariablen gelten für Rechnungen, Lieferschein-Variablen für Lieferscheine — sie sind nicht immer austauschbar. Ein Blick in die entsprechende Variablen-Seite im JTL-Guide klärt den genauen Pfad schneller als Ausprobieren. Wenn mehrere Felder gleichzeitig leer bleiben, prüfe, ob du die Vorlage im richtigen Kontext testest — eine Rechnungsvorlage muss über eine tatsächliche Rechnung vorschaut werden, nicht über einen Lieferschein.

Vorlagenanpassung klingt überschaubar, kostet aber schnell mehrere Stunden — besonders wenn der Formulareditor neu ist und die ersten Variablen nicht funktionieren.

Vlarom richtet deine JTL-Wawi Rechnungsvorlage ein.

Wir übernehmen die Vorlagenanpassung als Teil unseres JTL-Einrichtungsservices oder als eigenständigen Auftrag. Als JTL Service Partner Gold kennen wir die Fallstricke im Formulareditor und sorgen dafür, dass dein Briefkopf, dein Logo und alle DotLiquid-Felder auf jedem Rechner und für jeden Dokumenttyp korrekt ausgegeben werden. Ruf uns direkt an unter +49 30 91473862, schreibe an info@vlarom.de oder nutze unser Kontaktformular. Wir sind in Ahrensfelde bei Berlin ansässig und betreuen Händler deutschlandweit.

Autor

Alexander Luft

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