Code-Editor für gedruckte Belege für dein Shopify POS

Du kannst deine gedruckten Belege mit dem Code-Editor in deinem Shopify-Adminbereich anpassen. Die Dateien, aus denen deine Belege bestehen, enthalten Liquid, die Vorlagensprache von Shopify. Mit dem Code-Editor kannst du im Vergleich zum visuellen Editor erweiterte Anpassungen mit HTML, CSS und Liquid erstellen.

Du kannst die Belegvorlage und die Abschnittsvorlagen ändern, die für deine gedruckten Belege verwendet werden. Die Vorlagendateien für Belege sind die Arten von Belegen, die du in deinem Shop drucken kannst. Abschnitte sind Teile der Belege, wie z. B. der Header oder die Fußzeile. Abschnitte können von mehreren Belegen wiederverwendet werden.

Auf dieser Seite

Wichtige Hinweise zur Verwendung des Beleg-Code-Editors

Bevor du den Beleg-Code-Editor verwendest, beachte die folgenden wichtigen Hinweise:

Zugriffsbeschränkungen

Den Code-Editor kannst du nur in deinem Shopify-Adminbereich auf dem Desktop verwenden.
Der Code-Editor ist für keine POS-Standorte in Italien verfügbar.

Gültigkeitsbereich der Änderungen

Code-Änderungen, die du vornimmst, gelten nur für den ausgewählten Standort.
Anpassungen im Code-Editor gelten nur für POS Pro-Standorte. Wenn du den Code-Editor verwendest und Standorte ohne POS Pro hast, kannst du für diese Standorte den visuellen Editor verwenden, um den Header und den Footer anzupassen.
Du kannst gedruckte Belege anpassen, die eine Vorlage im Code-Editor haben, wie z. B. Verkaufsbelege, Geschenkbelege, Gutscheinbelege und Belege für Rückgaben und Warenumtausch.

Code-Sprachen

Die Dateien, aus denen deine Belege bestehen, enthalten Liquid, die Vorlagensprache von Shopify. Mehr Informationen zur Verwendung von Liquid.
Um die Vorlagen im Code-Editor für Belege zu bearbeiten, musst du mit HTML, CSS und Liquid vertraut sein. Der Shopify Theme Support kann bei kleineren Anpassungen im Rahmen der Shopify Design-Richtlinie helfen.

Einschränkungen bei der Anpassung

Du kannst dir im Code-Editor keine Vorschau der Belege in verschiedenen Druckergrößen ansehen. Um eine Vorschau nach Druckergröße anzuzeigen, verwende den visuellen Editor.
Produktbeschreibungen sind in Belegvorlagen nicht als Variable verfügbar und können gedruckten Belegen nicht hinzugefügt werden.

Pflege von Vorlagen

Wenn du einen Beleg mit dem Beleg-Code-Editor anpasst, fehlen in deiner bestehenden Vorlage möglicherweise neue Eigenschaften wie selling_plan_name. Um die neuesten verfügbaren Eigenschaften zu deiner Vorlage hinzuzufügen, musst du deine Belegvorlage auf die Standardeinstellungen zurücksetzen. Beim Zurücksetzen von Belegvorlagen auf die Standardeinstellungen werden alle Anpassungen entfernt, die du daran vorgenommen hast. Notiere dir deinen angepassten Code, bevor du die Vorlage zurücksetzt. Nachdem du die Vorlage zurückgesetzt hast, musst du deine Anpassungen wieder manuell anwenden.

Auf den Code-Editor zugreifen

Du kannst deine Vorlagen mit dem Code-Editor bearbeiten. Du musst zuerst vom standardmäßigen visuellen Editor zur Verwendung des Code-Editors wechseln und kannst jederzeit wieder zum visuellen Editor zurückwechseln.

Die Schritte für den Wechsel zwischen den Editoren unterscheiden sich geringfügig, je nachdem, ob alle deine POS-Standorte für den Code-Editor berechtigt sind oder ob nur einige deiner POS-Standorte berechtigt sind, z. B. wenn einige deiner POS-Standorte POS Pro nicht verwenden oder sich in Italien oder Frankreich befinden.

Schritte:

Alle POS Pro-Standorte

Gehe in deinem Shopify-Adminbereich zu Point of Sale > Einstellungen.
Klicke im Abschnitt Anpassung auf Gedruckte Belege, um den POS-Editor zu öffnen.
Klicke in der linken Seitenleiste auf das Symbol .
Klicke auf Code bearbeiten.
Bearbeite im Dialogfeld Code für gedruckte Belege bearbeiten den Code, den du ändern möchtest.
Klicke auf Speichern.
Optional: Um weitere Shopify POS-Seiten mit dem POS-Editor zu bearbeiten, gehe in deinem Browserfenster zurück.

Mit Lite- oder Italien-Standorten

Gehe in deinem Shopify-Adminbereich zu Point of Sale > Einstellungen.
Klicke im Abschnitt Anpassung auf Gedruckte Belege, um den POS-Editor zu öffnen.
Klicke auf der Seite Beleganpassung auf Code-Editor.

Benutzerdefinierte Dateien in deiner Belegvorlage verwenden

Du kannst Dateien wie z. B. Bild-Assets, die du in deinen Shopify-Adminbereich hochlädst, verwenden, um deine gedruckten Belege anzupassen.

Eine Datei muss in deinen Shopify-Adminbereich hochgeladen werden, bevor sie in einem gedruckten Beleg verwendet werden kann. Mehr Informationen zum Hochladen von Dateien.

Schritte:

Gehe in deinem Shopify-Adminbereich zu Inhalte > Dateien.
Klicke neben der Datei, die du in den Code deines gedruckten Belegs einfügen möchtest, auf , um den Link zu kopieren.
Navigiere zum Code-Editor.
Füge den Asset-Link in deine Vorlage ein.

Belegvorlage auf Standard zurücksetzen

Du kannst eine Belegvorlage mit dem Code-Editor auf die Standardversion zurücksetzen.

Schritte:

Alle POS Pro-Standorte

Gehe in deinem Shopify-Adminbereich zu Point of Sale > Einstellungen.
Klicke im Abschnitt Anpassung auf Gedruckte Belege, um den POS-Editor zu öffnen.
Klicke auf Deine Belege anpassen.
Klicke auf Code bearbeiten.
Klicke auf die Codedatei, die du zurücksetzen möchtest.
Klicke auf das Symbol .
Klicke im Dialogfeld Datei auf Standard zurücksetzen auf Zurücksetzen.

Mit Lite- oder Italien-Standorten

Gehe in deinem Shopify-Adminbereich zu Point of Sale > Einstellungen.
Klicke im Abschnitt Anpassung auf Gedruckte Belege, um den POS-Editor zu öffnen.
Klicke auf der Seite Beleganpassung auf Code-Editor.
Klicke auf die Codedatei, die du zurücksetzen möchtest.
Klicke auf das Symbol .
Klicke im Dialogfeld Datei auf Standard zurücksetzen auf Zurücksetzen.

Im Code-Editor für Belege verfügbare Liquid-Variablen

Du kannst Liquid verwenden, um deine Vorlage für gedruckte Belege und die Belegarten anzupassen.

Die folgenden Datenobjekte stehen für den Code-Editor für Belege zur Verfügung:

Belegobjekte

Beschreibung der Beleg-Datenobjekte
Objekt	Beschreibung
shop	Enthält die Shop-Informationen, wie z. B. den Shop-Namen.
location	Enthält die Informationen zum Einzelhandelsstandort, wie z. B. Adresse und Telefonnummer.
order	Enthält die Bestelldaten, einschließlich der Positionen, der Rabatte, der Steuern und der Transaktionsinformationen.
return	Nur in der Vorlage `return-and-exchange-receipt.liquid` und den zugehörigen Teilvorlagen verfügbar. Enthält Daten zu Rückgaben und zum Warenumtausch, einschließlich der zurückgegebenen Positionen, der neuen Positionen, der Nettosumme und der Transaktionsinformationen.
gift_card	Nur in der Vorlage `gift-card.liquid` verfügbar. Enthält die Gutscheindaten, einschließlich des Guthabens, des alphanumerischen Codes und des Inhalts eines QR-Codes, der von der POS-App gescannt werden kann.

Bestellobjekt

