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 위치
  1. Shopify 관리자에서 Point of Sale > 설정으로 이동합니다.

  2. 사용자 지정 섹션에서 인쇄된 영수증을 클릭하여 POS 편집기를 엽니다.

  3. 왼쪽 사이드바에서 섹션 아이콘을 클릭합니다.

  4. 코드 편집을 클릭합니다.

  5. 인쇄된 영수증 코드 편집 대화 상자에서 변경하려는 코드를 편집합니다.

  6. 저장을 클릭합니다.

  7. 선택 사항: POS 에디터를 사용하여 더 많은 Shopify POS 페이지를 계속 편집하려면 브라우저 창에서 뒤로 이동하십시오.

Lite 또는 이탈리아 위치의 경우
  1. Shopify 관리자에서 Point of Sale > 설정으로 이동합니다.

  2. 사용자 지정 섹션에서 인쇄된 영수증을 클릭하여 POS 편집기를 엽니다.

  3. 영수증 맞춤 설정 페이지에서 코드 편집기를 클릭합니다.

영수증 템플릿에 사용자 지정 파일 사용

Shopify 관리자에 업로드하는 이미지 자산과 같은 파일을 사용하여 인쇄된 영수증을 맞춤 설정할 수 있습니다.

인쇄된 영수증에 파일을 사용하려면 먼저 Shopify 관리자에 파일을 업로드해야 합니다. 파일 업로드에 대해 자세히 알아보십시오.

단계:

  1. Shopify 관리자에서 콘텐츠 > 파일로 이동합니다.

  2. 인쇄된 영수증 코드에 포함할 파일 옆의 링크 복사를 클릭하여 링크를 복사합니다.

  3. 코드 편집기로 이동합니다.

  4. 자산 링크를 템플릿에 포함합니다.

영수증 템플릿을 기본값으로 재설정

코드 편집기를 사용하여 영수증 템플릿을 기본 버전으로 재설정할 수 있습니다.

단계:

모든 POS Pro 위치
  1. Shopify 관리자에서 Point of Sale > 설정으로 이동합니다.

  2. 사용자 지정 섹션에서 인쇄된 영수증을 클릭하여 POS 편집기를 엽니다.

  3. 영수증 맞춤 설정을 클릭합니다.

  4. 코드 편집을 클릭합니다.

  5. 재설정하려는 코드 파일을 클릭합니다.

  6. 기본값으로 재설정 아이콘을 클릭합니다.

  7. 파일을 기본값으로 재설정 대화 상자에서 재설정을 클릭합니다.

Lite 또는 이탈리아 위치의 경우
  1. Shopify 관리자에서 Point of Sale > 설정으로 이동합니다.

  2. 사용자 지정 섹션에서 인쇄된 영수증을 클릭하여 POS 편집기를 엽니다.

  3. 영수증 맞춤 설정 페이지에서 코드 편집기를 클릭합니다.

  4. 재설정하려는 코드 파일을 클릭합니다.

  5. 기본값으로 재설정 아이콘을 클릭합니다.

  6. 파일을 기본값으로 재설정 대화 상자에서 재설정을 클릭합니다.

영수증 코드 편집기에서 사용할 수 있는 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 위치
  1. Shopify 관리자에서 Point of Sale > 설정으로 이동합니다.

  2. 사용자 지정 섹션에서 인쇄된 영수증을 클릭하여 POS 편집기를 엽니다.

  3. 영수증 맞춤 설정을 클릭합니다.

  4. 코드 편집을 클릭합니다.

  5. 미리 보려는 코드 파일을 클릭합니다. 영수증이 맨 오른쪽 편집기 창에 표시됩니다.

  6. 선택 사항: 미리 보기 창에서 영수증 콘텐츠로 사용할 특정 주문을 선택하려면 다음 작업을 수행하십시오.

    1. 보기 아이콘을 클릭하십시오.
    2. 미리 볼 주문 선택 대화 상자에 모든 위치의 Point of Sale 채널에서 이루어진 판매가 표시됩니다. 목록에서 주문을 선택하거나 검색 창을 사용하여 특정 주문 및 위치를 검색하십시오.
    3. 확인을 클릭하십시오.
  7. 선택 사항: gift-card.liquid 파일을 미리 보는 경우 보기 아이콘을 클릭하고 템플릿을 미리 보려는 위치를 선택하십시오.

Lite 또는 이탈리아 위치의 경우
  1. Shopify 관리자에서 Point of Sale > 설정으로 이동합니다.

  2. 사용자 지정 섹션에서 인쇄된 영수증을 클릭하여 POS 편집기를 엽니다.

  3. 영수증 맞춤 설정 페이지에서 코드 편집기를 클릭합니다.

  4. 미리 보려는 코드 파일을 클릭합니다. 영수증이 맨 오른쪽 편집기 창에 표시됩니다.

  5. 선택 사항: 미리 보기 창에서 영수증 콘텐츠로 사용할 특정 주문을 선택하려면 다음 작업을 수행하십시오.

    1. 보기 아이콘을 클릭하십시오.
    2. 미리 볼 주문 선택 대화 상자에 모든 위치의 Point of Sale 채널에서 이루어진 판매가 표시됩니다. 목록에서 주문을 선택하거나 검색 창을 사용하여 특정 주문 및 위치를 검색하십시오.
    3. 확인을 클릭하십시오.
  6. 선택 사항: gift-card.liquid 파일을 미리 보는 경우 보기 아이콘을 클릭하고 템플릿을 미리 보려는 위치를 선택하십시오.