通知の参照変数
ストアから送信された通知は、Liquidを使用してレンダリングされます。Liquidは、Shopifyの分かりやすくて使いやすいプログラミング言語です。テーマストアのテーマの構築に使用されたプログラミング言語です。
ストアから送信される通知を編集するために、通知テンプレートの基本カスタマイズを行うことができます。
高度な変更に関するヘルプや、カスタム通知のテンプレートの変更については、フォーラムでコミュニティに問い合わせてください。親切で役立つアドバイスを得ることができます。カスタマイズを行うにあたり、Shopifyエキスパートに依頼することも検討してください。
ストアの管理画面から編集できるLiquid通知テンプレートのリストは、以下のとおりです。
- カゴ落ち
- お客様に連絡する
- お客様アカウントの招待
- お客様アカウントへの挨拶
- お客様アカウントのパスワード再設定
- 下書き注文の請求書
- フルフィルメントのリクエスト
- ギフトカードの作成
- 新しい注文
- 新規注文（モバイル）
- キャンセル済のご注文
- 注文の確認
- POSとモバイル領収書
- 注文の返金
- 配送確認
- 配送の更新
管理画面のすべてのテンプレートで対応する注文のプロパティにアクセスできます。
注文プロパティ
多くの注文プロパティは、テンプレートや追加スクリプトで直接Liquidを使用できます。
注文プロパティは、以下のテンプレートで使用できます。
- 注文の確認
- 新しい注文
- 新規注文（モバイル）
- 配送確認
- 配送の更新
- 追加スクリプト
- フルフィルメントのリクエスト
| プロパティ | 説明 |
|---|---|
id |
社内で使用するシステム全体の固有の注文ID。ストアの管理画面セクションで注文へのリンクを生成するなどに使用可能。たとえば新しい注文テンプレートでは、以下のように配置できます。 <a href="{{ shop.url }}/admin/orders/{{ id }}">注文を見る</a>
|
| 注文に関連づけられたメール | |
name |
通常、order_numberの前のハッシュ記号。たとえば注文#1004と表示される |
order_name |
nameと同様 |
order_number |
注文のストア個別番号。たとえば「1004」と表示される。ハッシュ記号 (#) のプリフィックス、または、ストアの各種設定でストアオーナーが注文IDに追加したプリフィックスまたはサフィックスを削除したもの。 |
created_at |
お客様が注文を作成した日時。たとえば「2009-05-30T17:43:51+02:00」と表示される。日付絞り込みを使用してフォーマット可能 |
| tags | 注文のタグすべての配列を返す。タグはアルファベット順で返す。詳しくは、「Liquid参照ドキュメント」を参照 |
| transactions | 注文からの取引の配列を返します。 |
tax_price |
注文のすべてのアイテムに関する税金の総計 |
tax_lines |
以下のように課税の「レベル」で分けられた税金を表す
|
tax_line.title |
税金の名前。たとえばQSTやVATがこれに相当する |
tax_line.price |
税金の金額 |
tax_line.rate |
税率。17.5%の場合は0.175を返す |
tax_line.rate_percentage |
解読可能な形式での税率。税率が0.175の場合は17.5を返す |
customer |
customer出力の属性を含むcustomerオブジェクト |
billing_address |
請求先住所 |
billing_address.first_name |
お客様の名前 |
billing_address.last_name |
お客様の名字 |
billing_address.company |
請求先の会社名 |
billing_address.phone |
請求先住所の電話番号 |
shop.name |
ストアの名前 |
shop.phone |
ストアの電話番号 |
subtotal_price |
商品アイテムのディスカウントまたはカートのディスカウントが差し引かれた後の、注文の商品アイテム価格の合計。小計には、税金 (税金は価格に含まれていない場合) や送料は含まれない |
discounts |
ディスカウントのリスト |
discounts_amount |
すべてのディスカウントにより適用されるディスカウント金額 (たとえば、+ 5.00ドル) |
discounts_savings |
すべてのディスカウントにより生じた削減金額 (たとえば、- 5.00ドル) |
total_price |
注文の合計 (小計+送料-配送料ディスカウント+税) |
financial_status |
現在の決済状況。無、「保留」、「オーソリ済」、「支払い済」、「無効」、「返金済」のいずれか |
requires_shipping |
(ブーリアン) 配送を必要とする注文に、少なくとも1つのアイテムがある場合にtrueを返す |
shipping_method.title |
「通常配送」などの配送料名 |
shipping_method.price |
配送ディスカウントを含む配送価格。 例: |
shipping_price |
配送の価格 例: |
shipping_address |
配送先住所 |
shipping_address.first_name |
配送先住所で使用される名前 |
shipping_address.company |
配送先住所の会社名 |
shipping_address.phone |
配送先住所の電話番号 |
line_items |
注文の項目すべてのリスト |
item_count |
すべてのアイテムの個数の合計 |
fulfillment_status |
注文のフルフィルメント状況。「未発送」、「一部発送済」、「発送済」のいずれか |
note |
注文に添付するメモ。お客様から入手し、管理画面のインターフェイスの注文明細画面で編集可能 |
attributes |
注文に添付する任意の属性 例: |
referring_site |
お客様をストアに誘導した参照元のURLを含む 例: |
landing_site |
お客様が使用したランディングサイトのパスを含む。お客様がストアを訪問したときに、最初に閲覧したページ 例: |
landing_site_ref |
ランディングサイトを参照し、そこから参照パラメータを抽出する。参照パラメータは、 landing_siteが {% if landing_site_ref == 'my-tracking-token' %}My action...{% endif %}
|
cancelled |
(ブーリアン) 注文がキャンセルされた場合はtrueを返す |
cancelled_at |
注文がキャンセルされた日時 |
cancel_reason |
注文がキャンセルされた理由。「在庫」、「顧客」、「不正注文」、「その他」のいずれか |
has_high_risks? |
注文のリスクが高い場合は、trueを返す |
translate="no"unique_gateways |
注文に関して固有の決済サービスのリストを返す。たとえば、Visa、Mastercard、キャッシュで支払いを行う場合、返されるリストは |
location (POS only) |
注文の実際の場所を表示する。ここにリストされている、利用可能ないくつかのロケーションプロパティがある。管理画面のロケーションエリアで場所を設定 |
order_status_url |
この注文の注文状況ページへのリンクを返す |
|
発送済の項目リスト |
|
未発送の項目リスト |
下書き注文のプロパティ
下書き注文のプロパティは、下書き注文の請求書のメールテンプレートで利用可能です。これにより、お客様に未払い請求書を通知します。
| プロパティ | 説明 |
|---|---|
id |
社内で使用する固有の下書き注文ID |
invoice_url |
Shopifyの安全なチェックアウトを使用して、請求に対して支払いを行うためにお客様が使用するリンク |
reserve_inventory_until |
下書きの項目が留保されている日付と時間の期限。たとえば、「 Liquidの日付絞り込みを使用して日付のフォーマットが可能 |
user |
下書き注文を変更した最後のスタッフ |
user.name |
最後に下書き注文を変更したスタッフの名前 |
user.email |
最後に下書き注文を変更したスタッフのメールアドレス |
| 下書き注文に関連づけられたメール | |
name |
下書き注文の固有のnumberであり、先頭に番号記号＃が付属する。 |
number |
注文のプリフィックスやサフィックスのつかない下書き注文の固有番号 |
created_at |
お客様が下書き注文を作成した日時。たとえば、 Liquidの日付絞り込みを使用して日付のフォーマットが可能 |
| tags | 注文のタグすべての配列を返す。タグはアルファベット順で返す。詳しくは、「Liquid参照ドキュメント」を参照 |
tax_price |
下書き注文のすべてのアイテムに関する税金の総計 |
tax_lines |
以下のように課税の「レベル」で分けられた税金を表す {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
|
tax_line.title |
税金の名前。たとえば、QSTやVATなど |
tax_line.price |
税金の金額 |
tax_line.rate |
小数形式での税率。たとえば、17.5%の税率のときには0.175を返す |
tax_line.rate_percentage |
パーセント形式での税率。たとえば、0.175の率のときには17.5を返す |
customer |
customer出力の属性を含むcustomerオブジェクト |
billing_address |
下書き注文の請求先住所 |
billing_address.first_name |
お客様の名前 |
billing_address.last_name |
お客様の氏名 |
billing_address.company |
請求先住所の会社名 |
billing_address.phone |
請求先住所の電話番号 |
shop.name |
ストアの名前 |
shop.phone |
ストアの電話番号 |
subtotal_price |
単位品目のディスカウントまたはカートのディスカウントが差し引かれた後の、下書き注文の単位品目価格の合計。小計には、税金 (税抜きの場合) や送料は含まれない |
discounts |
ディスカウントのリスト |
discounts_amount |
すべてのディスカウントにより適用されるディスカウント金額 (たとえば、+ 5.00ドル) |
discounts_savings |
すべてのディスカウントにより生じた削減金額 (たとえば、- 5.00ドル) |
total_price |
注文の合計 (小計+送料-配送料ディスカウント+税) |
requires_shipping |
配送が必要な下書き注文に、少なくとも1つのアイテムがある場合にtrueを返す。下書き注文に配送を必要とする商品がない場合はfalseを返す。 |
shipping_method.title |
通常配送などの配送料名 |
shipping_method.price |
配送方法の価格。shipping_priceと同じ情報を返す。 |
shipping_price |
配送の価格 Liquidの資金絞り込みを使用して、この金額をフォーマット可能 |
shipping_address |
メモ: 通常の注文とは異なり、下書き注文の配送先住所は、不完全である場合があります。 |
shipping_address.first_name |
配送先住所で使用される名前 |
shipping_address.company |
配送先住所の会社名 |
shipping_address.phone |
配送先住所の電話番号 |
line_items |
下書き注文の項目すべてのリスト |
item_count |
下書き注文の全アイテムの個数の合計 |
note |
下書き注文に添付するメモ。お客様から入手でき、管理画面の下書き注文明細画面で編集することも可能 |
location |
注文の実際の場所。利用可能ないくつかのロケーションプロパティがある 管理画面のロケーションページで場所の設定が可能 |
項目名
line_itemsリストの各lineには、以下のようなプロパティがあります。
| プロパティ | 説明 |
|---|---|
|
このアイテムに適用されるディスカウントのリスト (各ディスカウント: title、code、amount、savings、typeのプロパティ) |
|
(ブーリアン) アイテムが下書き注文のカスタム項目である場合はtrueを返す |
line.grams |
1つのアイテムの重量 |
line.image |
このアイテムに関連付けられている画像のURLを返します。img_urlフィルターを使用して特定の画像サイズを取得することもできます。例: {{ line.image | img_url: 'small' }} |
line.line_price |
アイテムの数量を乗算した価格 |
line.price |
1つのアイテムの価格 |
line.properties |
アイテムのカスタム情報の配列を返す。項目名はカートに商品を追加する前に商品ページのお客様が指定する |
line.quantity |
アイテムの数量 |
line.requires_shipping |
(ブーリアン) 商品ページで、アイテムのバリエーションにチェックが入っている「配送が必要な商品です」チェックボックスがある場合、trueを返す。 |
line.variant.sku |
商品に関連づけられたSKU |
line.taxable |
(ブーリアン) 商品ページで、アイテムのバリエーションにチェックが入っている「商品価格に税を適用する」チェックボックスがある場合は、trueを返す |
line.title |
商品の名前。後ろにダッシュ、その後にバリエーションの名前が続く。「デフォルトのタイトル」の場合はバリエーションの名前は含まれない |
line.variant.barcode |
商品に関連づけられたバーコード |
line.variant.image |
商品のバリエーションの画像項目のバリエーションに割り当てられた特定の画像がある場合は画像のみを返す |
line.product.vendor |
アイテムの販売元 |
返金のプロパティ
この追加のプロパティは、返金のメールテンプレートで利用可能です。このメールテンプレートは、(完全または一部の) 返金注文に適用したことを、お客様に通知するために使用します。以下の変数に加えて、注文メール通知のテンプレートで利用可能な変数を使用できます。
| プロパティ | 説明 |
|---|---|
amount |
返金された金額 |
refund_line_items |
返金されるRefund_line_itemのリスト |
Refund_line_itemプロパティ
refund_line_itemsリストの各refund_lineには、以下のようなプロパティがあります。
| プロパティ | 説明 |
|---|---|
refund_line.line_item |
返金が行われているline_item。すべてのline_itemのプロパティにアクセス可能 |
refund_line.quantity |
返金される項目の数量 |
フルフィルメントのプロパティ
この追加プロパティは、配送確認、配送更新、フルフィルメントのリクエストのメールテンプレートで利用可能です。
配送確認と配送更新は、注文の一部またはすべてのアイテムが正常に発送済となった、または、新しい配送情報に更新したことをお客様に通知するために使用します。
フルフィルメントのリクエストのメールテンプレートは、ストアの管理画面で定義した、カスタムフルフィルメントサービスに使用します。カスタムフルフィルメントサービスを追加するには、設定 > 配送ページと順に移動し、「フルフィルメントとドロップシッピング」のセクションまでスクロールします。
| プロパティ | 説明 |
|---|---|
service_name |
設定 > 配送ページで定義した、カスタムサービスの名前(フルフィルメントのリクエストのみ) |
fulfillment.estimated_delivery_at |
USPS、FedEx、UPS、Canada Post (カナダのみ) のいずれかの配送業者が提供する追跡番号 (利用可能な場合) に基づく、配達日の見積もり。このプロパティは、配送業者が計算した送料を使用している場合にのみ利用可能 |
fulfillment.fulfillment_line_items |
発送済になるFulfillment_line_itemsのリスト |
fulfillment.item_count |
アイテムの個数すべての合計。発送済になっているアイテムの合計数 |
fulfillment.requires_shipping |
(ブーリアン) このフルフィルメントのリクエストで配送を必要とする場合はtrueを返す |
fulfillment.tracking_company |
追跡を行っている会社 |
fulfillment.tracking_numbers |
追跡番号のリスト |
fulfillment.tracking_urls |
追跡URLのリスト |
|
特定のカスタムフルフィルメントサービスによって発送済になる項目のリストです(フルフィルメントのリクエストのみ)。 |
|
リクエストで発送済になるアイテムの合計数(フルフィルメントのリクエストのみ) |
Fulfillment_line_itemプロパティ
fulfillment_line_itemsのリストの各fulfillment_lineには、以下のようなプロパティがあります。
| プロパティ | 説明 |
|---|---|
fulfillment_line.line_item |
発送済になっているline_item。すべてのline_itemのプロパティにアクセス可能 |
fulfillment_line.quantity |
発送済になっている項目の数量 |
ディスカウントのプロパティ
| プロパティ | 説明 |
|---|---|
discounts.first.code |
お客様がディスカウントを適用するために入力するコード。複数のクーポンコードを許可する場合、ループで入力する必要あり |
discounts.first.amount |
注文の合計からディスカウントした金額 |
discounts.first.savings |
クーポンコードでお客様が節減できた金額 |
discounts.first.type |
ディスカウントのタイプ (FixedAmountDiscount、PercentageDiscount、ShippingDiscount) |
メール通知プロパティ
| プロパティ | 説明 |
|---|---|
shop.email_logo_url |
管理画面のメールテンプレートを編集セクションで指定したロゴのURL |
shop.email_logo_width |
管理画面のメールテンプレートを編集セクションで指定したロゴの幅 (ピクセル) |
shop.email_accent_color |
管理画面のメールテンプレートを編集セクションで指定したアクセントの色の16進コード |