Shopify POS용 인쇄된 영수증 코드 편집기
Shopify 관리자에서 코드 편집기를 사용하여 인쇄된 영수증을 맞춤 설정할 수 있습니다. 영수증을 구성하는 파일에는 Shopify의 템플릿 언어인 Liquid가 포함되어 있습니다. 코드 편집기를 사용하면 시각적 편집기보다 HTML, CSS, Liquid를 사용하여 더 고급 맞춤 설정을 생성할 수 있습니다.
영수증 템플릿과 인쇄된 영수증에 사용되는 섹션 템플릿을 변경할 수 있습니다. 영수증 템플릿 파일은 스토어에서 인쇄할 수 있는 영수증 유형입니다. 섹션은 머리글 또는 바닥글과 같은 영수증의 일부입니다. 섹션은 여러 영수증에서 재사용할 수 있습니다.
이 페이지의 내용
영수증 코드 편집기 사용 시 고려 사항
영수증 코드 편집기를 사용하기 전에 다음 고려 사항을 검토하세요.
액세스 제한
- 코드 편집기는 데스크톱의 Shopify 관리자에서만 사용할 수 있습니다.
- 코드 편집기는 이탈리아의 POS 위치에서 사용할 수 없습니다.
변경 사항 적용 범위
- 코드 변경 사항은 선택한 위치에만 적용됩니다.
- 코드 편집기의 맞춤 설정은 POS Pro 위치에만 적용됩니다. 코드 편집기를 사용하며 POS Pro가 아닌 위치가 있는 경우 해당 위치에 시각적 편집기를 사용하여 머리글과 바닥글을 맞춤 설정할 수 있습니다.
- 코드 편집기에서 판매 영수증, 기프트 영수증, 기프트 카드 영수증, 반품 및 교환 영수증과 같은 템플릿이 있는 인쇄된 영수증을 맞춤 설정할 수 있습니다.
코드 언어
- 영수증을 구성하는 파일에는 Shopify의 템플릿 언어인 Liquid가 포함되어 있습니다. Liquid 사용에 대해 자세히 알아보십시오.
- 영수증 코드 편집기에서 템플릿을 편집하려면 HTML, CSS, Liquid에 익숙해야 합니다. Shopify 테마 지원팀은 Shopify 디자인 정책 범위 내에서 사소한 조정을 지원할 수 있습니다.
맞춤 설정 제한 사항
- 코드 편집기에서는 영수증을 다양한 프린터 크기로 미리 볼 수 없습니다. 프린터 크기별로 미리 보려면 시각적 편집기를 사용하십시오.
- 제품 설명은 영수증 템플릿의 변수로 사용할 수 없으며 인쇄된 영수증에 추가할 수 없습니다.
템플릿 관리
- 영수증 코드 편집기를 사용하여 영수증을 맞춤 설정하면 기존 템플릿에
selling_plan_name과 같은 새 속성이 누락될 수 있습니다. 템플릿에 사용할 수 있는 최신 속성을 추가하려면 영수증 템플릿을 기본값으로 재설정해야 합니다. 영수증 템플릿을 기본값으로 재설정하면 적용된 맞춤 설정이 모두 제거됩니다. 재설정하기 전에 맞춤 설정된 코드를 기록해 두십시오. 템플릿을 재설정한 후에는 맞춤 설정을 수동으로 다시 적용해야 합니다.
코드 편집기 액세스
코드 편집기를 사용하여 템플릿을 편집할 수 있습니다. 먼저 기본 시각적 편집기에서 코드 편집기 사용으로 전환해야 하며 언제든지 시각적 편집기로 다시 전환할 수 있습니다.
편집기 간 전환 단계는 모든 POS 위치가 코드 편집기 사용 기준을 충족하는지, 아니면 일부 POS 위치만 기준을 충족하는지(예: 일부 POS 위치에서 POS Pro를 사용하지 않거나 이탈리아 또는 프랑스에 기반을 둔 경우)에 따라 약간 다릅니다.
단계:
모든 POS Pro 위치
Shopify 관리자에서 Point of Sale > 설정으로 이동합니다.
사용자 지정 섹션에서 인쇄된 영수증을 클릭하여 POS 편집기를 엽니다.
왼쪽 사이드바에서
아이콘을 클릭합니다.
코드 편집을 클릭합니다.
인쇄된 영수증 코드 편집 대화 상자에서 변경하려는 코드를 편집합니다.
저장을 클릭합니다.
선택 사항: POS 에디터를 사용하여 더 많은 Shopify POS 페이지를 계속 편집하려면 브라우저 창에서 뒤로 이동하십시오.
Lite 또는 이탈리아 위치의 경우
Shopify 관리자에서 Point of Sale > 설정으로 이동합니다.
사용자 지정 섹션에서 인쇄된 영수증을 클릭하여 POS 편집기를 엽니다.
영수증 맞춤 설정 페이지에서 코드 편집기를 클릭합니다.
영수증 템플릿에 사용자 지정 파일 사용
Shopify 관리자에 업로드하는 이미지 자산과 같은 파일을 사용하여 인쇄된 영수증을 맞춤 설정할 수 있습니다.
인쇄된 영수증에 파일을 사용하려면 먼저 Shopify 관리자에 파일을 업로드해야 합니다. 파일 업로드에 대해 자세히 알아보십시오.
단계:
Shopify 관리자에서 콘텐츠 > 파일로 이동합니다.
인쇄된 영수증 코드에 포함할 파일 옆의
를 클릭하여 링크를 복사합니다.
자산 링크를 템플릿에 포함합니다.
영수증 템플릿을 기본값으로 재설정
코드 편집기를 사용하여 영수증 템플릿을 기본 버전으로 재설정할 수 있습니다.
단계:
모든 POS Pro 위치
Shopify 관리자에서 Point of Sale > 설정으로 이동합니다.
사용자 지정 섹션에서 인쇄된 영수증을 클릭하여 POS 편집기를 엽니다.
영수증 맞춤 설정을 클릭합니다.
코드 편집을 클릭합니다.
재설정하려는 코드 파일을 클릭합니다.
아이콘을 클릭합니다.
파일을 기본값으로 재설정 대화 상자에서 재설정을 클릭합니다.
Lite 또는 이탈리아 위치의 경우
Shopify 관리자에서 Point of Sale > 설정으로 이동합니다.
사용자 지정 섹션에서 인쇄된 영수증을 클릭하여 POS 편집기를 엽니다.
영수증 맞춤 설정 페이지에서 코드 편집기를 클릭합니다.
재설정하려는 코드 파일을 클릭합니다.
아이콘을 클릭합니다.
파일을 기본값으로 재설정 대화 상자에서 재설정을 클릭합니다.
영수증 코드 편집기에서 사용할 수 있는 Liquid 변수
Liquid를 사용하여 인쇄된 영수증 템플릿과 영수증 유형을 맞춤 설정할 수 있습니다.
영수증 코드 편집기에서 다음 데이터 개체를 사용할 수 있습니다.
영수증 개체
| 개체 | 설명 |
|---|---|
shop | 스토어 이름과 같은 스토어 정보를 포함합니다. |
location | 주소 및 전화번호와 같은 소매점 위치 정보를 포함합니다. |
order | 품목, 할인, 세금, 거래 정보를 포함한 주문 데이터를 포함합니다. |
return |
return-and-exchange-receipt.liquid 템플릿 및 관련 부분 템플릿 내에서만 사용할 수 있습니다.
반품된 품목, 새 품목, 순 합계, 거래 정보를 포함하여 반품 및 교환 데이터를 포함합니다.
|
gift_card |
gift-card.liquid 템플릿 내에서만 사용할 수 있습니다.
잔액, 영숫자 코드, POS 앱에서 스캔할 수 있는 QR 코드의 콘텐츠를 포함한 기프트 카드 데이터를 포함합니다.
|
주문 개체
| 속성 | 설명 |
|---|---|
id | 주문의 ID입니다. |
created_at | 주문이 생성된 날짜 및 시간(ISO 8601 형식)입니다. |
source_identifier | 고유한 POS 또는 타사 주문 식별자입니다. |
change_due | 주문에 대한 거스름돈입니다. |
balance_due | 이 주문에 대한 미결제 금액입니다. |
name | Shopify 관리자의 주문 페이지 및 주문 상태 페이지에 표시되는 주문의 고유 식별자입니다. 예: “#1001”, “EN1001” 또는 “1001-A”. 이 값은 여러 스토어에서 고유하지 않습니다. |
note | 주문과 연결된 메모의 콘텐츠입니다. |
line_items | 주문 품목 목록입니다. |
subtotal_price |
할인 후, 반품 전 모든 품목 가격의 합계입니다. taxesIncluded가 true이면 소계에 세금도 포함됩니다.
|
total_price | 반품 전 주문의 총가격입니다. 여기에는 세금과 할인이 포함됩니다. |
total_tip_received | 주문의 모든 팁 금액 합계입니다. |
discounts | 총 할인 금액입니다. |
transactions | 주문과 연결된 거래 목록입니다. |
taxes_included | 주문 소계 가격에 세금이 포함되는지 여부입니다. |
tax_lines | 반품 전 주문의 품목에 적용된 모든 세금 품목 목록입니다. 세금 품목 가격은 동일한 세율과 제목을 가진 모든 세금 품목의 총가격을 나타냅니다. |
customer | 주문을 한 고객입니다. |
shipping_address | 주문의 배송 주소입니다. |
shipping_groups | 주문의 배송 그룹 목록입니다. 각 그룹에는 함께 주문 처리되는 품목이 포함됩니다. |
반품 객체
| 속성 | 설명 |
|---|---|
name | Shopify 관리자의 주문 페이지 및 주문 상태 페이지에 표시되는 반품의 고유 식별자입니다. 예: “#1000-R1”. 이 값은 여러 스토어에서 고유하지 않습니다. |
created_at | 반품이 생성된 ISO 8601 형식의 날짜 및 시간입니다. |
is_unverified | 반품이 미확인 반품으로 생성되었는지 여부를 나타내는 부울 값입니다. |
is_exchange | 반품에 교환이 포함되었는지 여부를 나타내는 부울 값입니다. 기프트 카드로 환불된 금액도 포함됩니다. |
exchange_type |
반품에 교환이 포함된 경우 교환 유형입니다. 가능한 값은 LIKE_FOR_LIKE, NET_REFUNDABLE, NET_PAYABLE입니다.
|
return_discount | 환불된 총 주문 할인 금액입니다. |
return_subtotal |
할인 전 모든 반품 품목 가격의 합계입니다. taxesIncluded가 true이면 소계에 세금도 포함됩니다.
|
return_total | 총 환불 가능 금액입니다. 여기에는 세금, 할인, 배송비 및 팁이 포함됩니다. 실제 환불 금액이 아닐 수 있습니다. |
exchange_subtotal |
할인 전 교환의 모든 신규 품목 가격 합계입니다. taxesIncluded가 true이면 소계에 세금도 포함됩니다.
|
exchange_total | 교환의 모든 신규 품목에 대한 총 금액입니다. 여기에는 세금과 할인이 포함됩니다. |
total_cash_rounding_adjustment | 반품 또는 교환에 적용된 현금 반올림 조정 금액입니다. |
total_adjusted_amount | 현금 반올림 조정으로 조정된 반품 또는 교환의 총 금액입니다. |
net_total | 현금 반올림 적용 전, 반품 또는 교환에 대해 실제 지급되었거나 환불된 총 금액입니다. |
return_line_items | 반품된 품목입니다. |
exchange_line_items | 교환에 포함된 새 품목입니다. |
return_tax_lines | 반품된 품목의 세금 품목입니다. |
exchange_tax_lines | 교환의 새 품목에 대한 세금 품목입니다. |
shipping_refund_amount | 환불된 배송 금액입니다. |
tip_refund_amount | 환불된 팁 금액입니다. |
transactions | 반품 또는 교환과 연결된 거래입니다. |
배송 그룹 객체
| 속성 | 설명 |
|---|---|
destination | 배송되는 제품의 목적지입니다. |
products | 배송되는 제품 목록입니다. |
품목 객체
| 속성 | 설명 |
|---|---|
id | 품목의 ID입니다. |
name | 제품의 제목이며, 해당하는 경우 이형 상품의 제목이 추가될 수 있습니다. |
variant_title | 주문 생성 시점의 이형 상품 제목입니다. |
price | 주문 생성 시점의 품목 단가입니다. 이 값에는 할인이 포함되지 않습니다. |
is_gift_card | 품목이 기프트 카드 구매를 나타내는지 여부입니다. |
discount | 환불 및 제거된 수량에 할당된 할인을 포함하여 할인 적용에 의해 품목에 할당된 총 할인입니다. |
total_price | 이 품목의 합계입니다. |
selling_plan_name | 품목에 할당된 가입 요금의 이름입니다. |
tax_rates | 이 품목의 세금 품목입니다. |
custom_attributes | 사용자 지정 기능 또는 특별 요청을 나타내는 특성 목록입니다. |
variant_title | 이형 상품 제목입니다. |
variant_id | 이형 상품의 ID입니다. |
variant_metafields | 판매자가 이형 상품과 연결한 사용자 지정 필드 목록입니다. |
staff_member_description | 품목에 할당된 직원입니다. |
product_metafields | 판매자가 제품에 연결한 사용자 지정 필드 목록입니다. |
반품 품목 객체
품목 개체의 모든 항목과 다음 속성을 포함합니다.
| 속성 | 설명 |
|---|---|
return_reason | 품목의 반품 사유입니다. |
return_reason_note | 반품 사유에 추가하는 선택 사항 메모입니다. |
영수증 코드 편집기에서 사용 가능한 Liquid 필터
Liquid 필터를 사용하여 영수증 템플릿의 정보를 조정할 수 있습니다. 예를 들어 통화 서식이나 세금 코드와 같은 특정 텍스트의 대/소문자를 변경할 수 있습니다.
필터를 적용하려면 이중 중괄호 {{ }} 사이의 Liquid 코드 블록에 파이프 문자 |를 추가한 후 필터를 추가하십시오. 필터는 Liquid 코드 블록에만 적용할 수 있습니다.
다음 예시에서는 필터가 세금 코드를 소문자에서 대문자로 변경합니다.
{{ tax_line.title | upcase }}예시 코드 블록에서 product는 객체이고 title은 속성이며 upcase는 적용된 필터입니다. upcase 필터는 tax_line.title 값의 대소문자를 대문자로 변경합니다. 예를 들어 tax_line.title의 값이 Hst인 경우 upcase 필터는 이 값을 HST로 변경합니다.
Liquid 필터 사용 방법에 대한 자세한 내용은 Shopify Themes Liquid 참조의 필터 섹션을 참조하십시오.
영수증 코드 편집기에서 다음 필터를 사용할 수 있습니다.
| 속성 | 설명 | |
|---|---|---|
t | 미리 정의된 레이블을 위치에 할당된 언어로 번역합니다. | |
money | 가격을 위치 통화로 서식을 지정합니다. | |
escape |
HTML의 특수 문자인 <>, ', & 등을 이스케이프하고 문자를 이스케이프 시퀀스로 변환합니다.
| |
barcode | 1D 바코드 SVG를 생성합니다. | |
qrcode | 2D 바코드 SVG를 생성합니다. |
인쇄된 영수증 템플릿 코드 맞춤 설정 예시
Liquid를 사용하여 조건부 메시지를 추가할 수 있습니다. 이 기능은 시각적 편집기를 사용하여 단일 위치에 저장하는 것과 유사합니다. 예를 들어 비즈니스가 단일 위치에서 시작되었고 지금은 여러 개의 새 위치가 있다고 가정해 보겠습니다. 인쇄된 영수증에 원래 스토어를 강조 표시하고 싶을 수 있습니다.
코드 편집기의 섹션 폴더에 있는 header.liquid 템플릿에 사용자 지정 메시지를 추가하고 Liquid를 사용하여 플래그십 위치에만 메시지를 표시할 수 있습니다.
다음 코드는 위치 이름(이 경우 “Home”이라는 원래 위치)을 확인하여 이름과 일치하면 “1972년에 개점한 원래 스토어에 오신 것을 환영합니다.” 메시지를 표시합니다. 다른 위치에서 인쇄된 영수증에는 대신 “저희 스토어에 오신 것을 환영합니다.” 메시지가 표시됩니다.
{% if location.name == 'Home' %}
Welcome to our original store, opened in 1972.
{% else %}
Welcome to our store.
{% end %}코드 편집기에서 코드 변경 사항 미리 보기
Shopify 관리자의 POS 코드 에디터에서 인쇄된 영수증에 대한 변경 사항을 미리 볼 수 있습니다.
선택한 Liquid 파일에 따라 미리 보기 창에서 파일의 영향을 받는 영수증 디자인 또는 섹션이 강조 표시됩니다. 기본적으로 미리 보기 창에는 가장 최근 POS 주문의 콘텐츠가 표시됩니다. gift-card.liquid 파일을 제외한 모든 Liquid 파일의 미리 보기 창에서 영수증 콘텐츠로 사용할 특정 주문을 선택할 수 있습니다. gift-card.liquid 파일의 경우 선택 가능한 미리 보기 옵션으로 여러 위치만 표시됩니다.
단계:
모든 POS Pro 위치
Shopify 관리자에서 Point of Sale > 설정으로 이동합니다.
사용자 지정 섹션에서 인쇄된 영수증을 클릭하여 POS 편집기를 엽니다.
영수증 맞춤 설정을 클릭합니다.
코드 편집을 클릭합니다.
미리 보려는 코드 파일을 클릭합니다. 영수증이 맨 오른쪽 편집기 창에 표시됩니다.
선택 사항: 미리 보기 창에서 영수증 콘텐츠로 사용할 특정 주문을 선택하려면 다음 작업을 수행하십시오.
아이콘을 클릭하십시오.
- 미리 볼 주문 선택 대화 상자에 모든 위치의 Point of Sale 채널에서 이루어진 판매가 표시됩니다. 목록에서 주문을 선택하거나 검색 창을 사용하여 특정 주문 및 위치를 검색하십시오.
- 확인을 클릭하십시오.
선택 사항:
gift-card.liquid파일을 미리 보는 경우아이콘을 클릭하고 템플릿을 미리 보려는 위치를 선택하십시오.
Lite 또는 이탈리아 위치의 경우
Shopify 관리자에서 Point of Sale > 설정으로 이동합니다.
사용자 지정 섹션에서 인쇄된 영수증을 클릭하여 POS 편집기를 엽니다.
영수증 맞춤 설정 페이지에서 코드 편집기를 클릭합니다.
미리 보려는 코드 파일을 클릭합니다. 영수증이 맨 오른쪽 편집기 창에 표시됩니다.
선택 사항: 미리 보기 창에서 영수증 콘텐츠로 사용할 특정 주문을 선택하려면 다음 작업을 수행하십시오.
아이콘을 클릭하십시오.
- 미리 볼 주문 선택 대화 상자에 모든 위치의 Point of Sale 채널에서 이루어진 판매가 표시됩니다. 목록에서 주문을 선택하거나 검색 창을 사용하여 특정 주문 및 위치를 검색하십시오.
- 확인을 클릭하십시오.
선택 사항:
gift-card.liquid파일을 미리 보는 경우아이콘을 클릭하고 템플릿을 미리 보려는 위치를 선택하십시오.