알림 변수 참조

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

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

고급 변경 사항이나 사용자 지정 알림 템플릿 변경에 도움이 필요한 경우 포럼에서 커뮤니티의 도움을 받거나 Shopify Expert를 고용하여 사용자 지정을 의뢰할 수도 있습니다.

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를 반환합니다.

translate="no"
unique_gateways

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

location (POS only)

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

order_status_url

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

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

발주 주문 속성

발주 주문 속성은 발주 주문 인보이스 이메일 템플릿에서 사용할 수 있으며, 이를 통해 고객에게 미결제 인보이스 관련 정보를 알려줍니다.

발주 주문 속성에 대한 설명
속성 설명
id
내부 사용에 대한 발주 주문의 고유 ID입니다.
invoice_url
고객이 Shopify 안전 결제를 사용하여 인보이스를 결제할 때 따라가는 링크입니다.
reserve_inventory_until

발주 주문 품목이 예약된 날짜와 시간입니다(예: 2015-05-30T17:43:51+02:00).

Liquid 날짜 필터를 사용하여 날짜 형식을 지정할 수 있습니다.

user
발주 주문을 마지막으로 수정한 직원입니다.
user.name
발주 주문을 마지막으로 수정한 직원의 이름입니다.
user.email
발주 주문을 마지막으로 수정한 직원의 이메일 주소입니다.
email
발주 주문과 연관된 이메일 주소입니다.
name
숫자 기호 #을 접두사로 사용하는 발주 주문의 고유 number입니다.
number
주문 접두사나 접미사가 없는 발주 주문의 고유 번호입니다.
created_at

고객이 발주 주문을 생성한 날짜와 시간입니다(예: 2009-05-30T17:43:51+02:00).

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
고객 출력 특성이 포함된 고객 개체입니다.
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
배송해야 하는 발주 주문에 품목이 하나 이상 있으면 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
발주 주문에 첨부된 메모입니다. 참고 사항은 고객에게 얻을 수 있으며 해당 메모는 Shopify 관리자의 발주 주문 세부 정보 화면에서 편집할 수도 있습니다.
location

주문의 실제 위치입니다. 여러 위치 속성을 사용할 수 있습니다.

Shopify 관리자의 위치 페이지에서 위치를 구성할 수 있습니다.

품목 속성

line_items 또는 subtotal_line_items 목록에 있는 각 line에는 다음과 같은 속성이 있습니다.

품목 속성 설명
속성 설명
line.applied_discounts
(POS 및 발주 주문에만 해당)
이 품목에 적용된 할인 목록입니다(각 할인에는 제목 코드 금액 할인유형 속성이 있음).
line.custom
(발주 주문 전용)
(부울) 품목이 발주 주문에 대한 사용자 지정 품목인 경우 true를 반환합니다.
line.grams
단일 품목 중량입니다.
line.image
이 품목에 연결된 이미지의 URL을 반환합니다. img_url 필터를 사용하여 특정 이미지 사이즈(예: {{ line.image | img_url: 'small' }})를 가져올 수도 있습니다.
line.line_price
해당 품목의 수량에 가격을 곱한 값입니다.
line.original_line_price
할인이 적용되기 전에 품목에 포함된 품목 수량을 합산한 가격입니다.
line.final_line_price
모든 품목 수준의 할인 금액을 포함한 품목의 모든 품목을 합산한 가격입니다.
line.price
단일 품목 가격입니다.
line.product.metafields

제품 수준의 메타 필드입니다. 다음 구문을 사용하십시오.

line.product.metafields.NAMESPACE.KEY

line.product.title
제품의 이름입니다.
line.product.vendor
품목에 대한 공급업체입니다.
line.properties
품목에 대한 사용자 지정 정보 배열을 반환합니다. 품목 속성은 카트에 제품을 추가하기 전에 제품 페이지에서 고객이 지정합니다.
line.quantity
해당 품목 수량입니다.
line.requires_shipping
(부울) 제품 페이지에 품목의 이형 상품 확인란인 실제 제품입니다.가 선택된 경우 true를 반환합니다.
line.selling_plan_allocation
구독과 같은 판매 플랜이 품목에 어떤 영향을 미치는지 설명하는 selling_plan_allocation 객체를 반환합니다.
line.taxable
(부울) 제품 페이지에서 품목에 대한 이형 상품의 확인란인 '이 제품에 세금 부과' 확인란이 선택된 경우 true를 반환합니다.
line.title
이형 상품 이름 뒤에 대시, 제품 이름이 차례로 입력됩니다. 이형 상품 이름은 "기본 제목"인 경우 포함되지 않습니다.
line.url
품목의 이형 상품에 대한 상대 URL입니다. 상대 URL은 스토어의 루트 도메인(mystore.myshopify.com)을 포함하지 않습니다.
line.line_item.variant.barcode
이형 상품과 관련된 바코드입니다.
line.variant.compare_at_price
제품 이형과 연관된 가격 비교입니다.
line.variant.image
제품 이형에 대한 이미지입니다. 품목 내 이형 상품에 할당된 특정 이미지가 있는 경우에만 이미지를 반환합니다.
line.variant.metafields

