Referensi variabel notifikasi

Notifikasi yang dikirim dari toko Anda dirender menggunakan Liquid. Liquid adalah bahasa pemrograman Shopify yang sederhana dan mudah digunakan. Ini adalah bahasa pemrograman yang sama dengan yang digunakan untuk membangun tema dari Theme Store.

Untuk mengedit notifikasi yang dikirim dari toko Anda, Anda dapat melakukan kustomisasi dasar pada templat notifikasi Anda. Untuk mengakses daftar lengkap notifikasi yang dapat Anda sesuaikan, buka halaman Notifikasi di admin Shopify Anda.

Untuk bantuan terkait perubahan yang lebih lanjut, atau untuk membuat perubahan pada templat notifikasi kustom, Anda dapat menghubungi komunitas di forum kami, atau Anda juga dapat mempekerjakan Mitra Shopify untuk melakukan kustomisasi untuk Anda. Pelajari selengkapnya tentang mempekerjakan Mitra Shopify.

Catatan

Semua templat di admin Shopify memiliki akses ke properti pesanan yang terkait. Semua variabel tersedia untuk digunakan di templat notifikasi mana pun, tetapi beberapa variabel mungkin tidak berlaku jika data belum tersedia saat notifikasi dikirim.

Properti pesanan

Banyak properti pesanan tersedia secara langsung menggunakan Liquid, dan di dalam templat.

Catatan

Objek pesanan tidak dirujuk berdasarkan nama di templat email. Misalnya, daripada menggunakan {{ order.shipping_method.title }} di templat email konfirmasi pesanan Anda, sebaiknya gunakan {{ shipping_method.title }}. Namun, untuk notifikasi SMS, properti pesanan harus diawali dengan order seperti biasa.

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek pesanan di templat notifikasi

