# Переменные для документов [![шапка2.jpg](https://help.bulldok.ru/uploads/images/gallery/2024-01/scaled-1680-/ApNsapka2.jpg)](https://help.bulldok.ru/uploads/images/gallery/2024-01/ApNsapka2.jpg) ##### Общие правила Для формирования необходимых документов «Бульдок» требует подготовить и загрузить специальные шаблоны, на основании которых будет формироваться тот или иной документ. Шаблон представляет из себя файл в формате «docx» (MS Word) и содержит следующие основные данные: 1. Текст документа и его форматирование (пункты договора, таблицы и т.п.). 2. Имена переменных в специальном формате. 3. Подпись и печать. Шаблоны должны иметь особые имена, на основании которых «Бульдок» определяет, какой шаблон выбрать для того или иного документа. Имена шаблонов и соответствующие им типы документов перечислены в таблице ниже.

Имя файла шаблона	Назначение
dz.docx	Договор заказчика
zz.docx	Заявка заказчика
zp.docx	Заявка перевозчика
dov.docx	Доверенность на осуществление перевозки (перевозчику)
raz.docx	Разрешение на выгрузку (перевозчику)
pre.docx	Уведомление о прекращении действия договора-заявки (перевозчику)

Для подстановки данных внутри шаблона используются предопределённые переменные в особом формате: {{ имя\_переменной }} Необходимо помнить, что имя переменной должно быть отделено от фигурных скобок пробелами с каждой стороны, иначе подстановки не произойдёт. Также её не произойдёт, если фигурные скобки будет одинарными. Все имена переменных состоят из одного слова (т.е. пишутся слитно). Примеры правильного и неправильного оформления ниже.

{{ datezayavki }}	Верное написание
{{ date zayavki }}	Ошибка – имя переменной написано раздельно
{{datezayavki}}	Ошибка – нет пробелов между именем переменной и фигурными скобками
{ datezayavki }	Ошибка – скобки должны быть двойными
{{ датазаявки }}	Ошибка – несуществующая переменная

##### Полный список переменных шаблона

Имя переменной	Значение
{{ numzayavki }}	Номер заявки
{{ datezayavki }}	Дата заявки
{{ numdogovor }}	Номер договора
{{ datedogovorx }}	Дата договора
{{ basis }}	Основание (для оптовых счетов)
	отдельные поля (нужно включать доп.поля в настройках )
{{ numzz }}	номер заявки заказчика;
{{ datezz }}	дата заявки заказчика;
{{ numdp }}	номер договора перевозчика.
{{ datedp }}	дата договора перевозчика.
Оплаты
{{ stavkazakazchika }}	Ставка заказчика
{{ foramoplatyzakazchik }}	Форма оплаты заказчика
{{ ndsz }}	% НДС заказчика (пустая строка, если без НДС)
{{ stavkaperevozchika }}	Ставка перевозчика
{{ foramoplatyperevozchik }}	Форма оплаты перевозчика
{{ ndsp }}	% НДС перевозчика (пустая строка, если без НДС)
{{ uderzaniyeperevozchik }}	Удержание перевозчика
{{ fo2\_p }}	условие оплаты перевозчику.
{{ sz\_currency }}	Выбор валюты заказчика
{{ sp\_currency }}	Выбор валюты перевозчика
Данные перевозки
{{ marshrut }}	Маршрут перевозки
{{ namegruz }}	Наименование груза
{{ ves }}	Вес, объём груза
{{ volume }}	объём груза
{{ sposob }}	Способ погрузки
{{ trebovaniyaavto }}	Требования к автомобилю перевозчика

{{ datepogruzki }}	Дата погрузки
{{ adrespogruzki }}	Адрес погрузки
{{ nameotpravitel }}	Наименование отправителя
{{ kontakt1 }}	Контактные данные отправителя

{{ daterazgruzki }}	Дата разгрузки
{{ adresvigruzki }}	Адрес разгрузки
{{ namepoluchatel }}	Наименование получателя
{{ kontakt2 }}	Контактные данные получателя