Beschreibung des Bestellobjekts
Eigenschaft	Beschreibung
id	ID der Bestellung.
created_at	Das nach ISO 8601 formatierte Datum und die Uhrzeit der Erstellung der Bestellung.
source_identifier	Eine eindeutige Bestell-ID von POS oder einem Drittanbieter.
change_due	Fälliges Wechselgeld für die Bestellung.
balance_due	Geschuldeter Betrag für diese Bestellung.
name	Die eindeutige ID für die Bestellung, die auf der Bestellseite im Shopify-Adminbereich und auf der Bestellstatus-Seite angezeigt wird. Zum Beispiel „#1001“, „EN1001“ oder „1001-A“. Dieser Wert ist nicht über mehrere Shops hinweg eindeutig.
note	Der Inhalt der Notiz, die mit der Bestellung verknüpft ist.
line_items	Eine Liste der Positionen der Bestellung.
subtotal_price	Die Summe der Preise für alle Positionen nach Rabatten und vor Rückgaben. Wenn `taxesIncluded` wahr ist, enthält die Zwischensumme auch die Steuer.
total_price	Der Gesamtpreis der Bestellung vor Rückgaben. Dieser beinhaltet Steuern und Rabatte.
total_tip_received	Die Summe aller Trinkgeldbeträge für die Bestellung.
discounts	Der Gesamtbetrag der Rabatte.
transactions	Eine Liste der Transaktionen, die mit der Bestellung verknüpft sind.
taxes_included	Gibt an, ob Steuern in der Zwischensumme der Bestellung enthalten sind.
tax_lines	Eine Liste aller Steuerpositionen, die auf die Positionen der Bestellung angewendet wurden, vor Rückgaben. Die Preise der Steuerpositionen stellen den Gesamtpreis für alle Steuerpositionen mit demselben Satz und Titel dar.
customer	Der/die Kund:in, der/die die Bestellung aufgegeben hat.
shipping_address	Die Lieferadresse der Bestellung.
shipping_groups	Die Liste der Versandgruppen der Bestellung. Jede Gruppe enthält Positionen, die zusammen ausgeführt werden.

Rückgabeobjekt

Beschreibung des Rückgabeobjekts
Eigenschaft	Beschreibung
name	Die eindeutige ID für die Rückgabe, die auf der Bestellseite im Shopify-Adminbereich und auf der Bestellstatus-Seite angezeigt wird. Zum Beispiel „#1000-R1“. Dieser Wert ist nicht über mehrere Shops hinweg eindeutig.
created_at	Das nach ISO 8601 formatierte Datum und die Uhrzeit der Erstellung der Rückgabe.
is_unverified	Ein boolescher Wert, der angibt, ob die Rückgabe als unverifizierte Rückgabe erstellt wurde.
is_exchange	Ein boolescher Wert, der angibt, ob die Rückgabe einen Warenumtausch enthält. Dies schließt Rückerstattungen auf einen Gutschein ein.
exchange_type	Die Art des Warenumtauschs, falls die Rückgabe einen Warenumtausch enthält. Mögliche Werte sind `LIKE_FOR_LIKE`, `NET_REFUNDABLE` und `NET_PAYABLE`.
return_discount	Der Gesamtbetrag der Bestellrabatte, der zurückerstattet wurde.
return_subtotal	Die Summe der Preise für alle zurückgegebenen Positionen vor Rabatten. Wenn `taxesIncluded` wahr ist, enthält die Zwischensumme auch die Steuer.
return_total	Der mögliche Gesamterstattungsbetrag. Darin enthalten sind Steuern, Rabatte, Versand und Trinkgeld. Dies entspricht möglicherweise nicht dem tatsächlichen erstatteten Betrag.
exchange_subtotal	Die Summe der Preise für alle neuen Positionen im Warenumtausch vor Rabatten. Wenn `taxesIncluded` wahr ist, enthält die Zwischensumme auch die Steuer.
exchange_total	Der Gesamtbetrag für alle neuen Positionen im Warenumtausch. Dieser beinhaltet Steuern und Rabatte.
total_cash_rounding_adjustment	Die Betragsrundungsanpassung, die auf die Rückgabe oder den Warenumtausch angewendet wird.
total_adjusted_amount	Der Gesamtbetrag für die Rückgabe oder den Warenumtausch, angepasst um die Betragsrundungsanpassung.
net_total	Der tatsächliche Gesamtbetrag, der für die Rückgabe oder den Warenumtausch bezahlt bzw. zurückerstattet wurde, vor der Betragsrundung.
return_line_items	Die zurückgegebenen Positionen.
exchange_line_items	Die neuen Positionen beim Warenumtausch.
return_tax_lines	Die Steuerpositionen für die zurückgegebenen Positionen.
exchange_tax_lines	Die Steuerpositionen für die neuen Positionen im Warenumtausch.
shipping_refund_amount	Der Betrag der Versandkosten, der zurückerstattet wurde.
tip_refund_amount	Der Betrag des Trinkgelds, der zurückerstattet wurde.
transactions	Die Transaktionen, die mit der Rückgabe oder dem Warenumtausch verknüpft sind.

