Справочник по переменным для уведомлений
Уведомления, отправляемые из вашего магазина, отображаются с помощью Liquid. Liquid — это простой и удобный язык программирования от Shopify. Это тот же язык программирования, на котором созданы темы из Theme Store.
Чтобы отредактировать уведомления, отправляемые из вашего магазина, вы можете внести базовые изменения в шаблоны уведомлений. Чтобы получить доступ к полному списку настраиваемых уведомлений, перейдите на страницу «Уведомления» в панели администратора Shopify.
Если вам нужна помощь с более сложными изменениями или с внесением изменений в пользовательские шаблоны уведомлений, вы можете обратиться к сообществу на наших форумах или нанять партнера Shopify, который выполнит эти настройки для вас. Подробнее о найме партнеров Shopify.
На этой странице
- Свойства заказа
- Свойства черновика заказа
- Свойства графика платежей
- Свойства статуса платежа
- Свойства компонента набора
- Свойства компонента
- Свойства позиции в заказе
- Свойства группы позиций в заказе
- Свойства возвратов
- Свойства выполнения заказа
- Свойства подготовленной упаковки
- Свойства доставки
- Свойства скидки
- Свойства подписки
- Свойства email-уведомлений
- Свойства кредита магазина
Свойства заказа
Многие свойства заказа доступны напрямую через Liquid и в шаблонах.
| Свойство | Описание |
|---|---|
id |
Уникальный в рамках системы идентификатор заказа для внутреннего использования. Используйте следующий пример, чтобы сгенерировать ссылку на заказ в разделе администрирования вашего магазина. Например, в шаблон «Новый заказ» можно добавить следующий код: Посмотреть заказ
|
email | Адрес электронной почты, связанный с заказом. |
name |
Обычно это символ решетки (#), за которым следует Пример: #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_price |
Стоимость доставки. Пример: |
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 |
Любые атрибуты, которые были прикреплены к заказу. Пример: |
metafields |
Любые метаполя в заказе. Используйте следующий синтаксис: metafields.ПРОСТРАНСТВО_ИМЕН.КЛЮЧ |
referring_site |
Содержит URL-адрес реферера, который привёл клиента в ваш магазин. Пример: |
landing_site |
Содержит путь к целевой странице, которую использовал клиент. Это первая страница, которую клиент увидел, когда зашёл в магазин. Пример: |
landing_site_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 и наличных, то возвращаемый список будет « |
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 | Новая страница статуса для заказа, по которому клиент запросил возврат через аккаунты клиентов. |
Свойства черновика заказа
| Свойство | Описание |
|---|---|
id | Уникальный ИД черновика заказа для внутреннего использования. |
invoice_url | Ссылка, по которой клиент может перейти, чтобы оплатить счёт-фактуру через систему безопасного оформления заказов Shopify. |
reserve_inventory_until |
Дата и время, до которых зарезервированы позиции в черновике, например Даты можно форматировать с помощью фильтра дат Liquid. |
user | Последний сотрудник, который изменял черновик заказа. |
user.name | Имя последнего сотрудника, изменившего черновик заказа. |
user.email | Адрес электронной почты последнего сотрудника, изменившего черновик заказа. |
email | Адрес электронной почты, связанный с черновиком заказа. |
name | Уникальный number черновика заказа, с префиксом в виде знака решётки #. |
number | Уникальный номер черновика заказа без префикса или суффикса. |
created_at |
Дата и время создания черновика заказа клиентом, например Даты можно форматировать с помощью фильтра дат 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». |
Свойства графика платежей
| Свойство | Описание |
|---|---|
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, если платёж по графику не совершён и срок его оплаты истёк. |
Свойства статуса оплаты
| Свойство | Описание |
|---|---|
has_pending_payment |
(логическое значение) Возвращает значение true, если у заказа есть транзакция с оплатой в ожидании. Подробнее о платежах в ожидании. |
buyer_action_required |
(логическое значение) Возвращает значение true, если у заказа есть транзакция с оплатой в ожидании и для проведения платежа требуется действие покупателя. Когда это значение равно true и способ оплаты поддерживает платёжные инструкции, Подробнее об объекте транзакции в Liquid. |
Свойства товара в составе набора
Каждый элемент bundle_component в списке line_item.bundle_components имеет следующие свойства. (Только для черновиков заказов)
| Свойство | Описание |
|---|---|
bundle_component.image_url | URL изображения товара в составе набора. |
bundle_component.product.title | Название товара в составе набора. |
bundle_component.quantity | Количество товара в составе набора. |
bundle_component.variant.title | Текущие названия значений параметров варианта товара в составе набора, объединённые символом Пример: маленький / красный |
Свойства компонента
Каждый элемент component в списке line_item.components имеет следующие свойства. (Только для брошенных корзин)
`
| Свойство | Описание |
|---|---|
component.image_url | URL изображения компонента. |
component.product.title | Название товара компонента. |
component.quantity | Количество компонента. |
component.variant.title | Текущие названия значений параметров варианта компонента, объединённые символом Пример: маленький / красный |
Свойства позиции
Каждый элемент line в списке line_items или subtotal_line_items имеет следующие свойства.
| Свойство | Описание |
|---|---|
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) | Количество единиц товара для возврата платежа. Это свойство можно использовать для добавления идентификатора к позициям заказа, по которым оформлен возврат платежа. Например: |
Определение товаров 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 имеет следующие свойства.
| Свойство | Описание |
|---|---|
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 | ID варианта для группы позиций. |
Свойства возвратов платежей
| Свойство | Описание |
|---|---|
amount | Сумма возврата платежа. |
refund_line_items | Список позиций для возврата платежа. |
Свойства позиции возврата платежа
Каждая позиция refund_line в списке refund_line_items имеет следующие свойства:
| Свойство | Описание |
|---|---|
refund_line.line_item | Объект line_item, по которому выполняется возврат платежа. Он даёт доступ ко всем свойствам позиции. |
refund_line.quantity | Количество единиц в позиции для возврата платежа. |
Свойства выполнения заказа
| Свойство | Описание |
|---|---|
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 имеет следующие свойства.
| Свойство | Описание |
|---|---|
fulfillment_line.line_item | Объект line_item, для которого выполняется заказ. Он даёт доступ ко всем свойствам позиции. |
fulfillment_line.quantity | Количество единиц в позиции, для которой выполняется заказ. |
Свойства подготовленной упаковки
Подготовленная упаковка включает товары, отмеченные как готовые к самовывозу.
| Свойство | Описание |
|---|---|
item_count | Сумма количества всех позиций в подготовленной упаковке. |
prepared_package_line_items | Список позиций подготовленной упаковки. |
Свойства позиции подготовленной упаковки
Каждая позиция prepared_package_line_item в списке prepared_package_line_items имеет следующие свойства.
| Свойство | Описание |
|---|---|
line_item | Связанный объект line_item. Он даёт доступ ко всем свойствам позиции. |
quantity | Количество единиц в позиции, которые были отмечены как готовые к самовывозу. |
Свойства доставки
| Свойство | Описание |
|---|---|
delivery_agreements | Список всех соглашений о доставке для заказа. |
delivery_instructions | Информация о местной доставке для клиента. Эта информация управляется полем «Информация о доставке» в настройках местной доставки. |
consolidated_estimated_delivery_time | Информация о датах доставки заказа для клиента. Эта информация управляется настройкой «Время обработки», которую вы задаёте на странице «Доставка». Если в заказе несколько способов доставки, отображается список способов и дат доставки. |
has_multiple_delivery_methods | (логическое) Возвращает true, если в заказе несколько способов доставки. |
Свойства соглашения о доставке
| Свойство | Описание |
|---|---|
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 имеет следующие свойства.
| Свойство | Описание |
|---|---|
discount_allocation.amount | Сумма, сэкономленная клиентом по данной позиции. Необходимо указать в цикле, если вы хотите разрешить использование нескольких кодов скидок. |
discount_allocation.discount_application | Примененная скидка, распределяющая сумму по позиции. |
Свойства Discount_application
Каждый объект discount_application в списке discount_applications имеет следующие свойства.
| Свойство | Описание |
|---|---|
discount_application.target_selection |
Описывает, как скидка выбирает в корзине позиции, к которым будет применена скидка. Одно из следующих значений:
|
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.Свойства
| Свойство | Описание |
|---|---|
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 %}| Свойство | Описание |
|---|---|
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 %}| Свойство | Описание |
|---|---|
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 }}| Свойство | Описание |
|---|---|
payment_type |
Тип способа оплаты, представленный платежным инструментом. Используйте фильтры оплаты, чтобы вывести URL-адрес изображения или SVG. |
credit_card_brand | Бренд кредитной карты. |
credit_card_company | Название компании-эмитента кредитной карты. |
credit_card_last_four_digits | Последние 4 цифры номера кредитной карты. |
Свойства уведомлений по электронной почте
| Свойство | Описание |
|---|---|
shop.email_logo_url | URL логотипа, указанный в разделе «Настройка шаблонов электронной почты» панели администратора. |
shop.email_logo_width | Ширина логотипа (в пикселях), указанная в разделе «Настройка шаблонов электронной почты» панели администратора. |
shop.email_accent_color | HEX-код акцентного цвета, указанный в разделе «Настройка шаблонов электронной почты» панели администратора. |
Свойства кредита магазина
Свойства, содержащие сведения о выдаче кредита магазина.
| Свойство | Описание |
|---|---|
issued_store_credit.amount |
Сумма выданного кредита магазина. Эту сумму можно отформатировать с помощью денежных фильтров Liquid. |
issued_store_credit.expires_at |
Дата и время окончания срока действия выданного кредита магазина. Это значение можно отформатировать с помощью фильтров дат Liquid. |
issued_store_credit.balance_after_transaction |
Баланс счета с кредитом магазина после выдачи кредита. Эту сумму можно отформатировать с помощью денежных фильтров Liquid. |
customer | Объект клиента, содержащий атрибуты вывода данных о клиенте. |