Rujukan pemboleh ubah pemberitahuan

Pemberitahuan yang dihantar dari kedai anda dipaparkan menggunakan Liquid. Liquid ialah bahasa pemprograman Shopify yang ringkas dan mudah digunakan. Ini ialah bahasa pemprograman yang sama yang digunakan untuk membina tema dari Theme Store.

Untuk mengedit pemberitahuan yang dihantar dari kedai anda, anda boleh membuat penyesuaian asas pada templat pemberitahuan anda. Untuk mengakses senarai lengkap pemberitahuan yang boleh anda sesuaikan, pergi ke halaman Pemberitahuan dalam pentadbir Shopify anda.

Untuk mendapatkan bantuan tentang perubahan yang lebih lanjutan, atau untuk membuat perubahan pada templat pemberitahuan tersuai, anda boleh menghubungi komuniti di forum kami, atau anda juga boleh mengupah Rakan Kongsi Shopify untuk melakukan penyesuaian untuk anda. Ketahui lebih lanjut tentang mengupah Rakan Kongsi Shopify.

Pada halaman ini

Sifat pesanan

Banyak sifat pesanan yang tersedia secara terus menggunakan Liquid, dan dalam templat.

Perihalan sifat Liquid yang boleh anda gunakan dengan objek pesanan dalam templat pemberitahuan
Sifat	Perihalan
`id`	ID pesanan unik di seluruh sistem untuk kegunaan dalaman. Gunakan contoh berikut untuk menjana pautan ke pesanan dalam bahagian pentadbir kedai anda. Contohnya, dalam templat Pesanan baharu anda, anda boleh menambahkan kod berikut: `Lihat pesanan`
`email`	E-mel yang dikaitkan dengan pesanan.
`name`	Biasanya ini ialah simbol paun diikuti dengan `order_number`. Contoh: #1004
`order_name`	Sama seperti nama.
`order_number`	Nombor pesanan unik kedai, tanpa awalan paun #, atau sebarang awalan atau akhiran yang ditambahkan pada ID pesanan oleh pemilik kedai dalam keutamaan kedai mereka. Contoh: 1004
`confirmation_number`	Pengenal pasti abjad angka yang dijana secara rawak untuk pesanan yang mungkin ditunjukkan kepada pelanggan berbanding nama pesanan berurutan. Nilai ini tidak dijamin unik. Contoh: XPAV284CT
`created_at`	Tarikh dan masa pelanggan membuat pesanan. Anda boleh memformatnya menggunakan penapis tarikh. Contoh: 2009-05-30T17:43:51+02:00
`payment_terms`	Terma pembayaran menyatakan tarikh bahawa bayaran untuk pesanan perlu dibayar. Ketahui cara untuk menambah terma pembayaran pada invois pesanan. Untuk mendapatkan butiran lanjut, rujuk rujukan Liquid bagi payment_terms.
`destination`	Destinasi untuk item dihantar.
`tags`	Mengembalikan tatasusunan bagi semua tag pesanan. Tag dikembalikan mengikut urutan abjad. Tag yang digunakan secara dinamik oleh aplikasi atau ciri platform, seperti tag `Shopify Collective`, mungkin tidak tersedia apabila e-mel pemberitahuan dijana. Untuk mengesan item daripada ciri tertentu, semak tag peringkat produk pada setiap item baris sebaliknya. Rujuk dokumentasi rujukan Liquid untuk mendapatkan butiran lanjut.
`transactions`	Mengembalikan tatasusunan transaksi daripada pesanan.
`tax_price`	Cukai gabungan bagi semua item dalam pesanan.
`tax_lines`	Cukai dipecahkan mengikut jenis percukaian: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	Nama cukai. Contohnya, QST atau VAT.
`tax_line.price`	Amaun cukai.
`tax_line.rate`	Kadar cukai sebagai perpuluhan. Nilai yang dikembalikan ialah 0.175 jika kadarnya 17.5%.
`tax_line.rate_percentage`	Kadar cukai dalam bentuk yang boleh dibaca oleh manusia. Nilai yang dikembalikan ialah 17.5 jika kadarnya 0.175.
`customer`	Objek pelanggan yang mengandungi atribut output pelanggan.
`billing_address`	Alamat pengebilan.
`billing_address.first_name`	Nama pertama pelanggan.
`billing_address.last_name`	Nama akhir pelanggan.
`billing_address.company`	Nama syarikat untuk pengebilan.
`billing_address.phone`	Nombor telefon daripada alamat pengebilan.
`shop.name`	Nama kedai anda.
`shop.phone`	Nombor telefon kedai anda.
`subtotal_price`	Jumlah harga item baris pesanan selepas sebarang diskaun item baris atau diskaun troli ditolak. Subjumlah tidak merangkumi cukai (melainkan cukai disertakan dalam harga), kos penghantaran atau tip.
`discounts`	Senarai diskaun.
`discounts_amount`	Jumlah diskaun yang dikenakan oleh semua diskaun. Contoh: +$5.00
`discounts_savings`	Jumlah penjimatan yang disebabkan oleh semua diskaun. Contoh: -$5.00
`total_price`	Jumlah pesanan (subjumlah + kos penghantaran - diskaun pengiriman + cukai).
`financial_status`	Status pembayaran semasa. Salah satu daripada: nil, `pending`, `authorized`, `paid`, `voided`, `refunded`.
`requires_shipping`	(boolean) Mengembalikan benar jika terdapat sekurang-kurangnya satu item dalam pesanan yang memerlukan pengiriman.
`shipping_method.title`	Nama kadar pengiriman. Dalam pemberitahuan untuk pelanggan, nama kadar pengiriman diterjemahkan ke dalam bahasa yang pelanggan gunakan untuk membuat pembayaran, apabila bahasa tersebut berbeza daripada bahasa lalai kedai. Contoh: Pengiriman Standard
`shipping_method.price`	Harga pengiriman termasuk sebarang diskaun pengiriman. Contoh: `{{ shipping_method.price \| money }}`
`shipping_price`	Harga pengiriman. Contoh: `{{ shipping_price \| money }}`
`shipping_address`	Alamat penghantaran.
`shipping_address.first_name`	Nama pertama bagi alamat penghantaran.
`shipping_address.company`	Nama syarikat bagi alamat penghantaran.
`shipping_address.phone`	Nombor telefon daripada alamat penghantaran.
`line_items`	Senarai semua item baris dalam pesanan.
`line_items_including_zero_quantity`	Senarai semua item baris dalam pesanan, termasuk item yang mempunyai kuantiti sifar. Item baris mempunyai kuantiti sifar apabila wangnya dikembalikan sepenuhnya.
`line_item_groups`(Orders and POS only)	Senarai semua kumpulan item baris yang mengandungi komponen item baris dalam pesanan.
`item_count`	Hasil tambah semua kuantiti item.
`fulfillment_status`	Status pemenuhan semasa bagi pesanan. Salah satu daripada: `unfulfilled`, `partial`, `fulfilled`.
`note`	Nota yang dilampirkan pada pesanan. Nota tersebut boleh diperoleh daripada pelanggan dan/atau diedit pada skrin butiran pesanan dalam antara muka pentadbir anda.
`attributes`	Sebarang atribut yang dilampirkan pada pesanan. Contoh: `{{ attributes.gift-note }}`
`metafields`	Sebarang medan meta pada pesanan. Gunakan sintaks berikut: metafields.NAMESPACE.KEY
`referring_site`	Mengandungi url perujuk yang membawa pelanggan ke kedai anda. Contoh: `https://www.google.com/?s=great+products`
`landing_site`	Mengandungi laluan tapak penambat yang pelanggan gunakan. Halaman ini ialah halaman pertama yang pelanggan lihat apabila mereka tiba di kedai. Contoh: `/products/great-product?ref=my-tracking-token`
`landing_site_ref`	Menyemak tapak penambat dan mengekstrak parameter rujukan daripadanya. Parameter rujukan boleh jadi: `ref`, `source`, `r`. Jika `landing_site` ialah `/products/great-product?ref=my-tracking-token`, maka `landing_site_ref` ialah `my-tracking-token`. Anda boleh melakukan tindakan tertentu jika ref anda sama dengan nilai tertentu: `{% if landing_site_ref == 'my-tracking-token' %} Tindakan saya... {% endif %}`
`cancelled`	(boolean) Mengembalikan benar jika pesanan telah dibatalkan.
`cancelled_at`	Masa apabila pesanan dibatalkan.
`cancel_reason`	Sebab yang dipilih semasa membatalkan pesanan. Salah satu daripada: `inventory`, `customer`, `declined`, `fraud`, atau `other`.
`has_high_risks?`(deprecated)	Mengembalikan benar jika pesanan berisiko tinggi
`unique_gateways`	Mengembalikan senarai penyedia pembayaran unik pada sesuatu pesanan. Contohnya, jika seseorang membayar dengan Visa, Mastercard, dan wang tunai, maka senarai yang dikembalikan adalah `shopify_payments, cash`.
`location`(POS only)	Memaparkan lokasi fizikal pesanan. Terdapat beberapa sifat lokasi yang tersedia, disenaraikan di sini. Anda boleh mengkonfigurasi lokasi di bahagian Lokasi pada pentadbir.
`order_status_url`	Mengembalikan pautan ke halaman status pesanan untuk pesanan ini.
`fulfilled_line_items`(deprecated)	Senarai item baris yang telah dipenuhi.
`unfulfilled_line_items`(deprecated)	Senarai item baris yang belum dipenuhi sepenuhnya.
`b2b?`	Mengembalikan benar jika pesanan tersebut ialah pesanan B2B. Gunakan sifat bersama pemboleh ubah B2B untuk memaparkan maklumat berkaitan, seperti nama syarikat, lokasi syarikat, dan alamat dalam e-mel. Contohnya, untuk pesanan B2B, anda boleh menambah pengepala pada templat dengan maklumat berikut: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	Syarikat tempat anda menjual pada pesanan B2B.
`company.name`	Nama syarikat pada pesanan B2B.
`company.id`	ID syarikat pada pesanan B2B.
`company_location`	Lokasi syarikat pada pesanan B2B. Syarikat yang membeli daripada anda boleh mempunyai lebih daripada satu lokasi.
`company_location.name`	Nama lokasi syarikat pada pesanan B2B.
`company_location.id`	Nombor ID lokasi syarikat pada pesanan B2B.
`company_location.shipping_address`	Alamat penghantaran lokasi syarikat pada pesanan B2B.
`company_location.billing_address`	Alamat pengebilan lokasi syarikat pada pesanan B2B.
`customer_order_url`	Halaman status pesanan baharu pesanan yang pelanggannya memohon pemulangan menggunakan akaun pelanggan.

