Documentation, Syntaxe et API

Guide complet pour la syntaxe des modèles Word (.docx), la génération via REST API et les intégrations CRM (Bitrix24, amoCRM, Make, n8n).

Règles pour les modèles Microsoft Word (.docx)

Comment structurer les variables, les conditions, les tableaux et les images

Entourez les noms de variables de doubles accolades {{nom_du_champ}}'.

Dans le document Word

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

Données JSON

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

Résultat généré

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

Affichez ou masquez des sections ou paragraphes en fonction de booléens true/false.

Dans le document Word

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

Données JSON

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

Résultat généré

Скидка: 10%

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

Dupliquez automatiquement les lignes d'un tableau Word pour chaque élément d'un tableau JSON.

Dans le tableau Word

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

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

Données JSON

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

Résultat généré

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

Insérez des images d'espace réservé dans Word et liez-les via le texte de remplacement (Alt Text).

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

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

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

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

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

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