Versandgruppenobjekt

Beschreibung des Versandgruppenobjekts
Eigenschaft	Beschreibung
destination	Versandziel der zu versendenden Produkte.
products	Eine Liste der zu versendenden Produkte.

Positionsobjekt

Beschreibung des Positionsobjekts
Eigenschaft	Beschreibung
id	Die ID der Position.
name	Der Titel des Produkts, optional ergänzt um den Titel der Variante (falls zutreffend).
variant_title	Der Titel der Variante zum Zeitpunkt der Bestellerstellung.
price	Der Stückpreis der Position bei Erstellung der Bestellung. Dieser Wert enthält keine Rabatte.
is_gift_card	Gibt an, ob die Position den Kauf eines Gutscheins darstellt.
discount	Der Gesamtrabatt, der der Position durch Rabattanwendungen zugewiesen wurde, einschließlich der Rabatte, die zurückerstatteten und entfernten Mengen zugewiesen wurden.
total_price	Die Gesamtsumme für diese Position.
selling_plan_name	Der Name des Abonnements, das der Position zugewiesen ist.
tax_rates	Die Steuerpositionen für diese Position.
custom_attributes	Eine Liste von Attributen, die benutzerdefinierte Merkmale oder Sonderwünsche darstellen.
variant_title	Der Variantentitel.
variant_id	Die ID der Variante.
variant_metafields	Eine Liste von benutzerdefinierten Feldern, die ein:e Händler:in mit der Variante verknüpft hat.
staff_member_description	Das der Position zugeordnete Team-Mitglied.
product_metafields	Eine Liste von benutzerdefinierten Feldern, die ein:e Händler:in mit dem Produkt verknüpft hat.

Rückgabepositionsobjekt

Enthält alles im Positionsobjekt sowie die folgenden Eigenschaften:

Beschreibung des Positionsobjekts
Eigenschaft	Beschreibung
return_reason	Der Rückgabegrund für die Position.
return_reason_note	Eine optionale Notiz zum Rückgabegrund.

Liquid-Filter, die im Belegcode-Editor verfügbar sind

Du kannst Liquid-Filter verwenden, um Informationen in deinen Belegvorlagen anzupassen. Du kannst zum Beispiel die Formatierung der Währung oder die Groß- und Kleinschreibung von bestimmtem Text, wie z. B. einem Steuercode, ändern.

Um einen Filter anzuwenden, füge ein Pipe-Zeichen (|) und dann den Filter innerhalb des Liquid-Codeblocks zwischen den doppelten geschweiften Klammern ({{ }}) hinzu. Filter können nur auf Liquid-Codeblöcke angewendet werden.

Im folgenden Beispiel ändert der Filter den Steuercode von Klein- in Großbuchstaben.

{{ tax_line.title | upcase }}

Im Beispiel-Codeblock ist product das Objekt, title seine Eigenschaft und upcase der angewendete Filter. Der Filter upcase ändert die Groß-/Kleinschreibung des Wertes von tax_line.title in Großbuchstaben. Wenn tax_line.title beispielsweise den Wert Hst hat, ändert der Filter upcase den Wert in HST.

Informationen zur Verwendung von Liquid-Filtern findest du im Abschnitt „Filter“ der Shopify Themes Liquid-Referenz.

Die folgenden Filter sind im Code-Editor für Belege verfügbar:

Beschreibung der Belegfilter
Eigenschaft	Beschreibung
t	Übersetzt vordefinierte Etiketten in die Sprache, die deinem Standort zugewiesen ist.
money	Formatiert den Preis in der Währung deines Standorts.
escape	Maskiert Sonderzeichen in HTML, wie `<>`, `'` und `&`, und wandelt die Zeichen in Escape-Sequenzen um.
barcode	Erzeugt ein 1D-Barcode-SVG.
qrcode	Erzeugt ein 2D-Barcode-SVG.

Beispiel für eine Code-Anpassung der Vorlage für gedruckte Belege

