Справочник по переменным для уведомлений

Уведомления, отправляемые из вашего магазина, отображаются с помощью Liquid. Liquid — это простой и удобный язык программирования от Shopify. Это тот же язык программирования, на котором созданы темы из Theme Store.

Чтобы отредактировать уведомления, отправляемые из вашего магазина, вы можете внести базовые изменения в шаблоны уведомлений. Чтобы получить доступ к полному списку настраиваемых уведомлений, перейдите на страницу «Уведомления» в панели администратора Shopify.

Если вам нужна помощь с более сложными изменениями или с внесением изменений в пользовательские шаблоны уведомлений, вы можете обратиться к сообществу на наших форумах или нанять партнера Shopify, который выполнит эти настройки для вас. Подробнее о найме партнеров Shopify.

Свойства заказа

Многие свойства заказа доступны напрямую через Liquid и в шаблонах.

Описания свойств Liquid, которые можно использовать с объектом заказа в шаблонах уведомлений.
СвойствоОписание
id

Уникальный в рамках системы идентификатор заказа для внутреннего использования. Используйте следующий пример, чтобы сгенерировать ссылку на заказ в разделе администрирования вашего магазина. Например, в шаблон «Новый заказ» можно добавить следующий код:

Посмотреть заказ
emailАдрес электронной почты, связанный с заказом.
name

Обычно это символ решетки (#), за которым следует order_number.

Пример: #1004

order_nameТо же, что и name.
order_number

Уникальный номер заказа в магазине без префикса в виде решетки (#) и без каких-либо других префиксов или суффиксов, добавленных к ID заказа владельцем магазина в настройках.

Пример: 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.ПРОСТРАНСТВО_ИМЕН.КЛЮЧ

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' %} Мое действие... {% 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.ПРОСТРАНСТВО_ИМЕН.КЛЮЧ

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 money.

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

(логическое значение) Возвращает значение true, если у заказа есть транзакция с оплатой в ожидании.

Подробнее о платежах в ожидании.

buyer_action_required

(логическое значение) Возвращает значение true, если у заказа есть транзакция с оплатой в ожидании и для проведения платежа требуется действие покупателя. Когда это значение равно true и способ оплаты поддерживает платёжные инструкции, buyer_pending_payment_instructions предоставляет сведения, которые клиент может использовать для завершения покупки в офлайн-режиме.

Подробнее об объекте транзакции в Liquid.

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

Каждый элемент bundle_component в списке line_item.bundle_components имеет следующие свойства. (Только для черновиков заказов)

Описания свойств Liquid, которые можно использовать с объектом товара в составе набора в шаблонах уведомлений
СвойствоОписание
bundle_component.image_urlURL изображения товара в составе набора.
bundle_component.product.titleНазвание товара в составе набора.
bundle_component.quantityКоличество товара в составе набора.
bundle_component.variant.title

Текущие названия значений параметров варианта товара в составе набора, объединённые символом /.

Пример: маленький / красный

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

Каждый элемент component в списке line_item.components имеет следующие свойства. (Только для брошенных корзин) `

Описания свойств Liquid, которые можно использовать с объектом компонента в шаблонах уведомлений
СвойствоОписание
component.image_urlURL изображения компонента.
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)(логическое значение) Возвращает значение true, если позиция является комплектом товаров.
line.components(Abandoned checkout only)Список позиций, которые являются компонентами этой позиции.
line.parent?(Abandoned checkout only)(логическое значение) Возвращает значение true, если у позиции есть компоненты.
line.custom(Draft orders only)(логическое значение) Возвращает значение 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(логическое значение) Возвращает значение true, если для варианта предмета на странице товара активирована настройка «Физический товар».
line.selling_plan_allocationВозвращает объект selling_plan_allocation, который описывает, как план продаж (например, подписка) влияет на позицию.
line.taxable(логическое значение) Возвращает значение true, если для варианта товара на его странице установлен флажок «Взимать налоги с этого товара».
line.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Артикул, связанный с вариантом товара.
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_idID варианта для группы позиций.

Свойства возвратов платежей

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

Свойства позиции возврата платежа

Каждая позиция refund_line в списке refund_line_items имеет следующие свойства:

Описания свойств Liquid, которые можно использовать с объектом позиций возврата платежа в шаблонах уведомлений.
СвойствоОписание
refund_line.line_itemОбъект line_item, по которому выполняется возврат платежа. Он даёт доступ ко всем свойствам позиции.
refund_line.quantityКоличество единиц в позиции для возврата платежа.

Свойства выполнения заказа

Описания свойств Liquid, которые можно использовать с объектом выполнения заказа в шаблонах уведомлений.
СвойствоОписание
service_nameНазвание пользовательской службы, заданное на странице Настройки > Доставка и получение. (Только для запроса на выполнение заказа)
fulfillment.estimated_delivery_atПредполагаемая дата доставки, основанная на номере для отслеживания (если он доступен), который предоставлен одной из следующих транспортных компаний: USPS, FedEx, UPS, Почта Канады (только для Канады). Это свойство доступно, только если используются тарифы, рассчитываемые перевозчиком.
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, для которого выполняется заказ. Он даёт доступ ко всем свойствам позиции.
fulfillment_line.quantityКоличество единиц в позиции, для которой выполняется заказ.

Свойства подготовленной упаковки

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

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

Свойства позиции подготовленной упаковки

Каждая позиция prepared_package_line_item в списке prepared_package_line_items имеет следующие свойства.

Описания свойств Liquid, которые можно использовать с объектом позиции подготовленной упаковки в шаблонах уведомлений.
СвойствоОписание
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, которые можно использовать с объектом платежного цикла по договору на подписку в шаблонах уведомлений
СвойствоОписание
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_urlURL-адрес, который клиент может использовать для обновления способа оплаты по этому договору.
shipping_address Адрес доставки по подписке.

Если подписка оформлена на услугу или цифровой товар, возвращается значение nil.
billing_addressАдрес выставления счета для подписки.
subtotal_priceПромежуточный итог по позициям подписки.
shipping_priceСтоимость доставки по подписке.
total_taxОбщая сумма налога по подписке.
total_priceОбщая стоимость подписки.
total_discountsОбщая сумма скидок по подписке.
customer_self_serve_urlURL-адрес, по которому клиент может самостоятельно управлять своими подписками.
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, которые можно использовать с объектом позиции в договоре на подписку в шаблонах уведомлений
СвойствоОписание
urlURL-адрес страницы с данными о товаре для варианта товара в позиции.
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_urlURL логотипа, указанный в разделе «Настройка шаблонов электронной почты» панели администратора.
shop.email_logo_widthШирина логотипа (в пикселях), указанная в разделе «Настройка шаблонов электронной почты» панели администратора.
shop.email_accent_colorHEX-код акцентного цвета, указанный в разделе «Настройка шаблонов электронной почты» панели администратора.

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

Свойства, содержащие сведения о выдаче кредита магазина.

Описания свойств Liquid, которые можно использовать с объектом выданного кредита магазина в шаблонах уведомлений.
СвойствоОписание
issued_store_credit.amount

Сумма выданного кредита магазина.

Эту сумму можно отформатировать с помощью денежных фильтров Liquid.

issued_store_credit.expires_at

Дата и время окончания срока действия выданного кредита магазина.

Это значение можно отформатировать с помощью фильтров дат Liquid.

issued_store_credit.balance_after_transaction

Баланс счета с кредитом магазина после выдачи кредита.

Эту сумму можно отформатировать с помощью денежных фильтров Liquid.

customerОбъект клиента, содержащий атрибуты вывода данных о клиенте.