Установка та налаштування модулів з маркетплейсу 1С-Бітрікс

Ви купили модуль на маркетплейсі 1С-Бітрікс, натиснули «Встановити», але замість робочої інтеграції отримали помилку 500 або порожній екран. Це стандартний сценарій, з яким ми стикаємося щодня. Безкоштовні модулі часто містять застарілі залежності або недокументовані баги. Платні вимагають налаштування API-ключів, вебхуків і мапінгу полів за документацією партнера. Встановлення модулів Бітрікс з маркетплейсу без досвіду розробки веде до втрат часу від 2 до 8 годин тільки на пошук причин непрацездатності. А якщо модуль зачіпає ядро, наслідки помилки можуть вимагати відновлення з бекапу.

Ми за 7 років налаштували понад 50 комерційних модулів — від простих SEO-віджетів до складних CRM-конекторів із двосторонньою синхронізацією. Самостійне налаштування займає в 2 рази більше часу, ніж наша робота, і дає на 60% більше помилок. У цій статті розберемо типові пастки та покажемо, як ми налаштовуємо модулі з нуля до продакшену.

Чому модулі дають збої після встановлення?

За нашими даними, 60% проблем після встановлення пов'язані з несумісністю версій PHP. Модуль написаний під 8.1, а хостинг використовує 7.4 — це дає синтаксичну помилку. Перевіряється через phpinfo() або /bitrix/admin/sysinfo.php. Інша часта причина — конфлікт обробників подій. Два модулі реєструються на одну подію в таблиці b_module_to_module, і викликається не той обробник. Або модуль не може створити свої таблиці через відсутність прав MySQL на CREATE і ALTER. Іноді модуль не працює через невірний composer.json — залежності не встановлені, класи не автозавантажуються. Рішення: виконати composer install у папці модуля. Також можлива проблема з тегованим кешуванням: модуль не інвалідує кеш, і користувачі бачать старі дані. Конфігурація API Бітрікс вимагає коректних webhook-адрес, інакше модуль не зможе обмінюватися даними із зовнішніми сервісами.

Як налаштувати модуль оплати на прикладі ЮKassa?

Розглянемо налаштування модуля оплати через ЮKassa. Після встановлення через адмінку (розділ «Marketplace» → «Встановлені рішення») ми:

1. Реєструємо webhook в особистому кабінеті ЮKassa на URL модуля (зазвичай /bitrix/tools/sale_ps_result.php).
2. Прописуємо shopId та secretKey в налаштуваннях модуля: COption::SetOptionString('yukassa', 'shop_id', ...).
3. Перемикаємо в тестовий режим для перевірки sandbox-транзакцій.
4. Створюємо тестове замовлення, проводимо оплату, перевіряємо callback-статус success/fail/cancel.
5. У бойовому режимі змінюємо секретний ключ та вимикаємо тестовий прапорець.

Складні модулі доставки (СДЭК, Пошта Росії) вимагають додаткового налаштування: таблиці відповідності ПВЗ, тарифи, налаштування габаритів. Ми завжди перевіряємо розрахунок вартості для різних міст та ваг. Налаштування модуля через підтримку вендора займає в середньому в 2 рази більше часу, ніж наша робота — через чергу та відсутність розуміння архітектури вашого сайту. Ми ж виконуємо до 80% роботи віддалено, без простою вашого сайту.

// Приклад реєстрації обробника події RegisterModuleDependences("sale", "OnSalePayOrder", "vendor.module", "\Vendor\Module\Event", "onPayOrder"); 

Чому варто довірити налаштування професіоналам?

Наша команда має 7 років досвіду з Бітрікс та Бітрікс24. Ми встановили та налаштували понад 50 модулів із зовнішніми інтеграціями. Працюємо з CommerceML та REST API. Гарантуємо, що після налаштування модуль не зламає існуючий функціонал — використовуємо теговане кешування та пишемо модульні тести. Економія часу на налагодженні — до 8 годин на один модуль. Згідно з документацією Бітрікс, модуль має бути зареєстрований в таблиці b_module. Ми слідкуємо за цим та перевіряємо цілісність записів.

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

• Перевірка сумісності модуля з вашою версією Бітрікс та PHP.
• Встановлення через адмінку або вручну (якщо немає доступу).
• Конфігурація всіх параметрів: API-ключі, вебхуки, мапінг.
• Тестування всіх сценаріїв (успіх/помилка/скасування) у sandbox.
• Виправлення можливих конфліктів з іншими модулями.
• Коротка документація по налаштуваннях для вашої команди.
• Підтримка після запуску — 2 тижні гарантії на коректну роботу інтеграції.

Як уникнути типових помилок інтеграції?

Підготуйте заздалегідь облікові дані зовнішніх сервісів (API-ключі, OAuth-токени). Переконайтеся, що є доступ до адмін-панелі Бітрікс із правами адміністратора. Перевірте поточну версію PHP та Бітрікс через /bitrix/admin/sysinfo.php. Якщо модуль використовує події або агенти, перевірте, чи не конфліктують вони з уже встановленими рішеннями. Наше тестування включає перевірку всіх можливих статусів і callback-запитів, щоб уникнути збоїв у продакшені.

Порівняння самостійного налаштування та налаштування професіоналами

Порівняння модулів за складністю налаштування

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