Шаблоны документов
Общие правила
Для формирования необходимых документов «Бульдок» требует подготовить и загрузить специальные шаблоны, на основании которых будет формироваться тот или иной документ. Шаблон представляет из себя файл в формате «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 }} |
Дата договора (заказчика) |
Оплаты |
|
{{ stavkazakazchika }} |
Ставка заказчика |
{{ foramoplatyzakazchik }} |
Форма оплаты заказчика |
{{ stavkaperevozchika }} |
Ставка перевозчика |
{{ foramoplatyperevozchik }} |
Форма оплаты перевозчика |
{{ uderzaniyeperevozchik }} |
Удержание перевозчика |
Данные перевозки |
|
{{ marshrut }} |
Маршрут перевозки |
{{ namegruz }} |
Наименование груза |
{{ ves }} |
Вес, объём груза |
{{ sposob }} |
Способ погрузки |
{{ trebovaniyaavto }} |
Требования к автомобилю перевозчика |
|
|
{{ datepogruzki }} |
Дата погрузки |
{{ adrespogruzki }} |
Адрес погрузки |
{{ nameotpravitel }} |
Наименование отправителя |
{{ kontakt1 }} |
Контактные данные отправителя |
|
|
{{ daterazgruzki }} |
Дата разгрузки |
{{ adresvigruzki }} |
Адрес разгрузки |
{{ namepoluchatel }} |
Наименование получателя |
{{ kontakt2 }} |
Контактные данные получателя |
|
|
{{ markaavto }} |
Марка, модель автомобиля/прицепа |
{{ truck_plate }} |
Гос. номер тягача |
{{ truck_model }} |
Модель тягача |
{{ trailer_plate }} |
Гос. номер прицепа |
{{ trailer_model }} |
Модель прицепа |
{{ driver_name }} |
ФИО водителя |
{{ fiovoditela }} |
ФИО водителя и паспортные данные |
{{ telvoditela }} |
Телефон водителя |
{{ dopzakazchik }} |
Дополнительное поле заказчика |
{{ dopperevozchik }} |
Дополнительное поле перевозчика |
Данные нашей компании |
|
{{ 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_bik_ipz }} |
БИК банка для нашей организации для заказчика |
{{ bank_account_ipz }} |
Номер счёта для нашей организации для заказчика |
{{ bank_corr_account_ipz }} |
Кор. счёт для нашей организации для заказчика |
{{ address_u_ipz }} |
Юр. адрес для нашей организации для заказчика |
{{ sotrudnik_name }} |
Имя сотрудника, курирующего заявку |
{{ sotrudnik_email }} |
Эл. почта сотрудника, курирующего заявку |
{{ sotrudnik_phone }} |
Номер телефона сотрудника, курирующего заявку |
{{ offer_ipz }} |
Ссылка на сайт / публичную оферту для заказчика |
{{ offer_ipp }} |
Ссылка на сайт / публичную оферту для перевозчика |
Данные заказчика
Имя переменной |
Значение |
{{ namezakazchik }} |
Наименование заказчика |
{{ inn_z }} |
ИНН |
{{ kpp_z }} |
КПП |
{{ ogrn_z }} |
ОГРН |
{{ phone }} |
Номер телефона |
{{ email_z }} |
|
{{ vlice }} |
В лице |
{{ 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 }} |
Дополнительное поле перевозчика |
Позиции счёта (акта, УПД)
Имя переменной |
Значение |
{{ invoice_number }} |
Номер счёта |
{{ act_number }} |
Номер акта (УПД) |
{{ 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 номер, номер по порядку |
Пример добавления списка позиций в шаблон:
№ |
Товар (Услуга) |
Кол-во |
Ед. |
Цена |
Сумма |
{%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 |
Логотип филиала организации, взаимодействующей с перевозчиком |
Остались вопросы, ждем вас тут: support@bulldok.ru