이형 상품 수준의 메타 필드입니다. 다음 구문을 사용하십시오.

line.variant.metafields.NAMESPACE.KEY

line.variant.sku
제품 이형과 연관된 SKU(재고 관리 코드)입니다.
line.variant.title

/ 문자로 연결되는 이형 상품의 옵션 값입니다.

예: 소형/빨간색

환불 속성

이러한 추가 속성은 환불 이메일 템플릿에서 사용할 수 있습니다. 이 이메일 템플릿을 사용하여 주문에 환불 (전체 또는 일부)을 적용했음을 고객에게 알릴 수 있습니다. 다음 변수 외에도 주문 이메일 알림 템플릿에 사용 가능한 변수를 사용할 수 있습니다.

환불 속성 설명
속성 설명
amount
환불된 금액입니다.
refund_line_items
환불 예정인 환불 품목 목록입니다.

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.item_count
모든 품목 수량의 합계입니다. 주문 처리 중인 총 품목 수입니다.
fulfillment.requires_shipping
(부울) 주문 처리 요청에 배송이 필요한 경우 true를 반환합니다.
fulfillment.tracking_company
추적을 수행하는 회사입니다.
fulfillment.tracking_numbers
추적 번호 목록입니다.
fulfillment.tracking_urls
추적 URL 목록입니다.
items_to_fulfill
(사용되지 않음)
이 특정 사용자 지정 주문 처리 서비스를 통해 주문 처리될 품목 목록입니다. (주문 처리 요청 전용)
items_to_fulfill_count
(사용되지 않음)
이 요청에서 주문 처리될 총 품목 수입니다(주문 처리 요청 전용).

Fulfillment_line_item 속성

fulfillment_line_items 목록에 있는 각 fulfillment_line에는 다음과 같은 속성이 있습니다.

주문 처리 품목 속성 설명
속성 설명
fulfillment_line.line_item
처리 중인 line_item입니다. 이는 line_item의 모든 속성에 액세스할 수 있습니다.
fulfillment_line.quantity
처리 중인 품목의 수량입니다.

배송 속성

배송 속성 설명
속성 설명
delivery_instructions
고객과 공유할 지역 배송 정보입니다. 이 정보는 지역 배송 설정배송 정보 필드에서 제어합니다.

할인 속성

할인 속성에는 두 가지 유형이 있습니다.

discount_applications은(는) 품목이 할인된 사유 및 방식을 설명합니다.

discount_allocations은(는) 특정 할인이 품목에 미친 영향 및 가격이 할인된 방식을 설명합니다. 이 속성은 품목 수준에서 사용해야 합니다.

이러한 속성을 결합하여 품목 또는 주문 수준에서 할인 정보를 표시할 수 있습니다.

이 예는 품목에 할인이 적용되었는지 확인합니다. 할인이 주문 수준(all)에서 적용되지 않은 경우 할인 이름 및 금액이 표시됩니다.

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

결과는 다음과 같이 표시될 수 있습니다.

SPRING5 (-$5.00)

Discount_allocation 속성

discount_allocations 목록에 있는 각 discount_allocation에는 다음과 같은 속성이 있습니다.

Discount_application 속성 설명
속성 설명
discount_allocation.amount
고객이 품목에 저장한 금액입니다. 여러 할인 코드를 허용하려는 경우 루프로 입력해야 합니다.
discount_allocation.discount_application
품목에 금액을 할당하는 할인 적용입니다.

Discount_application 속성

discount_applications 목록에 있는 각 discount_application에는 다음과 같은 속성이 있습니다.

Discount_application 속성
속성 설명
discount_application.target_selection

할인이 적용될 카트의 품목이 할인 대상으로 선택되는 방식을 설명합니다.

  • all: 모든 품목에 할인이 적용됩니다.
  • entitled: 품목의 특정 하위 집합에 할인이 적용되며, 보통 조건에 의해 정의됩니다.
  • explicit: 특별히 선택된 품목 또는 배송 라인에 할인이 적용됩니다.
discount_application.target_type
할인이 적용되는 품목의 유형입니다(line_item 또는 shipping_line).
discount_application.title

할인에 대한 고객용 명칭입니다.

예: Welcome10 또는 CBBWQQAKYBYY

discount_application.total_allocated_amount
할인으로 인해 감소된 주문 가격의 총 금액입니다.
discount_application.type
할인 유형입니다. 자동, discount_code, 수동, 스크립트 중 하나에 해당합니다.
discount_application.value
할인의 값입니다.
discount_application.value_type
할인의 값 유형입니다. fixed_amount 또는 백분율 중 하나에 해당합니다.

이메일 알림 속성

이메일 알림 속성 설명
속성 설명
shop.email_logo_url
관리자의 이메일 템플릿 사용자 지정 섹션에 지정된 로고의 URL입니다.
shop.email_logo_width
관리자의 이메일 템플릿 사용자 지정 섹션에 지정된 로고 폭(픽셀)입니다.
shop.email_accent_color
관리자의 이메일 템플릿 사용자 지정 섹션에 지정된 강조 색상의 HEX 코드입니다.

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

무료 체험