Кастомні Vue.js інтерфейси для смарт-процесів Бітрікс24

Стандартна картка смарт-процесу в Бітрікс24 — це копія CRM-форми. Вона не підтримує динамічні кроки, залежні поля та візуальний прогрес. Коли бізнес потребує багатокрокового погодження з розгалуженням або кастомною валідацією, стандартний інтерфейс не справляється. Vue.js вирішує ці завдання: ми створюємо placement-додатки, які повністю замінюють форму динамічного процесу. За роки роботи ми розробили понад 50 інтерфейсів для Бітрікс24 — від простих однокрокових форм до складних CRM-надбудов з інтеграцією 1С, ЮKassa та СДЭК. Кожен проект починається з аудиту бізнес-процесу і закінчується передачею документації та навчанням адміністраторів. У середньому розробка займає від 4 до 20 робочих днів, а економія часу на погодженнях сягає 40%. Наша команда має 6 років досвіду в інтеграції Бітрікс24 та реалізувала понад 80 проектів для українських компаній. Наприклад, впровадження кастомного інтерфейсу для погодження договорів дозволило одному з клієнтів економити 120 000 грн на місяць. У цій статті розберемо, як ми проєктуємо багатокрокові інтерфейси для смарт-процесів: від отримання стадій до запуску бізнес-процесів, і чому кастомний UI на Vue.js знижує витрати на доопрацювання у 2-3 рази.

Проблеми, які вирішуємо

• Нестандартна послідовність кроків. У стандартному інтерфейсі стадії йдуть лінійно. Для складних сценаріїв (заявка на відпустку з розгалуженням, погодження договору з кількома підписантами) потрібен динамічний покроковий UI.
• Складна логіка полів. Залежні списки, умовне відображення, валідація на стороні клієнта — все це виходить за рамки налаштувань UF-полів.
• Візуальний контроль. Замовники хочуть бачити статус етапів, хто погодив, які документи прикріплені. Стандартний інтерфейс цього не дає.

Як працює інтеграція Vue з Бітрікс24?

Vue — ідеальний вибір для placement-додатків Бітрікс24. Легкий фреймворк, швидка реактивність, можливість використовувати компоненти з екосистеми. На відміну від React, Vue простіше вбудовується в iframe і не вимагає складного налаштування збірки. Компонентна архітектура дозволяє перевикористовувати кроки форми, а Pinia — централізовано керувати станом.

Типовий кейс — форма погодження з кількома кроками, де кожен крок відповідає стадії смарт-процесу:

<!-- SmartProcessWizard.vue -->
<template>
  <div class="wizard">
    <StepIndicator :steps="steps" :current="currentStep" />

    <Transition name="slide" mode="out-in">
      <component
        :is="currentStepComponent"
        :key="currentStep"
        :item="store.item"
        @next="handleNext"
        @back="handleBack"
        @save="handleSave"
      />
    </Transition>
  </div>
</template>

<script setup>
import { computed } from 'vue'
import { useSmartProcessStore } from '@/stores/smartProcess'

const store = useSmartProcessStore()

const steps = [
  { id: 'initial', label: 'Вихідні дані', component: StepInitial },
  { id: 'approval', label: 'Погодження', component: StepApproval },
  { id: 'documents', label: 'Документи', component: StepDocuments },
  { id: 'completion', label: 'Завершення', component: StepCompletion },
]

const currentStep = computed(() => store.currentStep)
const currentStepComponent = computed(
  () => steps.find(s => s.id === currentStep.value)?.component
)

async function handleNext(data) {
  await store.saveStepData(data)
  store.nextStep()
}
</script>

Технічні аспекти: стадії, поля, права

Отримання списку стадій смарт-процесу виконується через crm.status.list з фільтром по ENTITY_ID = DYNAMIC_{entityTypeId}_STAGE. Кожна стадія має колір та назву — їх можна використовувати для візуальної індикації. Наприклад, індикатор прогресу відображає поточну стадію кольором.

UF-поля динамічних процесів мають префікс ufCrm_{entityTypeId}_. Для роботи з переліками використовується userfield.enumvalues.get. Приклад отримання та оновлення поля:

// Отримання та оновлення UF-поля
const item = await callMethod('crm.item.get', {
  entityTypeId: 1040,
  id: itemId
})
const customDate = item.ufCrm_1040_1704067200   // тип date
await callMethod('crm.item.update', {
  entityTypeId: 1040,
  id: itemId,
  fields: { ufCrm_1040_1704067200: '2020-01-01' }
})

Перевірка прав виконується через crm.type.get. Поле userPermissions показує, які дії доступні поточному користувачу. Для компонента Vue реалізована проста перевірка:

