Dokumentation, Syntax & API-Referenz

Vollständiger Leitfaden für Word-Vorlagensyntax (.docx), REST API-Dokumentenerstellung und CRM-Integrationen (Bitrix24, amoCRM, Make, n8n).

Regeln für Microsoft Word (.docx) Vorlagen

Strukturieren von Variablen, Bedingungen, dynamischen Tabellen und Bildern

1

Text- und numerische Variablen

Umschließen Sie Variablennamen mit doppelten geschweiften Klammern {{feldname}}'.

Im Word-Dokument
Договор № {{contract_num}}
Клиент: {{client_name}}
Сумма: {{total_price}} руб.
JSON-Nutzdaten
{
  "contract_num": "458/26",
  "client_name": "ООО Вектор",
  "total_price": 150000
}
Generiertes Ergebnis
Договор № 458/26
Клиент: ООО Вектор
Сумма: 150000 руб.
2

Bedingungsblöcke (If / Else)

Ein- oder Ausblenden von Abschnitten dynamisch basierend auf true/false-Flags.

Im Word-Dokument
{{#if has_discount}}
Скидка: {{discount}}%
{{/if}}
{{^has_discount}}
Без скидки
{{/has_discount}}
JSON-Nutzdaten
{
  "has_discount": true,
  "discount": 10
}
Generiertes Ergebnis
Скидка: 10%

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

3

Tabellen, Listen und Schleifen

Automatisches Duplizieren von Zeilen in einer Word-Tabelle für jedes Array-Element.

In der Word-Tabelle
УслугаЦена
{{#items}}{{title}}{{price}}{{/items}}

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

JSON-Nutzdaten
{
  "items": [
    { "title": "Дизайн", "price": 40000 },
    { "title": "Разработка", "price": 110000 }
  ]
}
Generiertes Ergebnis
УслугаЦена
Дизайн40000
Разработка110000
4

Bilder, Logos, Unterschriften und Stempel

Fügen Sie Platzhalterbilder in Word ein und verknüpfen Sie sie über den Alternativtext (Alt Text).

Schritt-für-Schritt-Anleitung:

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

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

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

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

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

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