> ## Documentation Index
> Fetch the complete documentation index at: https://foliant-help.iforiti.com/llms.txt
> Use this file to discover all available pages before exploring further.

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

> Переменные Liquid, которые шаблоны используют для заказа, клиента, адресов, магазина, доставки, платежей, возвратов и выполнений.

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

На вкладке **Переменные Liquid** в редакторе кода перечислены все переменные, есть поиск. В этой статье описаны те, которые вам понадобятся чаще всего. Денежные значения указаны в центах; см. [Деньги и валюта в шаблонах](https://foliant-help.iforiti.com/ru/template-editor/liquid-money-and-currency.md).

## Заказ

| Переменная | Что выводит |
| - | - |
| `{{ 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` |

## Пример

```liquid theme={null}
<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' %}`. См. [Налоги и юридические данные](https://foliant-help.iforiti.com/ru/tax-and-legal.md).

## Похожие статьи

* [Позиции заказа в шаблонах](https://foliant-help.iforiti.com/ru/template-editor/liquid-line-items.md)
* [Деньги и валюта в шаблонах](https://foliant-help.iforiti.com/ru/template-editor/liquid-money-and-currency.md)
* [Фильтры Liquid](https://foliant-help.iforiti.com/ru/template-editor/liquid-filters.md)
* [Редактирование кода шаблона](https://foliant-help.iforiti.com/ru/template-editor/code-editor.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.