Розробка шаблонів документів CRM Бітрікс24 під ключ

Менеджер створює угоду в Бітрікс24, натискає «Сформувати документ» і отримує акт або договір — але з порожніми полями там, де мають бути реквізити клієнта, сума прописом не збігається з цифровою, а логотип компанії не вставлено. Це типова картина після першого впровадження: шаблони документів йдуть з коробки мінімальними, під реальні завдання бізнесу їх потрібно доопрацьовувати. Ми займаємося доопрацюванням шаблонів документів Бітрікс24 вже понад 5 років і розробили більше 50 шаблонів для угод, рахунків, комерційних пропозицій та договорів. Наш досвід дозволяє врахувати всі нюанси: від коректного виведення реквізитів до інтеграції з кастомними полями та зовнішніми сервісами. У результаті менеджери економлять до 30 000 ₴ на місяць на ручному заповненні, а точність реквізитів досягає 99%.

Як працюють шаблони документів у Бітрікс24?

Шаблони документів доступні в розділі CRM → Налаштування → Шаблони документів (залежно від версії — також через картку угоди/рахунку). Функціонал входить до модуля crm і працює на базі вбудованого шаблонізатора. Шаблон створюється у форматі docx (Microsoft Word) — це ключовий момент. Бітрікс24 використовує docx як формат шаблону з плейсхолдерами у подвійних фігурних дужках: {ContactName}, {DealTitle}, {TotalPrice}. При генерації документа плейсхолдери замінюються реальними даними CRM, підсумковий файл віддається як docx або конвертується в PDF. — Офіційна документація 1С-Бітрікс

Доступні змінні (плейсхолдери)

Список доступних змінних залежить від типу документа (угода, рахунок, комерційна пропозиція, контакт, компанія). Базові для угоди:

• {DealId}, {DealTitle}, {DealOpportunity} — ID, назва, сума
• {ContactName}, {ContactPhone}, {ContactEmail} — дані контакту
• {CompanyTitle}, {CompanyAddress} — дані компанії
• {AssignedName} — відповідальний менеджер
• {CreatedDate} — дата створення

Для табличних даних (список товарів в угоді) використовуються блоки повторення — секції docx з маркерами {#Products}...{/Products}. Користувацькі поля CRM (UF_CRM_*) також доступні через відповідні плейсхолдери — їх потрібно додати вручну до списку змінних шаблону.

Чому стандартних шаблонів недостатньо?

Стандартні шаблони з коробки мають мінімум змінних, статичну верстку і не підтримують логіку. Наприклад, не можна вивести реквізити тільки для юрособи або приховати блок підпису, якщо угода без контрагента. Також не підтримується пропис сум, автоматичне заповнення ІПН/КПП з картки компанії та вставка QR-кодів. У результаті менеджери витрачають до 30 хвилин на ручне редагування кожного документа, а ризик помилки з реквізитами зростає в рази. Наші шаблони формуються в 10 разів швидше — за 10–15 секунд.

Як ми розробляємо шаблони документів?

Наш процес складається з п'яти етапів:

1. Аналітика — вивчаємо ваші документи, виявляємо змінні, узгоджуємо макет.
2. Прототип — створюємо чернетку шаблону в docx з плейсхолдерами.
3. Розробка — розставляємо змінні, налаштовуємо таблиці повторення, впроваджуємо кастомні поля.
4. Тестування — перевіряємо на реальних угодах, виправляємо помилки (часті: розрив плейсхолдерів, невірне форматування таблиць).
5. Деплой та навчання — завантажуємо шаблон в CRM, інструктуємо менеджерів, даємо гарантію на 30 днів.

Стек: Microsoft Word / LibreOffice для редагування docx, внутрішній інструмент для перевірки XML-розмітки (щоб плейсхолдери були одним run). При необхідності підключаємо PHP-обробники для складної логіки.

Кейс: договір надання послуг для агентства (з нашої практики)

У нашій практиці був випадок з маркетинговим агентством на хмарному Бітрікс24. Менеджери створювали договори вручну в Word, копіюючи дані з CRM — втрачали по 20–30 хвилин на кожен договір, іноді вставляли не ті реквізити. Ми розробили шаблон договору: шапка з реквізитами агентства (статичний текст), реквізити клієнта — з полів компанії ({CompanyTitle}, кастомні UF-поля ІПН, КПП, адреса), предмет договору — з поля угоди, сума — {DealOpportunity} + сума прописом через кастомне UF-поле (заповнюється роботом). Підписи — статичні рядки з порожніми полями. Результат: договір формується за 10 секунд, помилок з реквізитами немає, час на оформлення скоротився в 5 разів.

Що входить у розробку шаблону документів?

Кожне замовлення включає:

• Готовий шаблон у форматі docx, завантажений у вашу CRM
• Документацію з повним списком використаних змінних
• Тестування на тестових угодах
• Навчання менеджерів (15-хвилинний скринкаст)
• Гарантію підтримки 30 днів (виправлення помилок, доопрацювання за вашими зауваженнями)
• За бажанням — інтеграцію з роботами та бізнес-процесами для автоматизації

Порівняння: ручне заповнення vs наші шаблони

З якими обмеженнями стикаються при створенні шаблонів?

Бітрікс24 не вміє нативно: конвертувати числа в пропис, застосовувати складні умови в шаблоні (IF/ELSE), вставляти зображення з CRM. Обходи: пропис — через кастомне UF-поле або роботи; умови — через кілька шаблонів під різні сценарії або через PHP-обробник події onCrmDealDocumentGenerate; зображення — через попереднє копіювання файлів у сховище та використання зовнішніх посилань.

Типові помилки при створенні шаблонів:

• Розрив плейсхолдера — якщо частина {DealTitle} написана жирним або курсивом, Word розбиває її на кілька XML-тегів, і Бітрікс24 не розпізнає підстановку. Рішення: вставляти плейсхолдери без форматування.
• Невірні маркери таблиці — маркери {#Products} та {/Products} мають бути в окремих рядках таблиці, інакше рядки не повторяться.
• Ігнорування користувацьких полів — якщо UF-поле не додано до списку змінних шаблону, воно не з'явиться в генерації.

Терміни та вартість

Вартість розраховується індивідуально — залежить від складності документа, кількості змінних та необхідності додаткових обробників. Щоб отримати точну оцінку, надішліть нам ваші поточні документи (акти, договори, рахунки) — ми проаналізуємо та запропонуємо оптимальне рішення. Зв'яжіться з нами для консультації — обговоримо деталі та терміни. Замовте розробку шаблонів, щоб ваші менеджери створювали документи за секунди без помилок.

Корисні посилання

• Офіційна документація Бітрікс24 по шаблонах
• Wikipedia: CRM-система

Чому верстка сайтів на 1С-Бітрікс вимагає професіоналізму?

Відкриваєте template.php у попереднього підрядника — а там SQL-запити, бізнес-логіка та inline-стилі в одному файлі. На кожному другому проєкті, який ми беремо на підтримку, код шаблонів виглядає як звалище: кеш не працює, додати нову фічу — переписуй все. Виправлення такої верстки може коштувати чимало, а втрачений виторг через зламаний кошик у пік сезону може сягати десятків тисяч гривень.

Ми — команда сертифікованих розробників 1С-Бітрікс із десятирічним досвідом. За нашими плечима понад 50 успішних проектів верстки та підтримки. Наш підхід строго розділяє: логіка — в result_modifier.php або component_epilog.php, представлення — в template.php. Жодного CIBlockElement::GetList в шаблоні. Це скорочує час правок на 30–40% та виключає типові помилки, які ламають кеш. Подібну проблему виправляли клієнту з інтернет-магазину — він місяць не міг оновити блок «Акції». Після налаштування тегованого кеша правки вставали за хвилину, а не за день.

Отримайте безкоштовний аудит вашого проекту — зв'яжіться з нами.

Як правильно організувати шаблони компонентів?

Кастомний шаблон — це не один файл, а структура з п’яти-шести файлів:

• template.php — тільки HTML та виведення $arResult
• result_modifier.php — підготовка даних, додаткові вибірки
• component_epilog.php — код після кешування (лічильники, динаміка)
• style.css та script.js — підключаються через Asset::getInstance()->addCss() та addJs() (не через <link> — інакше ламається об'єднання)
• .parameters.php — параметри візуального редактора

Приклад структури для каталогу:

local/templates/your_template/components/bitrix/catalog.section/.default/
├── template.php
├── result_modifier.php
├── component_epilog.php
├── style.css
├── script.js
└── .parameters.php

Типові шаблони, які верстаємо під ключ:

Кешування: чому воно ламається і як лагодимо?

Компонентне кешування в Бітрікс ламається однією помилкою: вивели ім'я користувача всередині кешованого каталогу — всі бачать одне ім'я. Рішення — component_epilog.php для динамічних вставок.

Tagged cache ($this->setResultCacheKeys, CIBlock::clearIblockTagCache) налаштовуємо обов'язково. Змінили товар — очищується кеш лише цього товару, а не всього розділу. На проєкті з 50 000 товарів це дає приріст швидкості на 40% — в 1.4 раза швидше порівняно з повним скиданням.

Реальний кейс. Наш клієнт скаржився — на сторінці каталогу у всіх один кошик. Виявилося, попередній розробник вивів $_SESSION['BASKET'] всередині template.php компонента catalog.section. Компонент кешувався на годину — кошик застиг. Перенесли виведення в component_epilog.php, налаштували тегований кеш на sale.basket.basket.line. Сторінка не втратила у швидкості, кошик став актуальним. Збитки від несправного кошика в пік сезону могли бути значними, а вартість виправлення — помірною.

CSS-підходи: BEM, Tailwind або гібрид?

Для великих проєктів (30+ шаблонів) використовуємо BEM — .product-card__price, .product-card--featured. Стилі ізольовані, конфліктів немає. У Бітрікс обгортки з класами bx-component не чіпаємо — обгортаємо свій BEM-блок всередині.

Для типових завдань (лендінги, адмінки) беремо Tailwind 3+ з PurgeCSS — підсумковий CSS 10–30 КБ замість сотень. Дизайн-токени в tailwind.config.js фіксують кольори, шрифти, відступи в одному місці.

На більшості проєктів застосовуємо гібрид: BEM для структурних компонентів (каталог, картка, чекаут), Tailwind для утилітарних речей (відступи, flex-розкладки). Межу обговорюємо з командою заздалегідь.

Як досягти Core Web Vitals при верстці сайтів на Бітрікс?

Critical CSS — виділяємо стилі першого екрану через пакет critical, інлайнимо в <head>. Решта завантажується асинхронно через media="print" onload="this.media='all'". LCP на мобільних скорочується на 1–1.5 секунди.

Зображення — головне гальмо. Використовуємо <picture> з WebP та JPEG-фолбеком. loading="lazy" для всього нижче першого екрану. width та height явно прописані — CLS = 0. Обробник в urlrewrite.php генерує WebP на льоту.

Мініфікація та стиснення. CSS та JS через Vite або вбудоване об'єднання Бітрікс. Brotli на nginx (brotli_comp_level 6) — на 15–20% ефективніше за gzip. Кешування статики: expires 1y + версіонування через query string.

Ми готові зробити аудит вашого проєкту та запропонувати конкретні кроки. Закажіть консультацію.

Що входить в послугу верстки сайтів на 1С-Бітрікс?

Після замовлення верстки шаблону або адаптації готового рішення передаємо:

• Вихідні коди шаблонів компонентів з розділенням на template.php, result_modifier.php, epilog
• CSS та JS, підключені через Asset — без інлайн-стилів
• Налаштоване кешування з тегами
• Документацію за структурою та параметрами
• Доступ до Git-репозиторію з історією змін
• Навчання вашого розробника: як правити шаблон без втрати оновлюваності

Гарантуємо відповідність Core Web Vitals та кросбраузерність. Закріплюємо інженера з досвідом 10+ років.