Properti	Deskripsi
id	ID unik pesanan di seluruh sistem untuk penggunaan internal. Gunakan contoh berikut untuk membuat tautan ke pesanan di bagian admin toko Anda. Misalnya, di templat Pesanan baru Anda, Anda dapat menambahkan kode berikut: Lihat pesanan
email	Email yang terkait dengan pesanan.
name	Biasanya ini adalah simbol pagar yang diikuti oleh order_number. Contoh: #1004
order_name	Sama seperti nama.
order_number	Nomor unik pesanan toko, tanpa awalan pagar #, atau awalan maupun akhiran apa pun yang ditambahkan ke ID pesanan oleh pemilik toko dalam preferensi tokonya. Contoh: 1004
confirmation_number	Pengidentifikasi alfanumerik yang dibuat secara acak untuk pesanan yang mungkin ditampilkan kepada pelanggan, bukan nama pesanan yang berurutan. Nilai ini tidak dijamin unik. Contoh: XPAV284CT
created_at	Tanggal dan waktu pelanggan membuat pesanan. Anda dapat memformatnya menggunakan filter tanggal. Contoh: 2009-05-30T17:43:51+02:00
payment_terms	Ketentuan pembayaran menentukan tanggal jatuh tempo pembayaran untuk suatu pesanan. Pelajari cara menambahkan ketentuan pembayaran ke faktur pesanan. Untuk detail selengkapnya, lihat referensi Liquid untuk payment_terms.
destination	Tujuan tempat item harus dikirim.
tags	Mengembalikan array dari semua tag pesanan. Tag tersebut dikembalikan berdasarkan urutan abjad. Tag yang diterapkan secara dinamis oleh aplikasi atau fitur platform, seperti tag Shopify Collective, mungkin tidak tersedia saat email pemberitahuan dibuat. Sebagai gantinya, untuk mendeteksi item dari fitur tertentu, periksa tag di tingkat produk pada setiap item pesanan. Baca dokumentasi referensi Liquid untuk detail selengkapnya.
transactions	Menampilkan array transaksi dari pesanan.
tax_price	Gabungan pajak dari semua item dalam pesanan.
tax_lines	Pajak dipecah berdasarkan jenis perpajakan: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title	Nama pajak. Misalnya, QST atau PPN.
tax_line.price	Jumlah pajak.
tax_line.rate	Tarif pajak dalam format desimal. Akan menampilkan 0,175 jika tarifnya 17,5%.
tax_line.rate_percentage	Tarif pajak dalam format yang dapat dibaca manusia. Akan menampilkan 17,5 jika tarifnya 0,175.
customer	Objek pelanggan yang berisi atribut dari output pelanggan.
billing_address	Alamat penagihan.
billing_address.first_name	Nama depan pelanggan.
billing_address.last_name	Nama belakang pelanggan.
billing_address.company	Nama perusahaan untuk penagihan.
billing_address.phone	Nomor telepon dari alamat penagihan.
shop.name	Nama toko Anda.
shop.phone	Nomor telepon toko Anda.
subtotal_price	Jumlah harga item pesanan setelah diskon item pesanan atau diskon keranjang dikurangi. Subtotal tidak termasuk pajak (kecuali jika pajak sudah termasuk dalam harga), biaya pengiriman, atau tip.
discounts	Daftar diskon.
discounts_amount	Jumlah total diskon yang diterapkan. Contoh: +$5,00
discounts_savings	Jumlah penghematan dari semua diskon. Contoh: -$5,00
total_price	Total pesanan (subtotal + biaya pengiriman - diskon pengiriman + pajak).
financial_status	Status pembayaran saat ini. Salah satu dari: nil, pending, authorized, paid, voided, refunded.
requires_shipping	(boolean) Menampilkan true jika ada setidaknya satu item dalam pesanan yang memerlukan pengiriman.
shipping_method.title	Nama tarif pengiriman. Dalam notifikasi yang dilihat pelanggan, nama tarif pengiriman diterjemahkan ke dalam bahasa yang digunakan pelanggan saat checkout, jika bahasanya berbeda dari bahasa default toko. Contoh: Pengiriman Standar
shipping_method.price	Harga pengiriman termasuk diskon pengiriman apa pun. Contoh: {{ shipping_method.price | money }}
shipping_price	Harga pengiriman. Contoh: {{ shipping_price | money }}
shipping_address	Alamat pengiriman.
shipping_address.first_name	Nama depan untuk alamat pengiriman.
shipping_address.company	Nama perusahaan untuk alamat pengiriman.
shipping_address.phone	Nomor telepon dari alamat pengiriman.
line_items	Daftar semua item pesanan dalam pesanan.
line_items_including_zero_quantity	Daftar semua item pesanan dalam pesanan, termasuk yang kuantitasnya nol. Item pesanan memiliki kuantitas nol saat dananya telah dikembalikan sepenuhnya.
line_item_groups(Orders and POS only)	Daftar semua grup item pesanan yang berisi komponen item pesanan dalam pesanan.
item_count	Jumlah semua kuantitas item.
fulfillment_status	Status pemenuhan pesanan saat ini. Salah satu dari: unfulfilled, partial, fulfilled.
note	Catatan yang dilampirkan ke pesanan. Catatan dapat diperoleh dari pelanggan dan/atau diedit di layar detail pesanan di antarmuka admin Anda.
attributes	Setiap atribut yang dilampirkan pada pesanan. Contoh: {{ attributes.gift-note }}
metafields	Setiap metafield pada pesanan. Gunakan sintaksis berikut: metafields.NAMESPACE.KEY
referring_site	Berisi URL pereferensi yang membawa pelanggan ke toko Anda. Contoh: https://www.google.com/?s=great+products
landing_site	Berisi jalur situs landas yang digunakan pelanggan. Ini adalah halaman pertama yang dilihat pelanggan saat mereka tiba di toko. Contoh: /products/great-product?ref=my-tracking-token
landing_site_ref	Meninjau situs landas dan mengekstrak parameter referensi darinya. Parameter referensi dapat berupa: ref, source, r. Jika landing_site adalah /products/great-product?ref=my-tracking-token, maka landing_site_ref adalah my-tracking-token. Anda dapat melakukan tindakan tertentu jika ref Anda sama dengan nilai tertentu: {% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}
cancelled	(boolean) Menampilkan true jika pesanan telah dibatalkan.
cancelled_at	Waktu saat pesanan dibatalkan.
cancel_reason	Alasan yang dipilih saat membatalkan pesanan. Salah satu dari: inventory, customer, declined, fraud, atau other.
has_high_risks?(deprecated)	Menampilkan true jika pesanan memiliki risiko tinggi
unique_gateways	Mengembalikan daftar penyedia pembayaran unik pada suatu pesanan. Misalnya, jika seseorang membayar dengan Visa, Mastercard, dan uang tunai, maka daftar yang akan dikembalikan adalah shopify_payments, cash.
location(POS only)	Menampilkan lokasi fisik pesanan. Ada beberapa properti lokasi yang tersedia, yang tercantum di sini. Anda dapat mengonfigurasi lokasi di area Lokasi di panel admin.
order_status_url	Mengembalikan tautan ke halaman status pesanan untuk pesanan ini.
fulfilled_line_items(deprecated)	Daftar item pesanan yang telah terpenuhi.
unfulfilled_line_items(deprecated)	Daftar item pesanan yang belum terpenuhi sepenuhnya.
b2b?	Mengembalikan nilai benar (true) jika pesanan adalah pesanan B2B. Gunakan properti ini dengan variabel B2B untuk menampilkan informasi relevan, seperti nama perusahaan, lokasi perusahaan, dan alamat di email. Misalnya, pada pesanan B2B, Anda dapat menambahkan header ke templat dengan informasi berikut: {% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company	Perusahaan tempat Anda menjual pada pesanan B2B.
company.name	Nama perusahaan pada pesanan B2B.
company.id	ID perusahaan pada pesanan B2B.
company_location	Lokasi perusahaan pada pesanan B2B. Perusahaan yang membeli dari Anda dapat memiliki lebih dari satu lokasi.
company_location.name	Nama lokasi perusahaan pada pesanan B2B.
company_location.id	Nomor ID lokasi perusahaan pada pesanan B2B.
company_location.shipping_address	Alamat pengiriman dari lokasi perusahaan pada pesanan B2B.
company_location.billing_address	Alamat penagihan dari lokasi perusahaan pada pesanan B2B.
customer_order_url	Halaman status pesanan baru dari pesanan yang pengembaliannya diminta pelanggan menggunakan akun pelanggan.

Properti draf pesanan

Catatan

Anda tidak dapat mengirim notifikasi draf pesanan menggunakan SMS.

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek draf pesanan di templat notifikasi

Properti	Deskripsi
id	ID unik draf pesanan untuk penggunaan internal.
invoice_url	Tautan yang dapat diikuti pelanggan untuk membayar invois menggunakan checkout aman Shopify.
reserve_inventory_until	Tanggal dan waktu item pesanan dalam draf direservasi hingga, misalnya, 2015-05-30T17:43:51+02:00. Anda dapat memformat tanggal menggunakan filter tanggal Liquid.
user	Staf terakhir yang mengubah draf pesanan.
user.name	Nama staf terakhir yang mengubah draf pesanan.
user.email	Alamat email staf terakhir yang mengubah draf pesanan.
email	Alamat email yang terkait dengan draf pesanan.
name	Yang unik number dari draf pesanan, yang diawali dengan tanda pagar #.
number	Nomor unik draf pesanan tanpa awalan atau akhiran pesanan.
created_at	Tanggal dan waktu pelanggan membuat draf pesanan, misalnya, 2009-05-30T17:43:51+02:00. Anda dapat memformat tanggal menggunakan filter tanggal Liquid.
tags	Menampilkan array semua tag pesanan. Tag ditampilkan dalam urutan abjad. Lihat dokumentasi referensi Liquid untuk detail selengkapnya.
tax_price	Gabungan pajak dari semua item dalam draf pesanan.
tax_lines	Pajak yang diperinci berdasarkan jenis pajak: {% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }} {% endfor %}
tax_line.title	Nama pajak. Contoh: QST atau PPN
tax_line.price	Jumlah pajak.
tax_line.rate	Tarif pajak dalam bentuk desimal. Misalnya, tarif pajak 17,5% akan menghasilkan 0,175.
tax_line.rate_percentage	Tarif pajak dalam bentuk persentase. Misalnya, tarif 0,175 akan menghasilkan 17,5.
customer	Objek pelanggan yang berisi atribut dari output pelanggan.
billing_address	Alamat penagihan untuk draf pesanan.
billing_address.first_name	Nama depan pelanggan.
billing_address.last_name	Nama belakang pelanggan.
billing_address.company	Nama perusahaan di alamat penagihan.
billing_address.phone	Nomor telepon di alamat penagihan.
shop.name	Nama toko Anda.
shop.phone	Nomor telepon toko Anda.
subtotal_price	Jumlah harga item pesanan draf pesanan setelah diskon item pesanan atau diskon keranjang dikurangi. Subtotal tidak termasuk pajak (kecuali pajak sudah termasuk dalam harga) atau biaya pengiriman.
discounts	Daftar diskon.
discounts_amount	Jumlah diskon yang diterapkan oleh semua diskon. Contoh: +$5,00
discounts_savings	Jumlah penghematan yang disebabkan oleh semua diskon. Contoh: -$5,00
total_price	Total harga pesanan (subtotal + biaya pengiriman - diskon pengiriman + pajak).
amount_due_now	Jumlah yang diperlukan oleh invois draf pesanan.
requires_shipping	Mengembalikan true jika ada setidaknya satu item dalam draf pesanan yang memerlukan pengiriman. Mengembalikan false jika tidak ada item dalam draf pesanan yang memerlukan pengiriman.
shipping_method.title	Nama tarif pengiriman. Contoh: Pengiriman Standar
shipping_method.price	Harga metode pengiriman. Mengembalikan informasi yang sama dengan shipping_price.
shipping_price	Harga pengiriman. Anda dapat memformat jumlah ini menggunakan filter uang Liquid.
shipping_address	Alamat pengiriman. Catatan: Tidak seperti pada pesanan biasa, alamat pengiriman draf pesanan mungkin tidak lengkap.
shipping_address.first_name	Nama depan untuk alamat pengiriman.
shipping_address.company	Nama perusahaan di alamat pengiriman.
shipping_address.phone	Nomor telepon di alamat pengiriman.
line_items	Daftar semua item pesanan dalam draf pesanan.
item_count	Jumlah semua kuantitas item dalam draf pesanan.
note	Catatan yang dilampirkan ke draf pesanan. Catatan dapat diperoleh dari pelanggan dan juga diedit di layar detail draf pesanan di admin Shopify Anda.
metafields	Setiap bidang meta pada draf pesanan. Gunakan sintaksis berikut: metafields.NAMESPACE.KEY
location	Lokasi fisik pesanan. Ada beberapa properti lokasi yang tersedia. Anda dapat mengonfigurasi lokasi di halaman Lokasi di admin Shopify Anda.
b2b?	Mengembalikan nilai benar (true) jika pesanan adalah pesanan B2B. Gunakan properti ini dengan variabel B2B untuk menampilkan informasi relevan, seperti nama perusahaan, lokasi perusahaan, dan alamat di email. Misalnya, pada pesanan B2B, Anda dapat menambahkan header ke templat dengan informasi berikut: {% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}
company	Perusahaan tempat Anda menjual pada pesanan B2B.
company.name	Nama perusahaan pada pesanan B2B.
company.id	ID perusahaan pada pesanan B2B.
company_location	Lokasi perusahaan pada pesanan B2B. Perusahaan yang membeli dari Anda dapat memiliki lebih dari satu lokasi.
company_location.name	Nama lokasi perusahaan pada pesanan B2B.
company_location.id	Nomor ID lokasi perusahaan pada pesanan B2B.
company_location.shipping_address	Alamat pengiriman dari lokasi perusahaan pada pesanan B2B.
company_location.billing_address	Alamat penagihan dari lokasi perusahaan pada pesanan B2B.
payment_methods	Daftar metode pembayaran tersimpan yang tersedia untuk memproses total draf.
payment_method.payment_instrument	Instrumen pembayaran, yang berisi detail tentang metode pembayaran yang disimpan.
payment_method.payment_instrument.payment_type	Jenis metode pembayaran yang disimpan. Misalnya "credit_card, apple_pay"
payment_method.payment_instrument.credit_card_brand	Merek kartu, jika `payment_type` adalah "credit_card"
payment_method.payment_instrument.credit_card_company	Perusahaan kartu, jika `payment_type` adalah "credit_card"
payment_method.payment_instrument.credit_card_company	4 digit terakhir kartu, jika `payment_type` adalah "credit_card"

Properti jadwal pembayaran

Catatan

Anda tidak dapat mengirim notifikasi pengingat pembayaran melalui SMS.

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek jadwal pembayaran di templat notifikasi

Properti	Deskripsi
payment_schedule.amount_due	Jumlah yang harus dibayar untuk jadwal pembayaran. Anda dapat memformat jumlah dengan mata uang menggunakan filter uang Liquid.
payment_schedule.due_at	Tanggal jatuh tempo untuk jadwal pembayaran. Anda dapat memformat tanggal menggunakan filter tanggal Liquid.
payment_schedule.due_in_days	Jumlah hari hingga tanggal jatuh tempo jika jadwal pembayaran masih jatuh tempo (belum dibayar).
payment_schedule.due_later?	Menghasilkan nilai true jika jadwal pembayaran belum dibayar dan tanggal jatuh temponya akan datang.
payment_schedule.number_of_days_overdue?	Jumlah hari dari tanggal jatuh tempo saat jadwal pembayaran telah lewat jatuh tempo.
payment_schedule.overdue?	Menghasilkan nilai true jika jadwal pembayaran belum dibayar dan telah melewati tanggal jatuh temponya.

Properti status pembayaran

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek status pembayaran di templat notifikasi

Properti	Deskripsi
has_pending_payment	(boolean) Menghasilkan nilai true jika pesanan memiliki transaksi dengan pembayaran tertunda. Pelajari selengkapnya tentang pembayaran tertunda.
buyer_action_required	(boolean) Menghasilkan nilai true jika pesanan memiliki transaksi dengan pembayaran tertunda, dan tindakan pembeli diperlukan untuk membuka blokir pembayaran. Saat nilai ini menghasilkan true dan metode pembayaran mendukung instruksi pembayaran, buyer_pending_payment_instructions memberikan detail yang dapat digunakan pelanggan untuk menyelesaikan pembelian mereka secara offline. Pelajari selengkapnya tentang transaction object Liquid.

