Editorul de cod pentru chitanțe imprimate pentru Shopify POS

Înainte de a utiliza editorul de cod pentru chitanțe, examinați următoarele aspecte:

Restricții de acces

• Puteți utiliza editorul de cod numai din panoul de administrare Shopify de pe desktop.
• Editorul de cod nu este disponibil pentru nicio locație POS din Italia sau Franța.
• În editorul de cod nu mai pot fi adăugate magazine sau locații noi. Editorul de cod rămâne disponibil pentru magazinele cu personalizări existente care nu au fost încă migrate.

Unde se aplică modificările

• Modificările de cod pe care le efectuați se aplică doar locației selectate.
• Personalizările din editorul de cod se aplică numai locațiilor POS Pro. Dacă folosiți editorul de cod și aveți locații care nu sunt POS Pro, atunci puteți folosi editorul vizual pentru a personaliza antetul și subsolul pentru locațiile respective.
• Puteți personaliza chitanțele imprimate care dispun de un șablon în editorul de cod, cum ar fi chitanțele de vânzare, chitanțele pentru cadou, chitanțele aferente cardurilor cadou și chitanțele de retur și schimb.

Limbaje de cod

• Fișierele care alcătuiesc dovezile de plată conțin Liquid, limbajul de șabloane Shopify. Aflați mai multe despre utilizarea Liquid.
• Pentru a edita șabloanele în editorul de cod pentru dovada plății, aveți nevoie de cunoștințe de HTML, CSS și Liquid. Asistența pentru teme Shopify nu poate edita extensiv șabloanele pentru dovada plății pentru dumneavoastră, dar v-ar putea ajuta cu ajustări minore ale temelor Shopify gratuite, în conformitate cu Politica de design Shopify. Pentru modificări mai complexe, luați în considerare angajarea unui partener Shopify.

Limitări de personalizare

• Nu puteți previzualiza chitanțele în diferite dimensiuni de imprimantă din editorul de cod. Pentru a previzualiza în funcție de dimensiunea imprimantei, utilizați editorul vizual.
• Descrierile produselor nu sunt disponibile ca variabilă în șabloanele de chitanțe și nu pot fi adăugate pe chitanțele imprimate.

Întreținerea șablonului

• Șabloanele de chitanțe din editorul de cod nu mai primesc actualizări. Proprietățile adăugate după 1 iunie 2026 vor fi disponibile doar în editorul vizual.
• Resetarea unui șablon la varianta implicită nu mai este acceptată. Pentru a reveni la un șablon implicit, migrați către editorul vizual.

Pașii pentru comutarea între editoare diferă ușor în funcție de situația în care toate locațiile dumneavoastră POS sunt eligibile pentru editorul de cod sau dacă doar unele dintre locațiile POS sunt eligibile, de exemplu, unele dintre locațiile dumneavoastră POS nu utilizează POS Pro sau se află în Italia ori Franța.

Pași:

Puteți utiliza fișiere, cum ar fi active de imagine, pe care le încărcați în panoul de administrare Shopify pentru a vă personaliza chitanțele tipărite.

Un fișier trebuie încărcat în panoul de administrare Shopify înainte de a putea fi utilizat într-o dovadă de plată imprimată. Aflați mai multe despre încărcarea fișierelor.

Pași:

1. Din panoul de administrare Shopify, accesați Conținut > Fișiere.

2. Lângă fișierul pe care doriți să îl includeți în codul chitanței tipărite, dați clic pe pentru a copia linkul.

3. Navigați la editorul de cod.

4. Includeți linkul activului în șablonul dvs.

Resetarea unui șablon la starea implicită nu este acceptată în editorul de cod pentru chitanțe. Pentru a reveni la un șablon implicit de chitanță imprimată, migrați la editorul vizual de chitanțe, care oferă un șablon implicit cu toate câmpurile standard.

Următoarele variabile în Liquid sunt oferite ca referință pentru a vă ajuta să înțelegeți personalizările existente ale chitanțelor în timpul migrării. Personalizările noi ar trebui să fie create în editorul vizual de chitanțe.

Următoarele obiecte de date sunt disponibile pentru editorul de cod pentru chitanțe:

Obiecte de chitanță

shop

location

order

return

gift_card

Obiect comandă

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

Obiect retur

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

Obiect grup de expediere

destination

products

Obiect rând

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

Obiect rând retur

Include totul din obiectul rând plus următoarele proprietăți:

return_reason

return_reason_note

Puteți folosi filtrele Liquid pentru a efectua ajustări ale informațiilor din șabloanele dumneavoastră de chitanțe. De exemplu, puteți modifica formatarea monedei sau modul de utilizare a majusculelor pentru un anumit text, cum ar fi un cod fiscal.

Pentru a aplica un filtru, adăugați un caracter bară verticală | și apoi filtrul în blocul de cod Liquid dintre acoladele duble {{ }}. Filtrele pot fi aplicate numai blocurilor de cod Liquid.

În exemplul următor, filtrul convertește codul fiscal din litere mici în majuscule.

{{ tax_line.title | upcase }}

În exemplul de bloc de cod, product este obiectul, title este proprietatea sa, iar upcase este filtrul aplicat. Filtrul upcase transformă valoarea lui tax_line.title în majuscule. De exemplu, dacă tax_line.title are valoarea Hst, atunci filtrul upcase schimbă valoarea în HST.

Consultați secțiunea Filtre din documentația de referință Liquid pentru temele Shopify pentru detalii despre cum se utilizează filtrele Liquid.

Următoarele filtre sunt disponibile în editorul de cod pentru chitanțe:

t

money

escape

barcode

qrcode

Puteți utiliza Liquid pentru a adăuga mesaje condiționate. Această funcționalitate este similară cu salvarea într-o singură locație cu editorul vizual. De exemplu, afacerea dvs. a început cu o singură locație, iar acum aveți mai multe locații noi. Doriți să evidențiați magazinul original pe dovezile de plată imprimate.

Puteți adăuga un mesaj personalizat la șablonul header.liquid în folderul Secțiuni al editorului de cod și puteți utiliza Liquid pentru a afișa mesajul numai pentru locația dvs. principală.

Următorul cod verifică numele locației, în acest caz locația dvs. originală denumită „Home”, și afișează mesajul „Bun venit la magazinul nostru original, deschis în 1972.” dacă locația corespunde numelui. Chitanțele imprimate de la celelalte locații ale dvs. afișează în schimb mesajul „Bun venit la magazinul nostru.”.

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

Puteți previzualiza modificările aduse chitanțelor tipărite în editorul de cod POS din panoul de administrare Shopify.

În funcție de fișierul Liquid selectat, fereastra de previzualizare evidențiază designul sau secțiunea chitanței afectată de fișier. În mod implicit, fereastra de previzualizare afișează conținutul pentru cea mai recentă comandă POS. Puteți selecta o anumită comandă pentru a o utiliza drept conținut al chitanței în fereastra de previzualizare pentru toate fișierele Liquid, cu excepția fișierului gift-card.liquid, care afișează numai diferitele locații ca opțiuni de previzualizare selectabile.

Pași: