Объект заказа и основные переменные

Каждый документ формируется из одного заказа (а для сводных шаблонов — из выбранных заказов). В Liquid поля заказа доступны напрямую, например {{ name }}, а также через order, например {{ order.name }}. Оба варианта работают одинаково. Переменные повторяют переменные Shopify Order Printer, поэтому большинство шаблонов Order Printer работают в Foliant без изменений. На вкладке Переменные Liquid в редакторе кода перечислены все переменные, есть поиск. В этой статье описаны те, которые вам понадобятся чаще всего. Денежные значения указаны в центах; см. Деньги и валюта в шаблонах.

Заказ

Переменная	Что выводит
`{{ order_name }}` или `{{ name }}`	Название заказа со знаком # (`#1042`)
`{{ order_number }}`	Номер заказа (`1042`)
`{{ id }}`	ID заказа
`{{ po_number }}`	Номер заказа на покупку
`{{ date }}` или `{{ created_at }}`	Когда был оформлен заказ. Отформатируйте дату фильтром `date`.
`{{ processed_at }}`, `{{ updated_at }}`, `{{ cancelled_at }}`, `{{ closed_at }}`	Другие даты заказа
`{{ completed_at }}`	Когда был завершён черновик заказа
`{{ financial_status }}`	Статус оплаты, например `paid`, `pending` или `partially_refunded`
`{{ fulfillment_status }}`	Статус выполнения, например `unfulfilled` или `fulfilled`
`{{ note }}`	Примечание к заказу
`{{ tags }}`	Теги заказа (это список: перебирайте его через `{% for tag in tags %}`)
`{{ email }}`	Эл. почта заказа
`{{ customer_locale }}`	Язык, на котором клиент делал покупки
`{{ order_status_url }}`	Ссылка на страницу статуса заказа (онлайн-заказы)
`{{ total_items }}` или `{{ item_count }}`	Количество товаров
`{{ total_weight }}`	Общий вес; `{{ total_weight_in_grams \| weight_with_unit }}` добавляет единицу измерения
`{{ order_currency }}` или `{{ currency }}`	Код валюты заказа
`{% if pickup_in_store? %}…{% endif %}`	Забирается ли заказ в магазине
`{{ location.name }}`	Точка продаж POS (заказы POS), с полями `address1`, `city`, `zip`, `country`, `phone`…

Итоги

Выводите итоговые суммы с денежным фильтром, например {{ total_price | money }}.

Переменная	Что это
`subtotal_price`	Промежуточный итог
`shipping_price`	Доставка
`total_discounts`	Все скидки
`order_level_discounts`	Скидки на весь заказ (не входят в цены позиций)
`total_tax`	Налог
`total_line_items_tax`, `total_shipping_tax`	Налог на товары и на доставку
`total_duties`	Пошлины
`total_price`	Итог заказа
`total_paid`	Оплаченная сумма
`total_refunds`	Возвращённая сумма
`total_gift_cards`	Оплачено подарочными картами

Также доступны current_subtotal_price, current_total_discounts, current_total_tax и current_total_price.

Клиент и адреса

Переменная	Что выводит
`{{ customer.name }}`, `{{ customer.first_name }}`, `{{ customer.last_name }}`	Имя клиента
`{{ customer.email }}`, `{{ customer.phone }}`	Контактные данные
`{{ customer.note }}`	Примечание о клиенте
`{{ customer.tags }}`	Теги клиента
`{{ customer.total_spent \| money }}`	Сколько потратил клиент
`{% if customer.tax_exempt %}`	Освобождён ли клиент от налогов
`{{ shipping_address \| format_address }}`	Адрес доставки с переносами строк
`{{ billing_address \| format_address }}`	Платёжный адрес

У каждого адреса (shipping_address, billing_address и customer.default_address) есть поля name, first_name, last_name, company, address1, address2, street, city, province, province_code, zip, country, country_code, phone и city_province_zip. {% if shipping_address.member_of_eu %} проверяет, входит ли страна в ЕС.

Ваш магазин

Переменная	Что выводит
`{{ shop.name }}` или `{{ shop_name }}`	Название вашего магазина
`{{ shop.email }}`, `{{ shop.phone }}`, `{{ shop.domain }}`	Контактные данные
`{{ shop.address1 }}`, `{{ shop.city }}`, `{{ shop.zip }}`, `{{ shop.country }}`…	Ваш адрес, указанный в Shopify
`{{ shop_logo_url }}`, `{{ shop_logo_width }}`, `{{ shop_accent_color }}`	Ваш логотип и акцентный цвет из Настройки › Брендинг
`{{ shop.vat_number }}`, `{{ shop.eori }}`	Ваш номер плательщика НДС и EORI из Настройки › Налоги и юр. данные
`{{ seller.legal_lines \| join: ' · ' }}`	Ваши юридические данные, по одной строке, на языке документа

Доставка, платежи и выполнения

Переменная	Что выводит
`{{ shipping_method.title }}`	Способ доставки
`{% for shipping_line in shipping_lines %}`	Каждая строка доставки: `title`, `code`, `price`
`{{ payment_method }}`, `{{ gateway }}`	Способ оплаты заказа
`{% for transaction in transactions %}`	Каждая транзакция: `amount`, `kind`, `status`, `gateway`, `created_at`
`{% for tax_line in tax_lines %}`	Каждый налог: `title`, `rate`, `price`
`{% for discount in discounts %}`	Каждая скидка: `code`, `amount`, `savings`
`{% for fulfillment in fulfillments %}`	Каждое выполнение: `tracking_number`, `tracking_company`, `created_at`
`{{ latest_fulfillment }}`	Последнее выполнение
`{% for refund in refunds %}`	Каждый возврат: `created_at`, `note`, `subtotal`, `total_tax`, `total`, `refund_line_items`
`{{ latest_refund }}`	Последний возврат (кредит-ноты)
`{{ payment_terms.due_in_days }}`	Условия оплаты (B2B и черновики заказов), с `payment_schedules` и `current_payment_schedule.due_at`

Пример

<h1>{{ 'titles.invoice' | t }} {{ order_name }}</h1>
<p>{{ created_at | date: '%d %B %Y' }}</p>
<p>{{ shipping_address | format_address }}</p>
<p>{{ 'total' | t }}: {{ total_price | money }}</p>
{% if note != blank %}<p>{{ note | escape }}</p>{% endif %}

Полезно знать

Пустое значение ничего не выводит. Используйте {% if … != blank %}, чтобы скрыть подпись, когда значения нет.
Шаблоны для всех выбранных заказов вместо одного заказа используют orders (перебор через {% for order in orders %}), batch и pick_list. См. раздел Сводные шаблоны на вкладке Переменные Liquid.
Для счетов с НДС см. раздел НДС в справочнике: tax_breakdown, buyer.vat_number, {% include 'vat_breakdown' %} и {% include 'legal_notes' %}. См. Налоги и юридические данные.

Добро пожаловать

Начало работы

Печать

Шаблоны

Редактор шаблонов

Дизайны

Отправка PDF

Шаблоны писем

Аккаунты покупателей

Экспорт

Счета и нумерация

Налоги и юридические данные

Интеграции

Оплата и тарифы

Настройки

Устранение неполадок

Правовая информация