{{ markaavto }}	Марка, модель автомобиля/прицепа
{{ truck\_plate }}	Гос. номер тягача
{{ truck\_model }}	Модель тягача
{{ trailer\_plate }}	Гос. номер прицепа
{{ trailer\_model }}	Модель прицепа

	Водитель
{{ driver\_name }}	ФИО водителя
{{ fiovoditela }}	ФИО водителя и паспортные данные
{{ telvoditela }}	Телефон водителя
{{ driver\_passport\_number }}	Паспортные данные: серия номер
{{ driver\_passport\_date }}	Дата выдачи
{{ driver\_passport\_issued }}	Кем выдан
{{ dopzakazchik }}	Дополнительное поле заказчика
{{ dopperevozchik }}	Дополнительное поле перевозчика
{{ driver\_snils }}	СНИЛС
{{ driver\_license }}	Водительское удостоверение
{{ loading\_date\_fact }}	Дата погрузки факт
{{ unloading\_date\_fact }}	Дата выгрузки факт


Данные нашей компании
{{ nameipzakazchik }}	Наименование нашей организации для заказчика (мы для заказчика)
{{ nameipperevozchik }}	Наименование нашей организации для перевозчика (мы для перевозчика)
{{ rekvizitipzakazchik }}	Реквизиты нашей компании для заказчика
{{ rekvizitipperevozchik }}	Реквизиты нашей компании для перевозчика
{{ inn\_ipz }}	ИНН нашей организации для заказчика
{{ inn\_ipp }}	ИНН нашей организации для перевозчика
{{ kpp\_ipz }}	КПП нашей организации для заказчика
{{ kpp\_ipp }}	КПП нашей организации для перевозчика
{{ person\_ipz }}	Поле «в лице» для нашей организации для заказчика
{{ person\_ipp }}	Поле «в лице» для нашей организации для перевозчика
{{ based\_ipz }}	Поле «на основании» для нашей организации для заказчика
{{ based\_ipp }}	Поле «на основании» для нашей организации для перевозчика
{{ initials\_ipz }}	Фамилия и инициалы подписанта для нашей организации для заказчика
{{ initials\_ipp }}	Фамилия и инициалы подписанта для нашей организации для перевозчика
{{ bank\_name\_ipz }}	Наименование отделения банка для нашей организации для заказчика
{{ bank\_name\_ipp }}	Наименование отделения банка для нашей организации для перевозчика
{{ bank\_bik\_ipz }}	БИК банка для нашей организации для заказчика
{{ bank\_bik\_ipp }}	БИК банка для нашей организации для перевозчика
{{ bank\_account\_ipz }}	Номер счёта для нашей организации для заказчика
{{ bank\_account\_ipp }}	Номер счёта для нашей организации для перевозчика
{{ bank\_corr\_account\_ipz }}	Кор. счёт для нашей организации для заказчика
{{ bank\_corr\_account\_ipp }}	Кор. счёт для нашей организации для превозчика
{{ sotrudnik\_name }}	Имя сотрудника, курирующего заявку
{{ sotrudnik\_email }}	Эл. почта сотрудника, курирующего заявку
{{ sotrudnik\_phone }}	Номер телефона сотрудника, курирующего заявку
{{ offer\_ipz }}	Ссылка на сайт / публичную оферту для заказчика
{{ offer\_ipp }}	Ссылка на сайт / публичную оферту для перевозчика
{{ address\_p\_ipp }}	Почтовый адрес для нашей организации для перевозчика
{{ address\_p\_ipz }}	Почтовый адрес для нашей организации для заказчика
{{ address\_u\_ipp }}	Юр. адрес для нашей организации для перевозчика
{{ address\_u\_ipz }}	Юр. адрес для нашей организации для заказчика

##### Данные заказчика