Du kannst Liquid verwenden, um bedingte Nachrichten hinzuzufügen. Diese Funktionalität ähnelt dem Speichern für einen einzelnen Standort mit dem visuellen Editor. Beispielsweise hat dein Unternehmen mit einem einzigen Standort begonnen und du hast jetzt mehrere neue Standorte. Du möchtest deinen ursprünglichen Shop auf deinen gedruckten Belegen hervorheben.

Du kannst eine benutzerdefinierte Nachricht zur Vorlage header.liquid im Ordner Sections des Code-Editors hinzufügen und Liquid verwenden, um die Nachricht nur für deinen Flagship-Standort anzuzeigen.

Der folgende Code prüft den Namen des Standorts, in diesem Fall dein ursprünglicher Standort namens „Home“, und zeigt die Nachricht „Willkommen in unserem ursprünglichen Shop, eröffnet 1972.“ an, wenn der Standort mit dem Namen übereinstimmt. Auf Belegen, die von deinen anderen Standorten gedruckt werden, wird stattdessen die Nachricht „Willkommen in unserem Shop.“ angezeigt.

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}

Vorschau der Code-Änderungen im Code-Editor

Du kannst dir im Shopify-Adminbereich im POS-Code-Editor eine Vorschau der Änderungen an deinen gedruckten Belegen anzeigen lassen.

Je nachdem, welche Liquid-Datei ausgewählt ist, hebt das Vorschaufenster das Design oder den Abschnitt des Belegs hervor, der von der Datei betroffen ist. Standardmäßig zeigt das Vorschaufenster den Inhalt für deine letzte POS-Bestellung an. Du kannst eine bestimmte Bestellung auswählen, die als Beleginhalt im Vorschaufenster für alle Liquid-Dateien verwendet wird, mit Ausnahme der Datei gift-card.liquid. Bei dieser werden nur die verschiedenen Standorte als auswählbare Vorschauoptionen angezeigt.

Schritte:

Alle POS Pro-Standorte

Gehe in deinem Shopify-Adminbereich zu Point of Sale > Einstellungen.
Klicke im Abschnitt Anpassung auf Gedruckte Belege, um den POS-Editor zu öffnen.
Klicke auf Deine Belege anpassen.
Klicke auf Code bearbeiten.
Klicke auf die Codedatei, für die du eine Vorschau anzeigen möchtest. Dein Beleg wird im Editorfenster ganz rechts angezeigt.
Optional: Um eine bestimmte Bestellung auszuwählen, die als Beleginhalt im Vorschaufenster verwendet werden soll, gehe wie folgt vor:
1. Klicke auf das -Symbol.
2. Verkäufe aus dem Point of Sale-Kanal von allen Standorten werden im Dialogfeld Bestellung für Vorschau auswählen angezeigt. Wähle eine Bestellung aus der Liste aus oder suche über die Suchleiste nach bestimmten Bestellungen und Standorten.
3. Klicke auf Bestätigen.
Optional: Wenn du eine Vorschau der Datei gift-card.liquid anzeigst, klicke auf das -Symbol und wähle den Standort aus, für den du eine Vorschau der Vorlage anzeigen möchtest.

Mit Lite- oder Italien-Standorten

Gehe in deinem Shopify-Adminbereich zu Point of Sale > Einstellungen.
Klicke im Abschnitt Anpassung auf Gedruckte Belege, um den POS-Editor zu öffnen.
Klicke auf der Seite Beleganpassung auf Code-Editor.
Klicke auf die Codedatei, für die du eine Vorschau anzeigen möchtest. Dein Beleg wird im Editorfenster ganz rechts angezeigt.
Optional: Um eine bestimmte Bestellung auszuwählen, die als Beleginhalt im Vorschaufenster verwendet werden soll, gehe wie folgt vor:
1. Klicke auf das -Symbol.
2. Verkäufe aus dem Point of Sale-Kanal von allen Standorten werden im Dialogfeld Bestellung für Vorschau auswählen angezeigt. Wähle eine Bestellung aus der Liste aus oder suche über die Suchleiste nach bestimmten Bestellungen und Standorten.
3. Klicke auf Bestätigen.
Optional: Wenn du eine Vorschau der Datei gift-card.liquid anzeigst, klicke auf das -Symbol und wähle den Standort aus, für den du eine Vorschau der Vorlage anzeigen möchtest.