# メールテンプレート参照変数

> STEP 2-3

メールテンプレートには変数が用意されています。変数を使うことで、それぞれのメールテンプレートに対応した内容のメールを生成できます。

すべての変数はどの通知テンプレートでも使用できますが、通知の送信時点でデータがまだ利用できない場合、一部の変数は適用できないことがあります。

※配列の中では正しく利用できない変数もあります。配列の中で変数を扱う場合は、[配列の変数](#配列の変数)の「中で使える変数」に記載された変数を参照してください。

## 変数

| プロパティ | 説明 | 例 |
| --- | --- | --- |
| `Recustomer CSS` | Recustomerが定義したCSS 削除は非推奨です（削除するとメールのレイアウトが崩れます） | |
| `mail_title` | メールの件名が入ります | 返品申請を受け付けました |
| `customer_full_name` | 購入者の姓名を表示します | 佐藤 太郎 |
| `brand_name` | カスタマイズ画面のブランド名を参照し表示します | テストブランドストア |
| `brand_logo` | カスタマイズ画面のブランドロゴを参照し表示します | https://test-store.com |
| `return_cancel_portal_url` | 返品申請画面に遷移するリンクになります | https://test.rcrm.com |
| `approval_link` | 返品承認画面に遷移するリンクになります | https://test.rcrm.com/approval=xxx |
| `current_time` | メール送信時点での現在時刻を表示します | 2023/11/10 |
| `sendback_deadline_period` | メール送信時点での返送期限を表示します | 30 |
| `order_number` | 注文番号を表示します | ABC1001 |
| `product_name` | 商品名を表示します | テスト商品 |
| `product_image` | 商品画像を表示します | https://test-image.png |
| `product_quantity` | 商品数量を表示します | 3 |
| `currency_symbol` | 購入時の通貨記号を表示します | $、￥、€ |
| `product_price` | 商品金額を表示します | 10,000 |
| `formatted_price` | 通貨記号を含むフォーマット済みの商品金額を表示します | $10.00、￥1,000 |
| `refund_content_name` | 返金の項目名を表示します | 注文時の送料 |
| `refund_content_price` | 返金の項目に対応した料金を表示します | 10,000 |
| `refund_total_price` | 返金金額を表示します | 10,000 |
| `variant_name` | 商品に紐付いているバリエーション名を表示します | サイズ |
| `variant_value` | 商品に紐付いているバリエーションの値を表示します | Mサイズ |
| `exchange_variant_value` | 交換商品に紐付いているバリエーションの値を表示します | Mサイズ |
| `interview_title` | ヒアリング項目の質問文が表示されます | 返品理由をお教えください。 |
| `interview_value` | 質問に対しての回答が表示されます | 不良品のため |
| `request_reject_text` | 返品申請を拒否した場合の拒否理由が表示されます | 商品状態が不良ではないため |
| `resolution_method` | 返品申請時に選択したご希望の対応が表示されます | 交換 |
| `item_result` | 返品承認時に選択されているご希望の対応が表示されます | 返金 |
| `send_back_method` | 返送方法名が表示されます | 佐川集荷 |
| `send_back_description` | 返送方法に対しての詳細説明が表示されます | 集荷日時： 2024年12月22日 9:00〜12:00 集荷先住所： 〒111-111 東京都港区テスト1-2-3 テストビル5F |
| `send_back_location` | 返品ロケーション名が表示されます | 返送用倉庫 |
| `send_back_zip` | 返品ロケーションの郵便番号が表示されます | 1010000 |
| `send_back_address1` | 返品ロケーションの都道府県〜町名・番地が結合された情報が表示されます | 東京都千代田区テスト１ー１ |
| `send_back_address2` | 返品ロケーションのその他住所の情報が表示されます | テストビル５階 |
| `send_back_tel` | 返品ロケーションの電話番号が表示されます | 0300000000 |
| `send_back_fee` | 「元払い（お客様負担）」もしくは「着払い（弊社負担）」が表示されます | 元払い（お客様負担） |
| `delivery_company` | 交換商品発送時に登録した配送会社を表示します | 佐川急便 |
| `tracking_number` | 交換商品発送時に登録した配送追跡番号を表示します | 100000000000 |
| `exchange_reject_text` | 交換拒否理由を表示します | 商品が申請時の内容と異なる |
| `refund_reject_text` | 返金拒否理由を表示します | 商品が申請時の内容と異なる |
| `cancel_reject_text` | キャンセル承認拒否理由を表示します | すでに出荷してしまった注文のため |
| `cancel_refund_reject_text` | キャンセル時の返金拒否理由を表示します | すでに出荷してしまった注文のため |
| `receive_reject_text` | 受取拒否理由を表示します | 商品が申請時の内容と異なる |
| `return_line_item_id` | 返品商品IDを表示します | |
| `payment_collection_url` | 差額交換のリンクを表示します | |
| `total_outstanding_amount` | 差額の請求予定金額を表示します（返金がある場合は相殺されます） | |
| `exchange_status` | 交換ステータスを表示します ・`unexchanged`：交換品が未発送 ・`exchanged`：交換品が発送済み ・`rejected`：交換品の発送を拒否 | |
| `exchange_type` | 交換種別を表示します ・`same_variation`：同一バリエーションのみ交換 ・`no_price_diff`：バリエーション交換・差額なし ・`with_price_diff`：バリエーション交換・差額あり ・`unknown`：交換種別が記録されていない | |

## 配列の変数

商品や返金項目のように複数件になりうる情報は、配列で渡されます。配列の中で使える変数は、配列ごとに決まっています。

| プロパティ | 説明 | 中で使える変数 |
| --- | --- | --- |
| `request_line_items[]` | 返品申請された商品の情報が包含された配列です | `product_image` `product_name` `product_quantity` `product_price` `variant_options[]` `interviews[]` `resolution_method` `item_result` `return_line_item_id` |
| `approval_line_items[]` | 返品承認された商品の情報が包含された配列です | `product_image` `product_name` `product_quantity` `product_price` `variant_options[]` `interviews[]` `resolution_method` `item_result` `return_line_item_id` |
| `reject_line_items[]` | 返品拒否された商品の情報が包含された配列です | `product_image` `product_name` `product_quantity` `product_price` `variant_options[]` `interviews[]` `resolution_method` `item_result` `request_reject_text` `return_line_item_id` |
| `reject_exchange_line_items[]` | 交換拒否された商品の情報が包含された配列です | `product_image` `product_name` `product_quantity` `product_price` `variant_options[]` `interviews[]` `resolution_method` `item_result` `exchange_reject_text` `return_line_item_id` |
| `exchange_line_items[]` | 交換された商品の情報が包含された配列です | `product_image` `product_name` `product_quantity` `product_price` `variant_options[]` `interviews[]` `resolution_method` `item_result` `delivery_company` `tracking_number` `exchange_status` `exchange_type` `return_line_item_id` |
| `receive_reject_line_items[]` | 受取拒否された商品の情報が包含された配列です | `product_image` `product_name` `product_quantity` `product_price` `variant_options[]` `interviews[]` `resolution_method` `item_result` `receive_reject_text` `return_line_item_id` |
| `receive_line_items[]` | 受取商品の情報が包含された配列です | `product_image` `product_name` `product_quantity` `product_price` `variant_options[]` `interviews[]` `resolution_method` `item_result` `return_line_item_id` |
| `return_expired_line_items[]` | 返送期限が切れた商品の情報が包含された配列です | `product_image` `product_name` `product_quantity` `product_price` `variant_options[]` `interviews[]` `resolution_method` `item_result` `return_line_item_id` |
| `reship_line_items[]` | 再発送済み商品の情報が包含された配列です | `product_image` `product_name` `product_quantity` `product_price` `variant_options[]` `interviews[]` `resolution_method` `item_result` `return_line_item_id` |
| `cancel_approval_line_items[]` | キャンセルが承認された商品の情報が包含された配列です | `product_image` `product_name` `product_price` `variant_options[]` |
| `cancel_reject_line_items[]` | キャンセルが拒否された商品の情報が包含された配列です | `product_image` `product_name` `product_quantity` `product_price` `variant_options[]` |
| `refund_contents[]` | この返金に指定されている返金の項目の情報が包含された配列です | `refund_content_name` `refund_content_price` |
| `cancel_refund_contents[]` | このキャンセル返金に指定されている返金項目が包含された配列です | `refund_content_name` `refund_content_price` |
| `send_back_obj[]` | 返送方法・返送ロケーション・返送料金負担が一致している商品の情報が包含された配列です | `send_back_item[]` `send_back_method` `send_back_description` `send_back_location` `send_back_zip` `send_back_address1` `send_back_address2` `send_back_tel` `send_back_fee` |
| `not_send_back_obj[]` | 返送が不要な、返送方法・返送ロケーション・返送料金負担が一致している商品の情報が包含された配列です | `product_image` `product_name` `product_quantity` `product_price` `variant_options[]` `interviews[]` `resolution_method` `item_result` |
| `remind_send_back_obj[]` | 返送リマインド対象の、返送方法・返送ロケーション・返送料金負担が一致している商品が内包されている配列です ※リマインドメールの送信時のみ使用できます | `send_back_item[]` `send_back_method` `send_back_description` `send_back_location` `send_back_zip` `send_back_address1` `send_back_address2` `send_back_tel` `send_back_fee` |
| `variant_options[]` | 商品に紐付いているバリエーションの内容が包含されている配列です | `variant_name` `variant_value` `exchange_variant_value` |
| `interviews[]` | 回答した質問がすべて包含されている配列です | `interview_title` `interview_value` |

## 注文タグによる文言の出し分け

`order_tags[]` は、注文メタフィールドにある注文タグで設定した値が包含された配列です。タグの値をそのまま表示するのではなく、`{% if %}` による文言の出し分けに使用することを想定しています。

> **「ギフト」タグが付いた注文だけに文言を出す場合**
>
> `{% if "ギフト" in order_tags %}` ギフト注文のお客様向けの文言 `{% endif %}`