Имя переменной	Значение
{{ namezakazchik }}	Наименование заказчика
{{ inn\_z }}	ИНН
{{ kpp\_z }}	КПП
{{ ogrn\_z }}	ОГРН
{{ phone }}	Номер телефона
{{ email\_z }}	Email
{{ vlice }}	В лице
{{ based\_z }}	Действующий на основании
{{ person\_z }}	Фамилия И.О. (для подписи)
{{ address\_u\_z }}	Юридический адрес
{{ address\_p\_z }}	Почтовый адрес
{{ bank\_account\_z }}	Номер счёта
{{ bank\_corr\_account\_z }}	Кор. счёт
{{ bank\_name\_z }}	Наименование банка
{{ bank\_bik\_z }}	БИК
{{ comment\_z }}	Комментарий
{{ rekvizitzakazchik }}	Реквизиты заказчика
{{ dopzakazchik }}	Дополнительное поле заказчика

Данные перевозчика

Имя переменной	Значение
{{ nameperevozchik }}	Наименование перевозчика
{{ rekvizitperevozchik }}	Реквизиты перевозчика
{{ dopperevozchik }}	Дополнительное поле перевозчика
{{ person\_p }}	Инициалы для подписи перевозчика (Фамилия И.О.)
{{ vlice\_p }}	В лице
{{ carrier.based\_on }}	На основании
{{ carrier.inn }}	ИНН
{{ carrier.kpp }}	КПП
{{ carrier.ogrn }}	ОГРН
{{ carrier.address\_u }}	Юридический адрес
{{ carrier.bank\_account }}	Номер счёта
{{ carrier.bank\_corr\_account }}	Номер кор. счёта
{{ carrier.bank\_name }}	Наименование банка
{{ carrier.bank\_bik }}	БИК банка
{{ carrier.address\_p }}	Почтовый адрес перевозчика
{{ carrier.email }}	email перевозчика
{{ carrier.ati\_code }}	Код в АТИ перевозчика
{{ carrier.phone }}	Номер телефона перевозчика

##### Данные автомобиля

Имя переменной	Значение
{{ truck\_load }}	Грузоподъёмность
{{ truck\_dimensions }}	Габариты
{{ truck\_body }}	Тип кузова
{{ markaavto }}	Марка, модель автомобиля/прицепа
{{ truck\_plate }}	Гос. номер тягача
{{ truck\_model }}	Модель тягача
{{ truck\_sts }}	СТС тягача
{{ trailer\_plate }}	Гос. номер прицепа
{{ trailer\_model }}	Модель прицепа
{{ trailer\_sts }}	СТС прицепа
{{ truck.owner\_name }}	Наименование собственника авто

##### Погрузки/разгрузки (когда их несколько в заказе)

Имя переменной	Значение
{{ loadings }}	Массив погрузок/разгрузок.
{{ loading.type }}	Тип действия: "Погрузка" или "Разгрузка"
{{ loading.cargo }}	Наименование груза
{{ loading.name }}	Наименование отправителя/получателя
{{ loading.address }}	Адрес погрузки/разгрузки
{{ loading.contact }}	Контактные данные
{{ loading.addition }}	Дополнительная информация
{{ loading.datetime }}	Дата и время погрузки

##### Позиции счёта (акта, УПД)

Имя переменной	Значение
{{ invoice\_number }}	Номер счёта из 1С либо номер заявки
{{ act\_number }}	Номер акта (УПД) из 1С либо номер заявки
{{ sf\_number }}	Номер счёта-фактуры из 1С либо номер заявки
{{ items }}	Массив (список) позиций
{{ item.pos }}	Порядковый номер позиции
{{ item.name }}	Наименование позиции
{{ item.price }}	Цена (включая НДС, если он есть)
{{ item.price\_without\_nds }}	Цена (без НДС)
{{ item.units }}	Единицы измерения
{{ item.qty }}	Количество
{{ item.nds }}	Величина НДС (%)
{{ item.nds\_sum }}	Сумма НДС по данной позиции (учитывая количество)
{{ item.sum }}	Сумма по данной позиции с налогом (цена \* кол-во)
{{ item.sum\_without\_nds }}	Сумма по данной позиции без налога (цена без НДС \* кол-во)
{{ items\_count }}	Кол-во позиций
{{ items\_total }}	Общая сумма всех позиций, включая НДС
{{ items\_total\_nds }}	Общая сумма НДС по всем позициям
{{ items\_total\_without\_nds }}	Общая сумма всех позиций без НДС
{{ items\_nds\_present }}	Строка «Без налога (НДС)» или «В том числе НДС:» (для счёта)
{{ items\_total\_str }}	Общая сумма прописью
{{ order\_id }}	ID номер, номер по порядку

