Shopify POS için basılı makbuz kod düzenleyicisi

Makbuz kod düzenleyicisini kullanmadan önce aşağıdaki önemli noktaları gözden geçirin:

Erişim kısıtlamaları

• Kod düzenleyiciyi yalnızca masaüstündeki Shopify yöneticinizden kullanabilirsiniz.
• Kod düzenleyici, İtalya veya Fransa'daki hiçbir POS konumu için kullanılamaz.
• Kod düzenleyicisine yeni mağazalar veya konumlar eklenemez. Kod düzenleyicisi, mevcut kişiselleştirmeleri henüz taşınmamış mağazalar için kullanılabilir olmaya devam eder.

Değişikliklerin geçerli olduğu yerler

• Yaptığınız kod değişiklikleri yalnızca seçilen konum için geçerli olur.
• Kod düzenleyicisindeki özelleştirmeler yalnızca POS Pro konumları için geçerlidir. Kod düzenleyiciyi kullanıyorsanız ve POS Pro olmayan konumlarınız varsa bu konumlar için üstbilgi ve altbilgiyi özelleştirmek üzere görsel düzenleyiciyi kullanabilirsiniz.
• Satış makbuzları, hediye makbuzları, hediye kartı makbuzları ile iade ve değişim makbuzları gibi kod düzenleyicisinde şablonu olan basılı makbuzları kişiselleştirebilirsiniz.

Kod dilleri

• Makbuzlarınızı oluşturan dosyalar, Shopify'ın şablon dili olan Liquid'i içerir. Liquid kullanımı hakkında daha fazla bilgi edinin.
• Makbuz kodu düzenleyicisindeki şablonları düzenlemek için HTML, CSS ve Liquid dillerine aşina olmanız gerekir. Shopify Tema Destek ekibi makbuz şablonlarında sizin için kapsamlı düzenlemeler yapamaz ancak Shopify Tasarım Politikası kapsamında ücretsiz Shopify temalarındaki küçük ayarlamalarda size yardımcı olabilir. Daha karmaşık değişiklikler için bir Shopify İş Ortağı ile çalışmayı düşünün.

Özelleştirme sınırlamaları

• Kod düzenleyicisinden makbuzları farklı yazıcı boyutlarında önizleyemezsiniz. Yazıcı boyutuna göre önizleme yapmak için görsel düzenleyiciyi kullanın.
• Ürün tanımları, makbuz şablonlarında değişken olarak kullanılamaz ve yazdırılan makbuzlara eklenemez.

Şablon bakımı

• Kod düzenleyicisindeki makbuz şablonları artık güncelleme almamaktadır. 1 Haziran 2026'dan sonra eklenen özellikler yalnızca görsel düzenleyicide kullanılabilir.
• Bir şablonun varsayılana sıfırlanması artık desteklenmemektedir. Varsayılan bir şablona dönmek için görsel düzenleyiciye geçiş yapın.

Düzenleyiciler arasında geçiş yapma adımları; tüm POS konumlarınızın kod düzenleyicisi için uygun olup olmamasına veya yalnızca bazı POS konumlarınızın uygun olmasına (örneğin, bazı POS konumlarınızın POS Pro kullanmaması veya İtalya'da ya da Fransa'da bulunması) bağlı olarak biraz farklılık gösterir.

Adımlar:

Basılı fişlerinizi kişiselleştirmek için Shopify yöneticinize yüklediğiniz görsel öğeleri gibi dosyaları kullanabilirsiniz.

Bir dosyanın basılı bir makbuzda kullanılabilmesi için Shopify yöneticinize yüklenmesi gerekir. Dosya yüklemeleri hakkında daha fazla bilgi edinin.

Adımlar:

1. Shopify yöneticinizden İçerik > Dosyalar bölümüne gidin.

2. Basılı fiş kodunuza eklemek istediğiniz dosyanın yanındaki simgesine tıklayarak bağlantıyı kopyalayın.

3. Kod düzenleyiciye gidin.

4. Dosya bağlantısını şablonunuza ekleyin.