async function checkPermission(entityTypeId, action) {
  const result = await callMethod('crm.type.get', { id: entityTypeId })
  const userRole = result.userPermissions?.[action]
  return userRole !== 'NONE'
}

Автоматизація та історія змін

Запуск BP з інтерфейсу здійснюється методом bizproc.workflow.start. Документ передається у форматі ['crm', 'CCrmDocumentDynamic', '{entityTypeId}_{itemId}']. Параметри шаблону вказуються в PARAMETERS. Статус запущеного процесу відстежується через bizproc.workflow.instances.

await callMethod('bizproc.workflow.start', {
  TEMPLATE_ID: templateId,
  DOCUMENT_ID: ['crm', 'CCrmDocumentDynamic', `${entityTypeId}_${itemId}`],
  PARAMETERS: {
    approver_id: selectedApproverId,
    deadline: deadlineDate,
  }
})

Для побудови стрічки подій використовуються методи crm.timeline.bindings.list та crm.activity.list. Кожна подія містить дату, автора та опис — ці дані відображаються в кастомному компоненті timeline.

Що входить в роботу

• Аудит бізнес-процесу та складання ТЗ
• Прототипування багатокрокової форми
• Розробка Vue-додатку (Vue 3, Pinia, Vite, TypeScript)
• Інтеграція з REST API Бітрікс24 (crm.item, crm.status, userfield)
• Налаштування прав доступу та запуску BP
• Документація та навчання адміністраторів
• Гарантійна підтримка 3 місяці

Порівняння: стандартний інтерфейс vs кастомний Vue

Vue.js — один з найпопулярніших фреймворків для побудови реактивних інтерфейсів, що підтверджує його надійність для корпоративних рішень.

Процес розробки та терміни

Розробка кастомного інтерфейсу проходить п'ять етапів:

1. Аналіз — вивчаємо бізнес-процес, визначаємо етапи, поля та ролі.
2. Проектування — створюємо прототип багатокрокової форми.
3. Розробка — пишемо Vue-додаток (Vue 3, Pinia, Vite, TypeScript), інтегруємо з REST API.
4. Тестування — перевіряємо на 20+ сценаріях, включаючи граничні випадки.
5. Деплой та навчання — розміщуємо placement-додаток, передаємо документацію.

Терміни:

• Простий інтерфейс (однокрокова форма, базова логіка) — від 4 до 6 робочих днів.
• Складне рішення (багатокрокове погодження, BP, зовнішні інтеграції) — від 2 до 4 тижнів.

Вартість розраховується індивідуально після оцінки проекту. Ми гарантуємо якість коду та дотримання термінів.

Чому обирають кастомні інтерфейси?

Кастомний інтерфейс на Vue вирішує завдання, з якими не справляється стандартна CRM: він адаптується під унікальні бізнес-процеси, скорочує час погодження у 2-3 рази швидше за стандартний інтерфейс CRM та знижує навантаження на менеджерів. Вбудована аналітика та візуальний прогрес підвищують прозорість.

Хочете обговорити ваш смарт-процес? Зв'яжіться з нами — оцінимо проект за один робочий день і запропонуємо оптимальне рішення. Отримайте консультацію прямо зараз.

Чому CIBlockElement::GetList вбиває UX — і до чого тут Vue

Стандартний компонент bitrix:catalog.section при кожному кліку по фільтру перезавантажує сторінку цілком. Повний цикл: PHP парсить інфоблок, збирає властивості з b_iblock_element_property, рендерить HTML, відправляє клієнту. На каталозі в 50 000 SKU це 800–1200 мс. Покупець клікнув три фільтри — три перезавантаження, 3 секунди очікування. В e-commerce це прямий шлях до втрати до 20% конверсії. Vue.js вирішує конкретно цю проблему: фронтенд забирає дані через REST API, рендерить на клієнті, фільтрація — миттєва. Бітрікс залишається бекендом: контент, каталог, замовлення, обмін з 1С. Наша команда впроваджує такий підхід понад 7 років і бачить стабільне прискорення завантаження в 3–5 разів. Офіційна документація Vue.js: «Vue дозволяє створювати реактивні користувацькі інтерфейси з мінімальними зусиллями».

Розробка на Vue.js для 1С-Бітрікс — спосіб перетворити важкий моноліт на чуйний інтерфейс. Ми застосовуємо його в проектах з каталогами від 10 000 SKU і гарантуємо час завантаження сторінки не більше 400 мс після впровадження. Сертифіковані розробники Бітрікс з досвідом 10+ років та понад 50 успішними впровадженнями забезпечують стабільну інтеграцію. Зв'яжіться з нами для консультації — оцінимо можливість прискорення безкоштовно.

Коли Vue виправданий?

