レシートデータリファレンス

WCPOSのロジックレスHTMLテンプレートとサーマルXMLテンプレートは、同一の正規レシートペイロードからレンダリングされます。{{order.number}}、{{store.name}}、{{totals.total_display}}のようなMustacheドットパスを使用します。配列はセクションでレンダリングされます：

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

正規コントラクトはサーバー上のWCPOSレシートデータビルダーによって生成され、アプリ内のオフラインレシートレンダラーによってミラーリングされます。レシートはローカルデータからすぐに表示され、サーバーレスポンスが利用可能になると更新されるため、カスタムテンプレートではPHPの注文メソッドではなく以下のフィールドを使用してください。

レシートデータ v1.1 では、各商品明細に記録済みの通常価格、クーポン適用前の販売価格、割引額のフィールドが追加されました。また、注文レベルの割引合計も提供されます。これには、通常価格からの割引と WooCommerce の割引を合算した 合計割引額 の値が含まれますが、注文合計やレポートが変わることはありません。

レシートの対応関係

印刷されるレシートの各部分は、データコントラクトのいずれかのセクションに対応しています。どちらか一方にカーソルを合わせると対応関係が表示され、クリックするとそのセクションのフィールドに移動します。このページのすべての例では、同じサンプル注文を使用しています。

COFFEE MONSTER

12 Roast Lane, Portland OR

VAT: US-998877

---

レシート #10422026年7月13日

キャッシャー: Ada顧客: Nia

---

2 × Espresso Beans29.00

34.00 · 割引 −5.00

1 × Ceramic Mug18.00

1 × Croissant5.75

---

小計52.75

クーポン SUMMER10−5.28

ギフトラッピング2.50

配送10.00

合計59.97

合計割引額10.28

---

カード59.97

---

ご購入ありがとうございました！

店舗ヘッダー

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

注文と担当者

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

明細行

lines[] · line_savings · savings_in_discounts

合計ブロック

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

支払い

payments[]

フッター

store.personal_notes · store.policies_and_conditions · i18n.thank_you_purchase

よく使うレシピ

テンプレートの編集のほとんどは、次の3つのいずれかです。各カードには、まず印刷結果が表示され、続いて実際のマークアップが表示されます。ロジックレス HTML またはサーマル XML のテンプレートにそのままコピーしてください。3つ目のカードは、上記のサンプル注文ではなく v1.9 より前のレガシー注文を示しています。

2 × Espresso Beans29.00

34.00 · 割引 −5.00

通常価格に取り消し線を引く

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

価格履歴が記録されていない注文では、セクションガードによってすべて非表示になります。

合計59.97

合計割引額10.28

合計割引額の行を追加する

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

2つのガード: 価格履歴が不完全な場合や、割引がなかった場合にこの行は表示されません。

1 × Espresso Beans14.50

17.00 割引 −2.50

v1.9 より前の注文を安全に再印刷する

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

古い注文では割引額の中に値引きが含まれているため、二重表示を防ぎます。

レンダリングルール

通貨フィールド

数値の金額フィールドは数値として保持され、レンダラーがテンプレート出力用にロケール対応の_displayフィールドを追加します：

数値フィールド	表示フィールド
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

レシート印刷時は _display フィールドを使用してください。数値フィールドは条件付きセクションや機械可読出力にのみ使用します。

税表示対応フィールド

いくつかのフィールドには税込・税抜のバリアントに加え、表示用の便利な値があります。この便利な値は、店舗のカート税表示設定に従います。

便利フィールド	税込フィールド	税抜フィールド
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

日付オブジェクト

日付フィールドは、複数のフォーマット済みバリアントを持つオブジェクトです。これにより、Mustache 内での日付フォーマット処理が不要になります。

