Pomoc, Składnia i Dokumentacja API

Kompletny przewodnik po formatowaniu szablonów Word (.docx), generowaniu dokumentów przez REST API i integracji z CRM (Bitrix24, amoCRM, Make, n8n).

Zasady formatowania szablonów Microsoft Word (.docx)

Jak prawidłowo tworzyć zmienne, warunki logiczne, tabele i obrazy

Umieszczaj nazwy zmiennych w podwójnych nawiasach klamrowych {{nazwa_pola}}'.

W dokumencie Word

Договор № {{contract_num}}
Клиент: {{client_name}}
Сумма: {{total_price}} руб.

Dane JSON

{
  "contract_num": "458/26",
  "client_name": "ООО Вектор",
  "total_price": 150000
}

Wynik końcowy

Договор № 458/26
Клиент: ООО Вектор
Сумма: 150000 руб.

Wyświetlaj lub ukrywaj sekcje, klauzule i akapity dynamicznie na podstawie flag true/false.

W dokumencie Word

{{#if has_discount}}
Скидка: {{discount}}%
{{/if}}
{{^has_discount}}
Без скидки
{{/has_discount}}

Dane JSON

{
  "has_discount": true,
  "discount": 10
}

Wynik końcowy

Скидка: 10%

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

Automatyczne powielanie wierszy w tabeli Word dla każdego elementu w tablicy.

W tabeli Word

Услуга	Цена
{{#items}}{{title}}	{{price}}{{/items}}

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

Dane JSON

{
  "items": [
    { "title": "Дизайн", "price": 40000 },
    { "title": "Разработка", "price": 110000 }
  ]
}

Wynik końcowy

Услуга	Цена
Дизайн	40000
Разработка	110000

Wstawiaj obrazy zastępcze w programie Word i łącz je za pomocą tekstu alternatywnego (Alt Text).

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

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

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

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

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

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