Properti komponen bundel

Setiap bundle_component dalam daftar line_item.bundle_components memiliki properti berikut. (Hanya draf pesanan)

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek komponen bundel di templat notifikasi

Properti	Deskripsi
bundle_component.image_url	URL gambar komponen bundel.
bundle_component.product.title	Judul produk komponen bundel.
bundle_component.quantity	Kuantitas untuk komponen bundel.
bundle_component.variant.title	Nama nilai opsi varian komponen bundel saat ini, yang digabungkan dengan karakter /. Contoh: kecil / merah

Properti komponen

Setiap component dalam daftar line_item.components memiliki properti berikut. (Hanya checkout yang diabaikan) `

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek komponen di templat notifikasi

Properti	Deskripsi
component.image_url	URL gambar komponen.
component.product.title	Judul produk komponen.
component.quantity	Kuantitas untuk komponen.
component.variant.title	Nama nilai opsi varian komponen saat ini, yang digabungkan dengan karakter /. Contoh: kecil / merah

Properti item pesanan

Setiap line dalam daftar line_items atau subtotal_line_items memiliki properti berikut.

Tips

subtotal_line_items menghasilkan item pesanan yang digunakan untuk menghitung subtotal_price suatu pesanan. subtotal_line_items tidak menyertakan item pesanan tip.

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek item pesanan di templat notifikasi

Properti	Deskripsi
line.applied_discounts(POS and draft orders only)	Daftar diskon yang diterapkan pada item ini (setiap diskon memiliki properti title, code, amount, savings, dan type).
line.bundle_components(Draft orders only)	Daftar item pesanan yang merupakan komponen bundel dari item ini. Hanya menghasilkan daftar jika item pesanan ini adalah produk bundel.
line.bundle_parent?(Draft orders only)	(boolean) Menghasilkan nilai true jika item pesanan adalah produk bundel.
line.components(Abandoned checkout only)	Daftar item pesanan yang merupakan komponen dari item ini.
line.parent?(Abandoned checkout only)	(boolean) Menghasilkan nilai true jika item pesanan memiliki komponen.
line.custom(Draft orders only)	(boolean) Menghasilkan nilai true jika item tersebut adalah item pesanan kustom untuk draf pesanan.
line.delivery_agreement	Perjanjian Pengiriman yang terkait dengan item pesanan ini.
line.grams	Berat satu item.
line.groups	Grup item pesanan dari item.
line.image	Menghasilkan URL gambar yang terkait dengan item pesanan ini. Anda juga dapat menggunakan filter img_url untuk mendapatkan ukuran gambar tertentu, misalnya {{ line.image | img_url: 'small' }}
line.line_price	Harga dikalikan dengan kuantitas untuk item tersebut.
line.original_line_price	Harga gabungan kuantitas item yang disertakan dalam baris, sebelum diskon diterapkan.
line.final_line_price	Harga gabungan semua item dalam item pesanan, termasuk semua jumlah diskon tingkat item.
line.pre_tax_price	Harga sebelum pajak untuk item pesanan, dikalikan dengan kuantitas item pesanan yang dibeli.
line.price	Harga untuk satu item.
line.product.metafields	Metafield apa pun di tingkat produk. Gunakan sintaksis berikut: line.product.metafields.NAMESPACE.KEY
line.product.title	Nama produk saat ini.
line.product.vendor	Vendor untuk item tersebut.
line.properties	Menghasilkan array informasi kustom untuk sebuah item. Properti item pesanan ditentukan oleh pelanggan di halaman produk, sebelum menambahkan produk ke keranjang.
line.quantity	Kuantitas untuk item tersebut.
line.current_quantity	Kuantitas item saat ini setelah penghapusan.
line.requires_shipping	(boolean) Menghasilkan nilai true jika varian untuk item tersebut memiliki pengaturan Produk fisik yang diaktifkan di halaman produk.
line.selling_plan_allocation	Menghasilkan objek selling_plan_allocation, yang menjelaskan bagaimana rencana penjualan seperti langganan memengaruhi item pesanan.
line.taxable	(boolean) Menghasilkan nilai true jika varian untuk item memiliki kotak centang 'Kenakan pajak pada produk ini' yang dicentang di halaman produk.
line.title	Nama produk pada saat penjualan, diikuti dengan tanda hubung dan nama varian pada saat penjualan. Nama varian tidak disertakan jika berupa "Judul Default". Dalam notifikasi yang ditampilkan kepada pelanggan, nama produk dan nama varian diterjemahkan ke dalam bahasa yang digunakan pelanggan saat checkout, jika bahasa tersebut berbeda dari bahasa default toko.
line.url	URL relatif dari varian item pesanan. URL relatif tidak menyertakan URL root toko Anda (mystore.myshopify.com).
line.variant.barcode	Barkod yang terkait dengan varian produk.
line.variant.compare_at_price	Harga coret yang terkait dengan varian produk.
line.variant.image	Gambar untuk varian produk. Hanya menampilkan gambar jika ada gambar spesifik yang ditetapkan ke varian dalam item pesanan.
line.variant.metafields	Setiap metafield di tingkat varian. Gunakan sintaks berikut: line.variant.metafields.NAMESPACE.KEY
line.variant.sku	SKU yang terkait dengan varian produk.
line.variant.title	Nama nilai opsi varian saat ini, digabungkan dengan karakter /. Contoh: kecil / merah
line.refunded.quantity(within refund notifications)	Kuantitas item yang akan dikembalikan dananya. Anda dapat menggunakan properti ini untuk menambahkan pengidentifikasi ke item yang dikembalikan dananya dalam pesanan. Contohnya: {% if line.refunded_quantity > 0 %}Pengidentifikasi baris yang dikembalikan dananya{% endif %}

Mendeteksi item Shopify Collective di templat pemberitahuan

Tag Shopify Collective diterapkan pada pesanan setelah email konfirmasi pesanan dikirim, sehingga {% if tags contains 'Shopify Collective' %} tidak pernah bernilai true di templat konfirmasi pesanan. Sebagai gantinya, untuk mendeteksi item Shopify Collective, periksa tag di tingkat produk pada setiap item pesanan:

{% 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 %}

Properti grup item pesanan

Setiap line_item_group dalam daftar line_item_groups memiliki properti berikut.

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek grup item pesanan di templat notifikasi

Properti	Deskripsi
line_item_group.display_title	Judul grup item pesanan.
line_item_group.components	Daftar komponen item pesanan milik grup tersebut.
line_item_group.image	Gambar grup item pesanan.
line_item_group.product_id	ID produk grup item pesanan.
line_item_group.variant	Objek varian dari grup item pesanan.
line_item_group.variant_id	ID varian grup item pesanan.

Properti pengembalian dana

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek pengembalian dana di templat notifikasi

Properti	Deskripsi
amount	Jumlah uang yang dikembalikan dananya.
refund_line_items	Daftar item pesanan pengembalian dana yang akan dikembalikan dananya.

Properti item pesanan pengembalian dana

Setiap refund_line dalam daftar refund_line_items memiliki properti berikut:

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek item pesanan pengembalian dana di templat notifikasi

Properti	Deskripsi
refund_line.line_item	`line_item` yang sedang dikembalikan dananya. Ini memiliki akses ke semua properti line_item.
refund_line.quantity	Kuantitas item pesanan yang akan dikembalikan dananya.

Properti pemenuhan

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek pemenuhan di templat notifikasi

Properti	Deskripsi
service_name	Nama layanan khusus seperti yang ditentukan di halaman Pengaturan > Pengiriman dan pengantaran. (Khusus permintaan pemenuhan)
fulfillment.estimated_delivery_at	Perkiraan tanggal penyerahan berdasarkan nomor pelacakan (jika tersedia) yang disediakan oleh salah satu jasa pengiriman berikut: USPS, FedEx, UPS, Canada Post (khusus Kanada). Properti ini hanya tersedia bila tarif yang dihitung jasa pengiriman sedang digunakan.
fulfillment.fulfillment_line_items	Daftar item pesanan pemenuhan yang akan dipenuhi.
fulfillment.item_count	Jumlah dari kuantitas semua item. Jumlah total item yang sedang dipenuhi.
fulfillment.requires_shipping	(boolean) Mengembalikan true jika permintaan pemenuhan ini memerlukan pengiriman.
fulfillment.tracking_company	Perusahaan yang melakukan pelacakan.
fulfillment.tracking_numbers	Daftar nomor pelacakan.
fulfillment.tracking_urls	Daftar URL pelacakan.
items_to_fulfill(deprecated)	Daftar item pesanan yang akan dipenuhi oleh layanan pemenuhan pesanan kustom khusus ini. (Hanya permintaan pemenuhan)
items_to_fulfill_count(deprecated)	Jumlah total item yang akan dipenuhi oleh permintaan ini. (Hanya permintaan pemenuhan)

Properti item pesanan pemenuhan

Setiap fulfillment_line dalam daftar fulfillment_line_items memiliki properti berikut.

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek item pesanan pemenuhan di templat notifikasi

Properti	Deskripsi
fulfillment_line.line_item	`line_item` yang sedang dipenuhi. Ini memiliki akses ke semua properti line_item.
fulfillment_line.quantity	Kuantitas item pesanan yang sedang dipenuhi.

Properti paket yang disiapkan

Paket yang disiapkan mencakup item yang ditandai siap untuk penjemputan.

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek paket yang disiapkan di templat notifikasi

Properti	Deskripsi
item_count	Jumlah dari semua kuantitas item dalam paket yang disiapkan.
prepared_package_line_items	Daftar item pesanan paket yang disiapkan.

Properti item pesanan paket yang disiapkan

Setiap prepared_package_line_item dalam daftar prepared_package_line_items memiliki properti berikut.

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek item pesanan paket yang disiapkan di templat notifikasi

Properti	Deskripsi
line_item	`line_item` terkait. Ini memiliki akses ke semua properti line_item.
quantity	Kuantitas item pesanan yang telah ditandai siap untuk penjemputan.

Properti penyerahan

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek penyerahan di templat notifikasi

Properti	Deskripsi
delivery_agreements	Daftar semua Perjanjian Penyerahan untuk pesanan.
delivery_instructions	Informasi pengiriman lokal untuk dibagikan kepada pelanggan. Informasi ini dikontrol oleh kolom Informasi penyerahan di pengaturan pengiriman lokal.
consolidated_estimated_delivery_time	Informasi tanggal penyerahan pesanan untuk dibagikan kepada pelanggan. Informasi ini dikontrol oleh setelan Waktu pemrosesan yang Anda siapkan di halaman Pengiriman dan penyerahan. Saat pesanan memiliki beberapa metode penyerahan, daftar metode penyerahan dan tanggal akan ditampilkan.
has_multiple_delivery_methods	(boolean) Mengembalikan true jika pesanan memiliki beberapa metode penyerahan.

Properti Perjanjian Penyerahan

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek perjanjian penyerahan di templat notifikasi

Properti	Deskripsi
delivery_agreement.delivery_method_type	Jenis metode penyerahan.
delivery_agreement.delivery_method_name	Jenis metode penyerahan yang diterjemahkan ke bahasa yang digunakan pembeli saat checkout, ketika bahasa tersebut berbeda dari bahasa default toko.
delivery_agreement.line_item_groups	Daftar semua grup item pesanan yang berisi komponen item pesanan yang dibundel dalam perjanjian penyerahan.
delivery_agreement.line_items	Daftar semua item pesanan yang terkait dengan perjanjian penyerahan ini.

Properti diskon

Ada dua jenis properti diskon.

discount_applications menjelaskan alasan dan cara suatu item didiskon.

discount_allocations menjelaskan cara diskon tertentu memengaruhi item pesanan dan cara diskon tersebut mengurangi harga. Sebaiknya gunakan properti ini di tingkat item pesanan.

Anda dapat menggabungkan properti ini untuk menampilkan informasi diskon di tingkat item pesanan atau pesanan.

Contoh

Contoh ini memeriksa apakah diskon telah diterapkan pada item pesanan. Jika diskon tidak diterapkan pada tingkat pesanan (all), nama dan jumlah diskon akan ditampilkan.

{% 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 %}

Hasilnya mungkin akan serupa dengan ini:

SPRING5 (-$5.00)

Properti discount_allocation

Setiap discount_allocation dalam daftar discount_allocations memiliki properti berikut.

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek discount_allocation di templat notifikasi

Properti	Deskripsi
discount_allocation.amount	Jumlah uang yang dihemat oleh pelanggan pada item pesanan. Harus dimasukkan dalam satu loop jika Anda ingin mengizinkan beberapa kode diskon.
discount_allocation.discount_application	Aplikasi diskon yang mengalokasikan jumlah pada item pesanan.

Properti discount_application

Setiap discount_application dalam daftar discount_applications memiliki properti berikut.

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek discount_application di templat notifikasi

Properti	Deskripsi
discount_application.target_selection	Menjelaskan cara diskon memilih item baris di keranjang untuk didiskon. Salah satu dari: all: Diskon berlaku untuk semua item pesanan. entitled: Diskon berlaku untuk subkumpulan item baris tertentu, yang sering ditentukan oleh suatu kondisi. explicit: Diskon berlaku untuk item pesanan atau jalur pengiriman yang dipilih secara khusus.
discount_application.target_type	Jenis item yang dikenai diskon (line_item atau shipping_line).
discount_application.title	Nama diskon yang ditampilkan kepada pelanggan. Contoh: Welcome10 atau CBBWQQAKYBYY
discount_application.total_allocated_amount	Jumlah total pengurangan harga pesanan karena diskon.
discount_application.type	Jenis diskon. Salah satu dari: automatic, discount_code, manual, atau script.
discount_application.value	Nilai diskon.
discount_application.value_type	Jenis nilai diskon. Salah satu dari: fixed_amount atau percentage.

Properti langganan

Detail kontrak langganan, siklus penagihan saat ini, serta item pesanan, metode penyerahan, dan metode pembayarannya tersedia untuk semua templat email langganan.

Untuk mengedit templat notifikasi langganan, instal aplikasi Shopify Subscriptions, lalu temukan templat di bawah Pengaturan > Notifikasi di bagian Langganan.

Properti siklus penagihan kontrak langganan

Untuk mengakses properti kontrak langganan dan siklus penagihannya, 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.

Properti

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek siklus penagihan kontrak langganan di templat notifikasi

Properti	Deskripsi
status	Status kontrak. Salah satu dari active, paused, cancelled, failed, expired, stale,
delivery_method	Metode penyerahan langganan. Jika langganan untuk layanan atau produk digital, nil akan dikembalikan.
billing_frequency	Seberapa sering langganan ditagih.
delivery_frequency	Seberapa sering langganan dikirim.
origin_order	Pesanan asli yang pertama kali membuat langganan. Jika langganan tidak dibuat dari pesanan Shopify, maka nil akan dikembalikan.
customer	Pelanggan langganan.
line_items	Item pesanan dalam siklus penagihan langganan.
product_names	Daftar nama produk yang termasuk dalam siklus penagihan langganan.
update_payment_method_url	URL yang dapat digunakan pelanggan untuk memperbarui metode pembayaran untuk kontrak ini.
shipping_address	Alamat pengiriman langganan. Jika langganan untuk layanan atau produk digital, nil akan dikembalikan.
billing_address	Alamat penagihan langganan.
subtotal_price	Harga subtotal item pesanan langganan.
shipping_price	Harga pengiriman langganan.
total_tax	Total pajak langganan.
total_price	Total harga langganan.
total_discounts	Total diskon langganan.
customer_self_serve_url	URL layanan mandiri yang dapat digunakan pelanggan untuk mengelola langganan mereka.
billing_attempt_expected_date	Tanggal penagihan untuk siklus penagihan ini.
next_billing_date	Tanggal penagihan berikutnya yang tidak dilewati setelah siklus penagihan ini.
last_attempted_billing_date	Tanggal penagihan terakhir yang dicoba untuk siklus penagihan.
days_overdue	Jumlah hari tagihan telah jatuh tempo untuk siklus penagihan ini.
payment_instrument	Instrumen pembayaran yang terkait dengan kontrak langganan. Instrumen pembayaran ini digunakan untuk menagih pelanggan.

Properti item pesanan kontrak langganan

Properti untuk setiap item pesanan yang termasuk dalam siklus penagihan. Akses properti item pesanan kontrak melalui properti induk subscription_contract_billing_cycle.line_items.

Contoh

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

Catatan

Selain properti item pesanan kontrak, semua properti item pesanan standar juga tersedia.

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek item pesanan kontrak langganan di templat notifikasi

Properti	Deskripsi
url	URL ke halaman detail produk untuk varian produk item pesanan.
requires_shipping	Apakah item pesanan memerlukan pengiriman fisik.
unit_price_measurement	Pengukuran harga satuan item pesanan.
selling_plan_allocation	Alokasi paket penjualan item pesanan.

Properti metode penyerahan kontrak langganan

Properti untuk metode penyerahan yang digunakan dalam siklus penagihan ini. Akses properti metode penyerahan melalui properti 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 %}

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek metode penyerahan kontrak langganan di templat notifikasi

Properti	Deskripsi
title	Judul opsi pengiriman yang terkait dengan metode penyerahan.
type	Jenis metode penyerahan. Salah satu dari shipping, local, atau pick-up.

Properti instrumen pembayaran kontrak langganan

Detail tentang instrumen pembayaran untuk kontrak langganan. Instrumen pembayaran ini digunakan untuk menagih pelanggan. Akses properti instrumen pembayaran melalui properti 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 }}

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek instrumen pembayaran kontrak langganan di templat notifikasi

Properti	Deskripsi
payment_type	Jenis metode pembayaran yang diwakili oleh instrumen pembayaran. Gunakan filter pembayaran untuk menghasilkan URL gambar atau SVG.
credit_card_brand	Merek kartu kredit.
credit_card_company	Nama perusahaan kartu kredit.
credit_card_last_four_digits	4 digit terakhir kartu kredit.

Properti notifikasi email

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek notifikasi email di templat notifikasi

Properti	Deskripsi
shop.email_logo_url	URL untuk logo yang ditentukan di bagian Kustomisasi templat email di panel admin.
shop.email_logo_width	Lebar logo (piksel) yang ditentukan di bagian Kustomisasi templat email di panel admin.
shop.email_accent_color	Kode HEX untuk warna aksen yang ditentukan di bagian Kustomisasi templat email di panel admin.

Properti kredit toko

Properti yang berisi detail tentang penerbitan kredit toko.

Deskripsi properti Liquid yang dapat Anda gunakan dengan objek kredit toko yang diterbitkan di templat notifikasi

Properti	Deskripsi
issued_store_credit.amount	Jumlah kredit toko yang diterbitkan. Anda dapat memformat jumlah ini menggunakan filter uang Liquid.
issued_store_credit.expires_at	Tanggal dan waktu kedaluwarsa kredit toko yang diterbitkan. Anda dapat memformat jumlah ini menggunakan filter tanggal Liquid.
issued_store_credit.balance_after_transaction	Saldo akun kredit toko setelah kredit diterbitkan. Anda dapat memformat jumlah ini menggunakan filter uang Liquid.
customer	Objek pelanggan yang berisi atribut dari output pelanggan.