Не кожному сайту потрібен фронтенд-фреймворк. Vue виправданий, коли стандартні компоненти Бітрікса не витягують. Основні сценарії:

• Каталоги з важкою фільтрацією — catalog.smart.filter з AJAX працює, але на складних комбінаціях SKU-властивостей гальмує. Vue + API = миттєвий відгук. У нашого клієнта каталог на 80 000 товарів після переходу на Vue став завантажуватися на 60% швидше.
• Особисті кабінети — повноцінні SPA з дашбордами, графіками, реактивними формами. sale.personal.section виглядає застарілим.
• Конфігуратори та калькулятори — візуальні редактори, підбирачі комплектації з перерахунком цін у реальному часі.
• Real-time — чати, сповіщення, оновлення залишків через WebSocket.
• PWA — офлайн-режим, push-сповіщення, встановлення на домашній екран.

Як Vue.js вирішує проблеми UX у Бітріксі?

Порівняння: стандартний компонент bitrix:catalog.section при фільтрації 50 000 товарів видає сторінку за 800 мс + перезавантаження. Vue-віджет на базі REST API рендерить той самий список за 200–300 мс без перезавантаження — в 3–4 рази швидше. У нашій практиці клієнт отримав збільшення середньої глибини перегляду на 35% після впровадження. Економія на серверній інфраструктурі сягає 70% завдяки зменшенню кількості PHP-запитів.

Три архітектурні підходи до інтеграції Vue.js з Бітрікс

Острівний — Vue-віджети на сторінках Бітрікс

Окремі Vue-компоненти монтуються в div#app-filter, div#app-cart на стандартних сторінках Бітрікса. Маршрутизація та серверний рендеринг — як і раніше Бітрікс. Мінімальне втручання в існуючий сайт. Підходить для поетапної модернізації. Типовий приклад — реактивний фільтр замість catalog.smart.filter. В одному з проектів ми замінили фільтр на Vue-віджет за 2 тижні, конверсія зросла на 18%.

SPA на Vue + Бітрікс REST API

Фронтенд — повноцінне Vue-додаток з Vue Router. Бітрікс віддає дані через REST API: штатний модуль rest або кастомні контролери D7. Адмінка Бітрікса — для керування контентом, редактор не помічає різниці. Ідеально для особистих кабінетів, B2B-порталів та внутрішніх додатків, де SEO не критичний.

Nuxt.js + Бітрікс як headless CMS

Nuxt забезпечує SSR/SSG для індексації. Бітрікс — headless: віддає дані через API, керує контентом. Для магазинів і контентних сайтів, де SEO — пріоритет. Ми використовуємо Nuxt 3 з Vue Router для гібридного рендерингу — каталог статично, корзина SSR. Економія на ліцензіях і серверах після впровадження становить десятки тисяч гривень на рік.

Які особливості REST API Бітрікс важливі для Vue-розробки?

Тут зосереджено 70% часу при інтеграції Vue + Бітрікс.

Штатний REST-модуль

Інфоблоки, каталог, корзина (sale.basket.*), замовлення (sale.order.*), користувачі — з коробки. Обмеження: штатні методи не завжди покривають кастомну логіку. Метод catalog.product.list не віддає обчислювані властивості — потрібен кастомний ендпоінт.

Кастомні контролери D7

Клас Bitrix\Main\Engine\Controller — правильний спосіб створення API для Vue. Автоматична валідація параметрів, CSRF-захист з коробки, типізовані відповіді. Не ajax.php з $_POST — це шлях до ін'єкцій.

namespace App\Controller;
use Bitrix\Main\Engine\Controller;

class CatalogController extends Controller
{
    public function getProductsAction(array $filter, int $page = 1): array
    {
        // ORM-запит до інфоблоку, не CIBlockElement::GetList
    }
}

Авторизація та кешування

Авторизація: OAuth 2.0 для SPA або сесійні токени. Rate limiting — через Bitrix\Main\Engine\Controller або nginx. Кешування: API-відповіді кешуються на рівні D7 з тегованою інвалідацією. Змінився товар в інфоблоці — кеш скинувся по тегу iblock_id_X. Без цього при 100 RPS сервер ляже. Ми налаштовуємо це в кожному проекті — гарантія стабільності під навантаженням. Приклад налаштування тегованого кешування:

use Bitrix\Main\Data\Cache;

$cache = Cache::createInstance();
$tag = 'iblock_id_' . $iblockId;
if ($cache->initCache(3600, md5($filter), $tag)) {
    return $cache->getVars();
}
// запит до БД
$cache->startDataCache();
$cache->endDataCache($data);
\CIBlock::registerWithTagCache($iblockId);

Якою має бути структура Vue-додатку для Бітрікса?

