Templa Logo

Довідка, Синтаксис та API Документація

Повний посібник із розмітки Word-шаблонів (.docx), генерації документів через REST API та інтеграції з CRM (Bitrix24, amoCRM, Make, n8n).

Правила розмітки шаблонів Microsoft Word (.docx)

Як правильно створювати змінні, розгалуження, цикли та зображення в документі

1

Текстові та числові змінні

Огортайте назви змінних у подвійні фігурні дужки {{ім’я_поля}}.

У документі Word
Договор № {{contract_num}}
Клиент: {{client_name}}
Сумма: {{total_price}} руб.
JSON-дані для підстановки
{
  "contract_num": "458/26",
  "client_name": "ООО Вектор",
  "total_price": 150000
}
Результат у готовому файлі
Договор № 458/26
Клиент: ООО Вектор
Сумма: 150000 руб.
2

Умовні блоки (If / Else)

Відображайте або приховуйте фрагменти тексту, пункти та параграфи залежно від прапорців true/false.

У документі Word
{{#if has_discount}}
Скидка: {{discount}}%
{{/if}}
{{^has_discount}}
Без скидки
{{/has_discount}}
JSON-дані для підстановки
{
  "has_discount": true,
  "discount": 10
}
Результат у готовому файлі
Скидка: 10%

(Блок без скидки скрывается полностью)

3

Таблиці, списки та цикли

Автоматичне дублювання рядків таблиці Word для кожного елемента масиву даних.

У таблиці Word
УслугаЦена
{{#items}}{{title}}{{price}}{{/items}}

Word автоматически создаст новую строку на каждый элемент массива!

JSON-дані для підстановки
{
  "items": [
    { "title": "Дизайн", "price": 40000 },
    { "title": "Разработка", "price": 110000 }
  ]
}
Результат у готовому файлі
УслугаЦена
Дизайн40000
Разработка110000
4

Зображення, логотипи, підписи та печатки

Вставляйте зображення у Word і керуйте ними через заміщувальний текст (Alt Text).

Як вставити зображення по кроках:

Шаг 1: Вставка в Word

Вставьте любую картинку-заглушку в документ и настройте ее размер (ширину и высоту).

Шаг 2: Alt-Text (Замещающий текст)

Нажмите правой кнопкой по картинке ➔ «Формат рисунка» ➔ «Замещающий текст» (Alt Text) и укажите название переменной: {{logo}}.

Шаг 3: Передача данных

В API передайте Base64-строку data:image/png;base64,... или прямой HTTP-URL картинки.