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.
store.name · store.address_lines · store.tax_ids · store.logoorder.number · order.created · cashier.name · customer.namelines[] · line_savings · savings_in_discountstotals.* · discounts[] · fees[] · shipping[] · totals.total_savedpayments[]store.personal_notes · store.policies_and_conditions · i18n.thank_you_purchaseHä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.
{{# line_savings }}
<s>{{ line_regular_total_display }}</s>
{{ i18n.savings }}: -{{ line_savings_display }}
{{/ line_savings }}{{# totals.total_saved_complete }}
{{# totals.total_saved }}
{{ i18n.total_saved }}:
{{ totals.total_saved_display }}
{{/ totals.total_saved }}
{{/ totals.total_saved_complete }}{{# line_savings }}
{{^ savings_in_discounts }}
{{ i18n.savings }}: -{{ line_savings_display }}
{{/ savings_in_discounts }}
{{/ line_savings }}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 %.
unit_price → 13.05 · line_total → 26.10lines[].discounts → 2.90 für diese Positionunit_savings → 2.50 · line_savings → 5.00totals.sale_savings_total = 5.00totals.discount_total = 5.28totals.total_saved = 10.28Ersparnisse 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.
| Feld | Typ | Beschreibung |
|---|---|---|
key | Zeichenfolge | Stabiler Zeilenschlüssel/Bestellpositions-ID |
sku | Zeichenfolge | Produkt-SKU |
name | Zeichenfolge | Anzeigename des Produkts oder der Position |
qty | Zahl | Verkaufte Menge |
qty_refunded | Zahl | Für diese Position erstattete Menge |
regular_price / _incl / _excl | Zahl/null | Erfasster regulärer Stückpreis |
selling_price / _incl / _excl | number/null | Verkaufseinzelpreis vor Coupon — der erfasste POS-Preis, sofern verfügbar, andernfalls aus der gespeicherten Zwischensumme der Position abgeleitet |
unit_savings / _incl / _excl | Zahl/null | regular_price - selling_price, auf null begrenzt |
line_regular_total / _incl / _excl | Zahl/null | Erfasster regulärer Preis multipliziert mit der Menge |
line_selling_total / _incl / _excl | Zahl/null | Verkaufspreis vor Coupons multipliziert mit der Menge |
line_savings / _incl / _excl | Zahl/null | Gesamtersparnis dieser Position zwischen regulärem Preis und Verkaufspreis |
savings_in_discounts | Boolesch | Wahr, wenn eine ältere Bestellung dieselbe Ersparnis bereits in discounts enthält |
unit_subtotal / _incl / _excl | Zahl | WooCommerce-Stückwert vor Rabatt; nicht als regulären Preis verwenden |
unit_price / _incl / _excl | Zahl | Endgültiger Stückwert nach WooCommerce-Rabatten |
line_subtotal / _incl / _excl | Zahl | WooCommerce-Zwischensumme der Zeile vor Rabatt |
discounts / _incl / _excl | Zahl | Nativer WooCommerce-Zeilenrabatt als positiver Wert; bei aktuellen Bestellungen normalerweise nur für Gutscheine |
line_total / _incl / _excl | Zahl | Endgültiger Gesamtbetrag der Zeile |
total_refunded | Zahl | Insgesamt für diese Zeile erstatteter Betrag als positiver Wert |
taxes | Array | Steuerzeilen je Steuersatz für diese Zeile |
meta | Array | Metadaten der Bestellposition als {key, value}-Paare |
attributes | Array | Produkt-/Variationsattribute als {key, value}-Paare |
Jedes Geldfeld verfügt über ein formatiertes _display-Begleitfeld, einschließlich regular_price_display, selling_price_display, unit_savings_display, line_regular_total_display, line_selling_total_display und line_savings_display. Auch inklusive und exklusive Felder verfügen über _display-Varianten. Wenn ein Nullable-Einsparungsfeld null ist, wird sein _display-Begleitfeld vollständig weggelassen.
Ersparnisfelder sind null, wenn die Bestellung nicht genügend aufgezeichnete POS-Preisdaten enthält. Vorlagen sollten sie daher in Mustache-Abschnitte einschließen, statt anzunehmen, dass jede historische Bestellung einen regulären Preis hat.
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.
Ä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
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
| Feld | Typ | Beschreibung |
|---|---|---|
totals.subtotal / _incl / _excl | Zahl | Bestellzwischensumme vor Rabatten |
totals.discount_total / _incl / _excl | Zahl | Gesamtrabatt der Bestellung als positiver Wert |
totals.sale_savings_total / _incl / _excl | Zahl/null | Gesamte erfasste Ersparnisse zwischen regulärem Preis und Verkaufspreis über alle Produktzeilen hinweg, einschließlich Katalogangeboten und Änderungen der Kassenpreise |
totals.total_saved / _incl / _excl | Zahl/null | Kombinierte WooCommerce-Rabatte und Ersparnisse gegenüber dem regulären Preis, ohne Überschneidungen aus älteren Versionen |
totals.total_saved_complete | Boolesch | Ob der Beleg genügend erfasste Preisdaten enthält, um die vollständigen Ersparnissummen zu berechnen |
totals.tax_total | Zahl | Gesamtsteuerbetrag |
totals.total / _incl / _excl | Zahl | Gesamtsumme der Bestellung |
totals.paid_total | Zahl | Gezahlter/angerechneter Betrag |
totals.change_total | Zahl | An den Kunden ausgezahltes Rückgeld |
totals.refund_total | Zahl | Gesamter Rückerstattungsbetrag als positiver Wert |
totals.net_total | Zahl | total - refund_total, auf null begrenzt |
totals.total_qty | Zahl | Summe der Artikelmengen |
totals.line_count | Zahl | Anzahl der Produktzeilen |
Formatierte Varianten umfassen subtotal_display, discount_total_display, sale_savings_total_display, total_saved_display, tax_total_display, total_display, paid_total_display, change_total_display, refund_total_display und net_total_display sowie gegebenenfalls Varianten inklusive/exklusive Steuern.
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.