• Vue Router — lazy loading маршрутів через defineAsyncComponent. Каталог не тягне за собою код особистого кабінету.
• Pinia — стейт-менеджмент: каталог, корзина, користувач, фільтри. Модульна архітектура сховища. Vuex — легасі, нові проекти на Pinia.
• Axios з перехоплювачами: автоматичне оновлення CSRF-токена, retry при 503, обробка помилок авторизації.
• Vue Query (TanStack Query) — кешування API-запитів, автоматична ревалідація, оптимістичні оновлення. Користувач додав товар у корзину — UI оновився миттєво, запит до API пішов фоном.

Каталог на Vue — розбір ключового кейсу

Різниця в UX відчувається одразу. Конкретика:

• Фільтр — чекбокси, range-слайдери, select з пошуком. Стан синхронізується з URL через vue-router query params — посилання з фільтрами можна відправити колезі.
• Картка товару — галерея з зумом, перемикання SKU (колір/розмір), ціна перераховується через API catalog.product.offer.list, залишки по складах з catalog.store.product.list.
• Віртуальний скролінг — vue-virtual-scroller рендерить лише видимі елементи. Каталог у 10 000 товарів працює без гальм.
• Розумний пошук — debounced-запити до search.title.search або ElasticSearch, автодоповнення через випадаючий список. У нашому проекті це скоротило час пошуку на 40%.
• Порівняння — динамічна таблиця характеристик з підсвічуванням відмінностей. Зберігання в Pinia + localStorage для персистентності.

Процес впровадження Vue.js покроково:

1. Аудит поточної архітектури Бітрікса та виявлення вузьких місць (фільтрація, корзина, особистий кабінет).
2. Проектування API — визначаємо ендпоінти, моделі даних, використовуємо Bitrix\Main\Engine\Controller.
3. Розробка Vue-віджетів або SPA — збірка на Vite, Code Splitting, Pinia.
4. Інтеграція з Бітріксом — теговане кешування, OAuth, обробка помилок.
5. Тестування під навантаженням (до 100 RPS) та деплой з CI/CD.

Продуктивність досягається за рахунок code splitting, tree shaking та lazy loading важких компонентів (Chart.js, карти, WYSIWYG). Бандл сторінки каталогу — 80–120 КБ gzip.

Nuxt.js і SEO: як зберегти індексацію

SPA на чистому Vue віддає пошуковику порожній HTML з <div id="app"></div>. Google вміє рендерити JS, але з затримкою в дні. Яндекс — взагалі непередбачувано. Nuxt.js вирішує:

• SSR — сервер віддає повний HTML, після гідратації працює як SPA.
• SSG — сторінки генеруються при nuxt generate, роздаються з CDN. Максимальна швидкість.
• Гібридний режим — каталог статично, корзина та ЛК — SSR.
• useHead() — динамічні title, description, Open Graph, Schema.org для кожної сторінки.
• Sitemap — @nuxtjs/sitemap, маршрути з API Бітрікса. Це забезпечує повну індексацію — наша гарантія потрапляння в топ-5 Google.

Порівняння підходів та строки

Повний цикл: проектування API, розробка контролерів D7, Vue-додаток, налаштування Vite, тестування, деплой. Код рев'юється, покривається тестами, документується — не «зібрав і забув». Вартість розробки розраховується індивідуально після аналізу вашого поточного сайту та ТЗ. Детальну оцінку ви отримаєте протягом дня — замовте консультацію.

Типові помилки при інтеграції Vue.js і Бітрікс

1. Використання ajax.php замість Bitrix\Main\Engine\Controller — призводить до вразливостей та нестабільності.
2. Відсутність тегованого кешування API — при високому навантаженні сервер не витримує.
3. Ігнорування авторизації OAuth для SPA — сесійні токени можуть закінчуватися, ламаючи UX.
4. Повний перепис всього сайту на SPA без необхідності — збільшує строки та бюджет.
5. Неправильне налаштування Nuxt SSR — повільна генерація сторінок на бекенді.

Що входить у роботу та наші гарантії

• Документація API (Swagger/OpenAPI) для інтеграції з вашим бекендом.
• Доступи до репозиторію з кодом та CI/CD.
• Навчання вашої команди роботі з Vue-компонентами.
• Пост-релізна підтримка на 1 місяць — гарантія стабільності.
• Код відповідає стандартам PSR-12 та Bitrix\Main\Engine\Controller.

Замовте розробку Vue.js інтерфейсів для вашого Бітрікс-проекту — отримайте консультацію та оцінку строків протягом дня. Напишіть нам, і ми надішлемо комерційну пропозицію з детальним планом робіт. Оцінимо проект безкоштовно — просто надішліть ТЗ або посилання на поточний сайт.