Справка за променливите в известията

Известията, изпращани от Вашия магазин, се изобразяват с помощта на Liquid. Liquid е простият и лесен за използване език за програмиране на Shopify. Това е същият език за програмиране, на който са изградени темите от Theme Store.

За да редактирате известията, които се изпращат от Вашия магазин, можете да направите основни персонализации на шаблоните си за известия. За достъп до пълния списък с известия, които можете да персонализирате, отидете на страницата Известия във Вашия администраторски панел на Shopify.

За помощ с по-сложни промени или за извършване на промени в персонализирани шаблони за известия можете да се свържете с общността в нашите форуми, или можете също да наемете Партньор на Shopify, който да направи персонализациите за Вас. Научете повече за наемането на Партньор на Shopify.

На тази страница

Свойства на поръчката

Много свойства на поръчката са достъпни директно чрез Liquid и в шаблоните.

Описания на свойствата на Liquid, които можете да използвате с обекта на поръчката в шаблоните за известия
Свойство	Описание
`id`	Уникален за цялата система идентификатор на поръчката за вътрешна употреба. Използвайте следния пример, за да генерирате връзка към поръчката в администраторския раздел на Вашия магазин. Например във Вашия шаблон за Нова поръчка можете да добавите следния код: `Преглед на поръчката`
`email`	Имейлът, свързан с поръчката.
`name`	Обикновено това е символ диез, последван от `order_number`. Пример: #1004
`order_name`	Същото като name.
`order_number`	Уникален номер на поръчката за магазина, без префикс диез (#) или друг префикс или суфикс, добавен към идентификатора на поръчката от собственика на магазина в предпочитанията на магазина. Пример: 1004
`confirmation_number`	Случайно генериран буквено-цифров идентификатор за поръчката, който може да бъде показан на клиента вместо последователното име на поръчката. Не е гарантирано, че тази стойност е уникална. Пример: XPAV284CT
`created_at`	Датата и часът, в които клиентът е създал поръчката. Можете да форматирате това с помощта на филтъра за дата. Пример: 2009-05-30T17:43:51+02:00
`payment_terms`	Условията за плащане посочват датата, на която трябва да бъде извършено плащането за дадена поръчка. Научете как да добавяте условия за плащане към фактури за поръчки. За повече подробности вижте справката за Liquid за payment_terms.
`destination`	Дестинацията, до която трябва да бъдат изпратени артикулите.
`tags`	Връща масив от всички тагове на поръчката. Таговете се връщат в азбучен ред. Тагове, които се прилагат динамично от приложения или функции на платформата, като например тага `Shopify Collective`, може да не са налични при генериране на имейла с известието. За да откриете артикули от конкретна функция, вместо това проверявайте таговете на ниво продукт за всеки ред. За повече подробности вижте справочната документация на Liquid.
`transactions`	Връща масив от трансакции от поръчката.
`tax_price`	Общата сума на данъците за всички артикули в поръчката.
`tax_lines`	Данъци, разбити по вид на облагане: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	Името на данъка. Например QST или ДДС.
`tax_line.price`	Сумата на данъка.
`tax_line.rate`	Данъчната ставка като десетична дроб. Ще върне 0,175, ако е 17,5%.
`tax_line.rate_percentage`	Данъчната ставка в четим за човек формат. Ще върне 17,5, ако ставката е 0,175.
`customer`	Обект на клиент, съдържащ атрибутите на изходните данни за клиент.
`billing_address`	Адресът за фактуриране.
`billing_address.first_name`	Собствено име на клиента.
`billing_address.last_name`	Фамилно име на клиента.
`billing_address.company`	Име на фирмата за фактуриране.
`billing_address.phone`	Телефонен номер от адреса за фактуриране.
`shop.name`	Име на Вашия магазин.
`shop.phone`	Телефонен номер на Вашия магазин.
`subtotal_price`	Сбор от цените на редовете на поръчката, след като е приспадната всяка отстъпка за ред или отстъпка за количка. Междинната сума не включва данъци (освен ако данъците не са включени в цените), разходи за доставка или бакшиши.
`discounts`	Списък с отстъпки.
`discounts_amount`	Сумата на отстъпката, приложена от всички отстъпки. Пример: +5,00 $
`discounts_savings`	Спестената сума от всички отстъпки. Пример: -5,00 $
`total_price`	Обща сума на поръчката (междинна сума + разходи за доставка - отстъпка за доставка + данък).
`financial_status`	Текущият статус на плащането. Едно от: nil, `pending`, `authorized`, `paid`, `voided`, `refunded`.
`requires_shipping`	(булев тип) Връща true, ако в поръчката има поне един артикул, който изисква доставка.
`shipping_method.title`	Името на тарифата за доставка. В известията, предназначени за клиенти, името на тарифата за доставка се превежда на езика, на който клиентът е финализирал поръчката си, когато езикът е различен от езика по подразбиране на магазина. Пример: Стандартна доставка
`shipping_method.price`	Цената на доставката, включително всяка отстъпка за доставка. Пример: `{{ shipping_method.price \| money }}`
`shipping_price`	Цената на доставката. Пример: `{{ shipping_price \| money }}`
`shipping_address`	Адресът за доставка.
`shipping_address.first_name`	Собственото име за адреса за доставка.
`shipping_address.company`	Име на фирмата за адреса за доставка.
`shipping_address.phone`	Телефонен номер от адреса за доставка.
`line_items`	Списък на всички редове в поръчката.
`line_items_including_zero_quantity`	Списък на всички редове в поръчката, включително тези с количество нула. Редовете имат количество нула, когато сумата по тях е напълно възстановена.
`line_item_groups`(Orders and POS only)	Списък на всички групи редове, съдържащи компоненти на редове в поръчката.
`item_count`	Сбор от количествата на всички артикули.
`fulfillment_status`	Текущото състояние на изпълнение на поръчката. Едно от: `unfulfilled`, `partial`, `fulfilled`.
`note`	Бележката, която е прикачена към поръчката. Бележката може да бъде получена от клиента и/или редактирана в екрана с подробности за поръчката във Вашия администраторски панел.
`attributes`	Всички атрибути, които са били прикачени към поръчката. Пример: `{{ attributes.gift-note }}`
`metafields`	Всички метаполета на поръчката. Използвайте следния синтаксис: metafields.NAMESPACE.KEY
`referring_site`	Съдържа URL адреса на препращащия източник, който е довел клиента до Вашия магазин. Пример: `https://www.google.com/?s=great+products`
`landing_site`	Съдържа пътя на целевия сайт, който клиентът е използвал. Това е първата страница, която клиентът е видял, когато е достигнал до магазина. Пример: `/products/great-product?ref=my-tracking-token`
`landing_site_ref`	Преглежда целевия сайт и извлича от него референтен параметър. Референтните параметри могат да бъдат: `ref`, `source`, `r`. Ако `landing_site` е `/products/great-product?ref=my-tracking-token`, тогава `landing_site_ref` е `my-tracking-token`. Можете да извършите определено действие, ако Вашият ref е равен на определена стойност: `{% if landing_site_ref == 'my-tracking-token' %} My action... {% endif %}`
`cancelled`	(булев тип) Връща true, ако поръчката е била анулирана.
`cancelled_at`	Времето, когато поръчката е била анулирана.
`cancel_reason`	Причината, избрана при анулиране на поръчката. Една от: `inventory`, `customer`, `declined`, `fraud` или `other`.
`has_high_risks?`(deprecated)	Връща true, ако поръчката е с висок риск
`unique_gateways`	Връща списък с уникалните доставчици на плащания за дадена поръчка. Например, ако някой е платил с Visa, Mastercard и в брой, тогава върнатият списък ще бъде `shopify_payments, cash`.
`location`(POS only)	Показва физическото местоположение на поръчката. Налични са няколко свойства за местоположение, изброени тук. Можете да конфигурирате местоположенията в раздела „Местоположения“ на администраторския панел.
`order_status_url`	Връща връзката към страницата за състоянието на тази поръчка.
`fulfilled_line_items`(deprecated)	Списък с редовете, които са изпълнени.
`unfulfilled_line_items`(deprecated)	Списък с редовете, които не са напълно изпълнени.
`b2b?`	Връща true, ако поръчката е B2B поръчка. Използвайте свойството с B2B променливи, за да показвате съответната информация, като например име на компанията, локация на компанията и адрес в имейлите. Например при B2B поръчки можете да добавите заглавка към шаблон със следната информация: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	Компанията, на която продавате при B2B поръчка.
`company.name`	Името на компанията при B2B поръчка.
`company.id`	Идентификаторът на компанията при B2B поръчка.
`company_location`	Локацията на компанията при B2B поръчка. Една компания, която купува от Вас, може да има повече от една локация.
`company_location.name`	Името на локацията на компанията при B2B поръчка.
`company_location.id`	Идентификационният номер на локацията на компанията при B2B поръчка.
`company_location.shipping_address`	Адресът за доставка на локацията на компанията при B2B поръчка.
`company_location.billing_address`	Адресът за фактуриране на локацията на компанията при B2B поръчка.
`customer_order_url`	Новата страница за състоянието на поръчката, за която клиент е поискал връщане чрез клиентски акаунти.

Свойства на чернова на поръчка

Описания на свойства на Liquid, които можете да използвате с обекта за чернова на поръчка в шаблоните за известия
Свойство	Описание
`id`	Уникален идентификатор на черновата на поръчка за вътрешна употреба.
`invoice_url`	Връзка, която клиентът може да последва, за да плати фактурата, като използва сигурния процес на плащане на Shopify.
`reserve_inventory_until`	Датата и часът, до които са резервирани редовете в черновата, например `2015-05-30T17:43:51+02:00`. Можете да форматирате датите, като използвате филтъра за дата на Liquid.
`user`	Последният член на персонала, който е променил черновата на поръчката.
`user.name`	Името на последния член на персонала, който е променил черновата на поръчката.
`user.email`	Имейл адресът на последния член на персонала, който е променил черновата на поръчката.
`email`	Имейл адресът, свързан с черновата на поръчката.
`name`	Уникалният `number` на черновата на поръчката, с префикс диез `#`.
`number`	Уникалният номер на черновата на поръчката без префикс или суфикс.
`created_at`	Датата и часът, когато клиентът е създал черновата на поръчката, например `2009-05-30T17:43:51+02:00`. Можете да форматирате датите, като използвате филтъра за дата на Liquid.
`tags`	Връща масив с всички тагове на поръчката. Таговете се връщат по азбучен ред. За повече подробности вижте документацията за справка на Liquid.
`tax_price`	Комбинираните данъци за всички артикули в черновата на поръчката.
`tax_lines`	Данъци, разбити по вид данък: `{% for tax_line in tax_lines %} {{ tax_line.title }} ({{ tax_line.rate_percentage }}%) : {{ tax_line.price \| money_with_currency }} {% endfor %}`
`tax_line.title`	Името на данъка. Примери: QST или ДДС
`tax_line.price`	Сумата на данъка.
`tax_line.rate`	Данъчната ставка в десетичен вид. Например данъчна ставка от 17,5% ще върне `0,175`.
`tax_line.rate_percentage`	Данъчната ставка в процентен вид. Например `rate` от 0,175 ще върне `17,5`.
`customer`	Обект на клиент, съдържащ атрибутите на изходните данни за клиент.
`billing_address`	Адресът за фактуриране за черновата на поръчката.
`billing_address.first_name`	Собственото име на клиента.
`billing_address.last_name`	Фамилията на клиента.
`billing_address.company`	Името на компанията в адреса за фактуриране.
`billing_address.phone`	Телефонният номер в адреса за фактуриране.
`shop.name`	Името на Вашия магазин.
`shop.phone`	Телефонен номер на Вашия магазин.
`subtotal_price`	Сумата от цените на редовете в черновата на поръчката, след като е приспадната всяка отстъпка за ред или отстъпка за количка. Междинната сума не включва данъци (освен ако данъците не са включени в цените) или разходи за доставка.
`discounts`	Списък с отстъпки.
`discounts_amount`	Сумата на отстъпката, приложена от всички отстъпки. Пример: +5,00 $
`discounts_savings`	Сума на спестяванията, причинени от всички отстъпки. Пример: -5,00 $
`total_price`	Общата цена на поръчката (междинна сума + разходи за доставка - отстъпка за доставка + данък).
`amount_due_now`	Сумата, изисквана от фактурата за чернова на поръчка.
`requires_shipping`	Връща `true` ако има поне един артикул в черновата на поръчката, който изисква доставка. Връща `false` ако нито един артикул в черновата на поръчката не изисква доставка.
`shipping_method.title`	Името на тарифата за доставка. Пример: Стандартна доставка
`shipping_method.price`	Цената на начина на доставка. Връща същата информация като `shipping_price`.
`shipping_price`	Цената на доставката. Можете да форматирате тази сума, като използвате филтрите за пари на Liquid.
`shipping_address`	Адресът за доставка. Забележка: За разлика от обикновените поръчки, адресът за доставка на черновата на поръчка може да е непълен.
`shipping_address.first_name`	Собственото име за адреса за доставка.
`shipping_address.company`	Името на компанията в адреса за доставка.
`shipping_address.phone`	Телефонният номер в адреса за доставка.
`line_items`	Списък на всички редове в черновата на поръчката.
`item_count`	Сумата от количествата на всички артикули в черновата на поръчката.
`note`	Бележката, прикачена към черновата на поръчката. Бележката може да бъде получена от клиента, а също и редактирана в екрана с подробности за черновата на поръчката във Вашия администраторски панел на Shopify.
`metafields`	Всички метаполета в черновата на поръчката. Използвайте следния синтаксис: metafields.NAMESPACE.KEY
`location`	Физическото местоположение на поръчката. Налични са няколко свойства за местоположение. Можете да конфигурирате местоположенията на страницата Местоположения във Вашия администраторски панел на Shopify.
`b2b?`	Връща true, ако поръчката е B2B поръчка. Използвайте свойството с B2B променливи, за да показвате съответната информация, като например име на компанията, локация на компанията и адрес в имейлите. Например при B2B поръчки можете да добавите заглавка към шаблон със следната информация: `{% if b2b? %} <p> Customer: {{ customer.name }} <p> Company: {{ company.name }} <p> Location: {{ company_location.name }} {% endif%}`
`company`	Компанията, на която продавате при B2B поръчка.
`company.name`	Името на компанията при B2B поръчка.
`company.id`	Идентификаторът на компанията при B2B поръчка.
`company_location`	Локацията на компанията при B2B поръчка. Една компания, която купува от Вас, може да има повече от една локация.
`company_location.name`	Името на локацията на компанията при B2B поръчка.
`company_location.id`	Идентификационният номер на локацията на компанията при B2B поръчка.
`company_location.shipping_address`	Адресът за доставка на локацията на компанията при B2B поръчка.
`company_location.billing_address`	Адресът за фактуриране на локацията на компанията при B2B поръчка.
`payment_methods`	Списък със запазени начини на плащане, достъпни за обработка на общата сума на черновата.
`payment_method.payment_instrument`	Платежният инструмент, съдържащ подробности за запазения начин на плащане.
`payment_method.payment_instrument.payment_type`	Типът на запазения начин на плащане. Напр. „credit_card, apple_pay“
`payment_method.payment_instrument.credit_card_brand`	Марката на картата, когато `payment_type` е „credit_card“
`payment_method.payment_instrument.credit_card_company`	Компанията, издала картата, когато `payment_type` е „credit_card“
`payment_method.payment_instrument.credit_card_company`	Последните 4 цифри на картата, когато `payment_type` е „credit_card“

Свойства на графика на плащане

Описания на Liquid свойства, които можете да използвате с обекта за график на плащане в шаблоните за известия
Свойство	Описание
`payment_schedule.amount_due`	Сумата за плащане за даден график на плащане. Можете да форматирате суми с валути с помощта на Liquid филтъра за пари.
`payment_schedule.due_at`	Падежната дата за графика на плащане. Можете да форматирате датите, като използвате филтъра за дата на Liquid.
`payment_schedule.due_in_days`	Броят дни до падежната дата, ако плащането по графика все още е дължимо (неплатено).
`payment_schedule.due_later?`	Връща true, ако плащането по даден график не е извършено и падежната му дата е в бъдещето.
`payment_schedule.number_of_days_overdue?`	Броят на дните от падежната дата, когато плащането по графика е просрочено.
`payment_schedule.overdue?`	Връща true, ако плащането по даден график не е извършено и падежната му дата е минала.

Свойства на статуса на плащане

Описания на Liquid свойства, които можете да използвате с обекта за статус на плащане в шаблоните за известия
Свойство	Описание
`has_pending_payment`	(boolean) Връща true, ако поръчката има транзакция с предстоящо плащане. Научете повече за предстоящите плащания.
`buyer_action_required`	(boolean) Връща true, ако дадена поръчка има транзакция с предстоящо плащане и се изисква действие от страна на купувача за деблокиране на плащането. Когато тази стойност върне true и начинът на плащане поддържа инструкции за плащане, `buyer_pending_payment_instructions` предоставя подробности, които клиентът може да използва, за да завърши покупката си офлайн. Научете повече за Liquid обекта за транзакция.

Свойства на компонента в пакет

Всеки bundle_component в списъка с line_item.bundle_components има следните свойства. (Само за чернови на поръчки)

Описания на Liquid свойства, които можете да използвате с обекта за компонент в пакет в шаблоните за известия
Свойство	Описание
`bundle_component.image_url`	URL адресът на изображението на компонента в пакет.
`bundle_component.product.title`	Заглавието на продукта на компонента в пакет.
`bundle_component.quantity`	Количество на компонента в пакет.
`bundle_component.variant.title`	Текущите имена на стойностите на опциите на варианта на компонента в пакет, свързани със знаци `/`. Пример: малък / червен

Свойства на компонента

Всеки component в списъка с line_item.components има следните свойства. (Само за изоставено плащане) `

Описания на Liquid свойства, които можете да използвате с обекта за компонент в шаблоните за известия
Свойство	Описание
`component.image_url`	URL адресът на изображението на компонента.
`component.product.title`	Заглавието на продукта на компонента.
`component.quantity`	Количество на компонента.
`component.variant.title`	Текущите имена на стойностите на опциите на варианта на компонента, свързани със знаци `/`. Пример: малък / червен

Свойства на реда

Всеки line в списъка с line_items или subtotal_line_items има следните свойства.

Описания на Liquid свойства, които можете да използвате с обекта за ред в шаблоните за известия
Свойство	Описание
`line.applied_discounts`(POS and draft orders only)	Списък с отстъпки, приложени към този артикул (всяка отстъпка има свойствата `title`, `code`, `amount`, `savings` и `type`).
`line.bundle_components`(Draft orders only)	Списък с редове, които са компоненти в пакет на този артикул. Връща списък само ако този ред е продукт в пакет.
`line.bundle_parent?`(Draft orders only)	(boolean) Връща true, ако редът е продукт в пакет.
`line.components`(Abandoned checkout only)	Списък с редове, които са компоненти на този артикул.
`line.parent?`(Abandoned checkout only)	(boolean) Връща true, ако редът има компоненти.
`line.custom`(Draft orders only)	(boolean) Връща true, ако артикулът е персонализиран ред за чернова на поръчка.
`line.delivery_agreement`	Споразумението за доставка, свързано с този ред.
`line.grams`	Тегло на един артикул.
`line.groups`	Група редове на артикула.
`line.image`	Връща URL адреса на изображението, свързано с този ред. Можете също да използвате филтъра img_url, за да получите конкретни размери на изображението, например `{{ line.image \| img_url: 'small' }}`
`line.line_price`	Цената, умножена по количеството за този артикул.
`line.original_line_price`	Комбинираната цена на количеството артикули, включени в реда, преди да бъдат приложени отстъпките.
`line.final_line_price`	Комбинираната цена на всички артикули в реда, включително всички суми на отстъпки на ниво ред.
`line.pre_tax_price`	Цената преди данъци за артикулите в реда, умножена по закупеното количество.
`line.price`	Цената за един артикул.
`line.product.metafields`	Всички метаполета на ниво продукт. Използвайте следния синтаксис: line.product.metafields.NAMESPACE.KEY
`line.product.title`	Текущото име на продукта.
`line.product.vendor`	Доставчикът на артикула.
`line.properties`	Връща масив с персонализирана информация за даден артикул. Свойствата на реда се задават от клиента на страницата на продукта, преди добавяне на продукт в количката.
`line.quantity`	Количество за този артикул.
`line.current_quantity`	Текущото количество на артикула след премахвания.
`line.requires_shipping`	(boolean) Връща true, ако вариантът за артикула има активирана настройка Физически продукт на страницата на продукта.
`line.selling_plan_allocation`	Връща обект `selling_plan_allocation`, който описва как даден план за продажба, като например абонамент, засяга реда.
`line.taxable`	(boolean) Връща true, ако за варианта на артикула е отметнато полето за отметка „Начисляване на данъци върху този продукт“ на страницата на продукта.
`line.title`	Името на продукта към момента на продажбата, последвано от тире и името на варианта към момента на продажбата. Името на варианта не се включва, когато е „Default Title“. В известията, видими за клиентите, името на продукта и името на варианта се превеждат на езика, на който клиентът е извършил плащането, когато езикът е различен от езика по подразбиране на магазина.
`line.url`	Относителният URL адрес на варианта на реда. Относителният URL адрес не включва основния URL адрес на Вашия магазин (`mystore.myshopify.com`).
`line.variant.barcode`	Баркодът, свързан с продуктовия вариант.
`line.variant.compare_at_price`	Сравнителната цена, свързана с продуктовия вариант.
`line.variant.image`	Изображението за продуктовия вариант. Връща изображение само ако към варианта в реда е присвоено конкретно изображение.
`line.variant.metafields`	Всички метаполета на ниво вариант. Използвайте следния синтаксис: line.variant.metafields.NAMESPACE.KEY
`line.variant.sku`	SKU, свързан с продуктовия вариант.
`line.variant.title`	Текущите имена на стойностите на опциите на варианта, свързани със символи `/`. Пример: малък / червен
`line.refunded.quantity`(within refund notifications)	Количеството на артикул, за който се възстановява сума. Можете да използвате това свойство, за да добавите идентификатор към артикули с възстановена сума в дадена поръчка. Например: `{% if line.refunded_quantity > 0 %}Идентификатор на ред с възстановена сума{% endif %}`

Откриване на артикули на Shopify Collective в шаблони за известия

Тагът Shopify Collective се прилага към поръчка след изпращане на имейла за потвърждение на поръчката, така че {% if tags contains 'Shopify Collective' %} никога не е true в шаблон за потвърждение на поръчка. За да откриете артикули на Shopify Collective, вместо това проверявайте таговете на ниво продукт за всеки ред:

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

Свойства на групата от редове

Всяка line_item_group в списъка с line_item_groups има следните свойства.

Описания на Liquid свойства, които можете да използвате с обекта за група от редове в шаблоните за известия
Свойство	Описание
`line_item_group.display_title`	Заглавието на групата от редове.
`line_item_group.components`	Списък с компоненти на реда, принадлежащи към групата.
`line_item_group.image`	Изображението на групата от редове.
`line_item_group.product_id`	Идентификаторът на продукта на групата от редове.
`line_item_group.variant`	Обектът на варианта на групата от редове.
`line_item_group.variant_id`	Идентификаторът на варианта на групата от редове.

Свойства за възстановяване на суми

Описания на Liquid свойства, които можете да използвате с обекта за възстановяване на сума в шаблоните за известия
Свойство	Описание
`amount`	Възстановената сума.
`refund_line_items`	Списък с редове за възстановяване на сума.

Свойства на ред за възстановяване на сума

Всеки refund_line в списъка с refund_line_items има следните свойства:

Описания на Liquid свойства, които можете да използвате с обекта за редове за възстановяване на сума в шаблоните за известия
Свойство	Описание
`refund_line.line_item`	Редът (line_item), за който се възстановява сума. Той има достъп до всички свойства на line_item.
`refund_line.quantity`	Количеството от реда, за което се възстановява сума.

Свойства за обработка и доставка

Описания на Liquid свойства, които можете да използвате с обекта за обработка и доставка в шаблоните за известия
Свойство	Описание
`service_name`	Името на персонализираната услуга, както е дефинирано на страницата Настройки > Доставка и получаване. (Само за заявка за изпълнение)
`fulfillment.estimated_delivery_at`	Очаквана дата на доставка въз основа на номера за проследяване (ако е наличен), предоставен от един от следните превозвачи: USPS, FedEx, UPS, Canada Post (само за Канада). Това свойство е достъпно само когато се използват тарифи, изчислени от превозвач.
`fulfillment.fulfillment_line_items`	Списък с редове за обработка и доставка.
`fulfillment.item_count`	Сбор от количествата на всички артикули. Общият брой артикули, които се обработват и доставят.
`fulfillment.requires_shipping`	(булева стойност) Връща true, ако тази заявка за изпълнение изисква доставка.
`fulfillment.tracking_company`	Компанията, която извършва проследяването.
`fulfillment.tracking_numbers`	Списък с номера за проследяване.
`fulfillment.tracking_urls`	Списък с URL адреси за проследяване.
`items_to_fulfill`(deprecated)	Списък с редове, които трябва да бъдат изпълнени от тази конкретна услуга за персонализирано изпълнение. (Само за заявка за изпълнение)
`items_to_fulfill_count`(deprecated)	Общият брой артикули, които да бъдат изпълнени с тази заявка. (Само за заявка за изпълнение)

Свойства на ред за обработка и доставка

Всеки fulfillment_line в списъка с fulfillment_line_items има следните свойства.

Описания на Liquid свойства, които можете да използвате с обекта за редове за обработка и доставка в шаблоните за известия
Свойство	Описание
`fulfillment_line.line_item`	Редът (line_item), който се изпълнява. Той има достъп до всички свойства на line_item.
`fulfillment_line.quantity`	Количеството на реда, което се изпълнява.

Свойства на подготвена пратка

Подготвената пратка включва артикулите, маркирани като готови за получаване.

Описания на Liquid свойства, които можете да използвате с обекта за подготвена пратка в шаблоните за известия
Свойство	Описание
`item_count`	Сбор от количествата на всички артикули в подготвената пратка.
`prepared_package_line_items`	Списък с редове от подготвената пратка.

Свойства на ред от подготвена пратка

Всеки prepared_package_line_item в списъка с prepared_package_line_items има следните свойства.

Описания на Liquid свойства, които можете да използвате с обекта за ред от подготвена пратка в шаблоните за известия
Свойство	Описание
`line_item`	Свързаният ред (line_item). Той има достъп до всички свойства на line_item.
`quantity`	Количеството на реда, което е маркирано като готово за получаване.

Свойства на доставка

Описания на Liquid свойства, които можете да използвате с обекта за доставка в шаблоните за известия
Свойство	Описание
`delivery_agreements`	Списък на всички Споразумения за доставка за поръчката.
`delivery_instructions`	Информация за местна доставка за споделяне с клиента. Тази информация се контролира от полето Информация за доставка във Вашите настройки за местна доставка.
`consolidated_estimated_delivery_time`	Информация за датите на доставка на поръчката за споделяне с клиента. Тази информация се контролира от настройката Време за обработка, която сте задали на Вашата страница Доставка. Когато поръчката има няколко начина на доставка, се показва списък с начини и дати на доставка.
`has_multiple_delivery_methods`	(булева стойност) Връща true, ако поръчката има няколко начина на доставка.

Свойства на споразумението за доставка

Описания на Liquid свойства, които можете да използвате с обекта за споразумение за доставка в шаблоните за известия
Свойство	Описание
`delivery_agreement.delivery_method_type`	Типът на начина на доставка.
`delivery_agreement.delivery_method_name`	Типът на начина на доставка, преведен на езика, на който купувачът е финализирал поръчката, когато езикът е различен от езика по подразбиране на магазина.
`delivery_agreement.line_item_groups`	Списък на всички групи от редове, съдържащи групирани компоненти на редове в споразумението за доставка.
`delivery_agreement.line_items`	Списък на всички редове, свързани с това споразумение за доставка.

Свойства на отстъпката

Съществуват два вида свойства за отстъпки.

discount_applications описват защо и как даден артикул е получил отстъпка.

discount_allocations описват как конкретна отстъпка засяга ред и как намалява цената. Трябва да използвате това свойство на ниво ред.

Можете да комбинирате тези свойства, за да покажете информация за отстъпката на ниво ред или поръчка.

Пример

Този пример проверява дали е приложена отстъпка към реда. Ако отстъпката не е приложена на ниво поръчка (all), тогава се показват името и размерът на отстъпката.

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

Резултатът може да бъде подобен на този:

SPRING5 (-$5.00)

Свойства на Discount_allocation

Всеки discount_allocation в списъка с discount_allocations има следните свойства.

Описания на Liquid свойства, които можете да използвате с обекта discount_allocation в шаблоните за известия
Свойство	Описание
`discount_allocation.amount`	Сумата пари, спестена от клиента за даден ред. Трябва да се въведе в цикъл, ако искате да разрешите множество кодове за отстъпка.
`discount_allocation.discount_application`	Приложението за отстъпка, което разпределя сумата по реда.

Свойства на Discount_application

Всеки discount_application в списъка с discount_applications има следните свойства.

Описания на Liquid свойства, които можете да използвате с обекта discount_application в шаблоните за известия
Свойство	Описание
`discount_application.target_selection`	Описва как дадена отстъпка избира редове в количката, които да получат отстъпка. Едно от: `all`: Отстъпката се прилага за всички редове. `entitled`: Отстъпката се прилага за определен поднабор от редове, често дефиниран от условие. `explicit`: Отстъпката се прилага за конкретно избран ред или ред при доставка.
`discount_application.target_type`	Типът на артикула, за който се прилага отстъпка (`line_item` или `shipping_line`).
`discount_application.title`	Името на отстъпката, видимо за клиента. Примери: Welcome10 или CBBWQQAKYBYY
`discount_application.total_allocated_amount`	Общата сума, с която цената на поръчката се намалява от отстъпката.
`discount_application.type`	Типът на отстъпката. Едно от: `automatic`, `discount_code`, `manual` или `script`.
`discount_application.value`	Стойността на отстъпката.
`discount_application.value_type`	Типът на стойността на отстъпката. Едно от: `fixed_amount` или `percentage`.

Свойства на абонамента

Подробности за договор за абонамент, текущия цикъл на фактуриране и неговите редове, начин на доставка и начин на плащане са достъпни за всички имейл шаблони за абонамент.

За да редактирате шаблоните за известия за абонамент, инсталирайте приложението Shopify Subscriptions и след това намерете шаблона в Настройки > Известия в секцията Абонаменти.

Свойства на цикъла на фактуриране на договор за абонамент

За достъп до свойствата на договора за абонамент и неговия цикъл на фактуриране използвайте обекта subscription_contract_billing_cycle.

Пример

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

Резултат:

This contract is currently paused.

Свойства

Описания на Liquid свойства, които можете да използвате с обекта subscription_contract_billing_cycle в шаблоните за известия
Свойство	Описание
`status`	Състоянието на договора. Едно от `active`, `paused`, `cancelled`, `failed`, `expired`, `stale`.
`delivery_method`	Начинът на доставка на абонамента. Ако абонаментът е за услуга или дигитален продукт, тогава се връща `nil`.
`billing_frequency`	Колко често се таксува абонаментът.
`delivery_frequency`	Колко често се доставя абонаментът.
`origin_order`	Първоначалната поръчка, която е създала абонамента. Ако абонаментът не е създаден от поръчка в Shopify, тогава се връща `nil`.
`customer`	Клиентът на абонамента.
`line_items`	Редовете в цикъла на фактуриране на абонамента.
`product_names`	Списък с имената на продуктите, включени в цикъла на фактуриране на абонамента.
`update_payment_method_url`	URL адресът, който клиентът може да използва за актуализиране на начина на плащане за този договор.
`shipping_address`	Адресът за доставка на абонамента. Ако абонаментът е за услуга или дигитален продукт, тогава се връща `nil`.
`billing_address`	Адресът за фактуриране на абонамента.
`subtotal_price`	Междинната сума на цената на редовете на абонамента.
`shipping_price`	Цената за доставка на абонамента.
`total_tax`	Общият данък на абонамента.
`total_price`	Общата цена на абонамента.
`total_discounts`	Общите отстъпки на абонамента.
`customer_self_serve_url`	URL адресът за самообслужване, който клиентът може да използва, за да управлява своите абонаменти.
`billing_attempt_expected_date`	Датата на таксуване за този цикъл на фактуриране.
`next_billing_date`	Следващата непропусната дата на таксуване след този цикъл на фактуриране.
`last_attempted_billing_date`	Последната дата на опит за таксуване за цикъла на фактуриране.
`days_overdue`	Броят дни, с които е просрочено таксуването за този цикъл на фактуриране.
`payment_instrument`	Платежният инструмент, свързан с договора за абонамент. Този платежен инструмент се използва за таксуване на клиента.

Свойства на ред в договор за абонамент

Свойствата за всеки ред, включен в цикъла на фактуриране. Достъпете свойствата на реда в договора чрез родителското свойство subscription_contract_billing_cycle.line_items.

Пример

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

Описания на Liquid свойства, които можете да използвате с обекта subscription contract line item в шаблоните за известия
Свойство	Описание
`url`	URL адресът към страницата с подробности за продукта за продуктовия вариант на реда.
`requires_shipping`	Дали редът изисква физическа доставка.
`unit_price_measurement`	Измерването на единичната цена на реда.
`selling_plan_allocation`	Разпределението по план за продажба на реда.

Свойства на начина на доставка по договор за абонамент

Свойствата за начина на доставка, използван в този период на фактуриране. Достъп до свойствата на начина на доставка можете да получите чрез родителското свойство subscription_contract_billing_cycle.delivery_method.

Пример

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

Описания на свойствата на Liquid, които можете да използвате с обекта за начин на доставка на договор за абонамент в шаблоните за известия
Свойство	Описание
`title`	Заглавието на опцията за доставка, свързана с начина на доставка.
`type`	Типът на начина на доставка. Едно от `shipping`, `local` или `pick-up`.

Свойства на платежния инструмент на договора за абонамент

Подробности за платежния инструмент за договора за абонамент. Този платежен инструмент се използва за таксуване на клиента. Достъп до свойствата на платежния инструмент можете да получите чрез родителското свойство subscription_contract_billing_cycle.payment_instrument.

Пример

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

Описания на свойствата на Liquid, които можете да използвате с обекта за платежен инструмент на договор за абонамент в шаблоните за известия
Свойство	Описание
`payment_type`	Типът начин на плащане, представен от платежния инструмент. Използвайте филтри за плащане, за да изведете URL адрес на изображение или SVG.
`credit_card_brand`	Марката на кредитната карта.
`credit_card_company`	Името на компанията, издала кредитната карта.
`credit_card_last_four_digits`	Последните 4 цифри на кредитната карта.

Свойства на имейл известията

Описания на свойствата на Liquid, които можете да използвате с обекта за имейл известия в шаблоните за известия
Свойство	Описание
`shop.email_logo_url`	URL адресът за логото, посочен в раздел Персонализиране на имейл шаблони на администраторския панел.
`shop.email_logo_width`	Ширината на логото (в пиксели), посочена в раздел Персонализиране на имейл шаблони на администраторския панел.
`shop.email_accent_color`	HEX кодът за акцентиращия цвят, посочен в раздел Персонализиране на имейл шаблони на администраторския панел.

Свойства на кредита в магазина

Свойствата, съдържащи подробности за издаване на кредит в магазина.

Описания на свойствата на Liquid, които можете да използвате с обекта за издаден кредит в магазина в шаблоните за известия
Свойство	Описание
`issued_store_credit.amount`	Сумата на издадения кредит в магазина. Можете да форматирате тази сума, като използвате филтрите за пари на Liquid.
`issued_store_credit.expires_at`	Датата и часът, на които ще изтече издаденият кредит в магазина. Можете да форматирате тази стойност, като използвате филтри за дата на Liquid.
`issued_store_credit.balance_after_transaction`	Салдото по кредитната сметка в магазина след издаването на кредита. Можете да форматирате тази сума, като използвате филтрите за пари на Liquid.
`customer`	Обект на клиент, съдържащ атрибутите на изходните данни за клиент.