알림 변수 참조

스토어에서 전송된 알림은 Liquid를 사용하여 렌더링됩니다. Liquid는 Shopify의 간단하고 사용하기 쉬운 프로그래밍 언어입니다. 테마 스토어에서 테마 구축에 사용된 것과 동일한 프로그래밍 언어입니다.

스토어에서 전송된 알림을 편집하기 위해 알림 템플릿에 기본적인 사용자 지정을 설정할 수 있습니다.

고급 변경 사항이나 사용자 지정 알림 템플릿 변경에 도움이 필요한 경우 포럼에서 커뮤니티의 도움을 받거나 Shopify Expert를 고용하여 사용자 지정을 의뢰할 수도 있습니다. Shopify 전문가 고용에 대해 자세히 알아보십시오.

Shopify 관리자에서 사용자 지정할 수 있는 Liquid 알림 템플릿 목록은 다음과 같습니다.

  • 중단된 결제
  • 고객에게 연락
  • 고객 계정 초대
  • 고객 계정 환영
  • 고객 계정 비밀번호 재설정
  • 발주 주문 인보이스
  • 주문 처리 요청
  • 기프트 카드 생성됨
  • 새 주문
  • 새 주문(모바일)
  • 주문 인보이스
  • 주문 취소됨
  • 주문 확인
  • POS 및 모바일 영수증
  • 주문 환불
  • 배송 확인
  • 배송 업데이트

Shopify 관리자에 있는 모든 템플릿은 해당 주문의 속성에 액세스할 수 있습니다.

주문 속성

Liquid, 템플릿 및 추가 스크립트를 사용하여 많은 주문 속성을 직접 사용할 수 있습니다.

주문 속성은 다음 템플릿에서 사용할 수 있습니다.

  • 주문 확인
  • 새 주문
  • 새 주문(모바일)
  • 주문 인보이스
  • 배송 확인
  • 배송 업데이트
  • 추가 스크립트
  • 주문 처리 요청
주문 속성 설명
속성 설명
id

내부 사용에 대한 주문의 시스템 전체 고유 ID입니다. 이 예를 사용하여 상점의 관리자 섹션에서 주문에 대한 링크를 생성할 수 있습니다. 예를 들어 새 주문 템플릿에서는 다음 코드를 추가할 수 있습니다.

<a href="{{ shop.url }}/admin/orders/{{ id }}">주문 보기</a>
email
주문과 관련된 이메일입니다.
name

일반적으로 이는 order_number 다음에 오는 파운드 기호입니다.

예: #1004

order_name
이름과 같습니다.
order_number

파운드 # 접두사가 없거나 상점 기본 설정에서 상점 소유자가 주문 ID에 추가한 접두사나 접미사가 없는 주문에 대한 상점 고유 번호(예: 1004)입니다.

예: 1004

created_at

고객이 주문을 생성한 날짜와 시간입니다. 날짜 필터를 사용하여 이 형식을 지정할 수 있습니다.

예: 2009-05-30T17:43:51+02:00

payment_terms

결제 약관은 주문에 대한 결제 기한을 명시합니다.

주문 인보이스에 결제 약관을 추가하는 방법을 알아보십시오.

자세한 내용은 결제 약관에 대한 Liquid 참조를 참조하십시오.

tags 모든 주문 태그의 배열을 반환합니다. 태그는 알파벳순으로 반환됩니다. 자세한 내용은 Liquid 참조 문서를 참조하십시오.
transactions 주문에서 거래 배열을 반환합니다.
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
고객 출력 특성이 포함된 고객 개체입니다.
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
(부울) 배송해야 하는 주문에 품목이 하나 이상 있으면 true를 반환합니다.
shipping_method.title

배송료 이름입니다.

예: 표준 배송

shipping_method.price

배송 할인을 포함한 배송 가격입니다.

예: {{ shipping_method.price | money }}

shipping_price

배송 가격입니다.

예: {{ shipping_price | money }}

shipping_address
배송 주소입니다.
shipping_address.first_name
배송 주소의 첫 번째 이름입니다.
shipping_address.company
배송 주소의 회사 이름입니다.
shipping_address.phone
배송 주소의 전화 번호입니다.
line_items
주문의 모든 품목 목록입니다.
item_count
모든 품목 수량의 합계입니다.
fulfillment_status
주문의 현재 주문 처리 상태입니다. 주문 미처리, 주문 일부 처리, 주문 처리됨 중 하나에 해당합니다.
note
주문에 첨부된 메모입니다. 참고 사항은 고객에게 얻거나 관리자 인터페이스의 주문 세부 정보 화면에서 편집할 수 있습니다.
attributes

주문에 연결된 속성입니다.

예: {{ attributes.gift-note }}

referring_site

