Что такое переменные в шаблонах Doku.by

Переменные в шаблонах — это специальные значения, которые автоматически заменяются реальными данными при создании документа. Вместо ручного ввода названия компании, реквизитов, даты, номера документа и данных контрагента вы вставляете переменную, а Doku.by сам подставляет нужную информацию.

Например, если в шаблоне указана переменная [company.name], то в готовом документе вместо нее появится название вашей компании.

Зачем нужны переменные

• ускоряют создание документов;
• уменьшают количество ошибок;
• позволяют использовать один шаблон много раз;
• автоматически подставляют данные компании, контрагента, физического лица и документа.

Как работают переменные

1. Вы добавляете переменные в текст шаблона.
2. При создании документа Doku.by берет данные из профиля компании, карточки контрагента, карточки физического лица и параметров документа.
3. Переменные автоматически заменяются реальными значениями.

Ниже приведен полный список переменных с названиями на русском языке, как они отображаются в кнопках редактора.

Полный список переменных

• Разделитель [separator] — Добавляет разделительную линию или визуальный разделитель в документ.
• Дата [date] —  Подставляет дату документа.
• День [date.day] —  Подставляет только день из даты документа.
• Месяц [date.month] —  Подставляет только месяц из даты документа.
• Год [date.year] —  Подставляет только год из даты документа.
• Номер документа [number] —  Подставляет номер документа

• Любое число прописью [any_number_words] —  Преобразует число в текстовый формат.
• Любая сумма прописью [any_amount_words] —  Подставляет сумму словами.
• Подробно с НДС [amount_words_vat_detailed] —  Подставляет сумму прописью с детальным указанием НДС.
• Классический [amount_words_classic] — Подставляет сумму прописью в стандартном формате.
• Для договоров [amount_words_contract] — Подставляет сумму прописью в формате, удобном для договоров.
• С НДС [amount_words_vat] — Подставляет сумму прописью с указанием НДС.
• НДС (20% в т.ч.) [vat_amount] — Подставляет сумму НДС.
• Краткий [amount_words_short] — Подставляет короткий вариант суммы прописью.

Моя компания. Основная информация

• Название [company.name] — Краткое название компании.
• Полное наименование [company.full_name] —  Полное юридическое наименование компании.
• Сокращённое наименование [company.short_name] —  Краткая форма названия компании.
• Логотип [company.logo] —  Подставляет логотип компании.
• Печать [company.seal] —  Подставляет печать компании.
• УНП [company.unp] —  Подставляет учетный номер плательщика.
• ОКПО [company.okpo] —  Подставляет код ОКПО.

Моя компания. Адреса и контакты

• Юридический адрес [company.legal_address] — Подставляет юридический адрес компании.
• Почтовый адрес [company.postal_address] —  Подставляет почтовый адрес компании.
• Email [company.email] —  Подставляет электронную почту компании.
• Телефон [company.phone] — Подставляет телефон компании.

Моя компания. Банковские реквизиты

• Банк [company.bank.name] —  Подставляет название банка компании.
• Адрес банка [company.bank.address] —  Подставляет адрес банка компании.
• IBAN [company.account.iban] — Подставляет номер счета в формате IBAN.
• БИК [company.account.bic] —  Подставляет банковский идентификационный код.

Моя компания. Уполномоченное лицо

• ФИО [company.director.name] —  Подставляет полное имя руководителя.
• ФИО (род. падеж) [company.director.name_genitive] — Подставляет имя руководителя в родительном падеже.
• ФИО сокращённое [company.director.name_short] —  Подставляет сокращенное имя руководителя.
• ФИО сокращённое (род. падеж) [company.director.name_short_genitive] —  Подставляет сокращенное имя руководителя в родительном падеже.
• Должность [company.director.position] — Подставляет должность руководителя.
• Действует на основании [company.legal_basis] — Подставляет основание полномочий, например Устава, доверенности или приказа.

Контрагент - Юридическое лицо. Основная информация

• Название [counterparty.name] — Краткое название контрагента.
• Полное наименование [counterparty.full_name] — Полное юридическое наименование контрагента.
• Сокращённое наименование [counterparty.short_name] —  Краткая форма названия контрагента.
• УНП [counterparty.unp] —  Подставляет УНП контрагента.
• ОКПО [counterparty.okpo] —  Подставляет ОКПО контрагента.

Контрагент - Юридическое лицо. Адреса и контакты