Makbuz kodu düzenleyicisinde bir şablonun varsayılana sıfırlanması desteklenmez. Varsayılan bir basılı makbuz şablonuna dönmek için, tüm standart alanları içeren varsayılan bir şablon sunan görsel makbuz düzenleyicisine geçiş yapın.

Aşağıdaki Liquid değişkenleri, geçiş sırasında mevcut makbuz kişiselleştirmelerinizi anlamanıza yardımcı olmak için referans olarak verilmiştir. Yeni kişiselleştirmeler görsel makbuz düzenleyicisinde oluşturulmalıdır.

Aşağıdaki veri nesneleri fiş kodu düzenleyicisinde kullanılabilir:

Fiş nesneleri

shop

location

order

return

gift_card

Sipariş nesnesi

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

İade nesnesi

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

Kargo grubu nesnesi

destination

products

Satır öğesi nesnesi

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

İade satır öğesi nesnesi

Satır öğesi nesnesindeki her şeyi ve ek olarak aşağıdaki özellikleri içerir:

return_reason

return_reason_note

Makbuz şablonlarınızdaki bilgilerde ayarlamalar yapmak için Liquid filtrelerini kullanabilirsiniz. Örneğin, para birimi biçimlendirmesini veya vergi kodu gibi belirli bir metnin büyük/küçük harf kullanımını değiştirebilirsiniz.

Bir filtre uygulamak için çift küme parantezleri {{ }} arasındaki Liquid kodu bloğuna bir dikey çizgi karakteri (|) ve ardından filtrenin kendisini ekleyin. Filtreler yalnızca Liquid kodu bloklarına uygulanabilir.

Aşağıdaki örnekte filtre, vergi kodunu küçük harften büyük harfe dönüştürür.

{{ tax_line.title | upcase }}

Örnek kod bloğunda product nesne, title onun özelliği ve upcase de uygulanan filtredir. upcase filtresi, tax_line.title değerini büyük harfe dönüştürür. Örneğin tax_line.title öğesinin değeri Hst ise upcase filtresi bu değeri HST olarak değiştirir.

Liquid filtrelerinin nasıl kullanılacağına ilişkin ayrıntılar için Shopify Temaları Liquid referansındaki Filtreler bölümüne bakın.

Makbuz kodu düzenleyicisinde aşağıdaki filtreler mevcuttur:

t

money

escape

barcode

qrcode

Koşullu mesajlar eklemek için Liquid'i kullanabilirsiniz. Bu işlevsellik, görsel düzenleyici ile tek bir konuma kaydetmeye benzer. Örneğin, işletmeniz tek bir konumla başladı ve şimdi birkaç yeni konumunuz var. Basılı makbuzlarınızda orijinal mağazanızı vurgulamak istiyorsunuz.

Kod düzenleyicinin Bölümler klasöründeki header.liquid şablonuna özel bir mesaj ekleyebilir ve bu mesajı yalnızca ana konumunuz için görüntülemek üzere Liquid'i kullanabilirsiniz.

Aşağıdaki kod, bu örnekte "Home" olarak adlandırılan orijinal konumunuzun adını kontrol eder ve konum adla eşleşirse "1972'de açılan orijinal mağazamıza hoş geldiniz." mesajını görüntüler. Diğer konumlarınızdan yazdırılan makbuzlarda bunun yerine "Mağazamıza hoş geldiniz." mesajı görüntülenir.

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

Shopify yöneticisindeki POS kod düzenleyicisinde basılı makbuzlarınızda yapılan değişiklikleri önizleyebilirsiniz.

Hangi Liquid dosyasının seçildiğine bağlı olarak önizleme penceresi, makbuzun dosyadan etkilenen tasarımını veya bölümünü vurgular. Önizleme penceresi varsayılan olarak en son POS siparişinizin içeriğini görüntüler. gift-card.liquid dosyası hariç tüm Liquid dosyaları için önizleme penceresinde makbuz içeriğiniz olarak kullanılacak belirli bir siparişi seçebilirsiniz. gift-card.liquid dosyasında, seçilebilir önizleme seçenekleri olarak yalnızca farklı konumlar görüntülenir.

Adımlar: