lexoffice Integration: Dynamische Textersetzung

Wie du in den Einstellungen unserer App vielleicht schon gesehen hast, kannst du den Vortext und den Nachtext deiner Rechnungen und Gutschriften individuell gestalten. Dazu kannst du unsere dynamische Textersetzung in Verbindung mit den Auftragseigenschaften nutzen. Seit dem neuesten Update kann hier sogar Liquid verwendet werden, die gleiche Templatesprache, die Shopify auch in seinen Themes verwendet. So ist es beispielsweise möglich, bestimmte Textbausteine nur konditional einzubinden.

Beispielblöcke

Hier möchten wir dir einige Beispiele geben, damit du siehst, auf welche Art und Weise du diese Funktion nutzen kannst. Gerne kannst du die Blöcke kopieren und bei dir einfügen. 

Rechnungen und Gutschriften

Um deine Rechnung etwas persönlicher zu gestalten kannst du im  Vortext den Kunden mit seinem Namen ansprechen. Außerdem kann es für den Kunden hilfreich sein, wenn er weiß, wann er die Bestellung aufgegeben hat. Zusätzlich kannst du auch die Auftragsnummer mit in die Rechnung nehmen. All das musst du nicht für jeden Kunden neu schreiben. Es reicht, wenn du z.B. folgenden Befehl in deinen Vortext schreibst:

	 <em>Hallo {{customer.first_name}} {{customer.last_name}}, 
	 vielen Dank für Ihre Bestellung vom {{processed_at| date: "%d.%m.%y um %H.%M Uhr" }}. 
	 Sie erhalten heute Ihre Rechnung über die folgenden Positionen zu Auftrag {{name}}.</em>

In den Nachtext der Rechnung kannst du beispielsweise reinschreiben für welche Zahlungsmethode sich der Kunde entschieden hat. Außerdem kannst du reinschreiben, an welche Adresse die Ware geliefert wird.

	 <em>Sie haben sich für folgende Zahlungsmethode entschieden:
	 {% assign zahlart= payment_gateway_names| first %}
	 {{ zahlart }}
	 {% if zahlart == "Vorkasse" %}
	 Da Sie sich für diese Zahlart entschieden haben, bitten wir Sie den Gesamtbetrag Ihrer Rechnung innerhalb der nächsten 14 Tage auf folgendes Konto zu überweisen.
	 Sobald wir Ihre Zahlung erhalten haben, wird Ihnen Ihre Bestellung zugeliefert.
	 Name der Bank: ABCD
	 IBAN: 123456789
	 Verwendungszweck: {{name}}
	 {% endif %}<br>
	 Lieferadresse:
	 {{shipping_address.name}}
	 {{shipping_address.address1}}
	 {{shipping_address.city}}
	 {{shipping_address.country}}<br>
	 Wir hoffen, Sie sind zufrieden mit Ihrem Einkauf. </em>

Ein weiteres Beispiel:  Wenn du im Nachtext der Rechnung eine Unterscheidung machen möchtest, ob bereits gezahlt wurde oder nicht, kannst du das mit folgendem Code tun:

{% if financial_status == "pending" %}<br>Text für Ausstehende Zahlungen
{% else %}Text für bereits überwiesene Zahlungen
{% endif %}

Textausgabe unterschieden nach Zahlungsmethode:

Außerdem kannst du einen Code in den Nachtext schreiben, welcher je nach Zahlungsmethode einen anderen Text ausgibt. Hier ein Beispiel (ohne Shopify Payments) dazu:

<em> Du hast dich für folgende Zahlungsmethode entschieden:
{% for type in payment_gateway_names %}
{%- if type == "paypal" -%}
TEXT
{% endif %}
{%- if type == "Bank Deposit" -%}
TEXT
{% endif %}
{%- if type == "Vorkasse" -%}
TEXT
{%- if type == "visa" -%}
TEXT
{% endif %}
Vielen dank für deine Bestellung!
{%- endif -%}
{%- endfor -%} <em><br>

Passe diesen am Besten an deinen Shop an und füge ihn in den Nachtext hinzu.

Hier ein Beispielcode, wenn du zusätzlich Shopify Payments nutzt:

Gewählte Zahlungsart:
{% for type in payment_gateway_names %}
{%- if type == "paypal" -%}
{%- if processing_method == "express"-%}
PayPal Express
{% else %}
PayPal
{% endif %}
{% endif %}
{%- if type == "Vorkasse" -%}
Vorkasse
{% endif %}
{%- if type == "eBay/PayPal" -%}
eBay Bezahlsystem
{% endif %}
{%- if type == "shopify_payments" -%}
{% for transaction in order_transactions %}
{% if transaction.payment_details.credit_card_company == "Visa" %}
Visa (Kreditkarte) 
{% if transaction.payment_details.credit_card_wallet == "apple_pay" %} 
via Apple Pay
{% endif %}
{% elsif transaction.payment_details.credit_card_company == "Mastercard" %}
Mastercard (Kreditkarte) 
{% if transaction.payment_details.credit_card_wallet == "apple_pay" %} 
via Apple Pay
{% endif %}
{% elsif transaction.payment_details.payment_method_name == "klarna_pay_later" %}
Klarna Kauf auf Rechnung
{%- else -%}
Online-Zahlung
{% endif %}
{% endfor %}
{% endif %}
{%- if type == "Kauf auf Rechnung" -%}
Kauf auf Rechnung
Zahlungsbedingungen: Zahlung innerhalb von 7 Tagen ab Rechnungseingang ohne Abzüge. Die korrekten Bankdaten findest Du unten in der Fußzeile.
{% endif %}
{%- endfor -%}

Du kannst beide Codes ergänzen, um sie nach deinen Zahlungsmethoden anzupassen. Dadurch hast du die Möglichkeit je nach Zahlungsmethode einen anderen Text ausgeben zu lassen.

Bezahlung mit Gutscheincode / Geschenkkarte

Wir haben den Umgang mit Gutscheinen mittlerweile angepasst, so dass wir Rechnungen nicht um den Gutschein-Betrag vermindern. Das liegt daran, dass für den gekauften Artikel die volle MwSt. fällig wird. Wenn wir die Rechnung mindern würden, würde zu wenig MwSt. ausgewiesen werden. Du könntest in den Nachtext der Rechnung einen Liquid-Text reinschreiben, der darauf hinweist, dass ein Teil der Rechnung mit einem Gutschein bezahlt worden ist. Zum Beispiel diesen Code:

{% for transaction in order_transactions %}
{% if transaction.gateway ==  "gift_card" %}
Die Rechnung wurde vollständig oder teilweise mit einem Gutschein bezahlt. 
Gutscheinwert: {{transaction.amount}} {{transaction.currency}} 
{% endif %}
{% endfor %}

Tipp: Nachdem du die Texte individuell gestalten hast, hast du die Möglichkeit eine Vorschau der eingegebenen Texte mit Auflösung der dynamischen Textersetzung und des Liquid-Codes anzusehen. Klicke dazu auf das "Auge" unter dem jeweiligen Feld. Durch den Klick öffnet sich die Vorschau.

Textausgabe bei Nutzung anderer Währungen

lexoffice unterstützt nur EUR, weshalb es mit unserer App auch keine Möglichkeit gibt Belege mit einer anderen Währung zu erstellen und nach lexoffice zu übertragen. 

Wenn du Shopify Multicurrency nutzt, empfehlen wir dir für die Nutzung von lexoffice zwingend EUR als Shop-Currency einzustellen. Da unsere App den Preis immer aus dem "price"-Feld in den line_items liest, werden die Belege dann mit den korrekt umgerechneten Euro-Beträgen erstellt.

Du hast allerdings die Möglichkeit mit der dynamischen Textersetzung den Betrag in der entsprechenden Währung als Nachtext anzeigen zu lassen. Siehe hier.

<em>{%- if total_price_set.shop_money.currency_code != total_price_set.presentment_money.currency_code -%}
Der Auftrag wurde in {{total_price_set.presentment_money.currency_code}} gezahlt.
Gesamtbetrag: {{total_price_set.presentment_money.amount}} {{total_price_set.presentment_money.currency_code}}
{%- endif -%}<br></em>

Hinweis: Die bereits erstellten Rechnungen kannst du außerdem aus Shopify heraus öffnen. Gehe dazu auf die jeweilige Bestellung, klicke auf weitere Aktionen und dann auf  Show Invoice. Der Beleg öffnet sich anschließend.

Achtung: Beachte dabei, dass du Google Chrome oder Firefox verwendest und den Pop-Up-Blocker deaktiviert hast, bzw. eine Ausnahme für die Seite hinzugefügt hast. Diese Beispiele sollen als Inspirationsquelle dienen. Wie erwähnt, kannst du sämtliche Auftragseigenschaften in Kombination mit Liquid nutzen.

---