フィールド	説明
datetime、date、time	デフォルトの日付/時刻文字列
datetime_short、datetime_long、datetime_full	ロケール対応の結合フォーマット
date_short, date_long, date_full	ロケール対応の日付のみのフォーマット
date_ymd, date_dmy, date_mdy	固定順序の日付フォーマット
weekday_short, weekday_long	曜日名
day, month, month_short, month_long, year	個別の日付要素

利用可能な日付オブジェクト: order.created、order.paid、order.completed、order.printed、および refunds[].date。order.printed はレンダリング時に更新されるため、再印刷時に便利です。

トップレベルセクション

セクション	型	説明
order	object	注文のID、ステータス、日付、メモ、および決済URL情報
store	object	店舗のID、住所、連絡先、税務ID、ロゴ、営業時間、およびフッターテキスト
cashier	object	注文を処理したユーザー
customer	object	顧客の表示名、住所、および税務ID
lines	array	商品明細行
fees	array	手数料行
shipping	array	配送料行
discounts	array	クーポン／割引行
totals	object	注文合計、支払合計、返金概要、および項目数
tax	object	セクションガード用の税表示モードフラグ
tax_summary	array	税率別の税概要行
has_tax_summary	boolean	tax_summary の有無を示す簡易ガード
payments	array	支払行
refunds	array	注文に適用された返金レコード
fiscal	object	財務連携により設定されるフィスカルスナップショットフィールド
presentation_hints	object	書式設定およびレンダラーヒント
i18n	object	組み込みテンプレートおよびカスタムテンプレート用の翻訳ラベル

価格どうしの関係

1つの商品明細には複数の価格が含まれますが、実際の金額の上で見れば名前の意味は明確になります。以下はサンプル注文のエスプレッソの明細です。通常価格 $17.00 の商品が $14.50 で販売され、さらに 10% のクーポンが適用されています。

Espresso Beans — 1個あたり（注文には2個含まれます）

13.05 支払額

1.45

2.50

0通常価格 17.00

顧客が支払う金額unit_price → 13.05 · line_total → 26.10

クーポン割引 (SUMMER10)lines[].discounts → この明細で 2.90

通常価格からの割引額unit_savings → 2.50 · line_savings → 5.00

注文全体のセール割引額totals.sale_savings_total = 5.00

注文全体のクーポン割引額totals.discount_total = 5.28

割引額と値引きの合計（レガシーの重複を除去）totals.total_saved = 10.28

セール割引額とクーポン割引は別のものです。セール割引額は販売価格と記録された通常価格を比較したものであるのに対し、discounts は WooCommerce 自体のクーポン計算です。WooCommerce の注文合計とレポートに含まれるのはクーポン分のみです。だからこそ、両方を合算した唯一の顧客向けの数値として total_saved が存在します。

フィールドリファレンス

完全なフィールドリファレンスは、以下でセクションごとにグループ化されています。すべてデフォルトで折りたたまれています。必要なグループを展開してください。

order — ID、ステータス、日付

order

フィールド	型	例 / 説明
order.id	number	1042
order.number	string	表示用の注文番号（例: "1042"）
order.currency	string	ISO 通貨コード（例: "USD"）
order.customer_note	string	顧客メモ / 注文メモ
order.wc_status	string	WooCommerce のステータススラッグ（例: "processing"）
order.status_label	string	ローカライズされたステータスラベル（カスタムステータスを含む）
order.created_via	string	作成元 / チャネル（例: "woocommerce-pos"）
order.needs_payment	boolean	支払いセクションを表示するかどうか
order.payment_url	string	利用可能な場合の注文決済 URL
order.created	date object	注文作成日
order.paid	date object	支払日、未払いの場合は空文字列
order.completed	date object	完了日、未完了の場合は空文字列
order.printed	date object	レンダリング時の印刷／再印刷タイムスタンプ

store — ID、住所、連絡先、営業時間

store