Sifat pesanan draf

Penerangan sifat Liquid yang boleh anda gunakan dengan objek pesanan draf dalam templat pemberitahuan
Sifat	Perihalan
`id`	ID unik pesanan draf untuk kegunaan dalaman.
`invoice_url`	Pautan yang boleh pelanggan ikuti untuk membayar invois menggunakan pembayaran selamat Shopify.
`reserve_inventory_until`	Tarikh dan masa item baris dalam draf dirizabkan sehingga, contohnya, `2015-05-30T17:43:51+02:00`. Anda boleh memformatkan tarikh menggunakan penapis tarikh Liquid.
`user`	Kakitangan terakhir yang mengubah suai pesanan draf.
`user.name`	Nama kakitangan terakhir yang mengubah suai pesanan draf.
`user.email`	Alamat e-mel kakitangan terakhir yang mengubah suai pesanan draf.
`email`	Alamat e-mel yang dikaitkan dengan pesanan draf.
`name`	Unik `number` pesanan draf, didahului dengan tanda nombor `#`.
`number`	Nombor unik pesanan draf tanpa awalan atau akhiran pesanan.
`created_at`	Tarikh dan masa pelanggan membuat pesanan draf, contohnya, `2009-05-30T17:43:51+02:00`. Anda boleh memformatkan tarikh menggunakan penapis tarikh Liquid.
`tags`	Mengembalikan tatasusunan untuk semua tag pesanan. Tag dikembalikan dalam susunan abjad. Rujuk dokumentasi rujukan Liquid untuk butiran lanjut.
`tax_price`	Gabungan cukai semua item dalam pesanan draf.
`tax_lines`	Cukai yang dipecahkan mengikut jenis cukai: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	Nama cukai. Contoh: QST atau VAT
`tax_line.price`	Amaun cukai.
`tax_line.rate`	Kadar cukai dalam bentuk perpuluhan. Sebagai contoh, kadar cukai sebanyak 17.5% akan mengembalikan `0.175`.
`tax_line.rate_percentage`	Kadar cukai dalam bentuk peratusan. Sebagai contoh, `rate` 0.175 akan mengembalikan `17.5`.
`customer`	Objek pelanggan yang mengandungi atribut output pelanggan.
`billing_address`	Alamat pengebilan untuk pesanan draf.
`billing_address.first_name`	Nama pertama pelanggan.
`billing_address.last_name`	Nama akhir pelanggan.
`billing_address.company`	Nama syarikat dalam alamat pengebilan.
`billing_address.phone`	Nombor telefon dalam alamat pengebilan.
`shop.name`	Nama kedai anda.
`shop.phone`	Nombor telefon kedai anda.
`subtotal_price`	Jumlah harga item baris pesanan draf selepas sebarang diskaun item baris atau diskaun troli ditolak. Subjumlah tidak merangkumi cukai (melainkan cukai dimasukkan ke dalam harga) atau kos penghantaran.
`discounts`	Senarai diskaun.
`discounts_amount`	Amaun diskaun yang digunakan untuk semua diskaun. Contoh: +$5.00
`discounts_savings`	Amaun penjimatan yang terhasil daripada semua diskaun. Contoh: -$5.00
`total_price`	Jumlah harga pesanan (subjumlah + kos penghantaran - diskaun penghantaran + cukai).
`amount_due_now`	Amaun yang diperlukan oleh invois pesanan draf.
`requires_shipping`	Mengembalikan `true` jika terdapat sekurang-kurangnya satu item dalam pesanan draf yang memerlukan pengiriman. Mengembalikan `false` jika tiada item dalam pesanan draf yang memerlukan pengiriman.
`shipping_method.title`	Nama kadar pengiriman. Contoh: Pengiriman Standard
`shipping_method.price`	Harga kaedah pengiriman. Mengembalikan maklumat yang sama seperti `shipping_price`.
`shipping_price`	Harga pengiriman. Anda boleh memformatkan amaun ini menggunakan penapis wang Liquid.
`shipping_address`	Alamat penghantaran. Nota: Tidak seperti pesanan biasa, alamat penghantaran pesanan draf mungkin tidak lengkap.
`shipping_address.first_name`	Nama pertama bagi alamat penghantaran.
`shipping_address.company`	Nama syarikat dalam alamat penghantaran.
`shipping_address.phone`	Nombor telefon dalam alamat penghantaran.
`line_items`	Senarai semua item baris dalam pesanan draf.
`item_count`	Jumlah semua kuantiti item dalam pesanan draf.
`note`	Nota yang dilampirkan pada pesanan draf. Nota ini boleh diperoleh daripada pelanggan dan juga diedit dalam skrin perincian pesanan draf di pentadbir Shopify anda.
`metafields`	Sebarang medan meta pada pesanan draf. Gunakan sintaks berikut: metafields.NAMESPACE.KEY
`location`	Lokasi fizikal pesanan tersebut. Terdapat beberapa sifat lokasi yang tersedia. Anda boleh mengkonfigurasi lokasi dalam halaman Lokasi di pentadbir Shopify anda.
`b2b?`	Mengembalikan benar jika pesanan tersebut ialah pesanan B2B. Gunakan sifat bersama pemboleh ubah B2B untuk memaparkan maklumat berkaitan, seperti nama syarikat, lokasi syarikat, dan alamat dalam e-mel. Contohnya, untuk pesanan B2B, anda boleh menambah pengepala pada templat dengan maklumat berikut: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	Syarikat tempat anda menjual pada pesanan B2B.
`company.name`	Nama syarikat pada pesanan B2B.
`company.id`	ID syarikat pada pesanan B2B.
`company_location`	Lokasi syarikat pada pesanan B2B. Syarikat yang membeli daripada anda boleh mempunyai lebih daripada satu lokasi.
`company_location.name`	Nama lokasi syarikat pada pesanan B2B.
`company_location.id`	Nombor ID lokasi syarikat pada pesanan B2B.
`company_location.shipping_address`	Alamat penghantaran lokasi syarikat pada pesanan B2B.
`company_location.billing_address`	Alamat pengebilan lokasi syarikat pada pesanan B2B.
`payment_methods`	Senarai kaedah pembayaran yang disimpan dan tersedia untuk memproses jumlah draf.
`payment_method.payment_instrument`	Instrumen pembayaran, yang mengandungi butiran tentang kaedah pembayaran yang disimpan.
`payment_method.payment_instrument.payment_type`	Jenis kaedah pembayaran yang disimpan. Cth. "credit_card, apple_pay"
`payment_method.payment_instrument.credit_card_brand`	Jenama kad, apabila `payment_type` ialah "credit_card"
`payment_method.payment_instrument.credit_card_company`	Syarikat kad, apabila `payment_type` ialah "credit_card"
`payment_method.payment_instrument.credit_card_company`	4 digit terakhir kad tersebut, apabila `payment_type` ialah "credit_card"

