Trình soạn thảo mã biên lai in cho Shopify POS

Có thể tùy chỉnh biên lai in bằng trình soạn thảo mã trong bảng điều khiển quản trị Shopify. Các tệp tạo nên biên lai chứa Liquid, ngôn ngữ lập trình mẫu của Shopify. Với trình soạn thảo mã, bạn có thể tạo các tùy chỉnh nâng cao hơn bằng HTML, CSS và Liquid so với việc sử dụng trình chỉnh sửa trực quan.

Có thể thay đổi mẫu biên lai và các mẫu phần dùng trên biên lai in. Các tệp mẫu Biên lai là những loại biên lai có thể in tại cửa hàng. Phần là các bộ phận của biên lai, chẳng hạn như đầu trang hoặc chân trang. Nhiều biên lai có thể sử dụng lại các phần này.

Lưu ý khi sử dụng trình soạn thảo mã biên lai

Trước khi sử dụng trình soạn thảo mã biên lai, hãy xem xét các lưu ý sau:

Hạn chế quyền truy cập

• Chỉ có thể sử dụng trình soạn thảo mã từ bảng điều khiển quản trị Shopify trên máy tính để bàn.
• Trình chỉnh sửa mã không khả dụng cho bất kỳ điểm bán hàng nào tại Ý.

Nơi áp dụng thay đổi

• Các thay đổi mã chỉ áp dụng cho địa điểm đã chọn.
• Tùy chỉnh trong trình soạn thảo mã chỉ áp dụng cho các địa điểm POS Pro. Nếu sử dụng trình soạn thảo mã và có những địa điểm không thuộc POS Pro, bạn có thể dùng trình chỉnh sửa trực quan để tùy chỉnh đầu trang và chân trang cho các địa điểm đó.
• Có thể tùy chỉnh biên lai in có mẫu trong trình soạn thảo mã, chẳng hạn như biên lai bán hàng, biên lai quà tặng, biên lai thẻ quà tặng và biên lai đơn hàng trả lại hoặc đổi trả.

Ngôn ngữ mã

• Các tệp tạo nên biên lai chứa Liquid, ngôn ngữ lập trình mẫu của Shopify. Tìm hiểu thêm về cách sử dụng Liquid.
• Để chỉnh sửa mẫu trong trình soạn thảo mã biên lai, bạn cần thông thạo HTML, CSS và Liquid. Bộ phận hỗ trợ chủ đề của Shopify có thể giúp thực hiện các điều chỉnh nhỏ trong phạm vi Chính sách thiết kế của Shopify.

Giới hạn tùy chỉnh

• Bạn không thể xem trước biên lai ở các kích thước máy in khác nhau từ trình chỉnh sửa mã. Để xem trước theo kích thước máy in, hãy sử dụng trình chỉnh sửa trực quan.
• Mô tả sản phẩm không khả dụng dưới dạng biến trong mẫu biên lai và không thể thêm vào biên lai in.

Bảo trì mẫu

• Nếu bạn tùy chỉnh biên lai bằng trình chỉnh sửa mã biên lai, mẫu hiện tại của bạn có thể thiếu các thuộc tính mới, chẳng hạn như selling_plan_name. Để thêm các thuộc tính mới nhất hiện có vào mẫu, bạn cần thiết lập lại mẫu biên lai về mặc định. Việc thiết lập lại mẫu biên lai về mặc định sẽ xóa mọi tùy chỉnh bạn đã thực hiện. Hãy ghi lại mã tùy chỉnh của bạn trước khi thiết lập lại. Sau khi thiết lập lại mẫu, bạn cần áp dụng lại các tùy chỉnh theo cách thủ công.

Truy cập trình soạn thảo mã

Có thể chỉnh sửa mẫu bằng trình soạn thảo mã. Trước tiên, phải chuyển sang trình soạn thảo mã từ trình chỉnh sửa trực quan mặc định và bạn có thể chuyển lại về trình chỉnh sửa trực quan bất cứ lúc nào.

Các bước chuyển đổi giữa những trình biên tập sẽ khác nhau một chút tùy thuộc vào việc tất cả điểm bán hàng của bạn đều đủ điều kiện sử dụng trình biên tập mã hay chỉ một số điểm bán hàng đủ điều kiện. Ví dụ: một số điểm bán hàng của bạn không sử dụng POS Pro hoặc ở Ý hay Pháp.

Các bước thực hiện:

Sử dụng tệp tùy chỉnh trong mẫu biên lai

Có thể sử dụng các tệp đã tải lên bảng điều khiển quản trị Shopify, chẳng hạn như tài nguyên hình ảnh, để tùy chỉnh biên lai in.

Phải tải tệp lên bảng điều khiển quản trị Shopify trước khi có thể sử dụng tệp trên biên lai in. Tìm hiểu thêm về việc tải tệp lên.

Các bước thực hiện:

1. Từ bảng điều khiển quản trị Shopify, vào Nội dung > Tệp.

2. Bên cạnh tệp bạn muốn đưa vào mã biên lai in, nhấp vào để sao chép liên kết.

3. Đi tới trình chỉnh sửa mã.

4. Đưa liên kết tài nguyên vào mẫu của bạn.

