Bildirim değişkenleri referansı
Mağazanızdan gönderilen bildirimler, Liquid kullanılarak oluşturulur. Liquid, Shopify'ın basit ve kullanımı kolay programlama dilidir. Bu, Theme Store'daki temaların oluşturulmasında da kullanılan programlama dilidir.
Mağazanızdan gönderilen bildirimleri düzenlemek için bildirim şablonlarınızda temel kişiselleştirmeler yapabilirsiniz. Kişiselleştirebileceğiniz bildirimlerin tam listesine erişmek için Shopify yöneticinizdeki Bildirimler sayfasına gidin.
Daha gelişmiş değişikliklerle ilgili yardım almak veya özel bildirim şablonlarında değişiklik yapmak için forumlarımızdaki topluluğa ulaşabilir veya kişiselleştirmelerinizi yapması için bir Shopify İş Ortağı ile çalışabilirsiniz. Shopify İş Ortağı ile çalışma hakkında daha fazla bilgi edinin.
Bu sayfada
- Sipariş özellikleri
- Taslak sipariş özellikleri
- Ödeme planı özellikleri
- Ödeme durumu özellikleri
- Paket bileşeni özellikleri
- Bileşen özellikleri
- Satır öğesi özellikleri
- Satır öğesi grubu özellikleri
- Para iadesi özellikleri
- Gönderim özellikleri
- Hazırlanan paket özellikleri
- Teslimat özellikleri
- İndirim özellikleri
- Abonelik özellikleri
- E-posta bildirimi özellikleri
- Mağaza kredisi özellikleri
Sipariş özellikleri
Bir siparişin birçok özelliği, doğrudan Liquid kullanılarak ve şablonlarda kullanılabilir.
| Özellik | Açıklama |
|---|---|
id |
Siparişin dahili kullanım için sistem genelinde benzersiz olan kimliğidir. Mağazanızın yönetici bölümünde siparişe bir bağlantı oluşturmak için aşağıdaki örneği kullanın. Örneğin, Yeni sipariş şablonunuza aşağıdaki kodu ekleyebilirsiniz: Siparişi görüntüle
|
email | Siparişle ilişkili e-posta. |
name |
Genellikle bir diyez simgesinin ardından gelen Örnek: #1004 |
order_name | name ile aynıdır. |
order_number |
Siparişin mağazaya özgü numarasıdır. Diyez (#) ön ekini veya mağaza sahibinin tercihlerinde sipariş numarasına eklediği diğer ön/son ekleri içermez. Örnek: 1004 |
confirmation_number | Sıralı sipariş adı yerine müşteriye gösterilebilecek, sipariş için rastgele oluşturulmuş alfanümerik bir tanımlayıcıdır. Bu değerin benzersiz olacağı garanti edilmez. Örnek: XPAV284CT |
created_at |
Müşterinin siparişi oluşturduğu tarih ve saattir. Bunu, tarih filtresini kullanarak biçimlendirebilirsiniz. Örnek: 2009-05-30T17:43:51+02:00 |
payment_terms |
Ödeme koşulları, bir sipariş için ödemenin son yapılacağı tarihi belirtir. Sipariş faturalarına ödeme koşulları ekleme hakkında bilgi edinin. Daha fazla ayrıntı için payment_terms ile ilgili Liquid referansına bakın. |
destination | Ürünlerin gönderilmesi gereken varış yeridir. |
tags | Siparişe ait tüm etiketlerin bir dizisini döndürür. Etiketler alfabetik sırayla döndürülür. Shopify Collective etiketi gibi uygulamalar veya platform özellikleri tarafından dinamik olarak uygulanan etiketler, bildirim e-postası oluşturulduğunda kullanılamayabilir. Belirli bir özelliğe ait ürünleri algılamak için bunun yerine her bir satır öğesindeki ürün düzeyindeki etiketleri kontrol edin. Daha fazla ayrıntı için Liquid referans belgelerine bakın. |
transactions | Siparişin işlemlerini içeren bir dizi döndürür. |
tax_price | Siparişteki tüm ürünlerin birleşik vergileridir. |
tax_lines |
Vergilendirme türüne göre ayrılmış vergiler:
{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_line.title | Verginin adıdır. Örneğin, QST veya KDV. |
tax_line.price | Vergi tutarıdır. |
tax_line.rate | Ondalık sayı olarak vergi oranı. Vergi oranı %17,5 ise 0,175 döndürür. |
tax_line.rate_percentage | Okunabilir biçimde vergi oranıdır. Oran 0,175 ise 17,5 değerini döndürür. |
customer | `Müşteri` çıktısının özelliklerini içeren müşteri nesnesidir. |
billing_address | `Fatura adresi. |
billing_address.first_name | Müşterinin adıdır. |
billing_address.last_name | Müşterinin soyadıdır. |
billing_address.company | Faturalama için şirket adıdır. |
billing_address.phone | Fatura adresindeki telefon numarasıdır. |
shop.name | Mağazanızın adıdır. |
shop.phone | Mağazanızın telefon numarasıdır. |
subtotal_price | Herhangi bir satır öğesi veya sepet indirimi düşüldükten sonraki, siparişin satır öğesi fiyatları toplamıdır. Alt toplama; vergiler (fiyatlara dahil değilse), kargo masrafları veya bahşişler dahil değildir. |
discounts | İndirimler listesidir. |
discounts_amount | Uygulanan tüm indirimlerin toplam tutarıdır. Örnek: +5,00 $ |
discounts_savings | Tüm indirimlerin sağladığı tasarruf miktarıdır. Örnek: -5,00 $ |
total_price |
Siparişin toplamıdır (alt toplam + kargo masrafı - kargo indirimi + vergi). |
financial_status | Mevcut ödeme durumudur. Şunlardan biridir: nil, pending, authorized, paid, voided, refunded. |
requires_shipping | (boole) Siparişte kargo gerektiren en az bir ürün varsa true değerini döndürür. |
shipping_method.title | Kargo ücretinin adıdır. Müşteriye yönelik bildirimlerde, müşterinin ödeme yaptığı dil varsayılan mağaza dilinden farklı olduğunda kargo ücreti adı o dile çevrilir. Örnek: Standart Kargo |
shipping_method.price |
Herhangi bir kargo indirimi dahil kargo ücretidir. Örnek: |
shipping_price |
Kargo ücretidir. Örnek: |
shipping_address | `Kargo adresi. |
shipping_address.first_name | Kargo adresindeki addır. |
shipping_address.company | Kargo adresi için şirket adıdır. |
shipping_address.phone | Kargo adresindeki telefon numarasıdır. |
line_items | Siparişteki tüm satır öğelerinin listesidir. |
line_items_including_zero_quantity | Miktarı sıfır olanlar da dahil olmak üzere, siparişteki tüm satır öğelerinin listesidir. Satır öğelerinin miktarı, tamamen para iadesi yapıldığında sıfır olur. |
line_item_groups(Orders and POS only) | Siparişte satır öğesi bileşenlerini içeren tüm satır öğesi gruplarının listesidir. |
item_count | Tüm ürünlerin miktarlarının toplamıdır. |
fulfillment_status | Siparişin mevcut gönderim durumudur. Şunlardan biridir: unfulfilled, partial, fulfilled. |
note | Siparişe eklenen nottur. Not, müşteriden alınabilir ve/veya yönetici panelinizdeki sipariş ayrıntıları ekranında düzenlenebilir. |
attributes |
Siparişe eklenmiş tüm özelliklerdir. Örnek: |
metafields |
Siparişteki tüm meta alanlardır. Şu söz dizimini kullanın: metafields.NAMESPACE.KEY |
referring_site |
Müşteriyi mağazanıza getiren yönlendirenin URL'sini içerir. Örnek: |
landing_site |
Müşterinin kullandığı açılış sitesinin yolunu içerir. Bu, müşterinin mağazaya ulaştığında gördüğü ilk sayfadır. Örnek: |
landing_site_ref |
Açılış sitesini inceler ve buradan bir referans parametresi çıkarır. Referans parametreleri şunlar olabilir: `landing_site`, `/products/great-product?ref=my-tracking-token` ise
{% if landing_site_ref == 'my-tracking-token' %}
My action...
{% endif %}
|
cancelled | (boole) Sipariş iptal edildiyse true değerini döndürür. |
cancelled_at | Siparişin iptal edildiği zamandır. |
cancel_reason | Siparişi iptal ederken seçilen nedendir. Şunlardan biridir: inventory, customer, declined, fraud veya other. |
has_high_risks?(deprecated) | Sipariş yüksek riskliyse true değerini döndürür |
unique_gateways |
Bir siparişteki benzersiz ödeme sağlayıcılarının listesini döndürür. Örneğin, birisi Visa, Mastercard ve nakit ile ödeme yaptıysa döndürülen liste şu şekilde olur: |
location(POS only) |
Siparişin fiziksel konumunu gösterir. Kullanılabilecek çeşitli konum özellikleri burada listelenmiştir. Konumları, yönetici panelindeki Konumlar alanından yapılandırabilirsiniz. |
order_status_url |
Bu siparişin sipariş durumu sayfası bağlantısını döndürür. |
fulfilled_line_items(deprecated) | Gönderilmiş satır öğelerinin listesi. |
unfulfilled_line_items(deprecated) | Tamamen gönderilmemiş satır öğelerinin listesi. |
b2b? |
Sipariş bir B2B siparişiyse "true" değerini döndürür. Şirket adı, şirket konumu ve adres gibi ilgili bilgileri e-postalarda görüntülemek için bu özelliği B2B değişkenleriyle birlikte kullanın. Örneğin, B2B siparişlerinde bir şablona aşağıdaki bilgileri içeren bir üstbilgi ekleyebilirsiniz:
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | Bir B2B siparişinde satış yaptığınız şirket. |
company.name | Bir B2B siparişindeki şirketin adı. |
company.id | Bir B2B siparişindeki şirketin kimliği. |
company_location | Bir B2B siparişindeki şirketin konumu. Sizden alım yapan bir şirketin birden fazla konumu olabilir. |
company_location.name | Bir B2B siparişindeki şirket konumunun adı. |
company_location.id | Bir B2B siparişindeki şirket konumunun kimlik numarası. |
company_location.shipping_address | Bir B2B siparişindeki şirket konumunun kargo adresi. |
company_location.billing_address | Bir B2B siparişindeki şirket konumunun fatura adresi. |
customer_order_url | Bir müşterinin müşteri hesaplarını kullanarak iade talebinde bulunduğu bir siparişin yeni sipariş durumu sayfası. |
Taslak sipariş özellikleri
| Özellik | Açıklama |
|---|---|
id | Dahili kullanıma yönelik taslak siparişin benzersiz kimliği. |
invoice_url | Müşterinin, Shopify'ın güvenli ödeme sayfasını kullanarak faturayı ödemek için takip edebileceği bir bağlantı. |
reserve_inventory_until |
Taslaktaki satır öğelerinin rezerve edildiği son tarih ve saat (örneğin, Liquid tarih filtresini kullanarak tarihleri biçimlendirebilirsiniz. |
user | Taslak siparişi son değiştiren personel. |
user.name | Taslak siparişi son değiştiren personelin adı. |
user.email | Taslak siparişi son değiştiren personelin e-posta adresi. |
email | Taslak siparişle ilişkilendirilen e-posta adresi. |
name | Benzersiz number taslak siparişin, başına # numara işareti eklenmiş olan hali. |
number | Sipariş ön eki veya son eki olmadan taslak siparişin benzersiz numarası. |
created_at |
Müşterinin taslak siparişi oluşturduğu tarih ve saat; örneğin, Liquid tarih filtresini kullanarak tarihleri biçimlendirebilirsiniz. |
tags | Siparişin tüm etiketlerinden oluşan bir dizi döndürür. Etiketler alfabetik sırayla döndürülür. Daha fazla ayrıntı için Liquid referans belgelerine bakın. |
tax_price | Taslak siparişteki tüm ürünlerin toplam vergileri. |
tax_lines |
Vergi türüne göre ayrılmış vergiler:
{% for tax_line in tax_lines %}
{{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price | money_with_currency }}
{% endfor %}
|
tax_line.title | Verginin adı. Örnekler: QST veya KDV |
tax_line.price | Vergi tutarı. |
tax_line.rate | Vergi oranının ondalık biçimi. Örneğin, %17,5'lik bir vergi oranı 0,175 değerini döndürür. |
tax_line.rate_percentage | Vergi oranının yüzde biçimi. Örneğin, 0,175'lik bir oran, 17,5 değerini döndürür. |
customer | `Müşteri` çıktısının özelliklerini içeren müşteri nesnesidir. |
billing_address | Taslak siparişin fatura adresi. |
billing_address.first_name | Müşterinin adı. |
billing_address.last_name | Müşterinin soyadı. |
billing_address.company | Fatura adresindeki şirket adı. |
billing_address.phone | Fatura adresindeki telefon numarası. |
shop.name | Mağazanızın adı. |
shop.phone | Mağazanızın telefon numarasıdır. |
subtotal_price | Herhangi bir satır öğesi indirimi veya sepet indirimi düşüldükten sonraki, taslak siparişin satır öğesi fiyatları toplamı. Alt toplam, vergileri (fiyatlara dahil edilmediği sürece) veya kargo masraflarını içermez. |
discounts | İndirimler listesidir. |
discounts_amount | Uygulanan tüm indirimlerin tutarı. Örnek: +5,00 $ |
discounts_savings | Tüm indirimlerin sağladığı tasarruf tutarı. Örnek: -5,00 $ |
total_price | Siparişin toplam fiyatı (alt toplam + kargo masrafı - kargo indirimi + vergi). |
amount_due_now | Taslak sipariş faturası için gereken tutar. |
requires_shipping | Döndürür: true taslak siparişte kargo gerektiren en az bir ürün varsa. Döndürür: false taslak siparişteki hiçbir ürün kargo gerektirmiyorsa. |
shipping_method.title | Kargo ücretinin adı. Örnek: Standart Kargo |
shipping_method.price | Kargo yönteminin fiyatı. Şu değişkenle aynı bilgileri döndürür: shipping_price. |
shipping_price |
Kargo ücretidir. Bu tutarı Liquid para filtrelerini kullanarak biçimlendirebilirsiniz. |
shipping_address |
Not: Normal siparişlerin aksine, taslak siparişin kargo adresi eksik olabilir. |
shipping_address.first_name | Kargo adresindeki addır. |
shipping_address.company | Kargo adresindeki şirket adı. |
shipping_address.phone | Kargo adresindeki telefon numarası. |
line_items | Taslak siparişteki tüm satır öğelerinin listesi. |
item_count | Taslak siparişteki tüm ürün miktarlarının toplamı. |
note | Taslak siparişe eklenen not. Not, müşteriden alınabilir ve Shopify yöneticinizdeki taslak sipariş ayrıntıları ekranında düzenlenebilir. |
metafields |
Taslak siparişteki tüm meta alanlar. Aşağıdaki söz dizimini kullanın: metafields.NAMESPACE.KEY |
location |
Siparişin fiziksel konumu. Kullanılabilecek birkaç konum özelliği vardır. Konumları, Shopify yöneticinizdeki Konumlar sayfasında yapılandırabilirsiniz. |
b2b? |
Sipariş bir B2B siparişiyse "true" değerini döndürür. Şirket adı, şirket konumu ve adres gibi ilgili bilgileri e-postalarda görüntülemek için bu özelliği B2B değişkenleriyle birlikte kullanın. Örneğin, B2B siparişlerinde bir şablona aşağıdaki bilgileri içeren bir üstbilgi ekleyebilirsiniz:
{% if b2b? %}
<p> Customer: {{ customer.name }}
<p> Company: {{ company.name }}
<p> Location: {{ company_location.name }}
{% endif%}
|
company | Bir B2B siparişinde satış yaptığınız şirket. |
company.name | Bir B2B siparişindeki şirketin adı. |
company.id | Bir B2B siparişindeki şirketin kimliği. |
company_location | Bir B2B siparişindeki şirketin konumu. Sizden alım yapan bir şirketin birden fazla konumu olabilir. |
company_location.name | Bir B2B siparişindeki şirket konumunun adı. |
company_location.id | Bir B2B siparişindeki şirket konumunun kimlik numarası. |
company_location.shipping_address | Bir B2B siparişindeki şirket konumunun kargo adresi. |
company_location.billing_address | Bir B2B siparişindeki şirket konumunun fatura adresi. |
payment_methods | Taslağın toplam tutarını işlemek için kullanılabilecek kayıtlı ödeme yöntemlerinin listesi. |
payment_method.payment_instrument | Kayıtlı ödeme yöntemiyle ilgili ayrıntıları içeren ödeme aracı. |
payment_method.payment_instrument.payment_type | Kaydedilen ödeme yönteminin türü. Örn. "credit_card, apple_pay" |
payment_method.payment_instrument.credit_card_brand | `payment_type`, "credit_card" olduğunda kartın markası |
payment_method.payment_instrument.credit_card_company | `payment_type`, "credit_card" olduğunda kart şirketi |
payment_method.payment_instrument.credit_card_company | `payment_type`, "credit_card" olduğunda kartın son 4 hanesi |
Ödeme planı özellikleri
| Özellik | Açıklama |
|---|---|
payment_schedule.amount_due |
Bir ödeme planı için ödenecek tutar. Liquid para filtresini kullanarak tutarları para birimleriyle biçimlendirebilirsiniz. |
payment_schedule.due_at |
Ödeme planının son tarihi. Liquid tarih filtresini kullanarak tarihleri biçimlendirebilirsiniz. |
payment_schedule.due_in_days |
Ödeme planının vadesi henüz gelmediyse (ödenmediyse) son tarihe kalan gün sayısı. |
payment_schedule.due_later? |
Bir ödeme planı ödenmemişse ve son tarihi gelecek bir tarihse true değerini döndürür. |
payment_schedule.number_of_days_overdue? |
Bir ödeme planının vadesi geçtiğinde, son tarihten itibaren geçen gün sayısı. |
payment_schedule.overdue? |
Bir ödeme planı ödenmemişse ve son tarihi geçmişse true değerini döndürür. |
Ödeme durumu özellikleri
| Özellik | Açıklama |
|---|---|
has_pending_payment |
(boolean) Siparişin, beklemedeki bir ödemesi olan bir işlemi varsa true değerini döndürür. Beklemedeki ödemeler hakkında daha fazla bilgi edinin. |
buyer_action_required |
(boolean) Bir siparişin beklemedeki bir ödemesi olan bir işlemi varsa ve ödemenin engellemesini kaldırmak için alıcı eylemi gerekiyorsa true değerini döndürür. Bu değer true döndürdüğünde ve ödeme yöntemi, ödeme talimatlarını destekliyorsa Liquid işlem nesnesi hakkında daha fazla bilgi edinin. |
Paket bileşeni özellikleri
line_item.bundle_components listesindeki her bundle_component aşağıdaki özelliklere sahiptir. (Yalnızca Taslak siparişler)
| Özellik | Açıklama |
|---|---|
bundle_component.image_url | Paket bileşeninin görsel URL'si. |
bundle_component.product.title | Paket bileşeni ürününün başlığı. |
bundle_component.quantity | Paket bileşeninin miktarı. |
bundle_component.variant.title | Paket bileşeni varyasyonunun seçenek değerlerinin geçerli adları ( Örnek: küçük / kırmızı |
Bileşen özellikleri
line_item.components listesindeki her bir component aşağıdaki özelliklere sahiptir. (Yalnızca terk edilmiş ödeme)
`
| Özellik | Açıklama |
|---|---|
component.image_url | Bileşenin görsel URL'si. |
component.product.title | Bileşen ürününün başlığı. |
component.quantity | Bileşenin miktarı. |
component.variant.title | Bileşen varyasyonunun seçenek değerlerinin geçerli adları ( Örnek: küçük / kırmızı |
Satır öğesi özellikleri
line_items veya subtotal_line_items listesindeki her line, aşağıdaki özelliklere sahiptir.
| Özellik | Açıklama |
|---|---|
line.applied_discounts(POS and draft orders only) | Bu ürüne uygulanan indirimlerin listesi (her indirimin title, code, amount, savings ve type özellikleri vardır). |
line.bundle_components(Draft orders only) | Bu ürünün paket bileşenleri olan satır öğelerinin listesi. Yalnızca bu satır öğesi bir paket ürünse liste döndürür. |
line.bundle_parent?(Draft orders only) | (boolean) Satır öğesi bir paket ürünse true değerini döndürür. |
line.components(Abandoned checkout only) | Bu ürünün bileşenleri olan satır öğelerinin listesi. |
line.parent?(Abandoned checkout only) | (boolean) Satır öğesinin bileşenleri varsa true değerini döndürür. |
line.custom(Draft orders only) | (boolean) Ürün, bir taslak sipariş için özel bir satır öğesiyse true değerini döndürür. |
line.delivery_agreement | Bu satır öğesiyle ilişkili Teslimat Sözleşmesi. |
line.grams | Tek bir ürünün ağırlığı. |
line.groups | Ürünün satır öğesi grubu. |
line.image | Bu satır öğesiyle ilişkili görselin URL'sini döndürür. Belirli görsel boyutlarını almak için img_url filtresini de kullanabilirsiniz. Örneğin: {{ line.image | img_url: 'small' }} |
line.line_price | Bu ürünün fiyatının miktarla çarpımı. |
line.original_line_price | İndirimler uygulanmadan önce satırda yer alan ürünlerin miktarının birleşik fiyatı. |
line.final_line_price | Tüm satır düzeyindeki indirim tutarları dahil olmak üzere, satır öğesindeki tüm ürünlerin birleşik fiyatı. |
line.pre_tax_price | Satır öğelerinin vergi öncesi fiyatının, satın alınan satır öğesi miktarıyla çarpımı. |
line.price | Tek bir ürünün fiyatı. |
line.product.metafields | Ürün düzeyindeki tüm meta alanlar. Aşağıdaki söz dizimini kullanın: line.product.metafields.NAMESPACE.KEY |
line.product.title | Ürünün geçerli adı. |
line.product.vendor | Ürünün satıcısı. |
line.properties | Bir ürün için özel bilgileri içeren bir dizi döndürür. Satır öğesi özellikleri, müşteri tarafından ürün sayfasına bir ürün sepete eklenmeden önce belirtilir. |
line.quantity | Bu ürünün miktarı. |
line.current_quantity | Kaldırma işlemlerinden sonra ürünün geçerli miktarı. |
line.requires_shipping | (boolean) Ürünün varyasyonu, ürün sayfasında Fiziksel ürün ayarı etkinleştirilmiş durumdaysa true değerini döndürür. |
line.selling_plan_allocation | abonelik gibi bir satış planının satır öğesini nasıl etkilediğini açıklayan bir selling_plan_allocation nesnesi döndürür. |
line.taxable | (boolean) Ürünün varyasyonunda, ürün sayfasındaki 'Bu üründen vergi al' onay kutusu işaretliyse true değerini döndürür. |
line.title | Satış anındaki ürün adı ve ardından kısa çizgi ile satış anındaki varyasyon adı. Varyasyon adı "Varsayılan Başlık" olduğunda dahil edilmez. Müşteriye yönelik bildirimlerde, müşterinin ödeme yaptığı dil mağazanın varsayılan dilinden farklıysa ürün adı ve varyasyon adı bu dile çevrilir. |
line.url | Satır öğesinin varyasyonunun göreli URL'si. Göreli URL, mağazanızın kök URL'sini (mystore.myshopify.com) içermez. |
line.variant.barcode | Ürün varyasyonuyla ilişkili barkod. |
line.variant.compare_at_price | Ürün varyasyonuyla ilişkili karşılaştırma fiyatı. |
line.variant.image | Ürün varyasyonunun görseli. Yalnızca satır öğesindeki varyasyona atanmış belirli bir görsel varsa görsel döndürür. |
line.variant.metafields | Varyasyon düzeyindeki tüm meta alanlar. Aşağıdaki söz dizimini kullanın: line.variant.metafields.NAMESPACE.KEY |
line.variant.sku | Ürün varyasyonuyla ilişkili SKU. |
line.variant.title | Varyasyonun seçenek değerlerinin Örnek: küçük / kırmızı |
line.refunded.quantity(within refund notifications) | Para iadesi yapılacak bir ürünün miktarı. Bu özelliği, bir siparişte para iadesi yapılan ürünlere tanımlayıcı eklemek için kullanabilirsiniz. Örneğin: |
Bildirim şablonlarında Shopify Collective ürünlerini algılama
Shopify Collective etiketi, sipariş onayı e-postası gönderildikten sonra bir siparişe uygulandığı için bir sipariş onayı şablonunda {% if tags contains 'Shopify Collective' %} hiçbir zaman true olmaz. Shopify Collective ürünlerini algılamak için bunun yerine her bir satır öğesindeki ürün düzeyindeki etiketleri kontrol edin:
{% 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 %}Satır öğesi grubu özellikleri
line_item_groups listesindeki her bir line_item_group aşağıdaki özelliklere sahiptir.
| Özellik | Açıklama |
|---|---|
line_item_group.display_title | Satır öğesi grubunun başlığı. |
line_item_group.components | Gruba ait satır öğesi bileşenlerinin listesi. |
line_item_group.image | Satır öğesi grubunun görseli. |
line_item_group.product_id | Satır öğesi grubunun ürün kimliği. |
line_item_group.variant | Satır öğesi grubunun varyasyon nesnesi. |
line_item_group.variant_id | Satır öğesi grubunun varyasyon numarası. |
Para iadeleri özellikleri
| Özellik | Açıklama |
|---|---|
amount | Para iadesi tutarı. |
refund_line_items | Para iadesi yapılacak para iadesi satır öğelerinin listesi. |
Refund_line_item özellikleri
refund_line_items listesindeki her refund_line aşağıdaki özelliklere sahiptir:
| Özellik | Açıklama |
|---|---|
refund_line.line_item | Para iadesi yapılan line_item. Bu, tüm line_item özelliklerine erişebilir. |
refund_line.quantity | Para iadesi yapılacak satır öğesinin miktarı. |
Gönderim özellikleri
| Özellik | Açıklama |
|---|---|
service_name | Ayarlar > Kargo ve teslimat sayfasında tanımlanan özel hizmetin adı. (Yalnızca gönderim talebi) |
fulfillment.estimated_delivery_at | Aşağıdaki kargo şirketlerinden biri tarafından sağlanan takip numarasına (varsa) dayalı tahmini teslimat tarihi: USPS, FedEx, UPS, Canada Post (yalnızca Kanada). Bu özellik yalnızca kargo şirketi tarafından hesaplanan ücretler kullanımdayken kullanılabilir. |
fulfillment.fulfillment_line_items | Gönderilecek gönderim satır öğelerinin listesi. |
fulfillment.item_count | Tüm ürünlerin miktarlarının toplamı. Gönderilen toplam ürün sayısı. |
fulfillment.requires_shipping | (boolean) Bu gönderim talebinin kargo gerektirmesi durumunda true değerini döndürür. |
fulfillment.tracking_company | Takibi yapan şirket. |
fulfillment.tracking_numbers | Takip numaralarının listesi. |
fulfillment.tracking_urls | Takip URL'lerinin listesi. |
items_to_fulfill(deprecated) | Bu özel gönderim hizmeti tarafından gönderilecek satır öğelerinin listesi. (Yalnızca gönderim talebi) |
items_to_fulfill_count(deprecated) | Bu talep tarafından gönderilecek toplam ürün sayısı. (Yalnızca gönderim talebi) |
Fulfillment_line_item özellikleri
fulfillment_line_items listesindeki her bir fulfillment_line aşağıdaki özelliklere sahiptir.
| Özellik | Açıklama |
|---|---|
fulfillment_line.line_item | Gönderilen line_item. Bu, tüm line_item özelliklerine erişebilir. |
fulfillment_line.quantity | Gönderilen satır öğesinin miktarı. |
Hazırlanan paket özellikleri
Hazırlanan paket, teslim alıma hazır olarak işaretlenen ürünleri içerir.
| Özellik | Açıklama |
|---|---|
item_count | Hazırlanan paketteki tüm ürün miktarlarının toplamı. |
prepared_package_line_items | Hazırlanan paket satır öğelerinin listesi. |
Prepared_package_line_item özellikleri
prepared_package_line_items listesindeki her bir prepared_package_line_item aşağıdaki özelliklere sahiptir.
| Özellik | Açıklama |
|---|---|
line_item | İlişkili line_item. Bu, tüm line_item özelliklerine erişebilir. |
quantity | Teslim alıma hazır olarak işaretlenmiş satır öğesinin miktarı. |
Teslimat özellikleri
| Özellik | Açıklama |
|---|---|
delivery_agreements | Siparişe yönelik tüm Teslimat Anlaşmalarının listesi. |
delivery_instructions | Müşteriyle paylaşılacak yerel teslimat bilgileri. Bu bilgiler, yerel teslimat ayarlarınızdaki Teslimat bilgileri alanı tarafından kontrol edilir. |
consolidated_estimated_delivery_time | Müşteriyle paylaşılacak sipariş teslimat tarihleri bilgileri. Bu bilgiler, Kargo ve teslimat sayfanızda ayarladığınız İşlem süresi ayarı tarafından kontrol edilir. Siparişte birden fazla teslimat yöntemi olduğunda teslimat yöntemlerinin ve tarihlerinin bir listesi görüntülenir. |
has_multiple_delivery_methods | (boolean) Siparişte birden fazla teslimat yöntemi olması durumunda true değerini döndürür. |
Teslimat Anlaşması özellikleri
| Özellik | Açıklama |
|---|---|
delivery_agreement.delivery_method_type | Teslimat yöntemi türü. |
delivery_agreement.delivery_method_name | Alıcının ödeme yaptığı dil varsayılan mağaza dilinden farklı olduğunda, teslimat yöntemi türünün alıcının diline çevrilmiş hali. |
delivery_agreement.line_item_groups | Teslimat anlaşmasında, gruplanmış satır öğesi bileşenlerini içeren tüm satır öğesi gruplarının listesi. |
delivery_agreement.line_items | Bu teslimat anlaşmasıyla ilişkili tüm satır öğelerinin listesi. |
İndirim özellikleri
İki tür indirim özelliği vardır.
discount_applications, bir ürünün neden ve nasıl indirime girdiğini açıklar.
discount_allocations, belirli bir indirimin satır öğesini nasıl etkilediğini ve fiyatı nasıl düşürdüğünü açıklar. Bu özelliği satır öğesi düzeyinde kullanmalısınız.
Satır öğesi veya sipariş düzeyinde indirim bilgilerini görüntülemek için bu özellikleri birleştirebilirsiniz.
Örnek
Bu örnek, satır öğesine bir indirim uygulanıp uygulanmadığını kontrol eder. İndirim, sipariş düzeyinde (all) uygulanmadıysa indirim adı ve tutarı görüntülenir.
{% 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 %}Sonuç şuna benzer olabilir:
SPRING5 (-$5.00)Discount_allocation özellikleri
discount_allocations listesindeki her discount_allocation aşağıdaki özelliklere sahiptir.
| Özellik | Açıklama |
|---|---|
discount_allocation.amount | Müşterinin bir satır öğesinde tasarruf ettiği para tutarı. Birden fazla indirim koduna izin vermek istiyorsanız bir döngüye girilmelidir. |
discount_allocation.discount_application | Tutarı satır öğesine ayıran indirim uygulaması. |
Discount_application özellikleri
discount_applications listesindeki her discount_application aşağıdaki özelliklere sahiptir.
| Özellik | Açıklama |
|---|---|
discount_application.target_selection |
Bir indirimin, indirim uygulanacak satır öğelerini sepette nasıl seçtiğini açıklar. Şunlardan biridir:
|
discount_application.target_type | İndirimin uygulandığı ürün türü (line_item veya shipping_line). |
discount_application.title | İndirimin müşteri tarafından görülen adı. Örnekler: Welcome10 veya CBBWQQAKYBYY |
discount_application.total_allocated_amount | Bir siparişin fiyatının indirimle düşürüldüğü toplam tutar. |
discount_application.type | İndirimin türü. Şunlardan biridir: automatic, discount_code, manual veya script. |
discount_application.value | İndirimin değeri. |
discount_application.value_type | İndirimin değer türü. Şunlardan biridir: fixed_amount veya percentage. |
Abonelik özellikleri
Bir abonelik sözleşmesinin, mevcut fatura döneminin ve bu dönemin satır öğelerinin, teslimat yönteminin ve ödeme yönteminin ayrıntıları, tüm abonelik e-posta şablonlarında mevcuttur.
Abonelik bildirim şablonlarını düzenlemek için Shopify Subscriptions uygulamasını yükleyin ve ardından şablonu Ayarlar > Bildirimler altında, Abonelikler bölümünde bulun.
Abonelik sözleşmesi fatura dönemi özellikleri
Abonelik sözleşmesinin ve fatura döneminin özelliklerine erişmek için subscription_contract_billing_cycle nesnesini kullanın.
Örnek
{% assign contract = subscription_contract_billing_cycle %}
This contract is currently {{ contract.status }}.Sonuç:
This contract is currently paused.Özellikler
| Özellik | Açıklama |
|---|---|
status |
Sözleşmenin durumu. Şunlardan biridir: active, paused, cancelled, failed, expired, stale
|
delivery_method |
Aboneliğin teslimat yöntemi. Abonelik bir hizmet veya dijital ürün içinse nil döndürülür.
|
billing_frequency | Aboneliğin ne sıklıkla faturalandırıldığı. |
delivery_frequency | Aboneliğin ne sıklıkla teslim edildiği. |
origin_order |
Aboneliği ilk oluşturan orijinal sipariş. Abonelik bir Shopify siparişinden oluşturulmadıysa nil döndürülür.
|
customer | Abonelik müşterisi. |
line_items | Abonelik fatura dönemindeki satır öğeleri. |
product_names | Abonelik fatura dönemine dahil olan ürünlerin adlarının listesi. |
update_payment_method_url | Müşterinin bu sözleşme için ödeme yöntemini güncellemek üzere kullanabileceği URL. |
shipping_address |
Aboneliğin kargo adresi. Abonelik bir hizmet veya dijital ürün içinse nil döndürülür.
|
billing_address | Aboneliğin fatura adresi. |
subtotal_price | Abonelik satır öğelerinin alt toplam fiyatı. |
shipping_price | Aboneliğin kargo ücreti. |
total_tax | Aboneliğin toplam vergisi. |
total_price | Aboneliğin toplam fiyatı. |
total_discounts | Aboneliğin toplam indirimleri. |
customer_self_serve_url | Müşterinin aboneliklerini yönetmek için kullanabileceği self servis URL'si. |
billing_attempt_expected_date | Bu fatura döneminin fatura tarihi. |
next_billing_date | Bu fatura döneminin ardından, atlanmayan bir sonraki fatura tarihi. |
last_attempted_billing_date | Fatura dönemi için son denenen fatura tarihi. |
days_overdue | Bu fatura dönemi için faturalandırmanın geciktiği gün sayısı. |
payment_instrument | Abonelik sözleşmesiyle ilişkili ödeme aracı. Bu ödeme aracı, müşteriyi faturalandırmak için kullanılır. |
Abonelik sözleşmesi satır öğesi özellikleri
Fatura dönemine dahil olan her bir satır öğesinin özellikleri. Sözleşme satır öğesi özelliklerine, üst subscription_contract_billing_cycle.line_items özelliği üzerinden erişin.
Örnek
{% for line_item in subscription_contract_billing_cycle.line_items %}
{{ line_item.url }}
{% endfor %}| Özellik | Açıklama |
|---|---|
url | Satır öğesi ürün varyasyonuna ait ürün ayrıntıları sayfasının URL'si. |
requires_shipping | Satır öğesinin fiziki kargo gerektirip gerektirmediği. |
unit_price_measurement | Satır öğesi birim fiyat ölçümü. |
selling_plan_allocation | Satır öğesi satış planı ataması. |
Abonelik sözleşmesi teslimat yöntemi özellikleri
Bu fatura döneminde kullanılan teslimat yönteminin özellikleridir. Teslimat yöntemi özelliklerine subscription_contract_billing_cycle.delivery_method üst özelliği aracılığıyla erişin.
Örnek
{% if subscription_contract_billing_cycle.delivery_method != blank %}
Delivery method: {{ subscription_contract_billing_cycle.delivery_method.title }}
{% endif %}| Özellik | Açıklama |
|---|---|
title | Teslimat yöntemiyle ilişkili kargo seçeneğinin başlığıdır. |
type |
Teslimat yöntemi türü.kargo, yerel veya gel al seçeneklerinden biridir.
|
Abonelik sözleşmesi ödeme aracı özellikleri
Abonelik sözleşmesinin ödeme aracıyla ilgili ayrıntılar. Bu ödeme aracı, müşteriyi faturalandırmak için kullanılır. Ödeme aracı özelliklerine subscription_contract_billing_cycle.payment_instrument üst özelliği aracılığıyla erişin.
Örnek
{% 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 }}| Özellik | Açıklama |
|---|---|
payment_type |
Ödeme aracının temsil ettiği ödeme yönteminin türüdür. Bir görsel URL'si veya SVG çıktısı almak için ödeme filtrelerini kullanın. |
credit_card_brand | Kredi kartının markasıdır. |
credit_card_company | Kredi kartı şirketinin adıdır. |
credit_card_last_four_digits | Kredi kartının son 4 hanesidir. |
E-posta bildirimi özellikleri
| Özellik | Açıklama |
|---|---|
shop.email_logo_url | Yönetici panelindeki E-posta şablonlarını kişiselleştirme bölümünde belirtilen logonun URL'sidir. |
shop.email_logo_width | Yönetici panelindeki E-posta şablonlarını kişiselleştirme bölümünde belirtilen logo genişliğidir (piksel). |
shop.email_accent_color | Yönetici panelindeki E-posta şablonlarını kişiselleştirme bölümünde belirtilen vurgu renginin HEX kodudur. |
Mağaza kredisi özellikleri
Bir mağaza kredisi verilmesiyle ilgili ayrıntıları içeren özelliklerdir.
| Özellik | Açıklama |
|---|---|
issued_store_credit.amount |
Verilen mağaza kredisinin tutarıdır. Bu tutarı Liquid para filtrelerini kullanarak biçimlendirebilirsiniz. |
issued_store_credit.expires_at |
Verilen mağaza kredisinin geçerliliğinin sona ereceği tarih ve saattir. Bu tutarı Liquid tarih filtrelerini kullanarak biçimlendirebilirsiniz. |
issued_store_credit.balance_after_transaction |
Kredi verildikten sonra mağaza kredisi hesabının bakiyesidir. Bu tutarı Liquid para filtrelerini kullanarak biçimlendirebilirsiniz. |
customer | `Müşteri` çıktısının özelliklerini içeren müşteri nesnesidir. |