Sifat jadual pembayaran

Perihalan sifat Liquid yang anda boleh gunakan dengan objek jadual pembayaran dalam templat pemberitahuan
Sifat	Perihalan
`payment_schedule.amount_due`	Amaun untuk dibayar bagi jadual pembayaran. Anda boleh memformatkan amaun dengan mata wang menggunakan penapis wang Liquid.
`payment_schedule.due_at`	Tarikh akhir untuk jadual pembayaran. Anda boleh memformatkan tarikh menggunakan penapis tarikh Liquid.
`payment_schedule.due_in_days`	Bilangan hari sehingga tarikh akhir jika jadual pembayaran masih perlu dijelaskan (belum dibayar).
`payment_schedule.due_later?`	Mengembalikan nilai benar (true) jika jadual pembayaran belum dibayar dan tarikh akhirnya pada masa hadapan.
`payment_schedule.number_of_days_overdue?`	Bilangan hari dari tarikh akhir apabila jadual pembayaran telah tertunggak.
`payment_schedule.overdue?`	Mengembalikan nilai benar (true) jika jadual pembayaran belum dibayar dan masanya telah melepasi tarikh akhir.

Sifat status pembayaran

Perihalan sifat Liquid yang anda boleh gunakan dengan objek status pembayaran dalam templat pemberitahuan
Sifat	Perihalan
`has_pending_payment`	(boolean) Mengembalikan nilai benar (true) jika pesanan mempunyai transaksi dengan pembayaran yang tertunda. Ketahui lebih lanjut tentang pembayaran yang tertunda.
`buyer_action_required`	(boolean) Mengembalikan nilai benar (true) jika pesanan mempunyai transaksi dengan pembayaran yang tertunda dan tindakan pembeli diperlukan untuk menyahsekat pembayaran. Apabila nilai ini mengembalikan benar dan kaedah pembayaran menyokong arahan pembayaran, `buyer_pending_payment_instructions` menyediakan butiran yang pelanggan boleh gunakan untuk melengkapkan pembelian mereka di luar talian. Ketahui lebih lanjut tentang objek transaksi Liquid.

