알림 변수 참조

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

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

더 많은 고급 변경이나 사용자 지정 알림 템플릿 변경에 도움이 필요하면 포럼에서 커뮤니티에 연락하여 친절하고 유용한 조언을 얻을 수 있습니다. Shopify Expert를 고용하여 사용자 지정을 맡기는 것도 한 방법입니다.

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

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

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

주문 속성

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

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

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

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

<a href="{{ shop.url }}/admin/orders/{{ id }}">주문 보기</a>
email
주문과 관련된 이메일입니다.
name
일반적으로는 order_number 다음에 파운드 기호(예: 주문 #1004 )가 옵니다.
order_name
이름과 같습니다.
order_number
파운드 # 접두사가 없거나 상점 기본 설정에서 상점 소유자가 주문 ID에 추가한 접두사나 접미사가 없는 주문에 대한 상점 고유 번호(예: 1004)입니다.
created_at
고객이 주문을 생성한 날짜와 시간(예: 2009-05-30T17:43:51+02:00) 날짜 필터를 사용하여 형식을 지정할 수 있습니다.
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_ref이(가) my-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 리스트의 각 line에는 다음과 같은 속성이 있습니다.

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

할인 속성

할인 속성 설명
속성 설명
discounts.first.code
고객이 할인을 적용하기 위해 입력하는 코드입니다. 여러 할인 코드를 허용하려는 경우에는 루프로 입력해야 합니다.
discounts.first.amount
주문 총액에서 할인된 금액입니다.
discounts.first.savings
할인 코드로 인해 고객이 저장한 금액입니다.
discounts.first.type
할인 유형(고정 금액 할인, 백분율 할인 또는 배송 할인)입니다.

이메일 알림 속성

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

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

무료 체험