Переменные для документов
Общие правила
Для формирования необходимых документов «Бульдок» требует подготовить и загрузить специальные шаблоны, на основании которых будет формироваться тот или иной документ. Шаблон представляет из себя файл в формате «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 }} |
Дата договора |
|
отдельные поля (нужно включать доп.поля в настройках ) |
{{ numzz }} |
номер заявки заказчика; |
{{ datezz }} |
дата заявки заказчика; |
{{ numdp }} |
номер договора перевозчика. |
{{ datedp }} |
дата договора перевозчика. |
Оплаты |
|
{{ stavkazakazchika }} |
Ставка заказчика |
{{ foramoplatyzakazchik }} |
Форма оплаты заказчика |
{{ stavkaperevozchika }} |
Ставка перевозчика |
{{ foramoplatyperevozchik }} |
Форма оплаты перевозчика |
{{ uderzaniyeperevozchik }} |
Удержание перевозчика |
{{ fo2_p }} |
условие оплаты перевозчику. |
Данные перевозки |
|
{{ 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 }} |
Телефон водителя |
{{ driver_passport_number }} |
Паспортные данные серия номер |
{{ driver_passport_issued }} |
кем выдан и дата выдачи |
{{ dopzakazchik }} |
Дополнительное поле заказчика |
{{ dopperevozchik }} |
Дополнительное поле перевозчика |
{{ driver_snils }} |
СНИЛС |
{{ driver_license }} |
Водительское удостоверение |
Данные нашей компании |
|
{{ 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 }} |
Кор. счёт для нашей организации для заказчика |
{{ 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 }} |
|
{{ 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 перевозчика |
Данные автомобиля
Имя переменной |
Значение |
{{ truck_load }} |
Грузоподъёмность |
{{ truck_dimensions }} |
Габариты |
{{ truck_body }} |
Тип кузова |
{{ markaavto }} |
Марка, модель автомобиля/прицепа |
{{ truck_plate }} |
Гос. номер тягача |
{{ truck_model }} |
Модель тягача |
{{ trailer_plate }} |
Гос. номер прицепа |
{{ trailer_model }} |
Модель прицепа |
Погрузки/разгрузки (когда их несколько в заказе)
Имя переменной | Значение |
{{ 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 номер, номер по порядку |
Пример добавления списка позиций в шаблон:
№ |
Товар (Услуга) |
Кол-во |
Ед. |
Цена |
Сумма |
{%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