알림 변수 참조
스토어에서 발송되는 알림은 Liquid를 사용하여 렌더링됩니다. Liquid는 Shopify의 간단하고 사용하기 쉬운 프로그래밍 언어입니다. Theme Store의 테마가 빌드되는 것과 동일한 프로그래밍 언어입니다.
스토어에서 발송되는 알림을 편집하려면 알림 템플릿을 기본적으로 맞춤 설정할 수 있습니다. 맞춤 설정할 수 있는 알림의 전체 목록에 액세스하려면 Shopify 관리자의 알림 페이지로 이동하십시오.
더 고급 변경에 대한 도움이 필요하거나 사용자 지정 알림 템플릿을 변경하려면 포럼의 커뮤니티에 문의하거나 Shopify 파트너를 고용하여 맞춤 설정을 의뢰할 수 있습니다. Shopify 파트너 고용에 대해 자세히 알아보십시오.
이 페이지의 내용
주문 속성
주문의 여러 속성은 Liquid를 사용하여 템플릿에서 직접 사용할 수 있습니다.
| 속성 | 설명 |
|---|---|
id |
내부용으로 사용되는 주문의 시스템 전체 고유 ID입니다. 다음 예시를 사용하여 스토어 관리자에서 주문으로 연결되는 링크를 생성하십시오. 예를 들어 새 주문 템플릿에 다음 코드를 추가할 수 있습니다. 주문 보기
|
email | 주문과 연결된 이메일입니다. |
name |
일반적으로 파운드 기호(#)와 예: #1004 |
order_name | name과 동일합니다. |
order_number |
파운드 # 접두사나 스토어 소유자가 스토어 기본 설정에서 주문 ID에 추가한 접두사 또는 접미사가 없는 스토어의 고유한 주문 번호입니다. 예: 1004 |
confirmation_number | 순차적 주문 이름 대신 고객에게 표시될 수 있는, 무작위로 생성된 영숫자 식별자입니다. 이 값은 고유하다고 보장되지 않습니다. 예: XPAV284CT |
created_at |
고객이 주문을 생성한 날짜 및 시간입니다. 날짜 필터를 사용하여 형식을 지정할 수 있습니다. 예: 2009-05-30T17:43:51+02:00 |
payment_terms |
결제 조건은 주문에 대한 결제 기한 날짜를 지정합니다. 주문 인보이스에 결제 조건을 추가하는 방법에 대해 알아보세요. 자세한 내용은 payment_terms에 대한 Liquid 참조를 확인하세요. |
destination | 품목을 보내야 하는 목적지입니다. |
tags | 주문의 모든 태그 배열을 반환합니다. 태그는 알파벳 순으로 반환됩니다. Shopify Collective 태그와 같이 앱 또는 플랫폼 기능에 의해 동적으로 적용되는 태그는 알림 이메일 생성 시 사용하지 못할 수 있습니다. 특정 기능의 품목을 감지하려면 대신 각 품목의 제품 수준 태그를 확인하십시오. 자세한 내용은 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 | 현재 결제 상태입니다. nil, pending, authorized, paid, voided, refunded 중 하나입니다. |
requires_shipping | (부울) 주문에 배송이 필요한 품목이 하나 이상 있는 경우 true를 반환합니다. |
shipping_method.title | 배송료 이름입니다. 고객용 알림에서 고객이 결제 시 사용한 언어가 스토어의 기본 언어와 다른 경우 배송료 이름이 해당 언어로 번역됩니다. 예: 표준 배송 |
shipping_method.price |
배송 할인이 포함된 배송비입니다. 예: |
shipping_price |
배송비입니다. 예: |
shipping_address | 배송 주소입니다. |
shipping_address.first_name | 배송 주소의 이름입니다. |
shipping_address.company | 배송 주소의 회사 이름입니다. |
shipping_address.phone | 배송 주소의 전화번호입니다. |
line_items | 주문에 있는 모든 품목의 목록입니다. |
line_items_including_zero_quantity | 수량이 0인 품목을 포함한, 주문의 모든 품목 목록입니다. 품목이 전액 환불되면 수량이 0이 됩니다. |
line_item_groups(Orders and POS only) | 주문에서 품목 구성 요소를 포함하는 모든 품목 그룹 목록입니다. |
item_count | 모든 품목 수량의 합계입니다. |
fulfillment_status | 주문의 현재 주문 처리 상태입니다. unfulfilled, partial, fulfilled 중 하나입니다. |
note | 주문에 첨부된 참고 사항입니다. 참고 사항은 고객에게서 받거나 관리자 패널의 주문 세부 정보 화면에서 편집할 수 있습니다. |
attributes |
주문에 첨부된 모든 특성입니다. 예: |
metafields |
주문의 모든 메타 필드입니다. 다음 구문을 사용하십시오. metafields.NAMESPACE.KEY |
referring_site |
고객을 스토어로 유도한 참조 페이지의 URL을 포함합니다. 예: |
landing_site |
고객이 사용한 랜딩 사이트의 경로를 포함합니다. 이는 고객이 스토어에 도달했을 때 처음 본 페이지입니다. 예: |
landing_site_ref |
랜딩 사이트를 검토하고 참조 매개변수를 추출합니다. 참조 매개변수는
{% if landing_site_ref == 'my-tracking-token' %}
My action...
{% endif %}
|
cancelled | (부울) 주문이 취소된 경우 true를 반환합니다. |
cancelled_at | 주문이 취소된 시간입니다. |
cancel_reason | 주문을 취소할 때 선택한 사유입니다. inventory, customer, declined, fraud, other 중 하나입니다. |
has_high_risks?(deprecated) | 주문에 위험도가 높은 경우 true를 반환합니다. |
unique_gateways |
주문의 고유 결제 서비스 공급업체 목록을 반환합니다. 예를 들어 Visa, Mastercard, 현금으로 결제한 경우 반환되는 목록은 다음과 같습니다. |
location(POS only) |
주문의 실제 위치를 표시합니다. 사용 가능한 몇 가지 위치 속성이 있으며 여기에 목록이 나와 있습니다. 관리자의 위치 영역에서 위치를 구성할 수 있습니다. |
order_status_url |
이 주문의 상태 페이지 링크를 반환합니다. |
fulfilled_line_items(deprecated) | 주문 처리된 품목 목록입니다. |
unfulfilled_line_items(deprecated) | 완전히 주문 처리되지 않은 품목 목록입니다. |
b2b? |
주문이 B2B 주문인 경우 true를 반환합니다. 이 속성을 B2B 변수와 함께 사용하여 회사 이름, 회사 위치, 주소와 같은 관련 정보를 이메일에 표시할 수 있습니다. 예를 들어, B2B 주문의 경우 다음과 같은 정보가 포함된 머리글을 템플릿에 추가할 수 있습니다.
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | B2B 주문에서 판매하는 대상인 회사입니다. |
company.name | B2B 주문에 있는 회사의 이름입니다. |
company.id | B2B 주문에 있는 회사의 ID입니다. |
company_location | B2B 주문에 있는 회사의 위치입니다. 구매하는 회사는 둘 이상의 위치를 가질 수 있습니다. |
company_location.name | B2B 주문에 있는 회사 위치의 이름입니다. |
company_location.id | B2B 주문에 있는 회사 위치의 ID 번호입니다. |
company_location.shipping_address | B2B 주문에 있는 회사 위치의 배송 주소입니다. |
company_location.billing_address | B2B 주문에 있는 회사 위치의 청구 주소입니다. |
customer_order_url | 고객이 고객 계정을 사용하여 반품을 요청한 주문의 새 주문 상태 페이지입니다. |
발주 주문 속성
| 속성 | 설명 |
|---|---|
id | 내부용으로 사용되는 발주 주문의 고유 ID입니다. |
invoice_url | 고객이 Shopify의 안전 체크아웃을 사용하여 인보이스를 결제할 때 사용할 수 있는 링크입니다. |
reserve_inventory_until |
발주 주문의 품목이 예약되는 날짜 및 시간입니다(예: Liquid 날짜 필터를 사용하여 날짜 형식을 지정할 수 있습니다. |
user | 발주 주문을 마지막으로 수정한 담당자입니다. |
user.name | 발주 주문을 마지막으로 수정한 담당자의 이름입니다. |
user.email | 발주 주문을 마지막으로 수정한 담당자의 이메일 주소입니다. |
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 | 백분율 형식의 세율입니다. 예를 들어 rate가 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 | 주문의 총 가격입니다(소계 + 배송비 - 배송 할인 + 세금). |
amount_due_now | 발주 주문 인보이스에서 요구하는 금액입니다. |
requires_shipping | 반환: true 발주 주문에 배송이 필요한 품목이 하나 이상 있는 경우. 반환: false 발주 주문에 배송이 필요한 품목이 없는 경우. |
shipping_method.title | 배송료 이름입니다. 예: 표준 배송 |
shipping_method.price | 배송 방법의 가격입니다. 다음과 동일한 정보를 반환합니다. shipping_price으로 구성됩니다. |
shipping_price |
배송비입니다. Liquid money 필터를 사용하여 이 금액의 형식을 지정할 수 있습니다. |
shipping_address |
배송 주소입니다. 참고: 일반 주문과 달리 발주 주문의 배송 주소는 불완전할 수 있습니다. |
shipping_address.first_name | 배송 주소의 이름입니다. |
shipping_address.company | 배송 주소에 있는 회사 이름입니다. |
shipping_address.phone | 배송 주소에 있는 전화번호입니다. |
line_items | 발주 주문에 있는 모든 품목의 목록입니다. |
item_count | 발주 주문에 있는 모든 품목 수량의 합계입니다. |
note | 발주 주문에 첨부된 참고 사항입니다. 참고 사항은 고객에게서 받을 수 있으며 Shopify 관리자의 발주 주문 세부 정보 화면에서도 편집할 수 있습니다. |
metafields |
발주 주문의 모든 메타 필드입니다. 다음 구문을 사용합니다. metafields.NAMESPACE.KEY |
location |
주문의 실제 위치입니다. 사용 가능한 여러 위치 속성이 있습니다. Shopify 관리자의 위치 페이지에서 위치를 구성할 수 있습니다. |
b2b? |
주문이 B2B 주문인 경우 true를 반환합니다. 이 속성을 B2B 변수와 함께 사용하여 회사 이름, 회사 위치, 주소와 같은 관련 정보를 이메일에 표시할 수 있습니다. 예를 들어, B2B 주문의 경우 다음과 같은 정보가 포함된 머리글을 템플릿에 추가할 수 있습니다.
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | B2B 주문에서 판매하는 대상인 회사입니다. |
company.name | B2B 주문에 있는 회사의 이름입니다. |
company.id | B2B 주문에 있는 회사의 ID입니다. |
company_location | B2B 주문에 있는 회사의 위치입니다. 구매하는 회사는 둘 이상의 위치를 가질 수 있습니다. |
company_location.name | B2B 주문에 있는 회사 위치의 이름입니다. |
company_location.id | B2B 주문에 있는 회사 위치의 ID 번호입니다. |
company_location.shipping_address | B2B 주문에 있는 회사 위치의 배송 주소입니다. |
company_location.billing_address | B2B 주문에 있는 회사 위치의 청구 주소입니다. |
payment_methods | 발주 주문의 총액을 처리하는 데 사용할 수 있는 저장된 결제 방법 목록입니다. |
payment_method.payment_instrument | 저장된 결제 방법에 대한 세부 정보가 포함된 결제 수단입니다. |
payment_method.payment_instrument.payment_type | 저장된 결제 방법 유형입니다. 예: “credit_card, apple_pay” |
payment_method.payment_instrument.credit_card_brand | `payment_type`이 “credit_card”인 경우의 카드 브랜드 |
payment_method.payment_instrument.credit_card_company | `payment_type`이 “credit_card”인 경우의 카드사 |
payment_method.payment_instrument.credit_card_company | `payment_type`이 “credit_card”인 경우의 카드 마지막 4자리 숫자 |
결제 일정 속성
| 속성 | 설명 |
|---|---|
payment_schedule.amount_due |
결제 일정에 대해 결제할 금액입니다. Liquid money 필터를 사용하여 통화로 금액 서식을 지정할 수 있습니다. |
payment_schedule.due_at |
결제 일정의 결제 기한입니다. Liquid 날짜 필터를 사용하여 날짜 형식을 지정할 수 있습니다. |
payment_schedule.due_in_days |
결제 일정이 아직 결제되지 않은(미결제) 경우 결제 기한까지 남은 일수입니다. |
payment_schedule.due_later? |
결제 일정이 결제되지 않았고 결제 기한이 아직 남은 경우 true를 반환합니다. |
payment_schedule.number_of_days_overdue? |
결제 일정이 연체된 경우 결제 기한으로부터 경과한 일수입니다. |
payment_schedule.overdue? |
결제 일정이 결제되지 않았고 결제 기한이 지난 경우 true를 반환합니다. |
결제 상태 속성
| 속성 | 설명 |
|---|---|
has_pending_payment |
(부울) 주문에 보류 중인 결제가 포함된 거래가 있는 경우 true를 반환합니다. 보류 중인 결제에 대해 자세히 알아보세요. |
buyer_action_required |
(부울) 주문에 보류 중인 결제가 포함된 거래가 있고 결제 차단을 해제하기 위해 구매자 조치가 필요한 경우 true를 반환합니다. 이 값이 true를 반환하고 결제 방법에 결제 지침이 지원되는 경우, Liquid 거래 객체에 대해 자세히 알아보세요. |
번들 구성 요소 속성
line_item.bundle_components 목록의 각 bundle_component에는 다음 속성이 있습니다. (발주 주문에만 해당)
| 속성 | 설명 |
|---|---|
bundle_component.image_url | 번들 구성 요소의 이미지 URL입니다. |
bundle_component.product.title | 번들 구성 요소 제품의 제목입니다. |
bundle_component.quantity | 번들 구성 요소의 수량입니다. |
bundle_component.variant.title |
예: 스몰 / 빨간색 |
구성 요소 속성
`line_item.components` 목록의 각 `component`에는 다음 속성이 있습니다. (중단된 체크아웃에만 해당) `
| 속성 | 설명 |
|---|---|
component.image_url | 구성 요소의 이미지 URL입니다. |
component.product.title | 구성 요소 제품의 제목입니다. |
component.quantity | 구성 요소의 수량입니다. |
component.variant.title |
예: 스몰 / 빨간색 |
품목 속성
line_items 또는 subtotal_line_items 목록의 각 line에는 다음 속성이 있습니다.
| 속성 | 설명 |
|---|---|
line.applied_discounts(POS and draft orders only) | 이 품목에 적용된 할인 목록입니다(각 할인에는 title, code, amount, savings, type 속성이 있음). |
line.bundle_components(Draft orders only) | 이 품목의 번들 구성 요소인 품목 목록입니다. 이 품목이 번들 제품인 경우에만 목록을 반환합니다. |
line.bundle_parent?(Draft orders only) | (부울) 품목이 번들 제품인 경우 true를 반환합니다. |
line.components(Abandoned checkout only) | 이 품목의 구성 요소인 품목 목록입니다. |
line.parent?(Abandoned checkout only) | (부울) 품목에 구성 요소가 있는 경우 true를 반환합니다. |
line.custom(Draft orders only) | (부울) 품목이 발주 주문의 사용자 지정 품목인 경우 true를 반환합니다. |
line.delivery_agreement | 이 품목과 연결된 배송 계약입니다. |
line.grams | 단일 품목의 무게입니다. |
line.groups | 품목의 품목 그룹입니다. |
line.image | 이 품목과 연결된 이미지의 URL을 반환합니다. img_url 필터를 사용하여 특정 이미지 크기를 가져올 수도 있습니다(예: {{ line.image | img_url: 'small' }}). |
line.line_price | 해당 품목의 가격에 수량을 곱한 값입니다. |
line.original_line_price | 할인이 적용되기 전 품목에 포함된 수량의 합산 가격입니다. |
line.final_line_price | 모든 품목 수준 할인액을 포함하여 품목에 포함된 모든 품목의 합산 가격입니다. |
line.pre_tax_price | 품목의 세전 가격에 구매한 품목의 수량을 곱한 값입니다. |
line.price | 단일 품목의 가격입니다. |
line.product.metafields | 제품 수준의 모든 메타 필드입니다. 다음 구문을 사용하십시오. line.product.metafields.NAMESPACE.KEY |
line.product.title | 제품의 현재 이름입니다. |
line.product.vendor | 품목의 공급업체입니다. |
line.properties | 품목에 대한 사용자 지정 정보의 배열을 반환합니다. 품목 속성은 제품을 카트에 추가하기 전에 고객이 제품 페이지에서 지정합니다. |
line.quantity | 해당 품목의 수량입니다. |
line.current_quantity | 제거 후 품목의 현재 수량입니다. |
line.requires_shipping | (부울) 품목의 이형 상품에 제품 페이지의 실물 제품 설정이 활성화된 경우 true를 반환합니다. |
line.selling_plan_allocation | 구독과 같은 판매 계획이 품목에 미치는 영향을 설명하는 selling_plan_allocation 객체를 반환합니다. |
line.taxable | (부울) 품목의 이형 상품에 제품 페이지의 '이 제품에 세금 부과' 확인란이 선택된 경우 true를 반환합니다. |
line.title | 판매 시점의 제품 이름이며, 그 뒤에 대시와 판매 시점의 이형 상품 이름이 표시됩니다. 이형 상품 이름이 “기본 제목”인 경우에는 포함되지 않습니다. 고객용 알림에서 고객이 체크아웃에 사용한 언어가 스토어의 기본 언어와 다른 경우, 제품 이름과 이형 상품 이름은 해당 언어로 번역됩니다. |
line.url | 품목 이형 상품의 상대 URL입니다. 상대 URL에는 스토어의 루트 URL(mystore.myshopify.com)이 포함되지 않습니다. |
line.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 | 이형 상품의 현재 옵션 값 이름이며 예: 스몰 / 빨간색 |
line.refunded.quantity(within refund notifications) | 환불할 품목의 수량입니다. 이 속성을 사용하여 주문에서 환불된 품목에 식별자를 추가할 수 있습니다. 예: |
알림 템플릿에서 Shopify Collective 품목 감지
Shopify Collective 태그는 주문 확인 이메일이 전송된 후 주문에 적용되므로 주문 확인 템플릿에서 {% if tags contains 'Shopify Collective' %}는 절대 true가 되지 않습니다. Shopify Collective 품목을 감지하려면 대신 각 품목의 제품 수준 태그를 확인하십시오.
{% assign has_collective_item = false %}
{% for line in line_items %}
{% if line.product.tags contains 'Shopify Collective' %}
{% assign has_collective_item = true %}
{% endif %}
{% endfor %}
{% if has_collective_item %}
<!-- Collective-specific content -->
{% endif %}품목 그룹 속성
line_item_groups 목록의 각 line_item_group에는 다음 속성이 있습니다.
| 속성 | 설명 |
|---|---|
line_item_group.display_title | 품목 그룹의 제목입니다. |
line_item_group.components | 그룹에 속한 품목 구성 요소 목록입니다. |
line_item_group.image | 품목 그룹의 이미지입니다. |
line_item_group.product_id | 품목 그룹의 제품 ID입니다. |
line_item_group.variant | 품목 그룹의 이형 상품 개체입니다. |
line_item_group.variant_id | 품목 그룹의 이형 상품 ID입니다. |
환불 속성
| 속성 | 설명 |
|---|---|
amount | 환불된 금액입니다. |
refund_line_items | 환불될 환불 품목 목록입니다. |
환불 품목 속성
refund_line_items 목록의 각 refund_line에는 다음 속성이 있습니다.
| 속성 | 설명 |
|---|---|
refund_line.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(deprecated) | 이 특정 사용자 지정 주문 처리 서비스에서 주문 처리할 품목 목록입니다. (주문 처리 요청에만 해당) |
items_to_fulfill_count(deprecated) | 이 요청으로 주문 처리될 총 품목 수입니다. (주문 처리 요청에만 해당) |
주문 처리 품목 속성
fulfillment_line_items 목록의 각 fulfillment_line에는 다음 속성이 있습니다.
| 속성 | 설명 |
|---|---|
fulfillment_line.line_item | 주문 처리 중인 품목입니다. 모든 품목 속성에 액세스할 수 있습니다. |
fulfillment_line.quantity | 주문 처리 중인 품목의 수량입니다. |
준비된 패키지 속성
준비된 패키지에는 픽업 준비 완료로 표시된 품목이 포함됩니다.
| 속성 | 설명 |
|---|---|
item_count | 준비된 패키지에 있는 모든 품목 수량의 합계입니다. |
prepared_package_line_items | 준비된 패키지 품목 목록입니다. |
준비된 패키지 품목 속성
prepared_package_line_items 목록의 각 prepared_package_line_item에는 다음 속성이 있습니다.
| 속성 | 설명 |
|---|---|
line_item | 연결된 품목입니다. 모든 품목 속성에 액세스할 수 있습니다. |
quantity | 픽업 준비 완료로 표시된 품목의 수량입니다. |
배송 속성
| 속성 | 설명 |
|---|---|
delivery_agreements | 주문에 대한 모든 배송 합의 목록입니다. |
delivery_instructions | 고객과 공유할 지역 배송 정보입니다. 이 정보는 지역 배송 설정의 배송 정보 필드에서 제어됩니다. |
consolidated_estimated_delivery_time | 고객과 공유할 주문 배송 날짜 정보입니다. 이 정보는 배송 및 배달 페이지에서 설정한 처리 시간 설정으로 제어됩니다. 주문에 여러 배송 방법이 있는 경우 배송 방법 및 날짜 목록이 표시됩니다. |
has_multiple_delivery_methods | (부울) 주문에 여러 배송 방법이 있는 경우 true를 반환합니다. |
배송 합의 속성
| 속성 | 설명 |
|---|---|
delivery_agreement.delivery_method_type | 배송 방법 유형입니다. |
delivery_agreement.delivery_method_name | 구매자가 결제한 언어가 기본 스토어 언어와 다를 경우, 해당 언어로 번역된 배송 방법 유형입니다. |
delivery_agreement.line_item_groups | 배송 합의에 포함된 번들 품목 구성 요소를 포함하는 모든 품목 그룹 목록입니다. |
delivery_agreement.line_items | 이 배송 합의와 연결된 모든 품목 목록입니다. |
할인 속성
할인 속성에는 두 가지 유형이 있습니다.
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_allocation.amount | 고객이 품목에서 절약한 금액입니다. 여러 할인 코드를 허용하려면 루프에 입력해야 합니다. |
discount_allocation.discount_application | 품목에 금액을 할당하는 할인 적용입니다. |
Discount_application 속성
discount_applications 목록의 각 discount_application에는 다음 속성이 있습니다.
| 속성 | 설명 |
|---|---|
discount_application.target_selection |
할인이 카트에서 할인될 품목을 선택하는 방법을 설명합니다. 다음 중 하나입니다.
|
discount_application.target_type | 할인이 적용되는 품목 유형(line_item 또는 shipping_line)입니다. |
discount_application.title | 고객에게 표시되는 할인 이름입니다. 예: Welcome10 또는 CBBWQQAKYBYY |
discount_application.total_allocated_amount | 할인으로 인해 주문 가격이 인하되는 총액입니다. |
discount_application.type | 할인 유형입니다. automatic, discount_code, manual, script 중 하나입니다. |
discount_application.value | 할인 값입니다. |
discount_application.value_type | 할인 값 유형입니다. fixed_amount 또는 percentage 중 하나입니다. |
구독 속성
모든 구독 이메일 템플릿에서 구독 계약, 현재 청구 주기, 그리고 해당 품목, 배송 방법, 결제 방법에 대한 세부 정보를 사용할 수 있습니다.
구독 알림 템플릿을 편집하려면 Shopify Subscriptions 앱을 설치한 다음 설정 > 알림의 Subscriptions 섹션에서 템플릿을 찾으십시오.
구독 계약 청구 주기 속성
구독 계약 및 해당 청구 주기 속성에 액세스하려면 subscription_contract_billing_cycle 객체를 사용하십시오.
예
{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.결과:
This contract is currently paused.속성
| 속성 | 설명 |
|---|---|
status |
계약의 상태입니다.active, paused, cancelled, failed, expired, stale 중 하나입니다.
|
delivery_method |
구독의 배송 방법입니다. 구독이 서비스 또는 디지털 제품에 대한 것이면 nil이 반환됩니다.
|
billing_frequency | 구독 청구 빈도입니다. |
delivery_frequency | 구독 배송 빈도입니다. |
origin_order |
구독을 처음 생성한 원래 주문입니다. 구독이 Shopify 주문에서 생성되지 않은 경우 nil이 반환됩니다.
|
customer | 구독 고객입니다. |
line_items | 구독 청구 주기의 품목입니다. |
product_names | 구독 청구 주기에 포함된 제품 이름 목록입니다. |
update_payment_method_url | 고객이 이 계약의 결제 방법을 업데이트하는 데 사용할 수 있는 URL입니다. |
shipping_address |
구독의 배송 주소입니다. 구독이 서비스 또는 디지털 제품에 대한 것이면 nil이 반환됩니다.
|
billing_address | 구독의 청구 주소입니다. |
subtotal_price | 구독 품목의 소계 가격입니다. |
shipping_price | 구독의 배송비입니다. |
total_tax | 구독의 총세금입니다. |
total_price | 구독의 총가격입니다. |
total_discounts | 구독의 총할인 금액입니다. |
customer_self_serve_url | 고객이 구독을 관리하는 데 사용할 수 있는 셀프 서비스 URL입니다. |
billing_attempt_expected_date | 이 청구 주기의 청구 날짜입니다. |
next_billing_date | 이 청구 주기 이후에 건너뛰지 않은 다음 청구 날짜입니다. |
last_attempted_billing_date | 청구 주기에 대해 마지막으로 시도된 청구 날짜입니다. |
days_overdue | 이 청구 주기에 대해 청구가 연체된 일수입니다. |
payment_instrument | 구독 계약과 연결된 결제 수단입니다. 이 결제 수단은 고객에게 청구하는 데 사용됩니다. |
구독 계약 품목 속성
청구 주기에 포함된 각 품목의 속성입니다. 상위 subscription_contract_billing_cycle.line_items 속성을 통해 계약 품목 속성에 액세스하십시오.
예
{% for line_item in subscription_contract_billing_cycle.line_items %}
{{ line_item.url }}
{% endfor %}| 속성 | 설명 |
|---|---|
url | 품목 제품 이형에 대한 제품 세부 정보 페이지의 URL입니다. |
requires_shipping | 품목에 실제 배송이 필요한지 여부입니다. |
unit_price_measurement | 품목 단위 가격 측정값입니다. |
selling_plan_allocation | 품목 판매 플랜 할당입니다. |
구독 계약 배송 방법 속성
이 청구 주기에 사용되는 배송 방법에 대한 속성입니다. 상위 subscription_contract_billing_cycle.delivery_method 속성을 통해 배송 방법 속성에 액세스하십시오.
예
{% if subscription_contract_billing_cycle.delivery_method != blank %}
Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}| 속성 | 설명 |
|---|---|
title | 배송 방법과 연결된 배송 옵션의 제목입니다. |
type |
배송 방법 유형입니다.배송, 지역, 픽업 중 하나입니다.
|
구독 계약 결제 수단 속성
구독 계약의 결제 수단에 대한 세부 정보입니다. 이 결제 수단은 고객에게 청구하는 데 사용됩니다. 상위 subscription_contract_billing_cycle.payment_instrument 속성을 통해 결제 수단 속성에 액세스하십시오.
예
{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}
<img src="{{ instrument.payment_type | payment_type_img_url }} " alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}| 속성 | 설명 |
|---|---|
payment_type |
결제 수단으로 표시되는 결제 방법의 유형입니다. 결제 필터를 사용하여 이미지 URL 또는 SVG를 출력하십시오. |
credit_card_brand | 신용 카드의 브랜드입니다. |
credit_card_company | 신용 카드 회사 이름입니다. |
credit_card_last_four_digits | 신용 카드의 마지막 4자리 숫자입니다. |
이메일 알림 속성
| 속성 | 설명 |
|---|---|
shop.email_logo_url | 관리자의 이메일 템플릿 사용자 지정 섹션에서 지정한 로고의 URL입니다. |
shop.email_logo_width | 관리자의 이메일 템플릿 사용자 지정 섹션에서 지정한 로고 너비(픽셀)입니다. |
shop.email_accent_color | 관리자의 이메일 템플릿 사용자 지정 섹션에서 지정한 강조 색상의 HEX 코드입니다. |
스토어 크레딧 속성
스토어 크레딧 발급에 대한 세부 정보를 포함하는 속성입니다.
| 속성 | 설명 |
|---|---|
issued_store_credit.amount |
발급된 스토어 크레딧 금액입니다. Liquid money 필터를 사용하여 이 금액의 형식을 지정할 수 있습니다. |
issued_store_credit.expires_at |
발급된 스토어 크레딧이 만료되는 날짜와 시간입니다. Liquid 날짜 필터를 사용하여 이 날짜의 서식을 지정할 수 있습니다. |
issued_store_credit.balance_after_transaction |
크레딧이 발급된 후의 스토어 크레딧 계정 잔액입니다. Liquid money 필터를 사용하여 이 금액의 형식을 지정할 수 있습니다. |
customer | 고객 출력의 특성을 포함하는 고객 개체입니다. |