Thiết lập lại mẫu biên lai về mặc định

Bạn có thể thiết lập lại mẫu biên lai về phiên bản mặc định bằng trình chỉnh sửa mã.

Các bước thực hiện:

Các biến Liquid có sẵn trong trình chỉnh sửa mã biên lai

Bạn có thể sử dụng Liquid để tùy chỉnh mẫu biên lai in và các loại biên lai.

Các đối tượng dữ liệu sau có sẵn trong trình chỉnh sửa mã biên lai:

Đối tượng biên lai

shop

location

order

return

gift_card

Đối tượng đơn hàng

id

created_at

source_identifier

change_due

balance_due

name

note

line_items

subtotal_price

total_price

total_tip_received

discounts

transactions

taxes_included

tax_lines

customer

shipping_address

shipping_groups

Đối tượng trả lại

name

created_at

is_unverified

is_exchange

exchange_type

return_discount

return_subtotal

return_total

exchange_subtotal

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

Đối tượng nhóm vận chuyển

destination

products

Đối tượng mục hàng

id

name

variant_title

price

is_gift_card

discount

total_price

selling_plan_name

tax_rates

custom_attributes

variant_title

variant_id

variant_metafields

staff_member_description

product_metafields

Đối tượng mục hàng trả lại

Bao gồm mọi thông tin trong đối tượng mục hàng cộng với các thuộc tính sau:

return_reason

return_reason_note

Các bộ lọc Liquid có sẵn trong trình chỉnh sửa mã biên lai

Bạn có thể dùng bộ lọc Liquid để điều chỉnh thông tin trong mẫu biên lai. Ví dụ: bạn có thể thay đổi định dạng tiền tệ hoặc kiểu viết hoa của văn bản cụ thể, chẳng hạn như mã số thuế.

Để áp dụng bộ lọc, hãy thêm ký tự gạch đứng | rồi đến bộ lọc trong khối mã Liquid nằm giữa hai dấu ngoặc nhọn {{ }}. Chỉ có thể áp dụng bộ lọc cho các khối mã Liquid.

Trong ví dụ sau, bộ lọc sẽ chuyển mã số thuế từ chữ thường sang chữ hoa.

{{ tax_line.title | upcase }}

Trong khối mã ví dụ, product là đối tượng, title là thuộc tính của đối tượng đó và upcase là bộ lọc được áp dụng. Bộ lọc upcase thay đổi kiểu viết hoa của giá trị tax_line.title thành chữ hoa. Ví dụ: nếu tax_line.title có giá trị là Hst thì bộ lọc upcase sẽ đổi giá trị này thành HST.

Tham khảo phần Bộ lọc trong tài liệu tham khảo Liquid của Chủ đề Shopify để biết chi tiết về cách dùng bộ lọc Liquid.

Các bộ lọc sau có sẵn trong trình chỉnh sửa mã biên lai:

t

money

escape

barcode

qrcode

Ví dụ về tùy chỉnh mã mẫu biên lai in

Bạn có thể dùng Liquid để thêm thông báo có điều kiện. Tính năng này tương tự như việc lưu vào một địa điểm duy nhất bằng trình chỉnh sửa trực quan. Ví dụ: doanh nghiệp của bạn ban đầu chỉ có một địa điểm nhưng hiện tại đã có một vài địa điểm mới. Bạn muốn làm nổi bật cửa hàng đầu tiên của mình trên các biên lai in.

Bạn có thể thêm thông báo tùy chỉnh vào mẫu header.liquid trong thư mục Mục (Sections) của trình chỉnh sửa mã và dùng Liquid để chỉ hiển thị thông báo đối với địa điểm quan trọng nhất của bạn.

Mã sau đây sẽ kiểm tra tên địa điểm, trong trường hợp này, địa điểm ban đầu của bạn tên là "Home" và hiển thị thông báo "Welcome to our original store, opened in 1972." (Chào mừng đến với cửa hàng đầu tiên của chúng tôi, mở từ năm 1972) nếu địa điểm khớp với tên. Thay vào đó, biên lai in từ các địa điểm khác sẽ hiển thị thông báo "Welcome to our store." (Chào mừng đến với cửa hàng của chúng tôi).

{% if location.name == 'Home' %}
  Welcome to our original store, opened in 1972.
{% else %}
  Welcome to our store.
{% end %}

Xem trước thay đổi mã trong trình chỉnh sửa mã

Bạn có thể xem trước các thay đổi trên biên lai in trong trình chỉnh sửa mã POS trên bảng điều khiển quản trị Shopify.

Tùy thuộc vào tệp Liquid được chọn, cửa sổ xem trước sẽ làm nổi bật thiết kế hoặc phần biên lai chịu ảnh hưởng của tệp đó. Theo mặc định, cửa sổ xem trước sẽ hiển thị nội dung của đơn hàng POS gần nhất. Bạn có thể chọn một đơn hàng cụ thể để dùng làm nội dung biên lai trong cửa sổ xem trước đối với mọi tệp Liquid trừ tệp gift-card.liquid. Tệp này chỉ hiển thị các địa điểm khác nhau làm tùy chọn xem trước có thể chọn.

Các bước thực hiện: