Template Sprache "Liquid" in easybill

Über den Einsatz der Template Sprache Liquid kannst du nicht nur Platzhalter nutzen, die in Texten auf Dokumenten, für Rechnungsposten oder den Mailversand dynamisch befüllt werden, sondern auch z.B. Wenn-Dann-Bedingungen festlegen. Diese Funktion muss zunächst aktiviert werden.

1. Wähle Einstellungen > Template Sprache
2. Wähle die Version, in der du die Template Sprache verwenden möchtest.
3. Klicke auf Speichern

Wichtiger Hinweis für Onlinehändler, die die Funktion schon aus easybill Connect kennen:

Die Liquid-Variablen in easybill sind nicht identisch mit denen von easybill Connect. Die Texte aus easybill Connect können daher nicht ohne Anpassungen übernommen werden.

Über den Bereich Changelog findest du immer die Optimierungen, die neue Versionen mit sich bringen, sodass du jederzeit die Version umstellen kannst auf eine neue Version.

Beispiele für Platzhalter, die du nutzen kannst:

• Dokumentennummer: {{ document.number }}
• Kundennummer: {{ customer.number }}
• Name des Kunden: {{ customer.display_name }}
• Dein Firmenname: {{ company.display_name }}
• Ersteller des Dokumentes: {{ login.display_name }}

Weitere Attribute der jeweiligen Objektvariablen findest du in unserer REST API Dokumentation.

Filter, die du auf die Platzhalter anwenden kannst:

• Kundenname in Großbuchstaben: {{ customer.last_name | upcase }}
  Bei Eingabe von Max Müller wäre die Ausgabe MAX MÜLLER
• Wohnort des Kunden groß schreiben: {{ customer.city | capitalize }}
  Bei Eingabe von düsseldorf wäre die Ausgabe Düsseldorf
• Anzahl der Positionen in einem Dokument: {{ document.items | size }}

Beispiele für Abfragen:

Bei Kunden mit hinterlegtem Lastschriftmandat (definiert über ein vorhandenes Eingangsdatum des Mandates) einen anderen Text auf Rechnungen drucken als bei Kunden, die per Überweisung zahlen:

{% if customer.sepa_agreement_date %}
Der Rechnungsbetrag wird innerhalb der nächsten Tage von Ihrem Bankkonto gemäß der vorliegenden Lastschrifteinzugsermächtigung eingezogen.
{% else %}
Bitte überweisen Sie den Rechnungsbetrag auf das unten stehende Bankkonto.
{% endif %}

Ausweisen des Angebots oder eines anderen Referenzdokument, wenn das neue Dokument aus einem vorherigen erstellt wurde.

{% if document.ref_id %}zu %REFDOKUMENT.TYP% %REFDOKUMENT.NUMMER%{% endif %}

Beschreibung einer Ware soll in Angeboten ausführlicher sein als in Rechnungen:

{% if document.type == 'OFFER' %}Ausführlicher Text für das Angebot
{% else %}Kurztext für die Rechnung
{% endif %}

Anlegen einer Ware, deren Beschreibung deutsch sein soll, wenn der Kunde in Deutschland, Österreich oder der Schweiz sitzt, in allen anderen Fällen aber englisch:

{% if customer.country == 'DE' or customer.country == 'AT' or customer.country == 'CH' %}Deutscher Text
{% else %}Englischer Text
{% endif %}

Anlegen einer Ware in mehr als zwei verschiedenen Sprachen, z. B. damit Kunden aus Deutschland, Österreich oder der Schweiz eine deutsche Bezeichnung, Kunden aus Frankreich eine französische, Kunden aus Italien eine italienische und alle anderen Kunden eine englische Bezeichnung sehen:

{% case customer.country %}
{% when 'DE' or 'AT' or 'CH' %}Deutscher Text
{% when 'FR' %}Französischer Text
{% when 'IT' %}Italienischer Text
{% else %}Englischer Text
{% endcase %}

Einen vollständigen Überblick über die möglichen Befehle und Operatoren findest du in dieser Dokumentation. Solltest du Unterstützung bei der Nutzung von Liquid benötigen, steht dir unser Support selbstverständlich gerne zur Verfügung.