フィールド	型	例 / 説明
store.id	number	店舗 ID、削除済み店舗の場合は過去の ID
store.name	string	店舗の表示名
store.address.address_1	string	住所1行目
store.address.address_2	string	建物名・部屋番号
store.address.city	string	市区町村
store.address.state	string	都道府県/地域
store.address.postcode	string	郵便番号
store.address.country	string	ISO 国コード
store.address_lines	array	フォーマット済みの住所行。ほとんどのテンプレートで推奨
store.tax_ids	array	構造化された事業者税務ID。単一の税務IDではなくループで使用
store.phone	string	店舗電話番号
store.email	string	店舗メールアドレス
store.logo	string/null	店舗ロゴのURLまたはデータURI
store.opening_hours	string/null	営業時間テキスト（コンパクト形式）
store.opening_hours_vertical	string/null	営業時間ブロック（複数行形式）
store.opening_hours_inline	string/null	営業時間テキスト（カンマ区切り形式）
store.opening_hours_notes	string/null	営業時間に関する自由記述メモ
store.personal_notes	string/null	レシートフッター／個人メモ
store.policies_and_conditions	string/null	返金・返品・利用規約テキスト
store.footer_imprint	string/null	法的フッターインプリント

税務IDオブジェクト

store.tax_ids と customer.tax_ids は同じ構造のオブジェクトを含みます：

フィールド	型	説明
type	string	eu_vat、de_steuernummer、au_abn、br_cpf、us_ein、other などの識別子
value	string	印刷する税務ID値
country	string/null	判明している場合のISO国コード
label	string/null	ローカライズされた表示ラベル（レンダリング前に解決済み）

例：

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

cashier — 注文を処理したユーザー

cashier

フィールド	型	例 / 説明
cashier.id	number	WordPress ユーザー ID、不明な場合は 0
cashier.name	string	レジ担当者の表示名

customer — 名前、住所、税務ID

customer

フィールド	型	例 / 説明
customer.id	number/null	顧客 ID、ゲストの場合は null
customer.name	string	顧客の表示名、またはゲストラベル
customer.billing_address.*	object	WooCommerce の請求先住所フィールド
customer.shipping_address.*	object	WooCommerce の配送先住所フィールド
customer.tax_ids	array	注文からスナップショットされた顧客の税 ID（構造化データ）

一般的な住所キーには first_name、last_name、company、address_1、address_2、city、state、postcode、country、email、phone があります。

lines — 商品明細行

lines

