Как подготовить шаблон документа

Шаблон в Бумдоке - это обычный файл Word в формате .docx. Вы готовите договор, акт, счет или другой документ в привычном виде, а в местах для переменных данных ставите специальные обозначения.

Такие обозначения называются плейсхолдерами. Например, вместо названия клиента в шаблоне можно написать {{client.name}}. При создании документа Бумдок заменит его на данные выбранного клиента.

Плейсхолдер всегда пишется в двойных фигурных скобках. Внутри указывается, какие данные нужно подставить:

Пробелы внутри скобок допустимы, но лучше писать без них: {{client.name}}.

В шаблоне есть три группы данных:

• client - данные клиента, для которого создается документ
• my - ваши реквизиты из настроек Бумдока
• doc - номер и дата создаваемого документа

Для организации или ИП используйте такие плейсхолдеры:

{{client.name}}

название организации или ИП

{{client.inn}}

ИНН

{{client.ogrn}}

ОГРН организации

{{client.ogrnip}}

ОГРНИП предпринимателя

{{client.address}}

адрес

{{client.contact.fio}}

контактное лицо

{{client.contact.phone}}

телефон

{{client.contact.email}}

электронная почта

{{client.bank.account}}

расчетный счет

{{client.bank.name}}

банк

{{client.bank.code}}

БИК банка

{{client.bank.corrAccount}}

корреспондентский счет

Для физического лица используйте такие плейсхолдеры:

{{client.fio}}

ФИО физического лица

{{client.inn}}

ИНН

{{client.passport}}

паспортные данные

{{client.address}}

адрес

{{client.contact.fio}}

контактное лицо

{{client.contact.phone}}

телефон

{{client.contact.email}}

электронная почта

{{client.bank.account}}

расчетный счет

{{client.bank.name}}

банк

{{client.bank.code}}

БИК банка

{{client.bank.corrAccount}}

корреспондентский счет

Если один шаблон подходит и для организаций, и для физических лиц, можно поставить два плейсхолдера рядом:

Для организации заполнится название, а ФИО останется пустым. Для физического лица будет наоборот.

Эти плейсхолдеры берут данные из ваших настроек в Бумдоке:

{{my.name}}

название вашей организации или ИП

{{my.fio}}

ваше ФИО

{{my.inn}}

ИНН

{{my.ogrn}}

ОГРН

{{my.ogrnip}}

ОГРНИП

{{my.passport}}

паспортные данные

{{my.address}}

адрес

{{my.contact.fio}}

контактное лицо

{{my.contact.phone}}

телефон

{{my.contact.email}}

электронная почта

{{my.bank.account}}

расчетный счет

{{my.bank.name}}

банк

{{my.bank.code}}

БИК банка

{{my.bank.corrAccount}}

корреспондентский счет

Эти значения Бумдок подставляет при создании документа:

{{doc.number}}

номер документа

{{doc.date}}

дата документа

Чтобы шаблон загрузился и корректно заполнялся, соблюдайте простые правила:

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

Бумдок сохраняет исходный DOCX-файл и старается не менять его оформление: таблицы, отступы, колонтитулы, изображения и стили остаются в вашем шаблоне.

При загрузке шаблона Бумдок проверяет файл и плейсхолдеры. Загрузка не пройдет, если:

• файл не в формате .docx
• файл больше 10 МБ
• плейсхолдер написан в неправильном формате
• использован плейсхолдер, которого нет в списке поддерживаемых

Если ошибка найдена, Бумдок покажет сообщение и попросит исправить шаблон.

Для ФИО можно указать падеж и формат имени прямо в плейсхолдере. Например, {{client.fio | case:2}} подставит ФИО в родительном падеже, а {{client.fio | person:short}} сократит его до формата Фамилия И.О..

Модификаторы работают для {{client.fio}}, {{client.contact.fio}}, {{my.fio}} и {{my.contact.fio}}. Их можно комбинировать: {{my.contact.fio | case:5 | person:short}}.