Version: 1.x

Referenz zu Belegdaten

Logikfreie HTML-Vorlagen von WCPOS und thermische XML-Vorlagen werden aus derselben kanonischen Belegdaten-Payload gerendert. Verwenden Sie Mustache-Punktpfade wie {{order.number}}, {{store.name}} und {{totals.total_display}}. Arrays werden mit Abschnitten gerendert:

{{#lines}}
  {{name}} x {{qty}} — {{line_total_display}}
{{/lines}}

Der kanonische Datenvertrag wird auf dem Server vom WCPOS-Belegdaten-Builder erstellt und vom Offline-Belegrenderer in der App gespiegelt. Belege werden sofort anhand lokaler Daten geöffnet und bei Verfügbarkeit mit der Serverantwort aktualisiert. Benutzerdefinierte Vorlagen sollten daher die unten aufgeführten Felder statt PHP-Bestellmethoden verwenden.

Belegdaten v1.1 ergänzt für jede Produktzeile erfasste Felder für regulären Preis, Verkaufspreis vor Couponabzug und Einsparungen. Außerdem stellt es Einsparungssummen auf Bestellungsebene bereit, einschließlich eines Werts Gesamt eingespart, der Einsparungen gegenüber dem regulären Preis mit WooCommerce-Rabatten kombiniert, ohne Bestellsummen oder Berichte zu ändern.

Der Beleg im Überblick

Jeder Teil eines gedruckten Belegs stammt aus einem Abschnitt des Datenvertrags. Bewegen Sie den Mauszeiger über eine Seite, um die Zuordnung zu sehen, und klicken Sie, um zu den Feldern dieses Abschnitts zu springen. Alle Beispiele auf dieser Seite verwenden dieselbe Beispielbestellung.

COFFEE MONSTER

Röststraße 12, Portland OR

USt-IdNr.: US-998877

Beleg Nr. 104213. Juli 2026

Kasse: AdaKunde: Nia

2 × Espressobohnen29.00

~~34.00~~ · Ersparnis −5.00

1 × Keramiktasse18.00

1 × Croissant5.75

Zwischensumme52.75

Coupon SUMMER10−5.28

Geschenkverpackung2.50

Versand10.00

GESAMT59.97

Gesamt eingespart10.28

Karte59.97

Vielen Dank für Ihren Einkauf!

Filialkopf

store.name · store.address_lines · store.tax_ids · store.logo

Bestellung und Personen

order.number · order.created · cashier.name · customer.name

Positionen

lines[] · line_savings · savings_in_discounts

Summenblock

totals.* · discounts[] · fees[] · shipping[] · totals.total_saved

Zahlungen

payments[]

Fußzeile

store.personal_notes · store.policies_and_conditions · i18n.thank_you_purchase

Häufige Vorlagenaufgaben

Die meisten Vorlagenänderungen gehören zu einer dieser drei Aufgaben. Jede Karte zeigt zuerst das Druckergebnis und danach das genaue Markup, das Sie in jede logikfreie HTML- oder thermische XML-Vorlage kopieren können. Die dritte Karte zeigt statt der obigen Beispielbestellung eine ältere Bestellung vor v1.9.

2 × Espressobohnen29.00

~~34.00~~ · Ersparnis −5.00

Regulären Preis durchstreichen

{{#lines}}
{{#line_savings}}
  <s>{{line_regular_total_display}}</s>
  {{i18n.savings}}: -{{line_savings_display}}
{{/line_savings}}
{{/lines}}

Die Abschnittsprüfung blendet alles bei Bestellungen ohne erfassten Preisverlauf aus.

GESAMT59.97

Gesamt eingespart10.28

Zeile „Gesamt eingespart“ hinzufügen

{{#totals.total_saved_complete}}
{{#totals.total_saved}}
  {{i18n.total_saved}}:
  {{totals.total_saved_display}}
{{/totals.total_saved}}
{{/totals.total_saved_complete}}

Zwei Prüfungen: Die Zeile verschwindet, wenn der Preisverlauf unvollständig ist oder nichts eingespart wurde.

1 × Espressobohnen14.50

~~17.00~~ Rabatt −2.50

Bestellung vor v1.9 sicher erneut drucken

{{#lines}}
{{#line_savings}}
  {{^savings_in_discounts}}
    {{i18n.savings}}: -{{line_savings_display}}
  {{/savings_in_discounts}}
{{/line_savings}}
{{/lines}}

Bei alten Bestellungen steckt die Ersparnis bereits im Rabatt. So wird sie nicht doppelt gedruckt.

Darstellungsregeln

Währungsfelder

Numerische Geldfelder werden als Zahlen beibehalten, und der Renderer ergänzt für die Vorlagenausgabe sprachabhängige _display-Felder:

Numerisches Feld	Anzeigefeld
`totals.total`	`totals.total_display`
`lines[].line_total`	`lines[].line_total_display`
`payments[].amount`	`payments[].amount_display`
`tax_summary[].tax_amount`	`tax_summary[].tax_amount_display`

Beim Drucken von Belegen sollten _display-Felder bevorzugt werden. Numerische Felder nur für bedingte Abschnitte oder maschinenlesbare Ausgaben verwenden.

Felder mit steueranzeigegerechten Werten

Mehrere Felder verfügen über Varianten inklusive und exklusive Steuern sowie über einen praktischen Anzeigewert. Dieser richtet sich nach der Einstellung der Filiale für die Steueranzeige im Warenkorb.

Komfortfeld	Feld inklusive Steuern	Feld exklusive Steuern
`lines[].regular_price`	`lines[].regular_price_incl`	`lines[].regular_price_excl`
`lines[].selling_price`	`lines[].selling_price_incl`	`lines[].selling_price_excl`
`lines[].unit_savings`	`lines[].unit_savings_incl`	`lines[].unit_savings_excl`
`lines[].line_regular_total`	`lines[].line_regular_total_incl`	`lines[].line_regular_total_excl`
`lines[].line_selling_total`	`lines[].line_selling_total_incl`	`lines[].line_selling_total_excl`
`lines[].line_savings`	`lines[].line_savings_incl`	`lines[].line_savings_excl`
`lines[].unit_price`	`lines[].unit_price_incl`	`lines[].unit_price_excl`
`lines[].unit_subtotal`	`lines[].unit_subtotal_incl`	`lines[].unit_subtotal_excl`
`lines[].line_subtotal`	`lines[].line_subtotal_incl`	`lines[].line_subtotal_excl`
`lines[].discounts`	`lines[].discounts_incl`	`lines[].discounts_excl`
`lines[].line_total`	`lines[].line_total_incl`	`lines[].line_total_excl`
`fees[].total`	`fees[].total_incl`	`fees[].total_excl`
`shipping[].total`	`shipping[].total_incl`	`shipping[].total_excl`
`discounts[].total`	`discounts[].total_incl`	`discounts[].total_excl`
`totals.subtotal`	`totals.subtotal_incl`	`totals.subtotal_excl`
`totals.discount_total`	`totals.discount_total_incl`	`totals.discount_total_excl`
`totals.sale_savings_total`	`totals.sale_savings_total_incl`	`totals.sale_savings_total_excl`
`totals.total_saved`	`totals.total_saved_incl`	`totals.total_saved_excl`
`totals.total`	`totals.total_incl`	`totals.total_excl`

Datumsobjekte

Datumsfelder sind Objekte mit mehreren vorformatierten Varianten. Dadurch entfällt die Datumsformatierung innerhalb von Mustache.

Feld	Beschreibung
`datetime`, `date`, `time`	Standard-Datums-/Zeitzeichenfolgen
`datetime_short`, `datetime_long`, `datetime_full`	Gebietsschemaabhängige kombinierte Formate
`date_short`, `date_long`, `date_full`	Gebietsschemaabhängige reine Datumsformate
`date_ymd`, `date_dmy`, `date_mdy`	Datumsformate mit fester Reihenfolge
`weekday_short`, `weekday_long`	Tagesnamen
`day`, `month`, `month_short`, `month_long`, `year`	Einzelne Datumsbestandteile

Verfügbare Datumsobjekte: order.created, order.paid, order.completed, order.printed und refunds[].date. order.printed wird beim Rendern aktualisiert, was für Nachdrucke nützlich ist.

Abschnitte der obersten Ebene

Abschnitt	Typ	Beschreibung
`order`	Objekt	Bestellkennung, Status, Datumsangaben, Notiz und Informationen zur Zahlungs-URL
`store`	Objekt	Filialidentität, Adresse, Kontaktdaten, Steuer-IDs, Logo, Öffnungszeiten und Fußzeilentext
`cashier`	Objekt	Benutzer, der die Bestellung verarbeitet hat
`customer`	Objekt	Kundenanzeigename, Adressen und Steuer-IDs
`lines`	Array	Produktpositionen
`fees`	Array	Gebührzeilen
`shipping`	Array	Versandzeilen
`discounts`	Array	Coupon-/Rabattzeilen
`totals`	Objekt	Bestellsummen, Zahlungssummen, Rückerstattungsübersicht und Artikelanzahl
`tax`	Objekt	Flags für den Steuermodus zur Steuerung von Abschnitten
`tax_summary`	Array	Steuerübersichtszeilen je Steuersatz
`has_tax_summary`	Boolesch	Hilfsprüfung für `tax_summary`
`payments`	Array	Zahlungszeilen
`refunds`	Array	Auf die Bestellung angewendete Rückerstattungsdatensätze
`fiscal`	Objekt	Felder der Fiskalübersicht, die von Fiskalintegrationen befüllt werden
`presentation_hints`	Objekt	Hinweise zur Formatierung und zum Renderer
`i18n`	Objekt	Übersetzte Beschriftungen für gebündelte und benutzerdefinierte Vorlagen

Zusammenhang der Preise

Eine Produktposition enthält mehrere Preise. Die Bezeichnungen werden verständlich, wenn sie direkt am Geldbetrag dargestellt werden. Dies ist die Espresso-Position aus der Beispielbestellung: ein Produkt zum regulären Preis von 17,00 $, im Angebot für 14,50 $, mit einem zusätzlichen Coupon über 10 %.

Espressobohnen — eine Einheit (die Bestellung enthält zwei)

13.05 bezahlt

1.45 Coupon

2.50 Ersparnis

0regulärer Preis 17.00

Vom Kunden bezahltunit_price → 13.05 · line_total → 26.10

Coupon-Rabatt (SUMMER10)lines[].discounts → 2.90 für diese Position

Ersparnis gegenüber dem regulären Preisunit_savings → 2.50 · line_savings → 5.00

Alle Ersparnisse der Bestellungtotals.sale_savings_total = 5.00

Alle Coupon-Rabatte der Bestellungtotals.discount_total = 5.28

Ersparnisse und Rabatte ohne ältere Überschneidungentotals.total_saved = 10.28

Ersparnisse und Coupon-Rabatte sind nicht dasselbe: Ersparnisse vergleichen den Verkaufspreis mit dem erfassten regulären Preis, während discounts die Coupon-Berechnung von WooCommerce bezeichnet. WooCommerce-Bestellsummen und -Berichte enthalten nur den Coupon-Anteil. Deshalb ist total_saved der kundenorientierte Gesamtwert, der beide Beträge kombiniert.

Feldreferenz

Die vollständige Feldreferenz ist unten nach Abschnitten gruppiert. Standardmäßig sind alle Bereiche eingeklappt – erweitern Sie die benötigte Gruppe.

Bestellung — Identität, Status, Datumsangaben

Bestellung

Feld	Typ	Beispiel / Beschreibung
`order.id`	Zahl	`1234`
`order.number`	Zeichenkette	Für Menschen lesbare Bestellnummer, z. B. `"10045"`
`order.currency`	Zeichenkette	ISO-Währungscode, z. B. `"USD"`
`order.customer_note`	Zeichenkette	Kunden-/Bestellnotiz
`order.wc_status`	Zeichenkette	Roher WooCommerce-Status-Slug, z. B. `"processing"`
`order.status_label`	Zeichenkette	Lokalisierte Statusbezeichnung, einschließlich benutzerdefinierter Status
`order.created_via`	Zeichenkette	Quelle/Kanal, z. B. `"woocommerce-pos"`
`order.needs_payment`	Boolescher Wert	Ob ein Zahlungsabschnitt angezeigt werden soll
`order.payment_url`	Zeichenkette	Zahlungs-URL der Bestellung, sofern verfügbar
`order.created`	Datumsobjekt	Erstellungsdatum der Bestellung
`order.paid`	Datumsobjekt	Zahlungsdatum; bei nicht bezahlten Bestellungen leere Zeichenketten
`order.completed`	Datumsobjekt	Abschlussdatum; bei nicht abgeschlossenen Bestellungen leere Zeichenketten
`order.printed`	Datumsobjekt	Zeitstempel für Druck/erneuten Druck zum Renderzeitpunkt

Filiale — Identität, Adresse, Kontakt, Öffnungszeiten

Filiale

Feld	Typ	Beispiel / Beschreibung
`store.id`	Zahl	Filial-ID oder historische ID für gelöschte Filialen
`store.name`	Zeichenfolge	Anzeigename der Filiale
`store.address.address_1`	Zeichenfolge	Erste Zeile der Straßenadresse
`store.address.address_2`	Zeichenfolge	Zeile für Suite/Einheit
`store.address.city`	Zeichenfolge	Stadt/Ort
`store.address.state`	Zeichenfolge	Bundesland/Region
`store.address.postcode`	Zeichenfolge	Postleitzahl
`store.address.country`	Zeichenfolge	ISO-Ländercode
`store.address_lines`	Array	Vorformatierte Adresszeilen; für die meisten Vorlagen empfohlen
`store.tax_ids`	Array	Strukturierte Steuer-IDs des Unternehmens; diese anstelle einer einzelnen Steuer-ID durchlaufen
`store.phone`	Zeichenfolge	Telefonnummer der Filiale
`store.email`	Zeichenfolge	E-Mail-Adresse der Filiale
`store.logo`	Zeichenfolge/null	Logo-URL oder Daten-URI der Filiale
`store.opening_hours`	Zeichenfolge/null	Kompakter Text zu den Öffnungszeiten
`store.opening_hours_vertical`	Zeichenfolge/null	Mehrzeiliger Block mit Öffnungszeiten
`store.opening_hours_inline`	Zeichenfolge/null	Durch Kommas getrennter Text zu den Öffnungszeiten
`store.opening_hours_notes`	Zeichenfolge/null	Freitextnotizen zu den Öffnungszeiten
`store.personal_notes`	Zeichenfolge/null	Fußzeile des Belegs/persönliche Notiz
`store.policies_and_conditions`	Zeichenfolge/null	Text zu Rückerstattungen, Rückgaben oder Bedingungen
`store.footer_imprint`	Zeichenfolge/null	Rechtliches Impressum in der Fußzeile

Steuer-ID-Objekte

store.tax_ids und customer.tax_ids enthalten Objekte mit derselben Struktur:

Feld	Typ	Beschreibung
`type`	Zeichenfolge	Kennung wie `eu_vat`, `de_steuernummer`, `au_abn`, `br_cpf`, `us_ein` oder `other`
`value`	Zeichenfolge	Zu druckender Steuer-ID-Wert
`country`	Zeichenfolge/null	ISO-Ländercode, sofern bekannt
`label`	Zeichenfolge/null	Lokalisierte Anzeigenbezeichnung, wird vor der Darstellung aufgelöst

Beispiel:

{{#store.tax_ids}}
  {{label}}: {{value}}
{{/store.tax_ids}}

Kassierer — Benutzer, der die Bestellung bearbeitet hat

Kassierer

Feld	Typ	Beispiel / Beschreibung
`cashier.id`	Zahl	WordPress-Benutzer-ID, `0` falls unbekannt
`cashier.name`	Zeichenfolge	Anzeigename des Kassierers

Kunde — Name, Adressen, Steuer-IDs

Kunde

Feld	Typ	Beispiel / Beschreibung
`customer.id`	Zahl/null	Kunden-ID oder `null` für Gäste
`customer.name`	Zeichenfolge	Anzeigename des Kunden oder Gastbezeichnung
`customer.billing_address.*`	Objekt	WooCommerce-Felder für die Rechnungsadresse
`customer.shipping_address.*`	Objekt	WooCommerce-Felder für die Lieferadresse
`customer.tax_ids`	Array	Strukturierte Steuer-IDs des Kunden, die aus der Bestellung übernommen wurden

Gängige Adressschlüssel sind first_name, last_name, company, address_1, address_2, city, state, postcode, country, email und phone.

Zeilen — Produktpositionen

Zeilen

Mit {{#lines}}...{{/lines}} durchlaufen. Die Beispielwerte stammen von der Espresso-Position aus der Beispielbestellung.

Jedes Geldfeld kommt als Paar: die Zahl (in {{#…}}-Prüfungen verwenden — null und null blenden den Abschnitt aus, und ein null-Feld hat überhaupt kein _display-Gegenstück) und die zugehörige _display-Zeichenfolge (zum Ausgeben verwenden). Mit incl/excl gekennzeichnete Felder liefern zusätzlich _incl- und _excl-Varianten, jeweils mit eigenem _display.

keystring

Stabiler Zeilenschlüssel / Bestellpositions-ID.

key"412"

skustring

Produkt-SKU.

sku"ESP-500"

namestring

Anzeigename des Produkts oder der Position.

name"Espresso Beans"

qtynumber

Verkaufte Menge.

qty2

qty_refundednumber

Für diese Position erstattete Menge.

qty_refunded0

regular_pricenumbermoneynullableincl/excl

Erfasster regulärer Stückpreis. Bei Bestellungen ohne POS-Preishistorie null — schließen Sie ihn in einen Abschnitt ein.

regular_price17

regular_price_display"$17.00"

selling_pricenumbermoneynullableincl/excl

Verkaufseinzelpreis vor Gutschein — der erfasste POS-Preis, sofern verfügbar, andernfalls aus der gespeicherten Zwischensumme der Position abgeleitet.

selling_price14.5

selling_price_display"$14.50"

unit_savingsnumbermoneynullableincl/excl

Regulärer Preis minus Verkaufspreis, auf null begrenzt. Null ist falsy, sodass abgesicherte Zeilen sich selbst ausblenden.

unit_savings2.5

unit_savings_display"$2.50"

line_regular_totalnumbermoneynullableincl/excl

Erfasster regulärer Preis multipliziert mit der Menge.

line_regular_total34

line_regular_total_display"$34.00"

line_selling_totalnumbermoneynullableincl/excl

Verkaufspreis vor Gutscheinen multipliziert mit der Menge.

line_selling_total29

line_selling_total_display"$29.00"

line_savingsnumbermoneynullableincl/excl

Gesamtersparnis dieser Position zwischen regulärem Preis und Verkaufspreis.

line_savings5

line_savings_display"$5.00"

savings_in_discountsboolean

Wahr bei Bestellungen vor v1.9.0, deren Ersparnis bereits in discounts enthalten ist — das Kennzeichen gegen Doppelzählung.

savings_in_discountsfalse

unit_subtotalnumbermoneyincl/excl

WooCommerce-Stückwert vor Rabatt. Nicht als regulären Preis verwenden.

unit_subtotal14.5

unit_subtotal_display"$14.50"

unit_pricenumbermoneyincl/excl

Endgültiger Stückwert nach WooCommerce-Rabatten.

unit_price13.05

unit_price_display"$13.05"

line_subtotalnumbermoneyincl/excl

WooCommerce-Zwischensumme der Zeile vor Rabatt.

line_subtotal29

line_subtotal_display"$29.00"

discountsnumbermoneyincl/excl

Nativer WooCommerce-Zeilenrabatt als positiver Wert — bei aktuellen Bestellungen nur Gutscheine.

discounts2.9

discounts_display"$2.90"

line_totalnumbermoneyincl/excl

Endgültiger Zeilenbetrag nach Gutscheinen — was in der Betragsspalte gedruckt wird.

line_total26.1

line_total_display"$26.10"

total_refundednumbermoney

Insgesamt für diese Zeile erstatteter Betrag als positiver Wert.

total_refunded0

total_refunded_display"$0.00"

taxesarray

Steuerzeilen je Steuersatz für diese Zeile.

—

metaarray

Metadaten der Bestellposition als {key, value}-Paare.

—

attributesarray

Produkt-/Variationsattribute als {key, value}-Paare.

—

Regulären Preis und Ersparnis anzeigen

Für ein Layout mit Stückpreisen werden der erfasste reguläre Preis, Verkaufspreis und die Ersparnis wie folgt angezeigt:

{{#lines}}
  {{#unit_savings}}
    <span style="text-decoration: line-through;">{{regular_price_display}}</span>
    <span>{{selling_price_display}}</span>
    <span>{{i18n.savings}}: -{{unit_savings_display}}</span>
  {{/unit_savings}}
{{/lines}}

Verwenden Sie die Felder für die Zeilensumme, wenn die Menge relevant ist:

{{#lines}}
  {{#line_savings}}
    <span style="text-decoration: line-through;">{{line_regular_total_display}}</span>
    <span>{{i18n.savings}}: -{{line_savings_display}}</span>
  {{/line_savings}}
{{/lines}}

selling_price ist der Preis vor Gutscheinen. Verwenden Sie unit_price oder line_total für den Endbetrag nach WooCommerce-Rabatten.

Erneutes Drucken von vor v1.9.0 erstellten Bestellungen

Ältere WCPOS-Bestellungen können die Reduzierung vom regulären Preis zum Verkaufspreis bereits in discounts enthalten. Wenn Ihre benutzerdefinierte Vorlage sowohl Zeilenersparnisse als auch Zeilenrabatte ausgibt, verwenden Sie savings_in_discounts, damit dieselbe Reduzierung nicht zweimal angezeigt wird:

{{#lines}}
  {{#line_savings}}
    <span style="text-decoration: line-through;">{{line_regular_total_display}}</span>
    {{^savings_in_discounts}}
      <span>{{i18n.savings}}: -{{line_savings_display}}</span>
    {{/savings_in_discounts}}
  {{/line_savings}}
  {{#discounts}}
    <span>{{i18n.discount}}: -{{discounts_display}}</span>
  {{/discounts}}
{{/lines}}

Wenn die Vorlage keine discounts-Zeile auf Zeilenebene ausgibt, zeigen Sie line_savings weiterhin an, auch wenn savings_in_discounts wahr ist. Die mitgelieferten Vorlagen berücksichtigen diesen Unterschied automatisch.

Gebühren und Versand

Durchlaufen Sie die Schleife mit {{#fees}}...{{/fees}} und {{#shipping}}...{{/shipping}}.

Feld	Typ	Beschreibung
`label`	Zeichenfolge	Gebührenbezeichnung oder Name der Versandart
`method_id`	Zeichenfolge	ID der Versandart (nur Versand)
`total` / `_incl` / `_excl`	Zahl	Gesamtsummen für Anzeige, inklusive und exklusive
`taxes`	Array	Steuerzeilen je Steuersatz
`meta`	Array	`{key, value}`-Metapaare

Formatierte Varianten: total_display, total_incl_display und total_excl_display.

Rabatte — Coupon-/Rabattzeilen

Rabatte

Schleife mit {{#discounts}}...{{/discounts}}.

Feld	Typ	Beschreibung
`label`	Zeichenfolge	Coupon-Beschreibung oder Fallback auf den Code
`code`	Zeichenfolge	Coupon-Code
`total` / `_incl` / `_excl`	Zahl	Rabattbetrag als positiver Wert

Formatierte Varianten: total_display, total_incl_display und total_excl_display. Fügen Sie in der Vorlage ein eigenes Minuszeichen hinzu, wenn Rabatte als negative Zeilen angezeigt werden sollen.

Summen — Bestell-, Zahlungs-, Rückerstattungs- und Artikelsummen

Summen

Die Beispielwerte stammen aus der Beispielbestellung, für die später eine Teilrückerstattung über 7,25 $ erfolgte.

Geldfelder folgen derselben Paarung wie Positionen: eine reine Zahl für Prüfungen und eine _display-Zeichenfolge zur Ausgabe, mit _incl-/_excl-Varianten, wo gekennzeichnet.

subtotalnumbermoneyincl/excl

Bestellzwischensumme vor Rabatten.

subtotal52.75

subtotal_display"$52.75"

discount_totalnumbermoneyincl/excl

Gesamtrabatt der Bestellung als positiver Wert — bei aktuellen Bestellungen nur Gutscheine.

discount_total5.28

discount_total_display"$5.28"

sale_savings_totalnumbermoneynullableincl/excl

Gesamte erfasste Ersparnisse zwischen regulärem Preis und Verkaufspreis über alle Produktzeilen hinweg, einschließlich Katalogangeboten und Preisänderungen an der Kasse.

sale_savings_total5

sale_savings_total_display"$5.00"

total_savednumbermoneynullableincl/excl

Kombinierte WooCommerce-Rabatte und Ersparnisse gegenüber dem regulären Preis, ohne Überschneidungen aus älteren Versionen. Die eine kundenorientierte Angabe für alle Ersparnisse.

total_saved10.28

total_saved_display"$10.28"

total_saved_completeboolean

Ob der Beleg genügend erfasste Preisdaten enthält, um die vollständigen Ersparnissummen zu berechnen.

total_saved_completetrue

tax_totalnumbermoney

Gesamtsteuerbetrag.

tax_total0

tax_total_display"$0.00"

totalnumbermoneyincl/excl

Gesamtsumme der Bestellung.

total59.97

total_display"$59.97"

paid_totalnumbermoney

Gezahlter/angerechneter Betrag.

paid_total59.97

paid_total_display"$59.97"

change_totalnumbermoney

An den Kunden ausgezahltes Rückgeld.

change_total0

change_total_display"$0.00"

refund_totalnumbermoney

Gesamter Rückerstattungsbetrag als positiver Wert.

refund_total7.25

refund_total_display"$7.25"

net_totalnumbermoney

Gesamtsumme abzüglich Rückerstattungen, auf null begrenzt.

net_total52.72

net_total_display"$52.72"

total_qtynumber

Summe der Artikelmengen.

total_qty4

line_countnumber

Anzahl der Produktzeilen.

line_count3

Verwenden Sie total_saved, wenn eine einzelne kundenorientierte Angabe für alle Ersparnisse benötigt wird. Berechnen Sie diesen Wert nicht durch Addition von discount_total und sale_savings_total in der Vorlage: Bestellungen, die vor v1.9.0 erstellt wurden, enthalten ihre POS-Preisersparnis möglicherweise bereits in der Rabattsumme von WooCommerce. Das kanonische Feld total_saved erkennt und entfernt diese Überschneidung.

Die Ersparnissummen sind null und total_saved_complete ist false, wenn für mindestens eine Produktzeile nicht genügend aufgezeichnete Preisdaten für eine zuverlässige Gesamtsumme vorhanden sind. Sichern Sie die Zeile mit total_saved_complete ab und verwenden Sie dann total_saved, um einen Nullwert auszublenden:

{{#totals.total_saved_complete}}
  {{#totals.total_saved}}
    <span>{{i18n.total_saved}}: {{totals.total_saved_display}}</span>
  {{/totals.total_saved}}
{{/totals.total_saved_complete}}

Die gebündelten preisführenden Vorlagen verwenden dieselbe Prüfstruktur mit den steuerinklusiven Varianten (total_saved_incl und total_saved_incl_display) und zeigen Gesamtersparnis nur an, wenn der vollständige Wert größer als null ist.

tax and tax_summary — Anzeige-Bedingungen und Zeilen je Steuersatz

tax und tax_summary

Verwenden Sie tax für Prüfungen des Anzeigemodus und tax_summary für einzelne Steuersatzzeilen.

Steuerfeld	Typ	Beschreibung
`tax.display`	Zeichenfolge	`incl` oder `excl`
`tax.display_incl`	Boolescher Wert	Wahr, wenn Preise einschließlich Steuer angezeigt werden
`tax.display_excl`	Boolescher Wert	Wahr, wenn Preise ohne Steuer angezeigt werden
`tax.breakdown`	Zeichenfolge	`hidden`, `single` oder `itemized`
`tax.breakdown_hidden`	Boolescher Wert	Wahr, wenn Steuerzeilen ausgeblendet werden sollen
`tax.breakdown_single`	Boolescher Wert	Wahr, wenn ein einzelner Steuerbetrag bevorzugt wird
`tax.breakdown_itemized`	Boolescher Wert	Wahr, wenn Zeilen pro Steuersatz bevorzugt werden
`has_tax_summary`	Boolescher Wert	Wahr, wenn `tax_summary` Zeilen enthält

Durchlaufen Sie tax_summary mit {{#tax_summary}}...{{/tax_summary}}.

Feld	Typ	Beschreibung
`code`	Zeichenfolge	Steuersatz-ID/-Code
`rate`	Zahl/null	Steuersatz in Prozent, sofern aufgelöst
`label`	Zeichenfolge	Bezeichnung des Steuersatzes
`compound`	boolescher Wert	Ob der Steuersatz zusammengesetzt ist
`taxable_amount_excl`	Zahl/null	Steuerpflichtige Bemessungsgrundlage ohne Steuer
`tax_amount`	Zahl	Erhobene Steuer
`taxable_amount_incl`	Zahl/null	Steuerpflichtige Bemessungsgrundlage einschließlich Steuer

Formatierte Varianten: taxable_amount_excl_display, tax_amount_display und taxable_amount_incl_display.

payments — Zahlungszeilen

Zahlungen

Schleife mit {{#payments}}...{{/payments}}.

Feld	Typ	Beschreibung
`method_id`	Zeichenfolge	Kennung der Zahlungsmethode
`method_title`	Zeichenfolge	Angezeigter Titel der Zahlungsmethode
`amount`	Zahl	Auf die Bestellung angewendeter Betrag
`transaction_id`	Zeichenfolge	Transaktions-ID des Zahlungsgateways
`tendered`	Zahl	Erhaltener Bargeldbetrag, falls vorhanden
`change`	Zahl	Ausgezahltes Rückgeld, falls vorhanden

Formatierte Varianten: amount_display, tendered_display und change_display.

refunds — Rückerstattungsdatensätze

Rückerstattungen

Mit {{#refunds}}...{{/refunds}} wiederholen. Rückerstattungsbeträge sind positive Werte; Vorlagen entscheiden, ob ein Minuszeichen vorangestellt oder ein separater Block für zurückgegebene Artikel gerendert wird.

Feld	Typ	Beschreibung
`id`	Zahl	ID des Rückerstattungsdatensatzes
`date`	Datumsobjekt	Erstellungsdatum der Rückerstattung
`amount`	Zahl	Gesamtsumme der Rückerstattung
`subtotal`	Zahl	Zwischensumme der erstatteten Position
`tax_total`	Zahl	Erstattete Steuer
`shipping_total`	Zahl	Erstatteter Versandbetrag
`shipping_tax`	Zahl	Erstattete Versandsteuer
`reason`	Zeichenfolge	Grund für die Rückerstattung
`refunded_by_id`	Zahl/null	Benutzer-ID, die die Rückerstattung ausgeführt hat
`refunded_by_name`	Zeichenfolge	Angezeigter Benutzername, der die Rückerstattung ausgeführt hat
`refunded_payment`	boolesch	Ob die Zahlung über das Zahlungsgateway erstattet wurde
`destination`	Zeichenfolge	`original_method`, `cash` oder `manual`
`gateway_id`	Zeichenfolge	Zahlungsgateway-ID für die Rückerstattung
`gateway_title`	Zeichenfolge	Angezeigter Titel des Zahlungsgateways
`processing_mode`	Zeichenfolge	Verarbeitungsmodus durch Anbieter/manuell
`lines`	Liste	Rückerstattete Produktzeilen
`fees`	Liste	Rückerstattete Gebührenzeilen
`shipping`	Liste	Rückerstattete Versandzeilen

Felder für Rückerstattungszeilen umfassen name, sku, qty, total, total_incl, total_excl, line_total, unit_total und taxes. Rückerstattete Gebühren- und Versandzeilen verwenden label, total, total_incl, total_excl und taxes. Für Summen und Steuerbeträge werden Anzeigevarianten hinzugefügt.

fiscal — Momentaufnahme der Fiskalintegration

Fiskal

Fiskalische Felder sind standardmäßig leer und werden durch Fiskalintegrationen oder die Snapshot-Anreicherung von WCPOS Pro ausgefüllt.

Feld	Typ	Beschreibung
`fiscal.immutable_id`	Zeichenfolge	Unveränderliche fiskalische Kennung
`fiscal.receipt_number`	Zeichenfolge	Fiskalbelegnummer
`fiscal.sequence`	Zahl/null	Sequenzzähler
`fiscal.hash`	Zeichenfolge	Hash-/Signaturwert
`fiscal.qr_payload`	Zeichenfolge	QR-Nutzdaten zur fiskalischen Verifizierung
`fiscal.tax_agency_code`	Zeichenfolge	Code der Steuerbehörde
`fiscal.signed_at`	Zeichenfolge	Zeitstempel der fiskalischen Signierung
`fiscal.signature_excerpt`	Zeichenfolge	Gekürzte Signatur zur Anzeige
`fiscal.document_label`	Zeichenfolge	Dokumentbezeichnung, z. B. Steuerrechnung
`fiscal.is_reprint`	Boolesch	Gibt an, ob diese Ausgabe ein Nachdruck ist
`fiscal.reprint_count`	Zahl	Anzahl der Nachdrucke
`fiscal.extra_fields`	Array/Objekt	Rechtsprechungsspezifische Werte

presentation_hints — Hinweise zur Formatierung und zum Rendern

presentation_hints

Diese Felder werden hauptsächlich vom Renderer und Formatierer verwendet. Sie stehen Vorlagen bei Bedarf zur Verfügung.

Feld	Typ	Beschreibung
`presentation_hints.display_tax`	Zeichenfolge	`incl`, `excl`, `hidden`, `itemized` oder `single`
`presentation_hints.prices_entered_with_tax`	boolescher Wert	Ob Katalogpreise Steuern enthalten
`presentation_hints.rounding_mode`	Zeichenfolge	WooCommerce-Einstellung für die Steuerrundung
`presentation_hints.locale`	Zeichenfolge	Für die Formatierung verwendetes Gebietsschema
`presentation_hints.timezone`	Zeichenfolge	Zeitzone des Belegs
`presentation_hints.currency_position`	Zeichenfolge	Position des Währungssymbols
`presentation_hints.currency_symbol`	Zeichenfolge	Währungssymbol
`presentation_hints.price_thousand_separator`	Zeichenfolge	Tausendertrennzeichen
`presentation_hints.price_decimal_separator`	Zeichenfolge	Dezimaltrennzeichen
`presentation_hints.price_num_decimals`	Zahl	Dezimalstellen
`presentation_hints.price_display_suffix`	Zeichenfolge	WooCommerce-Preisanzeigesuffix
`presentation_hints.order_barcode_type`	Zeichenfolge	Barcode-Typ, der von Galerievorlagen verwendet wird

i18n — übersetzte Beschriftungen

i18n

Verwenden Sie nach Möglichkeit i18n-Beschriftungen, statt Text fest zu codieren:

{{i18n.order}} #{{order.number}}
{{i18n.cashier}}: {{cashier.name}}
{{i18n.total}}: {{totals.total_display}}

Zu den gängigen Schlüsseln gehören order, date, cashier, customer, item, sku, qty, unit_price, regular_price, selling_price, savings, discount, subtotal, total_saved, total, tax, paid, tendered, change, tax_summary, refunded, net_total, customer_note, thank_you_purchase, opening_hours sowie die Steuernummer-Beschriftungsschlüssel wie store_tax_id_label_eu_vat und customer_tax_id_label_other. Erweiterungen können zusätzliche Schlüssel hinzufügen.

Der Beleg im Überblick​

Häufige Vorlagenaufgaben​

Darstellungsregeln​

Währungsfelder​

Felder mit steueranzeigegerechten Werten​

Datumsobjekte​

Abschnitte der obersten Ebene​

Zusammenhang der Preise​

Feldreferenz​

Bestellung​

Filiale​

Steuer-ID-Objekte​

Kassierer​

Kunde​

Zeilen​

Regulären Preis und Ersparnis anzeigen​

Gebühren und Versand​

Rabatte​

Summen​

tax und tax_summary​

Zahlungen​

Rückerstattungen​

Fiskal​

presentation_hints​

i18n​

Der Beleg im Überblick

Häufige Vorlagenaufgaben

Darstellungsregeln

Währungsfelder

Felder mit steueranzeigegerechten Werten

Datumsobjekte

Abschnitte der obersten Ebene

Zusammenhang der Preise

Feldreferenz

Bestellung

Filiale

Steuer-ID-Objekte

Kassierer

Kunde

Zeilen

Regulären Preis und Ersparnis anzeigen

Gebühren und Versand

Rabatte

Summen

tax und tax_summary

Zahlungen

Rückerstattungen

Fiskal

presentation_hints

i18n