{{#lines}}...{{/lines}} でループします。サンプル値はサンプル注文のエスプレッソの明細です。

金額フィールドはすべてペアで提供されます。数値（{{#…}} ガードで使用します。ゼロと null はセクションを非表示にし、null のフィールドには _display の対になる値がまったくありません）と、その _display 文字列（印刷に使用します）です。incl/excl の印が付いたフィールドには _incl と _excl のバリアントもあり、それぞれに独自の _display があります。

keystring

固定の明細キー／注文アイテム ID。

key"412"

skustring

商品 SKU。

sku"ESP-500"

namestring

商品名または明細の表示名。

name"Espresso Beans"

qtynumber

販売数量。

qty2

qty_refundednumber

この明細の返金数量。

qty_refunded0

regular_pricenumbermoneynullableincl/excl

記録された通常単価。POS の価格履歴がない注文では null になります。セクションで囲んでください。

regular_price17

regular_price_display"$17.00"

selling_pricenumbermoneynullableincl/excl

クーポン適用前の販売単価。記録された POS 価格があればそれを使用し、なければ保存された明細小計から算出されます。

selling_price14.5

selling_price_display"$14.50"

unit_savingsnumbermoneynullableincl/excl

通常価格から販売価格を引いた値（ゼロ以上に制限）。ゼロは偽値となるため、ガードで囲んだ行は自動的に非表示になります。

unit_savings2.5

unit_savings_display"$2.50"

line_regular_totalnumbermoneynullableincl/excl

記録された通常価格に数量を掛けた値。

line_regular_total34

line_regular_total_display"$34.00"

line_selling_totalnumbermoneynullableincl/excl

クーポン適用前の販売価格に数量を掛けた値。

line_selling_total29

line_selling_total_display"$29.00"

line_savingsnumbermoneynullableincl/excl

この明細における通常価格から販売価格までの割引額の合計。

line_savings5

line_savings_display"$5.00"

savings_in_discountsboolean

値引きがすでに discounts に含まれている v1.9.0 より前の注文で true になります。二重計上を防ぐためのフラグです。

savings_in_discountsfalse

unit_subtotalnumbermoneyincl/excl

WooCommerce の割引前単価。これを通常価格として使用しないでください。

unit_subtotal14.5

unit_subtotal_display"$14.50"

unit_pricenumbermoneyincl/excl

WooCommerce の割引適用後の最終単価。

unit_price13.05

unit_price_display"$13.05"

line_subtotalnumbermoneyincl/excl

WooCommerce の割引前明細小計。

line_subtotal29

line_subtotal_display"$29.00"

discountsnumbermoneyincl/excl

WooCommerce 本来の明細割引額（正の値）。現行の注文ではクーポンのみです。

discounts2.9

discounts_display"$2.90"

line_totalnumbermoneyincl/excl

クーポン適用後の最終的な明細合計。金額欄に印刷される値です。

line_total26.1

line_total_display"$26.10"

total_refundednumbermoney

この明細の返金合計（正の値）。

total_refunded0

total_refunded_display"$0.00"

taxesarray

この明細の税率別税額行。

—

metaarray

注文項目メタ（{key, value} ペア）。

—

attributesarray

商品／バリエーション属性（{key, value} ペア）。

—

通常価格と割引額の表示

単価レイアウトでは、記録された通常価格、販売価格、割引額を次のように表示します。

{{#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}}

数量が関係する場合は、明細合計のフィールドを使用します。

{{#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 はクーポン適用前の価格です。WooCommerce の割引適用後の最終金額には unit_price または line_total を使用してください。

v1.9.0 より前に作成された注文の再印刷

古い WCPOS の注文では、通常価格から販売価格への値引きがすでに discounts に含まれている場合があります。カスタムテンプレートで明細の割引額と明細の値引きの両方を印刷する場合は、savings_in_discounts を使用して同じ値引きが二重に表示されないようにしてください。

{{#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}}

テンプレートが明細レベルの discounts の行を印刷しない場合は、savings_in_discounts が true であっても line_savings を表示し続けてください。組み込みテンプレートはこの区別を自動的に処理します。

手数料と配送

手数料と配送

{{#fees}}...{{/fees}} および {{#shipping}}...{{/shipping}} でループします。

フィールド	型	説明
label	string	手数料ラベルまたは配送方法名
method_id	string	配送方法ID（配送のみ）
total / _incl / _excl	number	表示用、税込、税抜の合計
taxes	array	税率ごとの税額行
meta	array	{key, value} メタデータのペア

フォーマット済みバリアント: total_display、total_incl_display、total_excl_display。

discounts — クーポン／割引行

discounts

{{#discounts}}...{{/discounts}} でループします。

フィールド	型	説明
label	string	クーポンの説明またはコードのフォールバック
code	string	クーポンコード
total / _incl / _excl	number	正の値としての割引額

フォーマット済みバリアント: total_display、total_incl_display、total_excl_display。割引をマイナス行として表示する場合は、テンプレート内で独自にマイナス記号を追加してください。

totals — 注文、支払、返金、項目合計

totals

サンプル値はサンプル注文のもので、この注文にはその後 $7.25 の一部返金が行われています。

金額フィールドは明細行と同じペアの形式に従います。ガード用の素の数値と、印刷用の _display 文字列があり、印が付いたものには _incl / _excl のバリアントがあります。

subtotalnumbermoneyincl/excl

割引前の注文小計。

subtotal52.75

subtotal_display"$52.75"

discount_totalnumbermoneyincl/excl

正の値としての注文割引合計。現行の注文ではクーポンのみです。

discount_total5.28

discount_total_display"$5.28"

sale_savings_totalnumbermoneynullableincl/excl

商品明細全体で記録された、通常価格から販売価格までの割引額の合計。カタログのセールとレジでの価格変更を含みます。

sale_savings_total5

sale_savings_total_display"$5.00"

total_savednumbermoneynullableincl/excl

WooCommerce の割引と通常価格からの割引額を合算し、レガシーの重複を除いた値。節約された金額全体を表す唯一の顧客向けの数値です。

total_saved10.28

total_saved_display"$10.28"

total_saved_completeboolean

完全な割引合計を算出できるだけの価格データがレシートに記録されているかどうか。

total_saved_completetrue

tax_totalnumbermoney

税額合計。

tax_total0

tax_total_display"$0.00"

totalnumbermoneyincl/excl

注文総計。

total59.97

total_display"$59.97"

paid_totalnumbermoney

支払済み／適用済み金額。

paid_total59.97

paid_total_display"$59.97"

change_totalnumbermoney

顧客へのお釣り。

change_total0

change_total_display"$0.00"

refund_totalnumbermoney

返金合計（正の値）。

refund_total7.25

refund_total_display"$7.25"

net_totalnumbermoney

合計から返金を差し引いた値（ゼロ以上に制限）。

net_total52.72

net_total_display"$52.72"

total_qtynumber

明細数量の合計。

total_qty4

line_countnumber

商品明細行の数。

line_count3

節約された金額全体を1つの顧客向けの数値として表示したい場合は total_saved を使用してください。テンプレート内で discount_total と sale_savings_total を足して算出しないでください。v1.9.0 より前に作成された注文では、POS の価格による値引きがすでに WooCommerce の割引合計に含まれている場合があります。正規の total_saved フィールドは、この重複を検出して除去します。

いずれかの商品明細に、信頼できる集計に必要な価格データが記録されていない場合、割引合計は null となり、total_saved_complete は false になります。行を total_saved_complete でガードし、そのうえで total_saved を使ってゼロの値を非表示にしてください。

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

価格を表示する組み込みテンプレートは、税込バリアント（total_saved_incl と total_saved_incl_display）で同じガード構造を使用し、完全な値がゼロより大きい場合にのみ 合計割引額 を表示します。

tax と tax_summary — 表示ガードと税率別行

tax と tax_summary

表示モードの判定には tax を、税率別の明細行には tax_summary を使用します。

税フィールド	型	説明
tax.display	string	incl または excl
tax.display_incl	boolean	価格が税込みで表示される場合に true
tax.display_excl	boolean	価格が税抜きで表示される場合に true
tax.breakdown	string	hidden、single、または itemized
tax.breakdown_hidden	boolean	税の行を非表示にする場合に true
tax.breakdown_single	boolean	税合計を一行で表示する場合に true
tax.breakdown_itemized	boolean	税率ごとの行を表示する場合に true
has_tax_summary	boolean	tax_summary に行が含まれる場合に true

tax_summary を {{#tax_summary}}...{{/tax_summary}} でループします。

フィールド	型	説明
code	string	税率 ID／コード
rate	number/null	解決済みの場合の税率（パーセント）
label	string	税率ラベル
compound	boolean	複合税率かどうか
taxable_amount_excl	number/null	税抜課税対象額
tax_amount	number	徴収税額
taxable_amount_incl	number/null	税込課税対象額

フォーマット済みバリアント: taxable_amount_excl_display、tax_amount_display、taxable_amount_incl_display。

payments — 支払行

payments

{{#payments}}...{{/payments}} でループします。

フィールド	型	説明
method_id	string	決済方法の識別子
method_title	string	決済方法の表示名
amount	number	注文に適用された金額
transaction_id	string	ゲートウェイのトランザクション ID
tendered	number	現金の預かり金額（存在する場合）
change	number	現金のお釣り（存在する場合）

フォーマット済みバリアント: amount_display、tendered_display、change_display。

refunds — 返金レコード

refunds

{{#refunds}}...{{/refunds}} でループします。返金額は正の絶対値です。マイナス記号を付けるか、返品ブロックとして別に表示するかはテンプレート側で決定します。

フィールド	型	説明
id	number	返金レコード ID
date	date object	返金作成日
amount	number	返金合計
subtotal	number	返金された明細小計
tax_total	number	返金された税額
shipping_total	number	返金された送料
shipping_tax	number	返金された送料税
reason	string	返金理由
refunded_by_id	number/null	返金を実行したユーザーのID
refunded_by_name	string	返金を実行したユーザーの表示名
refunded_payment	boolean	ゲートウェイ経由で返金が処理されたかどうか
destination	string	original_method、cash、または manual
gateway_id	string	返金に使用されたゲートウェイID
gateway_title	string	ゲートウェイの表示タイトル
processing_mode	string	プロバイダー/手動処理モード
lines	array	返金対象の商品行
fees	array	返金対象の手数料行
shipping	array	返金対象の配送料行

返金明細行のフィールドには name、sku、qty、total、total_incl、total_excl、line_total、unit_total、および taxes があります。返金手数料行および配送料行では label、total、total_incl、total_excl、および taxes が使用されます。合計金額および税額には表示用のバリアントが追加されます。

fiscal — 財務連携スナップショット

fiscal

fiscal フィールドはデフォルトでは空であり、財務連携機能または WCPOS Pro のスナップショットエンリッチメントによって値が設定されます。

フィールド	型	説明
fiscal.immutable_id	string	不変の財務識別子
fiscal.receipt_number	string	財務レシート番号
fiscal.sequence	number/null	シーケンスカウンター
fiscal.hash	string	ハッシュ／署名値
fiscal.qr_payload	string	財務検証用QRペイロード
fiscal.tax_agency_code	string	税務当局コード
fiscal.signed_at	string	財務署名タイムスタンプ
fiscal.signature_excerpt	string	表示用の短縮署名
fiscal.document_label	string	ドキュメントラベル（例：Tax Invoice）
fiscal.is_reprint	boolean	再印刷かどうか
fiscal.reprint_count	number	再印刷回数
fiscal.extra_fields	array/object	管轄区域固有の値

presentation_hints — 書式設定およびレンダラーヒント

presentation_hints

これらのフィールドは主にレンダラーとフォーマッターによって使用されます。必要に応じてテンプレートからも利用できます。

フィールド	型	説明
presentation_hints.display_tax	string	incl、excl、hidden、itemized、または single
presentation_hints.prices_entered_with_tax	boolean	カタログ価格に税が含まれているかどうか
presentation_hints.rounding_mode	string	WooCommerce の税端数処理設定
presentation_hints.locale	string	フォーマットに使用されるロケール
presentation_hints.timezone	string	レシートのタイムゾーン
presentation_hints.currency_position	string	通貨記号の位置
presentation_hints.currency_symbol	string	通貨記号
presentation_hints.price_thousand_separator	string	桁区切り文字
presentation_hints.price_decimal_separator	string	小数点記号
presentation_hints.price_num_decimals	number	小数点以下の桁数
presentation_hints.price_display_suffix	string	WooCommerce の価格表示サフィックス
presentation_hints.order_barcode_type	string	ギャラリーテンプレートで使用されるバーコードの種類

i18n — 翻訳ラベル

i18n

テキストをハードコードせず、可能な限り i18n ラベルを使用してください：

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

一般的なキーには 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、および store_tax_id_label_eu_vat や customer_tax_id_label_other などの税 ID ラベルキーがあります。拡張機能によってキーが追加される場合もあります。