Sifat komponen berkas

Setiap bundle_component dalam senarai line_item.bundle_components mempunyai sifat yang berikut. (Pesanan draf sahaja)

Perihalan sifat Liquid yang anda boleh gunakan dengan objek komponen berkas dalam templat pemberitahuan
Sifat	Perihalan
`bundle_component.image_url`	URL imej komponen berkas.
`bundle_component.product.title`	Tajuk produk komponen berkas.
`bundle_component.quantity`	Kuantiti untuk komponen berkas.
`bundle_component.variant.title`	Nama semasa bagi nilai pilihan varian komponen berkas, disambungkan oleh aksara `/`. Contoh: kecil / merah

Sifat komponen

Setiap component dalam senarai line_item.components mempunyai sifat yang berikut. (Pembayaran terbiar sahaja) `

Perihalan sifat Liquid yang boleh anda gunakan dengan objek komponen dalam templat pemberitahuan
Sifat	Perihalan
`component.image_url`	URL imej komponen.
`component.product.title`	Tajuk produk komponen.
`component.quantity`	Kuantiti untuk komponen tersebut.
`component.variant.title`	Nama semasa untuk nilai pilihan varian komponen, digabungkan oleh aksara `/`. Contoh: kecil / merah

Sifat item baris

Setiap line dalam senarai line_items atau subtotal_line_items mempunyai sifat yang berikut.

Perihalan sifat Liquid yang boleh anda gunakan dengan objek item baris dalam templat pemberitahuan
Sifat	Perihalan
`line.applied_discounts`(POS and draft orders only)	Senarai diskaun yang digunakan pada item ini (setiap diskaun mempunyai sifat `title`, `code`, `amount`, `savings` dan `type`).
`line.bundle_components`(Draft orders only)	Senarai item baris yang menjadi komponen berkas untuk item ini. Hanya mengembalikan senarai jika item baris ini merupakan produk berkas.
`line.bundle_parent?`(Draft orders only)	(boolean) Mengembalikan nilai benar jika item baris ialah produk berkas.
`line.components`(Abandoned checkout only)	Senarai item baris yang merupakan komponen bagi item ini.
`line.parent?`(Abandoned checkout only)	(boolean) Mengembalikan nilai benar jika item baris tersebut mempunyai komponen.
`line.custom`(Draft orders only)	(boolean) Mengembalikan nilai benar jika item tersebut ialah item baris tersuai bagi pesanan draf.
`line.delivery_agreement`	Perjanjian Penghantaran yang dikaitkan dengan item baris ini.
`line.grams`	Berat satu item.
`line.groups`	Kumpulan item baris item tersebut.
`line.image`	Mengembalikan URL imej yang dikaitkan dengan item baris ini. Anda juga boleh menggunakan penapis img_url untuk mendapatkan saiz imej yang khusus, contohnya `{{ line.image \| img_url: 'small' }}`
`line.line_price`	Harga didarabkan dengan kuantiti untuk item tersebut.
`line.original_line_price`	Harga gabungan untuk kuantiti item yang disertakan dalam baris, sebelum diskaun dikenakan.
`line.final_line_price`	Harga gabungan bagi semua item dalam item baris, termasuk semua amaun diskaun peringkat baris.
`line.pre_tax_price`	Harga pracukai untuk item baris, didarabkan dengan kuantiti item baris yang dibeli.
`line.price`	Harga bagi item tunggal.
`line.product.metafields`	Sebarang medan meta pada peringkat produk. Gunakan sintaks yang berikut: line.product.metafields.NAMESPACE.KEY
`line.product.title`	Nama semasa produk.
`line.product.vendor`	Vendor untuk item tersebut.
`line.properties`	Mengembalikan tatasusunan maklumat tersuai untuk sesuatu item. Sifat item baris ditentukan oleh pelanggan pada halaman produk, sebelum menambah produk ke dalam troli.
`line.quantity`	Kuantiti untuk item tersebut.
`line.current_quantity`	Kuantiti semasa item selepas pengalihan keluar.
`line.requires_shipping`	(boolean) Mengembalikan nilai benar jika varian bagi item itu mempunyai tetapan Produk fizikal diaktifkan pada halaman produk.
`line.selling_plan_allocation`	Mengembalikan objek `selling_plan_allocation`, yang menerangkan cara pelan jualan seperti langganan mempengaruhi item baris tersebut.
`line.taxable`	(boolean) Mengembalikan nilai benar jika varian untuk item itu mempunyai kotak semak 'Caj cukai pada produk ini' ditandai pada halaman produk.
`line.title`	Nama produk semasa jualan, diikuti dengan sengkang dan nama varian semasa jualan. Nama varian tidak disertakan apabila nama varian ialah "Default Title". Dalam pemberitahuan yang dilihat pelanggan, nama produk dan nama varian diterjemahkan ke dalam bahasa yang pelanggan gunakan untuk mendaftar keluar, apabila bahasa tersebut berbeza daripada bahasa kedai lalai.
`line.url`	URL relatif bagi varian item baris. URL relatif tidak termasuk URL akar bagi kedai anda (`mystore.myshopify.com`).
`line.variant.barcode`	Kod bar yang dikaitkan dengan varian produk.
`line.variant.compare_at_price`	Harga bandingkan di yang dikaitkan dengan varian produk.
`line.variant.image`	Imej untuk varian produk. Hanya mengembalikan imej jika terdapat imej khusus yang ditetapkan kepada varian dalam item baris.
`line.variant.metafields`	Sebarang medan meta pada peringkat varian. Gunakan sintaks yang berikut: line.variant.metafields.NAMESPACE.KEY
`line.variant.sku`	SKU yang dikaitkan dengan varian produk.
`line.variant.title`	Nama semasa bagi nilai pilihan varian, digabungkan oleh aksara `/`. Contoh: kecil / merah
`line.refunded.quantity`(within refund notifications)	Kuantiti item yang akan dibayar balik. Anda boleh menggunakan sifat ini untuk menambahkan pengenal pasti pada item yang dibayar balik dalam pesanan. Contohnya: `{% if line.refunded_quantity > 0 %}Pengenal pasti baris dibayar balik{% endif %}`

Kesan item Shopify Collective dalam templat pemberitahuan

Tag Shopify Collective digunakan pada pesanan selepas e-mel pengesahan pesanan dihantar, oleh itu {% if tags contains 'Shopify Collective' %} tidak akan menjadi true dalam templat pengesahan pesanan. Untuk mengesan item Shopify Collective, sebaliknya periksa tag peringkat produk pada setiap item baris:

{% assign has_collective_item = false %}
{% for line in line_items %}
  {% if line.product.tags contains 'Shopify Collective' %}
    {% assign has_collective_item = true %}
  {% endif %}
{% endfor %}

{% if has_collective_item %}
  <!-- Collective-specific content -->
{% endif %}

Sifat kumpulan item baris

Setiap line_item_group dalam senarai line_item_groups mempunyai sifat yang berikut.

Perihalan sifat Liquid yang boleh anda gunakan dengan objek kumpulan item baris dalam templat pemberitahuan
Sifat	Perihalan
`line_item_group.display_title`	Tajuk bagi kumpulan item baris.
`line_item_group.components`	Senarai komponen item baris yang dimiliki oleh kumpulan tersebut.
`line_item_group.image`	Imej kumpulan item baris.
`line_item_group.product_id`	ID produk kumpulan item baris.
`line_item_group.variant`	Objek varian kumpulan item baris.
`line_item_group.variant_id`	ID varian kumpulan item baris.

Sifat bayaran balik

Perihalan sifat Liquid yang boleh anda gunakan dengan objek bayaran balik dalam templat pemberitahuan
Sifat	Perihalan
`amount`	Amaun wang yang dibayar balik.
`refund_line_items`	Senarai item baris bayaran balik yang perlu dibayar balik.

Sifat Refund_line_item

Setiap refund_line dalam senarai refund_line_items mempunyai sifat yang berikut:

Perihalan sifat Liquid yang boleh anda gunakan dengan objek item baris bayaran balik dalam templat pemberitahuan
Sifat	Perihalan
`refund_line.line_item`	line_item yang sedang dibayar balik. Ini mempunyai akses kepada semua sifat line_item.
`refund_line.quantity`	Kuantiti item baris yang akan dibayar balik.

Sifat pemenuhan

Perihalan sifat Liquid yang boleh anda gunakan dengan objek pemenuhan dalam templat pemberitahuan
Sifat	Perihalan
`service_name`	Nama perkhidmatan tersuai seperti yang ditetapkan dalam halaman Tetapan > Pengiriman dan penghantaran. (Permintaan pemenuhan sahaja)
`fulfillment.estimated_delivery_at`	Anggaran tarikh penghantaran berdasarkan nombor penjejakan (jika ada) yang disediakan oleh salah satu pembawa berikut: USPS, FedEx, UPS, Canada Post (Kanada sahaja). Sifat ini hanya tersedia apabila kadar yang dikira oleh pembawa sedang digunakan.
`fulfillment.fulfillment_line_items`	Senarai item baris pemenuhan yang akan dipenuhi.
`fulfillment.item_count`	Jumlah keseluruhan kuantiti item. Jumlah bilangan item yang sedang dipenuhi.
`fulfillment.requires_shipping`	(boolean) Mengembalikan true jika permintaan pemenuhan ini memerlukan pengiriman.
`fulfillment.tracking_company`	Syarikat yang melakukan penjejakan.
`fulfillment.tracking_numbers`	Senarai nombor penjejakan.
`fulfillment.tracking_urls`	Senarai URL penjejakan.
`items_to_fulfill`(deprecated)	Senarai item baris yang akan dipenuhi oleh perkhidmatan pemenuhan tersuai yang khusus ini. (Permintaan pemenuhan sahaja)
`items_to_fulfill_count`(deprecated)	Jumlah bilangan item yang akan dipenuhi melalui permintaan ini. (Permintaan pemenuhan sahaja)

Sifat Fulfillment_line_item

Setiap fulfillment_line dalam senarai fulfillment_line_items mempunyai sifat berikut.

Perihalan sifat Liquid yang boleh anda gunakan dengan objek item baris pemenuhan dalam templat pemberitahuan
Sifat	Perihalan
`fulfillment_line.line_item`	line_item yang sedang dipenuhi. Ini mempunyai akses kepada semua sifat line_item.
`fulfillment_line.quantity`	Kuantiti item baris yang sedang dipenuhi.

Sifat pakej yang disediakan

Pakej yang disediakan merangkumi item yang ditandakan sebagai sedia untuk pengambilan.

Perihalan sifat Liquid yang boleh anda gunakan dengan objek pakej yang disediakan dalam templat pemberitahuan
Sifat	Perihalan
`item_count`	Jumlah keseluruhan kuantiti item dalam pakej yang disediakan.
`prepared_package_line_items`	Senarai item baris pakej yang disediakan.

Sifat Prepared_package_line_item

Setiap prepared_package_line_item dalam senarai prepared_package_line_items mempunyai sifat berikut.

Perihalan sifat Liquid yang boleh anda gunakan dengan objek item baris pakej yang disediakan dalam templat pemberitahuan
Sifat	Perihalan
`line_item`	line_item yang berkaitan. Ini mempunyai akses kepada semua sifat line_item.
`quantity`	Kuantiti item baris yang telah ditandakan sebagai sedia untuk pengambilan.

Sifat penghantaran

Perihalan sifat Liquid yang boleh anda gunakan dengan objek penghantaran dalam templat pemberitahuan
Sifat	Perihalan
`delivery_agreements`	Senarai semua Perjanjian Penghantaran untuk pesanan.
`delivery_instructions`	Maklumat penghantaran tempatan untuk dikongsikan dengan pelanggan. Maklumat ini dikawal oleh medan Maklumat penghantaran dalam tetapan penghantaran tempatan anda.
`consolidated_estimated_delivery_time`	Maklumat tarikh penghantaran pesanan untuk dikongsikan dengan pelanggan. Maklumat ini dikawal oleh tetapan Masa pemprosesan yang anda sediakan dalam halaman Pengiriman dan penghantaran anda. Apabila pesanan mempunyai berbilang kaedah penghantaran, senarai kaedah dan tarikh penghantaran dipaparkan.
`has_multiple_delivery_methods`	(boolean) Mengembalikan true jika pesanan mempunyai berbilang kaedah penghantaran.

Sifat Perjanjian Penghantaran

Perihalan sifat Liquid yang boleh anda gunakan dengan objek perjanjian penghantaran dalam templat pemberitahuan
Sifat	Perihalan
`delivery_agreement.delivery_method_type`	Jenis kaedah penghantaran.
`delivery_agreement.delivery_method_name`	Jenis kaedah penghantaran yang diterjemahkan ke dalam bahasa yang digunakan oleh pembeli semasa mendaftar keluar, apabila bahasa tersebut berbeza daripada bahasa kedai lalai.
`delivery_agreement.line_item_groups`	Senarai semua kumpulan item baris yang mengandungi komponen item baris himpunan dalam perjanjian penghantaran.
`delivery_agreement.line_items`	Senarai semua item baris yang berkaitan dengan perjanjian penghantaran ini.

Sifat diskaun

Terdapat dua jenis sifat diskaun.

discount_applications menerangkan sebab dan cara item diberikan diskaun.

discount_allocations menerangkan cara diskaun tertentu memberikan kesan pada item baris dan cara diskaun tersebut mengurangkan harga. Anda harus menggunakan sifat ini pada tahap item baris.

Anda boleh menggabungkan sifat-sifat ini untuk memaparkan maklumat diskaun pada tahap item baris atau pesanan.

Contoh

Contoh ini menyemak sama ada diskaun telah digunakan pada item baris. Jika diskaun tidak digunakan pada tahap pesanan (all), maka nama dan jumlah diskaun akan dipaparkan.

{% if line.discount_allocations %}
	{% for discount_allocation in line.discount_allocations %}
    	{% if discount_allocation.discount_application.target_selection != 'all' %}
        	{{ discount_allocation.discount_application.title | upcase }}
        	(-{{ discount_allocation.amount | money }})
    	{% endif %}
	{% endfor %}
{% endif %}

Keputusan mungkin serupa dengan yang berikut:

SPRING5 (-$5.00)

Sifat Discount_allocation

Setiap discount_allocation dalam senarai discount_allocations mempunyai sifat berikut.

Perihalan sifat Liquid yang boleh anda gunakan dengan objek discount_allocation dalam templat pemberitahuan
Sifat	Perihalan
`discount_allocation.amount`	Jumlah wang yang dijimatkan oleh pelanggan pada sesuatu item baris. Mesti dimasukkan dalam gelung (loop) jika anda mahu membenarkan berbilang kod diskaun.
`discount_allocation.discount_application`	Penggunaan diskaun yang memperuntukkan jumlah pada item baris tersebut.

Sifat Discount_application

Setiap discount_application dalam senarai discount_applications mempunyai sifat berikut.

Perihalan sifat Liquid yang boleh anda gunakan dengan objek discount_application dalam templat pemberitahuan
Sifat	Perihalan
`discount_application.target_selection`	Menerangkan cara diskaun memilih item baris dalam troli untuk diberikan diskaun. Salah satu daripada yang berikut: `all`: Diskaun digunakan pada semua item baris. `entitled`: Diskaun digunakan pada subset item baris tertentu, yang lazimnya ditakrifkan oleh sesuatu syarat. `explicit`: Diskaun digunakan pada item baris atau baris pengiriman yang dipilih secara khusus.
`discount_application.target_type`	Jenis item yang dikenakan diskaun (`line_item` atau `shipping_line`).
`discount_application.title`	Nama diskaun yang dipaparkan kepada pelanggan. Contoh: Welcome10 atau CBBWQQAKYBYY
`discount_application.total_allocated_amount`	Jumlah keseluruhan harga pesanan yang dikurangkan oleh diskaun.
`discount_application.type`	Jenis diskaun. Salah satu daripada: `automatic`, `discount_code`, `manual` atau `script`.
`discount_application.value`	Nilai diskaun.
`discount_application.value_type`	Jenis nilai diskaun. Salah satu daripada: `fixed_amount` atau `percentage`.

Sifat langganan

Butiran kontrak langganan, kitaran pengebilan semasa dan item barisnya, kaedah penghantaran serta kaedah pembayaran tersedia untuk semua templat e-mel langganan.

Untuk mengedit templat pemberitahuan langganan, pasang aplikasi Shopify Subscriptions, kemudian cari templat tersebut di bawah Tetapan > Pemberitahuan dalam bahagian Langganan.

Sifat kitaran pengebilan kontrak langganan

Untuk mengakses sifat kontrak langganan dan kitaran pengebilannya, gunakan objek subscription_contract_billing_cycle.

Contoh

{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.

Hasil:

This contract is currently paused.

Sifat

Penerangan sifat Liquid yang boleh anda gunakan dengan objek kitaran pengebilan kontrak langganan dalam templat pemberitahuan
Sifat	Perihalan
`status`	Status kontrak. Salah satu daripada `active`, `paused`, `cancelled`, `failed`, `expired`, `stale`,
`delivery_method`	Kaedah penghantaran langganan. Jika langganan adalah untuk perkhidmatan atau produk digital, maka `nil` dikembalikan.
`billing_frequency`	Kekerapan langganan dikebilkan.
`delivery_frequency`	Kekerapan langganan dihantar.
`origin_order`	Pesanan asal yang pertama kali membuat langganan. Jika langganan tidak dibuat daripada pesanan Shopify, maka `nil` dikembalikan.
`customer`	Pelanggan langganan.
`line_items`	Item baris dalam kitaran pengebilan langganan.
`product_names`	Senarai nama produk yang disertakan dalam kitaran pengebilan langganan.
`update_payment_method_url`	URL yang boleh digunakan oleh pelanggan untuk mengemas kini kaedah pembayaran bagi kontrak ini.
`shipping_address`	Alamat penghantaran langganan. Jika langganan adalah untuk perkhidmatan atau produk digital, maka `nil` dikembalikan.
`billing_address`	Alamat pengebilan langganan.
`subtotal_price`	Harga subjumlah item baris langganan.
`shipping_price`	Harga pengiriman langganan.
`total_tax`	Jumlah cukai langganan.
`total_price`	Jumlah harga langganan.
`total_discounts`	Jumlah diskaun langganan.
`customer_self_serve_url`	URL layan diri yang boleh digunakan oleh pelanggan untuk mengurus langganan mereka.
`billing_attempt_expected_date`	Tarikh pengebilan untuk kitaran pengebilan ini.
`next_billing_date`	Tarikh pengebilan tidak dilangkau yang seterusnya selepas kitaran pengebilan ini.
`last_attempted_billing_date`	Tarikh percubaan pengebilan terakhir untuk kitaran pengebilan tersebut.
`days_overdue`	Bilangan hari pengebilan tertunggak untuk kitaran pengebilan ini.
`payment_instrument`	Instrumen pembayaran yang dikaitkan dengan kontrak langganan. Instrumen pembayaran ini digunakan untuk mengebilkan pelanggan.

Sifat item baris kontrak langganan

Sifat untuk setiap item baris yang disertakan dalam kitaran pengebilan. Akses sifat item baris kontrak melalui sifat induk subscription_contract_billing_cycle.line_items.

Contoh

{% for line_item in subscription_contract_billing_cycle.line_items %}
  {{ line_item.url }}
{% endfor %}

Penerangan sifat Liquid yang boleh anda gunakan dengan objek item baris kontrak langganan dalam templat pemberitahuan
Sifat	Perihalan
`url`	URL ke halaman butiran produk untuk varian produk item baris tersebut.
`requires_shipping`	Sama ada item baris tersebut memerlukan pengiriman fizikal.
`unit_price_measurement`	Ukuran harga unit item baris.
`selling_plan_allocation`	Peruntukan pelan jualan item baris.

Sifat kaedah penghantaran kontrak langganan

Sifat bagi kaedah penghantaran yang digunakan dalam kitaran pengebilan ini. Akses sifat kaedah penghantaran melalui sifat induk subscription_contract_billing_cycle.delivery_method.

Contoh

{% if subscription_contract_billing_cycle.delivery_method != blank %}
  Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}

Penerangan sifat Liquid yang boleh anda gunakan dengan objek kaedah penghantaran kontrak langganan dalam templat pemberitahuan
Sifat	Perihalan
`title`	Tajuk pilihan pengiriman yang dikaitkan dengan kaedah penghantaran.
`type`	Jenis kaedah penghantaran. Salah satu daripada `shipping`, `local` atau `pick-up`.

Sifat instrumen pembayaran kontrak langganan

Butiran tentang instrumen pembayaran untuk kontrak langganan tersebut. Instrumen pembayaran ini digunakan untuk mengebilkan pelanggan. Akses sifat instrumen pembayaran melalui sifat induk subscription_contract_billing_cycle.payment_instrument.

Contoh

{% assign instrument = subscription_contract_billing_cycle.payment_instrument %}

<img src="{{ instrument.payment_type | payment_type_img_url }} "  alt="{{ instrument.credit_card_company }}" />
{{ instrument.credit_card_company }} ending with {{ instrument.credit_card_last_four_digits }}

Penerangan sifat Liquid yang boleh anda gunakan dengan objek instrumen pembayaran kontrak langganan dalam templat pemberitahuan
Sifat	Perihalan
`payment_type`	Jenis kaedah pembayaran yang diwakili oleh instrumen pembayaran. Gunakan penapis pembayaran untuk mengeluarkan URL imej atau SVG.
`credit_card_brand`	Jenama kad kredit tersebut.
`credit_card_company`	Nama syarikat kad kredit tersebut.
`credit_card_last_four_digits`	4 digit terakhir kad kredit tersebut.

Sifat pemberitahuan e-mel

Penerangan sifat Liquid yang boleh anda gunakan dengan objek pemberitahuan e-mel dalam templat pemberitahuan
Sifat	Perihalan
`shop.email_logo_url`	URL untuk logo yang ditentukan di bahagian Sesuaikan templat e-mel pada panel pentadbir.
`shop.email_logo_width`	Lebar logo (piksel) yang ditentukan di bahagian Sesuaikan templat e-mel pada panel pentadbir.
`shop.email_accent_color`	Kod HEX untuk warna aksen yang ditentukan di bahagian Sesuaikan templat e-mel pada panel pentadbir.

Sifat kredit kedai

Sifat yang mengandungi butiran tentang pengeluaran kredit kedai.

Penerangan sifat Liquid yang boleh anda gunakan dengan objek kredit kedai yang dikeluarkan dalam templat pemberitahuan
Sifat	Perihalan
`issued_store_credit.amount`	Amaun kredit kedai yang telah dikeluarkan. Anda boleh memformatkan amaun ini menggunakan penapis wang Liquid.
`issued_store_credit.expires_at`	Tarikh dan masa kredit kedai yang dikeluarkan akan tamat tempoh. Anda boleh memformat amaun ini menggunakan penapis tarikh Liquid.
`issued_store_credit.balance_after_transaction`	Baki akaun kredit kedai selepas kredit dikeluarkan. Anda boleh memformatkan amaun ini menggunakan penapis wang Liquid.
`customer`	Objek pelanggan yang mengandungi atribut output pelanggan.