sevDesk Integration: Dynamische Textersetzung

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>

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

Bei Bezahlung mit Gutscheincodes / Geschenkkarten

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 %}

Textausgabe unterschieden nach Zahlungsmethode:

Außerdem kannst du einen Code in den Nachtext schreiben, welcher je nach Zahlungsmethode einen anderen Text ausgibt.

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

Hier ein Beispielcode:

Gewählte Zahlungsart:
{% for transaction in order_transactions %}
{% if transaction.receipt.payment_method_details.type =="klarna" %}
Klarna Text
{% endif %}
{% if transaction.receipt.payment_method_details.type =="ideal" %}
Ideal Text
{% endif %}
{% if transaction.payment_details.credit_card_company == "Mastercard" %}
Master Text
{% elsif transaction.payment_details.credit_card_company == "Visa" %}
Visa Text
{% elsif transaction.payment_details.credit_card_company == "American Express" %}
Amex Text
{% else %}
Online Zahlung
{% endif %}
{% if transaction.gateway == "paypal" %}
PayPal Text
{% endif %}
{% if transaction.gateway == "Vorkasse" %}
Vorkasse Text
{% endif %}
{% if transaction.gateway == "Kauf auf Rechnung" %}
Kauf auf Rechnung Text
{% endif %}
{% endfor %}

Bitte beachte, dass Shopify die Online-Zahlung Klarna unter Shopify Payments nicht in die Auftragsdaten schreibt, so dass wir keine Möglichkeit haben mit der dynamischen Textersetzung diese Informationen auf die Rechnung zu schreiben. 

Textausgabe bei Nutzung anderer Währungen

SevDesk unterstützt zwar unterschiedliche Währungen aber sowohl das deutsche als auch österreichische Finanzamt möchte alle Beträge in EUR haben. Wenn die Rechnungen nun in anderen Währungen ausgestellt werden, dann müsstest du diese immer in EUR umrechnen. Damit dir aber möglichst viel Arbeit abgenommen wird, ist dieser Prozess direkt bei Erstellung der Rechnungen eingebunden.

Wenn du Shopify Multicurrency nutzt, empfehlen wir dir für die Nutzung von sevDesk 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>

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.

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.

Noch mehr Fragen? Dann kontaktiere unseren Support direkt in der sevDesk Integrations App!

Wir freuen uns auf Dich!
Dein Eshop Guide Team

--