РИД Вектор Документация Оферта Войти

Шаблоны договоров

Шаблон — это ваш обычный документ Word, в котором переменные части заменены плейсхолдерами. Система подставляет данные и отдаёт готовый файл.

Загрузка

Тип шаблонаФорматы
Договор.docx, .xlsx, .xlsm
Отчёт.docx

Максимальный размер — 20 МБ. Формат .dotx не поддерживается: сохраните шаблон Word как обычный .docx.

Переменная

Договор № {{contract_no}} от {{contract_date}}
Территория: {{territory}}
Вознаграждение: {{licensor_share}}%

Если переменной нет в данных, плейсхолдер заменяется пустой строкой — документ не ломается, просто в этом месте ничего не будет. Список значений (например, несколько авторов) печатается через запятую.

Поддерживается обращение к полю: {{w.muz_name}}, {{works.0.artist}}.

Цикл

Повторяет фрагмент по каждому элементу списка:

{{FOR:w IN works}}
{{w.index}}. {{w.muz_name}} — {{w.artist}}, {{w.year_relize}}
{{ENDFOR:works}}

Внутри цикла доступны счётчики {{w.index}}, {{w.loop_index}} и {{w.no}} — все начинаются с единицы. Открывающий и закрывающий маркеры должны занимать абзац целиком. Если список пуст, весь блок удаляется.

Циклы в таблицах. Если строка таблицы начинается с {{FOR:…}} и заканчивается {{ENDFOR:…}}, размножается сама строка — так делается таблица произведений.

Условие

{{IF:has_M}}
Лицензиар передаёт права на музыкальное произведение…
{{ENDIF:has_M}}

Если условие ложно, удаляются и маркеры, и весь текст между ними. Условия можно вкладывать друг в друга. Маркер должен занимать абзац целиком.

Арифметика

Для сквозной нумерации, когда на каждый объект приходится несколько пунктов договора:

{{w.index*3-2}}   → 1, 4, 7
{{w.index*3-1}}   → 2, 5, 8
{{w.index*3}}     → 3, 6, 9

Доступны +, -, * и их комбинации. Работает только с числовыми переменными.

Изображения

{{cover_image}}          обложка, размер по умолчанию 53 × 53 мм
{{cover_image_30x30}}    обложка 30 × 30 мм
{{cover_image_2_60x40}}  обложка второго объекта, 60 × 40 мм

Размер задаётся в миллиметрах. Внутри цикла достаточно написать {{cover_image_30x30}} — номер объекта подставится автоматически по номеру итерации. Так же ведут себя {{file_hash}}, {{format}}, {{duration}} и {{size}}.

Какие переменные доступны

Договор

contract_no · contract_date · territory · license_term · license_start · license_end · licensor_share · exclusive_methods · nonexclusive_methods · objekt

Флаги вида объекта — для условий

has_M · has_I · has_F · has_O · has_Foto · has_Art, а также block_MIFO, block_MIO, block_MFO, block_MO и остальные комбинации.

Список произведений — works

Поля элемента: no, index, muz_name, name_albom, year_relize, artist, author_text, author_muz, phonogram, picture_own, license_term, territory, exclusive_methods, nonexclusive_methods, licensor_share, object_type, object_name, rights_scope, description, right_holder.

Правообладатели — licensors_all

Поля: name, short (краткая форма для подписной строки), share_percent, email.

Подписанты

Коллекции signers_fiz, signers_org, signers и готовые текстовые блоки — подробно в разделе Подписанты.

Файлы

file_hash (SHA-256), duration (в формате 3:45), format, size, storage_link, cover_image.

Расходы

expenses (список для цикла), expenses_total, recoupment_carry, licensor_due_after_expenses, готовый блок expenses_block и флаг has_expenses для условия. См. Расходы и возмещение.

Ваши реквизиты

org_full_name · org_short_name · org_inn · org_ogrn · org_address · org_bank_details · org_email · org_phone · org_signer_name · org_signer_position · org_signer_doc. Заполняются в «Настройки» → «Организация».

Проверка шаблона при загрузке

Каждый загруженный DOCX-шаблон автоматически проверяется, и вы сразу видите список замечаний:

ЗамечаниеЧто означает
Цикл без закрытия{{FOR:…}} есть, парного {{ENDFOR:…}} нет
Закрытие без циклаОбратная ситуация
Переменная файла вне циклаfile_hash, duration, format или size стоят вне {{FOR:…}} и всегда покажут значение первого файла
Неизвестная переменнаяИмя не совпало ни с одной известной — обычно опечатка
Арифметика на нечисловой переменнойВыражение может не сработать

Замечания не блокируют загрузку. Шаблон сохранится даже с незакрытым циклом — список замечаний носит рекомендательный характер. Прочитайте его перед первой генерацией, иначе ошибку вы увидите уже в готовом документе. Исключение — Excel-шаблоны: у них проверка строгая, файл с ошибкой не примут.

Совместимость со старым синтаксисом

Шаблоны, написанные в синтаксисе {% for %} и {% if %}, продолжают работать — они преобразуются автоматически. Новые шаблоны пишите в форме {{FOR:…}} и {{IF:…}}.