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

# Номера документов в шаблонах

> Выводите номера счетов, кредит-нот и предложений с помощью {{ document_number }}, дату счёта с помощью {{ document_date }}, а также отметку об аннулировании.

Когда нумерация документов включена, Foliant присваивает счетам, кредит-нотам и предложениям собственные последовательные номера, например `INV-0042`. Шаблон выводит номер с помощью `{{ document_number }}`, а в визуальном редакторе — с помощью блока **Номер документа**.

## Перед началом

* Включите нумерацию в разделе **Настройки › Документы и печать › Нумерация документов**. См. [Настройка нумерации документов](https://foliant-help.iforiti.com/ru/invoices-and-numbering/document-numbering.md).
* Укажите **Тип документа** шаблона на странице его настроек: **Счёт**, **Кредит-нота** или **Предложение**. Шаблоны типа **Другое (без номера)** номеров не получают.

## В визуальном редакторе

Добавьте блок **Номер документа** (в разделе **Соответствие требованиям**). Он выводит номер и дату документа с подписями, например «Номер счёта» и «Дата счёта» («Дата кредит-ноты» для кредит-ноты, «Дата предложения» для предложения), на языке документа. Блок отображается только в нумерованных документах.

Также можно добавить **Номер документа** и **Дата документа** в **Сведения под заголовком** блока **Заголовок** или выбрать **Номер документа** в качестве данных, которые кодирует блок **Штрихкод / QR**.

## В коде

| Переменная | Что это |
| - | - |
| `{{ document_number }}` | Номер документа. Пусто, если у документа нет номера. |
| `{{ document_issued_at }}` | Когда был присвоен номер. Пусто, если у документа нет номера. Форматируйте с помощью `date`. |
| `{{ document_date }}` | Дата документа, задана всегда: дата присвоения номера, а если номера нет — дата заказа (для кредит-ноты — дата возврата). Используйте её как дату счёта. Форматируйте с помощью `date`. |
| `{{ document_voided }}` | True, если документ аннулирован. Его номер остаётся занятым и больше никогда не присваивается. |
| `{{ document_kind }}` | `invoice`, `credit_note` или `quote`; пусто, если шаблон не нумеруется. |

Выводите номер, только если он есть:

```liquid theme={null}
{% if document_number %}
  <p>{{ 'document_number.invoice' | t }}: {{ document_number }}</p>
  <p>{{ 'document_date.invoice' | t }}: {{ document_date | date: '%d %B %Y' }}</p>
  {% if document_voided %}<p>{{ 'document_number.void' | t }}</p>{% endif %}
{% endif %}
```

`'document_date.invoice' | t` выводит «Дата счёта» на языке документа; для других типов используйте `document_date.credit_note` или `document_date.quote`.

## Дата счёта

Дата счёта — это день его выставления, то есть день присвоения номера. Это не дата заказа и не сегодняшняя дата, которая меняется при каждой повторной печати. `{{ document_date }}` даёт вам именно эту дату:

* В нумерованном документе это день присвоения номера в часовом поясе вашего магазина. Повторная печать документа в следующем месяце её не меняет.
* В документе без номера это дата заказа. Для заказов, импортированных из других систем, это дата обработки заказа. Кредит-нота использует дату возврата.

Поэтому один и тот же шаблон работает и с включённой, и с выключенной нумерацией. Встроенные шаблоны счёта, кредит-ноты и предложения уже выводят эту дату с подписью «Дата счёта», «Дата кредит-ноты» или «Дата предложения». Если ваш собственный шаблон выводит в качестве даты `'now' | date`, замените это на `{{ document_date | date: '%d %B %Y' }}`.

## Если ваш шаблон не выводит номер

Если шаблон нумерованного документа нигде не использует `document_number`, Foliant добавляет в конце небольшую строку с номером и датой его присвоения, например «Номер счёта: INV-0042 · 4 октября 2026», чтобы номер никогда не пропадал. Добавьте `{{ document_number }}` в нужное место, и эта строка исчезнет. Если ваш шаблон уже выводит `document_date` или `document_issued_at`, в строке будет только номер.

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

* Документ получает номер при первом скачивании, печати или экспорте и сохраняет его.
* Предпросмотр в редакторе показывает номер, который получит ваш следующий документ, но не расходует его.
* Штрихкод номера: `{{ document_number | barcode }}`. См. [Штрихкоды и QR-коды](https://foliant-help.iforiti.com/ru/template-editor/liquid-barcodes-and-qr-codes.md).
* Шаблоны для всех выбранных заказов сразу никогда не нумеруются.

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

* [Настройка нумерации документов](https://foliant-help.iforiti.com/ru/invoices-and-numbering/document-numbering.md)
* [Справочник блоков](https://foliant-help.iforiti.com/ru/template-editor/block-catalogue.md)
* [Штрихкоды и QR-коды](https://foliant-help.iforiti.com/ru/template-editor/liquid-barcodes-and-qr-codes.md)
* [Даты, языки и переводы](https://foliant-help.iforiti.com/ru/template-editor/liquid-dates-and-languages.md)


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