##### Редактирование позиции счета и акта [![image.png](https://help.bulldok.ru/uploads/images/gallery/2025-07/scaled-1680-/Yyaimage.png)](https://help.bulldok.ru/uploads/images/gallery/2025-07/Yyaimage.png) [![image.png](https://help.bulldok.ru/uploads/images/gallery/2025-07/scaled-1680-/aBqimage.png)](https://help.bulldok.ru/uploads/images/gallery/2025-07/aBqimage.png) В данном поле указываете тот образец который вам требуется, переменные для этого поля берем исключительно указанные ниже под ним. Нажав на них 1 раз, они копируются в буфер обмена. \_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_ Не для всех! Для некоторых решений, если требуется добавить в новый шаблон, то используем следующий вид переменных: Пример добавления списка позиций в шаблон:

№	Товар (Услуга)	Кол-во	Ед.	Цена	Сумма
{%tr for i in items %}
{{ i.pos }}	{{ i.name }}	{{ i.qty }}	{{ i.units }}	{{ i.price }}	{{ i.sum }}
{%tr endfor %}

Если к первой позиции в счете необходимо добавить (к примеру дату погрузки, номер автомобиля и прицепа а также ФИО водителя) Указываем в строке:

{{ i.name }}{% if i.pos==1 %}; {{ datepogruzki }}; {{ markaavto }}; {{ driver\_name }}{% endif %}

\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_\_ #### Добавление подписи, печати и логотипа Добавление изображений реализовано так: · в шаблон добавляются пустые изображения; · настраивается требуемый размер и положение изображений, делаются привязки; · задаётся «замещающий текст», чтобы система «знала», на что их подменять. Для минимизации искажений необходимо соблюдать соотношение сторон – изображения должны быть квадратными. Замещающий текст задаётся в зависимости от того, что нужно добавить в шаблон. Это может быть печать, подпись или логотип организации, взаимодействующей с заказчиком или с перевозчиком.

Замещающий текст	Подмена
stamp\_z.png	Печать организации, взаимодействующей с заказчиком
sign\_z.png	Подпись организации, взаимодействующей с заказчиком
logo\_z.png	Логотип филиала организации, взаимодействующей с заказчиком
stamp\_p.png	Печать организации, взаимодействующей с перевозчиком
sign\_p.png	Подпись организации, взаимодействующей с перевозчиком
logo\_p.png	Логотип филиала организации, взаимодействующей с перевозчиком

[![image.png](https://help.bulldok.ru/uploads/images/gallery/2024-05/scaled-1680-/Blzimage.png)](https://help.bulldok.ru/uploads/images/gallery/2024-05/Blzimage.png) [![image.png](https://help.bulldok.ru/uploads/images/gallery/2024-05/scaled-1680-/UuYimage.png)](https://help.bulldok.ru/uploads/images/gallery/2024-05/UuYimage.png) [![image.png](https://help.bulldok.ru/uploads/images/gallery/2024-05/scaled-1680-/NbUimage.png)](https://help.bulldok.ru/uploads/images/gallery/2024-05/NbUimage.png) Остались вопросы, ждем вас тут: [![подвалсж.jpg](https://help.bulldok.ru/uploads/images/gallery/2024-01/scaled-1680-/WDkpodvalsz.jpg)](https://help.bulldok.ru/uploads/images/gallery/2024-01/WDkpodvalsz.jpg)