• Юридический адрес [counterparty.legal_address] —  Подставляет юридический адрес контрагента.
• Почтовый адрес [counterparty.postal_address] —  Подставляет почтовый адрес контрагента.
• Email [counterparty.email] — Подставляет электронную почту контрагента.
• Телефон [counterparty.phone] —  Подставляет телефон контрагента.

Контрагент - Юридическое лицо. Банковские реквизиты

• Банк [counterparty.bank.name] —  Подставляет название банка контрагента.
• Адрес банка [counterparty.bank.address] —  Подставляет адрес банка контрагента.
• IBAN [counterparty.account.iban] —  Подставляет номер счета контрагента в формате IBAN.
• БИК [counterparty.account.bic] — Подставляет банковский идентификационный код контрагента.

Контрагент - Юридическое лицо. Уполномоченное лицо

• ФИО [counterparty.director.name] —  Подставляет полное имя руководителя контрагента.
• ФИО (род. падеж) [counterparty.director.name_genitive] —  Подставляет имя руководителя контрагента в родительном падеже.
• ФИО сокращённое [counterparty.director.name_short] —  Подставляет сокращенное имя руководителя контрагента.
• ФИО сокращённое (род. падеж) [counterparty.director.name_short_genitive] —  Подставляет сокращенное имя руководителя контрагента в родительном падеже.
• Должность [counterparty.director.position] —  Подставляет должность руководителя контрагента.
• Действует на основании [counterparty.legal_basis] —  Подставляет основание полномочий контрагента.

Физическое лицо

• ФИО [individual.full_name] —  Подставляет полное имя физического лица.
• ФИО (род. падеж) [individual.full_name_genitive] —  Подставляет имя физического лица в родительном падеже.
• Серия паспорта [individual.passport_series] — Подставляет серию паспорта.
• Номер паспорта [individual.passport_number] — Подставляет номер паспорта.
• Идентификационный номер [individual.identification_number] — Подставляет личный идентификационный номер.
• Выдан [individual.passport_issued_by] — Подставляет, кем выдан паспорт.
• Дата выдачи паспорта [individual.passport_issued_date] — Подставляет дату выдачи паспорта.

Родительский документ

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

• Тип документа [parent_document_type] — Подставляет тип родительского документа.
• Номер документа [parent_document_number] — Подставляет номер родительского документа.
• Дата документа [parent_document_date] — Подставляет дату родительского документа.
• Контрагент [parent_document_counterparty] —  Подставляет контрагента родительского документа.
• Полная ссылка [parent_document_full] — Подставляет полную ссылку на родительский документ, например Договор №123 от 01.01.2026.
• Развернутая ссылка [parent_document_reference] — Подставляет расширенное обозначение родительского документа.

Таблица товаров и услуг

• Таблица товаров/услуг [items_table] — Вставляет полную таблицу с позициями.
• № [items_table.no] — Подставляет номер позиции.
• Наименование [items_table.name] — Подставляет название товара или услуги.
• Ед. изм. [items_table.unit] — Подставляет единицу измерения.
• Кол-во [items_table.qty] — Подставляет количество.
• Цена [items_table.price] — Подставляет цену позиции.
• Стоимость [items_table.amount] — Подставляет стоимость позиции.
• НДС % [items_table.vat_rate] —Подставляет ставку НДС.
• НДС [items_table.vat] — Подставляет сумму НДС.
• Итого [items_table.total] — Подставляет итоговую сумму по позиции.

Пример использования

Можно написать в шаблоне так:

Исполнитель: [company.full_name], в лице [company.director.position] [company.director.name_genitive], действующего на основании [company.legal_basis], с одной стороны, и Заказчик: [counterparty.full_name], в лице [counterparty.director.position] [counterparty.director.name_genitive], действующего на основании [counterparty.legal_basis], с другой стороны.

После создания документа Doku.by автоматически заменит эти значения реальными данными.

Что важно помнить

• Переменные нужно вставлять точно в указанном формате, в квадратных скобках.
• Данные для подстановки берутся из карточки компании, карточки контрагента, карточки физического лица и параметров документа.
• Если какие-то данные не заполнены, переменная может подставиться пустой.
• Некоторые переменные работают только в определенных типах документов.

Итог

Переменные в шаблонах Doku.by помогают автоматизировать создание документов, сократить ручную работу и избежать ошибок. Чем точнее настроен шаблон, тем быстрее и удобнее будет подготовка договоров, актов, счетов и других документов.