고객을 스토어로 유입시킨 참조 페이지의 URL을 포함합니다.

예: https://www.google.com/?s=great+products

landing_site

고객이 사용한 방문 사이트의 경로를 포함합니다. 고객이 스토어에 방문하여 본 첫 번째 페이지입니다.

예: /products/great-product?ref=my-tracking-token

landing_site_ref

방문 사이트를 살펴보고 참조 매개 변수를 추출합니다. 참조 매개 변수에는 ref, source, r이 있습니다.

landing_site/products/great-product?ref=my-tracking-token인 경우 landing_site_refmy-tracking-token이 됩니다. Ref가 특정 값과 동일한 경우 특정 작업을 수행할 수 있습니다.

{% if landing_site_ref == 'my-tracking-token' %} 내 작업... {% endif %}
cancelled
(부울) 주문이 취소된 경우 true를 반환합니다.
cancelled_at
주문이 취소된 시간입니다.
cancel_reason
주문 취소 시 선택한 사유입니다. 재고, 고객, 거부됨, 사기, 기타 중 하나에 해당합니다.
has_high_risks?
(사용되지 않음)

주문 위험성이 높은 경우 true를 반환합니다.

unique_gateways

주문에 대한 고유 결제 서비스 공급업체 목록을 반환합니다. 예를 들어 고객이 Visa, Mastercard 및 현금으로 결제한 경우에는 반품된 목록이 shopify_payments, cash이(가) 됩니다.

location (POS only)

주문의 실제 위치를 표시합니다. 여기에 나열된 여러 위치 속성을 사용할 수 있습니다. 위치는 관리자의 위치 영역에서 구성할 수 있습니다.

order_status_url

이 주문의 주문 상태 페이지로 연결되는 링크를 반환합니다.

fulfilled_line_items
(사용되지 않음)
주문 처리된 품목 목록입니다.
unfulfilled_line_items
(사용되지 않음)
완전히 주문 처리되지 않은 품목 목록입니다.
b2b?

Returns true if the order is a B2B order. Use the property with B2B variables to display relevant information, such as the company name, company location, and address in emails. For example, on B2B orders, you might add a header to a template with the following information:

{% if b2b? %}
        <p> Customer: {{ customer.name }}
        <p> Company: {{ company.name }}
        <p> Location: {{ company_location.name }}
      {endif%}
      
company

The company that you’re selling to on a B2B order.

company.name

The name of the company on a B2B order.

company.id

The ID of the company on a B2B order.

company_location

The location of the company on a B2B order. A company that buys from you can have more than one location.

company_location.name

The name of the company location on a B2B order.

company_location.id

The ID number of the company location on a B2B order.

company_location.shipping_address

The shipping addressof the company location on a B2B order.

company_location.billing_address

The billing addressof the company location on a B2B order.

Draft order properties

Draft order properties are available on the Draft Order Invoice email template, which notifies your customers about outstanding invoices.

Description of draft order properties
Property Description
id
A unique ID of the draft order for internal use.
invoice_url
A link the customer can follow to pay for the invoice using Shopify's secure checkout.
reserve_inventory_until

The date and time the line items in the draft are reserved until, for example, 2015-05-30T17:43:51+02:00.

You can format dates using the Liquid date filter.

user
The last staff who modified the draft order.
user.name
The name of the last staff who modified the draft order.
user.email
The email address of the last staff who modified the draft order.
email
The email address associated with the draft order.
name
The unique number of the draft order, prefixed by a number sign #.
number
The unique number of the draft order without the order prefix or suffix.
created_at

The date and time the customer created the draft order, for example, 2009-05-30T17:43:51+02:00.

You can format dates using the Liquid date filter.

tags Returns an array of all of the order's tags. The tags are returned in alphabetical order. Please see our Liquid reference documentation for more details.
tax_price
The combined taxes of all the items in the draft order.
tax_lines

Taxes broken up by type of tax:

{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }}
{% endfor %}
tax_line.title

The name of the tax.

Examples: QST or VAT

tax_line.price
The tax amount.
tax_line.rate
The tax rate in decimal form. For example, a tax rate of 17.5% will return 0.175.
tax_line.rate_percentage
The tax rate in percentage form. For example, a rate of 0.175 will return 17.5.
customer
Customer object containing the attributes of the customer output.
billing_address
The billing address for the draft order.
billing_address.first_name
The customer's first name.
billing_address.last_name
The customer's last name.
billing_address.company
The company name in the billing address.
billing_address.phone
The phone number in the billing address.
shop.name
The name of your store.
shop.phone
Your store's phone number.
subtotal_price
Sum of the draft order's line-item prices after any line-item discount or cart discount has been deducted. The subtotal doesn't include taxes (unless taxes are included in the prices) or shipping costs.
discounts
A list of discounts.
discounts_amount

