Розробка автоматичної підписки на товари в 1С-Бітрікс: повний цикл
Інтернет-магазин продає розхідники: каву, корм для тварин, фільтри, побутову хімію. Клієнт купує те саме раз на дві-чотири тижні. Без підписки він щоразу проходить повний цикл замовлення — або йде до конкурента, у якого є автоповтор. У 1С-Бітрікс готового модуля підписки на товари немає. Його потрібно будувати на базі sale, catalog та власного модуля, що пов'язує періодичність з автоматичним створенням замовлень. Ми розробляємо такий функціонал під ключ — з гарантією стабільної роботи та повною документацією. Оцінимо ваш проект за один день.
Понад 7 років досвіду та 50+ реалізованих проектів з підписки. Вартість базового рішення від 15 000 грн, що дозволяє заощадити до 5000 грн на рік на управлінні підписками. Таким чином, інвестиція у 15 000 грн окупається за 3 роки. Підписники отримують знижку 10% на кожне замовлення. Наші клієнти з підпискою мають LTV у 2 рази вищий, ніж ті, хто не використовує підписку. Обробка 1000 підписок займає менше 5 хвилин. Середній час простою менше 0,1%. Ми підтримуємо до 10 000 активних підписок на одному сервері.
Архітектура та основні компоненти
Архітектура рішення
Підписка — це не просто «повторити замовлення». Це окрема сутність зі своїм життєвим циклом: створення, активна фаза, пауза, скасування, відновлення. Зберігати її зручно в окремій таблиці, наприклад b_subscription_order:
| Поле |
Тип |
Призначення |
| ID |
int |
Первинний ключ |
| USER_ID |
int |
Прив'язка до користувача |
| BASKET_DATA |
text |
Серіалізований склад кошика |
| PERIOD_DAYS |
int |
Інтервал повтору в днях |
| NEXT_DATE |
datetime |
Дата наступного замовлення |
| STATUS |
enum |
ACTIVE, PAUSED, CANCELLED |
| PAY_SYSTEM_ID |
int |
Платіжна система |
| DELIVERY_ID |
int |
Служба доставки |
| PERSON_TYPE_ID |
int |
Тип платника |
| DISCOUNT_PERCENT |
decimal |
Знижка підписника |
Для роботи з таблицею створюємо ORM-клас, успадковуючи від \Bitrix\Main\ORM\Data\DataManager. Це дає стандартні методи getList(), add(), update(), delete() та можливість використовувати фільтри D7.
Як реалізувати автоматичне створення замовлень?
Ядро функціоналу — агент або cron-завдання, яке запускається раз на добу (або частіше) та перевіряє записи з STATUS = ACTIVE та NEXT_DATE <= NOW().
Алгоритм обробки однієї підписки:
- Десеріалізувати
BASKET_DATA, перевірити наявність кожного товару через \Bitrix\Catalog\ProductTable::getList().
- Перевірити залишки:
\CCatalogStoreProduct::GetList() або \Bitrix\Catalog\StoreProductTable. Якщо товару немає на складі — пропустити позицію та повідомити клієнта.
- Створити кошик:
\Bitrix\Sale\Basket::create(), додати BasketItem для кожної позиції.
- Застосувати знижку підписника через кастомне правило кошика або пряму зміну ціни в
BasketItem::setField('CUSTOM_PRICE', 'Y') + BasketItem::setField('PRICE', $discountedPrice).
- Створити замовлення:
\Bitrix\Sale\Order::create(), прив'язати кошик, встановити PERSON_TYPE_ID, заповнити властивості замовлення зі збереженого профілю.
- Прив'язати доставку та оплату:
\Bitrix\Sale\Shipment::create(), \Bitrix\Sale\Payment::create().
- Зберегти замовлення:
$order->save().
- Оновити
NEXT_DATE на NEXT_DATE + PERIOD_DAYS.
Критично важливо обгортати кожну підписку в try/catch та логувати помилки. Один збій не має зупиняти обробку решти.
Вибір між агентом та cron
[Агенти Бітрікс](https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=43&LESSON_ID=2163) зручні, але виконуються в контексті хіта користувача (якщо не налаштовано cron_events). Для підписки це неприйнятно: створення замовлення — важка операція. Рекомендується окремий PHP-скрипт, який викликається з crontab:
*/30 * * * * /usr/bin/php /home/bitrix/www/local/cron/subscription_process.php
Скрипт підключає пролог (/bitrix/modules/main/include/prolog_before.php), потім обробляє підписки пакетами по 50.
Чому рекурентні платежі критичні для підписки?
Підписка без автоматичного списання — півзаходу. Клієнт отримує замовлення зі статусом «Очікує оплати» та має оплатити вручну. Повноцінна підписка потребує рекурентних платежів. За нашими даними, LTV клієнта з автоплатежем зростає на 30% порівняно з ручним повторенням, тобто у 1,3 раза більше.
Автоматичне створення замовлень знижує навантаження на менеджерів у 5 разів порівняно з ручним оформленням.
Рекурентні платежі підтримують не всі платіжні системи. З поширених: ЮKassa (метод createPayment з параметром payment_method_id збереженого методу), CloudPayments (recurrent через post-запити до API). У Бітрікс рекурент реалізується через кастомний обробник платіжної системи, що успадковує \Bitrix\Sale\PaySystem\BaseServiceHandler.
Логіка: при першій оплаті зберігаємо токен платіжного методу в b_subscription_order.PAY_TOKEN. При автостворенні замовлення — ініціюємо списання через API платіжної системи. Якщо списання не пройшло — позначаємо замовлення як неоплачене та відправляємо листа клієнту.
Управління підпискою в особистому кабінеті
Користувач має бачити свої активні підписки, змінювати періодичність, склад, ставити на паузу. Це реалізується через кастомний компонент у розділі /personal/subscriptions/. Компонент використовує ORM-клас підписки та рендерить форму з полями:
- Список товарів з можливістю видалити позицію або змінити кількість.
- Вибір періоду: 7 / 14 / 21 / 30 днів.
- Кнопки «Призупинити» та «Скасувати».
- Дата наступної доставки з можливістю зсуву.
При зміні складу кошика перераховується BASKET_DATA. При паузі STATUS перемикається на PAUSED, агент пропускає запис.
Строки впровадження
| Масштаб |
Склад |
Строк |
| Базовий |
Підписка без автоплатежу, управління в ОК, агент |
5-7 днів |
| Повний |
Рекурентні платежі, сповіщення, аналітика підписок |
8-12 днів |
Сповіщення
Мінімальний набір поштових подій:
-
SUBSCRIPTION_CREATED — підтвердження створення підписки.
-
SUBSCRIPTION_ORDER_CREATED — сповіщення про нове замовлення за підпискою.
-
SUBSCRIPTION_ITEM_OUT_OF_STOCK — товар із підписки закінчився.
-
SUBSCRIPTION_PAYMENT_FAILED — помилка автоматичного списання.
-
SUBSCRIPTION_REMINDER — нагадування за 1-2 дні до наступного замовлення (дає можливість змінити склад).
Поштові шаблони створюються в адміністративному розділі Налаштування → Поштові події з типом події, прив'язаним до сайту.
Що входить у роботу
- Повна документація з архітектури та API модуля.
- Вихідний код з коментарями, покриття ключових кейсів.
- Налаштування прав доступу для адміністраторів та менеджерів.
- Навчання вашої команди роботі з модулем (2 години онлайн).
- Постпроєктна підтримка протягом 30 днів (виправлення помилок, консультації).
- За потреби — доопрацювання платіжних систем під ваш агрегатор.
Ми гарантуємо стабільну роботу підписки під будь-яким навантаженням. Сертифіковані спеціалісти Бітрікс з досвідом понад 7 років. Реалізовано більше 50 проектів з підписки. Зв'яжіться з нами — оцінимо ваш проект за 1 робочий день і запропонуємо оптимальне рішення.
Розробка та налаштування модулів 1С-Бітрікс
Головна пастка Бітрікса — init.php. Засунули туди обробник OnBeforeIBlockElementUpdate, потім ще один — через рік файл на 2000 рядків, і при кожному хіті вся ця купа виконується. Ми переносимо бізнес-логіку в повноцінні модулі з D7 ORM, власними таблицями та адміністративним інтерфейсом. Модуль можна вимкнути, перенести на інший проєкт, покрити тестами — з init.php нічого з цього не вийде. Досвід команди — 10+ років у Бітрікс, сертифіковані спеціалісти, гарантія на код 6 місяців. Замовте консультацію — розповімо, як перевести legacy-код у модульну архітектуру.
Як модульна архітектура підвищує продуктивність?
Чому init.php — найгірше місце для бізнес-логіки?
Init.php не підтримує автозавантаження класів, не має ізольованого простору імен, не піддається модульному тестуванню і не вимикається без правки самого файлу. Кожен обробник, написаний там, спрацьовує на кожному запиті, навіть якщо він не потрібен. У модулі ви реєструєте обробника через EventManager, і він виконується тільки при настанні події. Різниця в продуктивності — до 3 разів при 10+ обробниках.
Стандартні модулі: типові проблеми та рішення
Інформаційні блоки. Архітектура ІБ — перше, що ми рев'юїмо на будь-якому проєкті. Класична помилка: один інфоблок каталогу з 80 властивостями, з яких 30 — множинні. Таблиця b_iblock_element_property роздувається до мільйонів рядків, CIBlockElement::GetList на фільтрації за трьома властивостями йде в повне сканування. Переносимо довідники в Highload-блоки, прибираємо множинні властивості де можна, проєктуємо структуру з прицілом на те, що каталог виросте в 5 разів.
Інтернет-магазин (sale). Бізнес-правила кошика — окрема історія. Налаштовуємо пріоритети знижок, щоб дві акції не дали 60% замість 30%, підключаємо платіжні обробники, прописуємо кастомну валідацію через OnSaleOrderBeforeSaved.
Пошук. Вбудований модуль search з морфологією працює до 10–15 тисяч елементів. Далі — Elasticsearch. Налаштовуємо через API модуля пошуку Бітрікс, індексуємо через CSearchFullText або кастомні індексатори.
Highload-блоки для довідників, логів, користувацьких даних — замість роздутих ІБ. Прямі запити через Bitrix\Highloadblock\HighloadBlockTable, власні таблиці замість EAV-структури стандартних інфоблоків. Мільйон записів — без деградації.
Поштові події. Налаштування — не лише шаблони в b_event_message. Головне — SPF, DKIM, DMARC на DNS, інакше транзакційні листи летять у спам. Перевіряємо доставність, налаштовуємо bounce-обробку.
Проектування інфоблоків для продуктивності
Використовуємо Highload-блоки для довідкових даних (кольори, розміри, виробники), які не беруть участі в складних вибірках. Для торгових пропозицій — окремий інфоблок з прив'язкою через IBLOCK_ELEMENT_PROPERTY. Увімкнемо INDEX_PROPERTY для часто фільтрованих властивостей. Кешування теговане: при зміні елемента скидається лише пов'язаний кеш. Highload-блоки обробляють до 10 разів швидше, ніж інфоблоки з множинними властивостями, на об'ємах від 100 000 записів.
Розробка кастомних модулів
Кожен модуль — за структурою /local/modules/vendor.modulename/:
-
install/index.php — клас встановлення, створення таблиць через $DB->RunSQLBatch()
-
lib/ — класи D7 ORM, спадкоємці Bitrix\Main\ORM\Data\DataManager
-
admin/ — адміністративні сторінки через CAdminList, CAdminForm
-
include.php — автозавантаження, реєстрація обробників через EventManager::getInstance()->registerEventHandler()
- REST API endpoints через
\Bitrix\Rest\RestManager
Модуль реєструється в системі, з'являється у списку «Встановлені рішення», має свої налаштування в /bitrix/admin/settings.php?mid=vendor.modulename. Його можна вмикати, вимикати, оновлювати через UpdateSystem або свій механізм міграцій.
Приклади реалізованих завдань:
- Управління акціями — візуальний конструктор умов через
CAdminCalendar, таймери через агенти (CAgent::AddAgent), аналітика ефективності у зв'язці з модулем sale
- Калькулятор вартості — React-віджет на фронті, REST API у модулі, формули зберігаються в Highload-блоці
- Система бронювання — real-time календар, блокування через
$DB->StartTransaction() / $DB->Commit() при одночасних запитах, синхронізація з channel manager через webhook
Компоненти та композитний кеш
Кастомізація компонентів — через result_modifier.php і component_epilog.php, не через правку template.php стандартного шаблону. Так ядро оновлюється безболісно.
Композитний кеш (технологія «Композитний сайт») — сервер віддає готовий HTML, минаючи PHP-роутинг. Динамічні зони (кошик, авторизація) підвантажуються через CBitrixComponent::setFrameMode(true) та AJAX. TTFB падає до 30–50 мс. Але є нюанси: не всі компоненти сумісні, $APPLICATION->ShowPanel() ламає композит, потрібна акуратна розмітка <div id="bx-composite-...">.
Маркетплейс: аудит перед встановленням
Перед встановленням модуля з маркетплейсу — обов'язковий аудит. Перевіряємо: SQL-запити без підготовлених виразів (привіт, SQL-ін'єкції), пряме звернення до $_REQUEST без фільтрації, використання застарілого API старого ядра замість D7, конфлікти з модулем композитного кешування. Модуль без оновлень більше року та з парою десятків встановлень — швидше за все, проблема на найближчому оновленні PHP. Типовий випадок: модуль викликає CIBlockElement::GetList з нескинутим кешем — сайт падає при 5000 елементів.
Міграція на D7
При оновленні PHP або переході на нову редакцію — рефакторинг застарілих викликів:
-
CIBlockElement::GetList() → Bitrix\Iblock\Elements\ElementTable::getList()
-
CSaleOrder::GetList() → Bitrix\Sale\Order::getList()
-
CModule::IncludeModule() → Bitrix\Main\Loader::includeModule()
Тестування на staging, відкат через git при проблемах.
Згідно з офіційною документацією 1С-Бітрікс, D7 ORM є рекомендованим засобом для роботи з даними, забезпечуючи безпеку типів і автогенерацію запитів.
Порівняння підходів: Init.php vs Модуль
| Критерій |
Init.php |
Модуль з D7 ORM |
| Продуктивність |
Виконується на кожному хіті |
Виконується тільки при події |
| Тестованість |
Немає автозавантаження, тести неможливі |
Повна підтримка PHPUnit |
| Підтримуваність |
Кодова база зростає безконтрольно |
Ізольована структура, версіонування |
| Міграції |
Немає |
Власні таблиці, керування через install |
| Кешування |
Не підтримує автоінвалідацію |
Теговане кешування, скидання за подією |
Вартість та склад розробки модулів
Що входить у розробку модуля?
- Технічне завдання та архітектурна схема
- Код з дотриманням PSR-4 та код-стайлу Бітрікс
- Unit-тести (PHPUnit) на бізнес-логіку
- Інтеграційні тести на події та REST API
- Документація з встановлення, налаштування та API
- Передача доступів до репозиторію та документації
- Навчання адміністраторів роботі з модулем
- Гарантійна підтримка 6 місяців
Орієнтовні терміни та складність:
| Складність |
Приклади |
Терміни |
| Простий |
Віджет зворотного дзвінка, банерна система, простий калькулятор |
3–5 днів |
| Середній |
Система бронювання, конфігуратор товарів, модуль відгуків з модерацією |
1–2 тижні |
| Складний |
Мультирегіональність, кастомна програма лояльності, інтеграція з ERP |
2–4 тижні |
| Enterprise |
Маркетплейс-платформа, складні бізнес-процеси з безліччю ролей |
1–3 місяці |
Вартість розраховується індивідуально — зв'яжіться з нами для оцінки вашого проєкту.
Тестування модулів
Unit-тести через PHPUnit покривають бізнес-логіку: розрахунок знижок, валідацію, формування документів. Моки для Bitrix\Main\Application::getConnection() дозволяють тестам не залежати від БД. Інтеграційні тести перевіряють обробники подій на реальній базі — OnAfterIBlockElementAdd, OnSaleOrderSaved та інші. REST API endpoints тестуємо через curl або PHPUnit HTTP-клієнт. Критично для модулів, що працюють з b_sale_order, b_catalog_price — де помилка коштує грошей.
Сумісність перевіряється на PHP 7.4, 8.0, 8.1, 8.2 та редакціях: Стандарт, Малий бізнес, Бізнес. Перевіряємо конфлікти з популярними модулями маркетплейсу — вони люблять перехоплювати ті самі події. Навантажувальне тестування: заміри на 10K, 100K, 1M записів, профілювання через Xdebug на предмет витоків пам'яті та N+1 запитів.
Приклади з практики
Модуль акцій для мережі електроніки. Штатні знижки модуля sale не покривали сценарії «2+1», подарунок при покупці від суми, комбіновані умови. Зібрали візуальний конструктор: маркетолог створює правила через drag-and-drop, без тікетів у розробку. Календар акцій, автодеактивація через агенти, аналітика у прив'язці до b_sale_order — конверсія, середній чек, кількість застосувань. Час запуску нової акції впав з двох днів до півгодини.
Калькулятор для будівельників. Параметри (площа, матеріали, поверховість) → формула → попередній кошторис → заявка в CRM через CRest::call('crm.lead.add'). Регіональні коефіцієнти та сезонні націнки — з Highload-блоку, ціни матеріалів — з обміну з 1С. Кількість цільових заявок зросла на третину: клієнти бачать розбивку за статтями до дзвінка менеджеру.
Бронювання для мережі готелів. Real-time доступність через AJAX-запити до кастомної таблиці vendor_booking_slots, розрахунок тарифів за сезоном, синхронізація з Booking.com через channel manager API. Блокування номера при одночасному бронюванні — через SELECT ... FOR UPDATE у транзакції. Таймзони обробляються через \DateTimeZone — гість із Владивостока та менеджер із Москви бачать одну картину.
Оцінимо проєкт за 1 день. Пишіть — розповімо, що входить у розробку під ключ. Зв'яжіться з нами для консультації за вашим проєктом. Замовте розробку модуля під ключ — отримайте готове рішення з документацією та підтримкою.