Amount of the discount applied by all discounts.

Example: +$5.00

discounts_savings

Amount of the savings caused by all discounts.

Example: -$5.00

total_price
The total price of the order (subtotal + shipping cost - shipping discount + tax).
requires_shipping
Returns true if there is at least one item in the draft order that requires shipping. Returns false if no items in the draft order require shipping.
shipping_method.title

The Shipping rate name.

Example: Standard Shipping

shipping_method.price
The price of the shipping method. Returns the same information as shipping_price.
shipping_price

The shipping price.

You can format this amount using Liquid money filters.

shipping_address

The shipping address.

Note: Unlike in regular orders, a draft order's shipping address may be incomplete.

shipping_address.first_name
The first name for the shipping address.
shipping_address.company
The company name in the shipping address.
shipping_address.phone
The phone number in the shipping address.
line_items
A list of all line items in the draft order.
item_count
A sum of all the item quantities in the draft order.
note
The note attached to the draft order. The note can be obtained from the customer and also edited in the draft order detail screen in your Shopify admin.
location

The physical location of the order. There are several location properties available.

You can configure locations in the Locations page of your Shopify admin.

b2b?

Returns true if the order is a B2B order. Use the property with B2B variables to display relevant information, such as the company name, company location, and address in emails. For example, on B2B orders, you might add a header to a template with the following information:

{% if b2b? %}
        <p> Customer: {{ customer.name }}
        <p> Company: {{ company.name }}
        <p> Location: {{ company_location.name }}
      {endif%}
      
company

The company that you’re selling to on a B2B order.

company.name

The name of the company on a B2B order.

company.id

The ID of the company on a B2B order.

company_location

The location of the company on a B2B order. A company that buys from you can have more than one location.

company_location.name

The name of the company location on a B2B order.

company_location.id

The ID number of the company location on a B2B order.

company_location.shipping_address

The shipping addressof the company location on a B2B order.

company_location.billing_address

The billing addressof the company location on a B2B order.

Line item properties

Each line in the list of line_items or subtotal_line_items has the following properties.

Description of line item properties
Property Description
line.applied_discounts
(POS and draft orders only)
List of discounts applied to this item (each discount has the title, code, amount, savings and type properties).
line.custom
(Draft orders only)
(boolean) Returns true if the item is a custom line item for a draft order.
line.grams
Weight of a single item.
line.image
Returns the URL of the image associated with this line item. You can also use the img_url filter to get specific image sizes, for example {{ line.image | img_url: 'small' }}
line.line_price
The price multiplied by the quantity for that item.
line.original_line_price
The combined price of the quantity of items included in the line, before discounts were applied.
line.final_line_price
The combined price of all the items in the line item, including all line level discount amounts.
line.price
The price for a single item.
line.product.metafields

The Metafields at the product level. Use the following syntax:

line.product.metafields.NAMESPACE.KEY

line.product.title
The name of the product.
line.product.vendor
The vendor for the item.
line.properties
Returns an array of custom information for an item. Line item properties are specified by the customer on the product page, before adding a product to the cart.
line.quantity
Quantity for that item.
line.requires_shipping
(boolean) Returns true if the variant for the item has the checkbox This is a physical product checked on the product page.
line.selling_plan_allocation
Returns a selling_plan_allocation object, which describes how a selling plan such as a subscription impacts the line item.
line.taxable
(boolean) Returns true if the variant for the item has the checkbox 'Charge taxes on this product' checked on the product page.
line.title
The name of the product followed by a dash followed by the name of the variant. The variant name isn't included when it is “Default Title”.
line.url
The relative URL of the line item's variant. The relative URL doesn't include your store's root URL (mystore.myshopify.com).
line.line_item.variant.barcode
The barcode associated with the product variant.
line.variant.compare_at_price
The compare at price associated with the product variant.
line.variant.image
The image for the product variant. Only returns an image if there is a specific image assigned to the variant in the line item.
line.variant.metafields

The Metafields at the variant level. Use the following syntax:

line.variant.metafields.NAMESPACE.KEY

line.variant.sku
The SKU associated with the product variant.
line.variant.title

The variant's option values, joined by / characters.

Example: small / red

line.refunded.quantity 
      
(within refund notifications)

The quantity of an item to be refunded. You can use this property to add an identifier to refunded items in an order.

For example: {% if line.refunded_quantity > 0 %}Refunded line identifier{% endif %}

Refunds properties

These additional properties are available on the Refunds email template. This email template is used to notify your customers that a refund (complete or partial) has been applied to their order. You can use any variable available for the Order email notification template, in addition to the following variables:

Description of refunds properties
Property Description
amount
The amount of money refunded.
refund_line_items
A list of refund line items to be refunded.

Refund_line_item properties

Each refund_line in the list of refund_line_items has the following properties:

Description of refund line item properties
Property Description
refund_line.line_item
The line_item that is being refunded. This has access to all the line_item’s properties.
refund_line.quantity
The quantity of the line item to be refunded.

Fulfillment properties

These additional properties are available on the Shipping confirmation, Shipping update and Fulfillment request email templates.

The Shipping confirmation and Shipping update are used to notify your customers that some or all items in their order have been successfully fulfilled, or updated with new shipping information.

The Fulfillment request email template is used for any custom fulfillment service defined in your shop admin. To add a custom fulfillment service, go to Settings > Shipping and scroll down to Fulfillment/Dropshipping.

Description of fulfillment properties
Property Description
service_name
The name of the custom service as defined in the Settings > Shipping page. (Fulfillment request only)
fulfillment.estimated_delivery_at
An estimated delivery date based on the tracking number (if available) provided by one of the following carriers: USPS, FedEx, UPS, Canada Post (Canada only). This property is only available when carrier-calculated rates are in use.
fulfillment.fulfillment_line_items
A list of fulfillment line items to be fulfilled.
fulfillment.item_count
A sum of all the items' quantities. The total number of items being fulfilled.
fulfillment.requires_shipping
(boolean) Returns true if this fulfillment request requires shipping.
fulfillment.tracking_company
The company doing the tracking.
fulfillment.tracking_numbers
A list of tracking numbers.
fulfillment.tracking_urls
A list of tracking URLs.
items_to_fulfill
(deprecated)
A list of line items that are to be fulfilled by this particular custom fulfillment service. (Fulfillment request only)
items_to_fulfill_count
(deprecated)
The total number of items to be fulfilled by this request. (Fulfillment request only)

Fulfillment_line_item properties

Each fulfillment_line in the list of fulfillment_line_items has the following properties.

Description of fulfillment line item properties
Property Description
fulfillment_line.line_item
The line_item being fulfilled. This has access to all the line_item's properties.
fulfillment_line.quantity
The quantity of the line item that is being fulfilled.

Delivery properties

Description of delivery properties
Property Description
delivery_instructions
Local delivery information to share with the customer. This information is controlled by the Delivery information field in your local delivery settings.
consolidated_estimated_delivery_time
Order delivery dates information to share with the customer. This information is controlled by the Processing time setting that you set up in your Shipping and delivery page.

Discount properties

There are two types of discount properties.

discount_applications describe why and how an item was discounted.

discount_allocations describe how a particular discount affects a line item and how it reduces the price. You should use this property at the line item level.

You can combine these properties to display discount information at the line item or order level.

Example

This example checks if a discount has been applied to the line item. If the discount wasn't applied at the order level (all), then the discount name and amount are displayed.

{% if line.discount_allocations %}
    {% for discount_allocation in line.discount_allocations %}
        {% if discount_allocation.discount_application.target_selection != 'all' %}
            {{ discount_allocation.discount_application.title | upcase }}
            (-{{ discount_allocation.amount | money }})
        {% endif %}
    {% endfor %}
{% endif %}

The result might look like this:

SPRING5 (-$5.00)

Discount_allocation properties

Each discount_allocation in the list of discount_allocations has the following properties.

Description of discount_allocation properties
Property Description
discount_allocation.amount
The amount of money saved by the customer on a line item. Must be entered in a loop if you want to allow multiple discount codes.
discount_allocation.discount_application
The discount application that allocates the amount on the line item.

Discount_application properties

Each discount_application in the list of discount_applications has the following properties.

Description of discount_application properties
Property Description
discount_application.target_selection

Describes how a discount selects line items in the cart to be discounted. One of:

  • all: The discount applies to all line items.
  • entitled: The discount applies to a particular subset of line items, often defined by a condition.
  • explicit: The discount applies to a specifically selected line item or shipping line.
discount_application.target_type
The type of item that a discount applies to (line_item or shipping_line).
discount_application.title

The customer-facing name of the discount.

Examples: Welcome10 or CBBWQQAKYBYY

discount_application.total_allocated_amount
The total amount that the price of an order is reduced by the discount.
discount_application.type
The type of the discount. One of: automatic, discount_code, manual, or script.
discount_application.value
The value of the discount.
discount_application.value_type
The value type of the discount. One of: fixed_amount or percentage.

Email notification properties

Description of email notification properties
Property Description
shop.email_logo_url
The url for the logo specified in the Customize email templates section of the admin.
shop.email_logo_width
The logo width (pixels) specified in the Customize email templates section of the admin.
shop.email_accent_color
The HEX code for the accent color specified in the Customize email templates section of the admin.

Shopify와 함께 사업을 시작할 준비가 되셨습니까?

무료 체험