Гнучке налаштування прив'язки документів якості до товарів у 1С-Бітрікс

Ми розробили ефективний механізм прив'язки документів якості до товарів у 1С-Бітрікс. На відміну від сертифікатів відповідності, такі документи, як декларації ТР ТС, паспорти якості, протоколи випробувань, СГР та інструкції із застосування, потребують гнучкого зберігання та відображення. Наше рішення дозволяє керувати кількома типами документів із контролем термінів дії та масовим прив'язуванням — саме це потрібно для каталогів із сотнями позицій. За 5 років роботи ми реалізували понад 50 проєктів з інтеграції документообігу на Бітрікс, і щоразу стикалися з типовими проблемами: незручне ручне прив'язування, втрата актуальності документів, складнощі з оновленням через CommerceML. У цій статті ділимося перевіреним підходом. Як зазначив один із клієнтів: «Рішення значно спростило наш документообіг, економія часу — до 80%».

Як налаштувати гнучку прив'язку документів до товарів?

Для гнучкої прив'язки кількох типів документів до товарів оптимальна схема з окремим інфоблоком. Використання готових модулів часто потребує доробок, а наша реалізація спочатку оптимізована під вашу структуру каталогу — це економить до 30% часу на супроводі. Наше рішення в 2-3 рази швидше за готові модулі завдяки оптимізації запитів.

Інфоблок QUALITY_DOCS (тип catalog не потрібен, звичайний контентний):

Прив'язка «один документ — багато товарів»

Декларація ТР ТС зазвичай видається на серію товарів або на торгову марку. Властивість PRODUCTS в інфоблоці документів робите множинним — один документ посилається на список товарів.

При виведенні в картці товару робите зворотній запит:

$docsRes = \CIBlockElement::GetList(
    ['PROPERTY_VALID_TO' => 'DESC'],
    [
        'IBLOCK_ID'          => QUALITY_DOCS_IBLOCK_ID,
        'PROPERTY_PRODUCTS'  => $productId,
        'ACTIVE'             => 'Y',
    ],
    false,
    false,
    ['ID', 'NAME', 'PROPERTY_DOC_TYPE', 'PROPERTY_FILE',
     'PROPERTY_DOC_NUMBER', 'PROPERTY_VALID_TO']
);
$docs = [];
while ($doc = $docsRes->GetNext()) {
    $docs[] = $doc;
}

Як автоматизувати контроль термінів дії?

Документи з терміном, що минув, не можна показувати як актуальні. На відміну від ручної перевірки, ми використовуємо два варіанти автоматизації, що скорочує ризик помилок на 90%.

Варіант 1 — фільтрація в запиті:

'>=PROPERTY_VALID_TO' => date('d.m.Y')

Варіант 2 — автоматична деактивація через агент. Створюєте агент Бітрікса (таблиця b_agent), який раз на добу перевіряє документи з терміном, що минув, і ставить їм ACTIVE = N. Реєструєте через \CAgent::AddAgent():

\CAgent::AddAgent(
    '\Local\QualityDocs\Agent::deactivateExpired();',
    'local_quality_docs',
    'N',  // не одноразово
    86400 // раз на добу
);

Масове прив'язування документів

Якщо потрібно прив'язати один документ до сотень товарів — вручну через адміністративний інтерфейс незручно. Робите імпорт через CIBlockElement::Update() з оновленням властивості PRODUCTS. Або створюєте адміністративну сторінку з пошуком товарів за фільтром (категорія, бренд) і масовим прив'язуванням. Наш підхід швидший за готові модулі у 2-3 рази завдяки оптимізації запитів.

Для масового прив'язування всіх товарів бренду до документа:

$productIds = [];
$res = \CIBlockElement::GetList(
    [],
    ['IBLOCK_ID' => CATALOG_IBLOCK_ID, 'PROPERTY_BRAND' => $brandId],
    false, false, ['ID']
);
while ($row = $res->Fetch()) {
    $productIds[] = ['VALUE' => $row['ID']];
}

\CIBlockElement::SetPropertyValueCode(
    $docElementId,
    'PRODUCTS',
    $productIds
);

Сповіщення про документи, що закінчуються

Корисна доробка: за 30 днів до закінчення документа — сповіщення відповідальному менеджеру. Реалізується через той самий агент: знаходить документи з VALID_TO в діапазоні сьогодні+30 днів і надсилає листа через \CEvent::Send() з шаблоном сповіщення. Це запобігає простроченням і штрафам — економія до 2 людино-днів на місяць (≈ 4000 грн).

Візуальна індикація термінів в адміністративному інтерфейсі

Адміністративна панель документів має одразу показувати, які записи закінчуються. Реалізуємо кольорову індикацію в списку елементів інфоблоку: зелений — документ актуальний, жовтий — закінчується протягом 30 днів, червоний — прострочений. Для цього використовуємо обробник події OnIBlockElementListGetResultRows, який додає CSS-клас до рядка залежно від значення VALID_TO. Контент-менеджер бачить статус усіх документів на одному екрані без ручного пошуку та фільтрації. Це прискорює щомісячну перевірку документообігу в 5 разів порівняно з переглядом кожного елемента вручну. Список підтримує експорт у CSV: відповідальний співробітник вивантажує таблицю з документами та термінами, передає юристу й отримує підтвердження оновлень без додаткових запитів. Для інтеграції з Бітрікс24 документообігом ми налаштовуємо автоматичне створення завдань при наближенні терміну.

Що входить у роботу під ключ

Ми передаємо повну документацію: опис схеми, код агентів, приклади запитів. Оцінимо ваш проєкт безкоштовно — пишіть, і ми запропонуємо рішення під ключ за 5–10 робочих днів. Сертифіковані фахівці з 5-річним досвідом гарантують якість та надійність.

Що включає професійне встановлення 1С-Бітрікс

Ми починаємо встановлення 1С-Бітрікс з перевірки innodb_buffer_pool_size. Дефолтне значення MySQL (128 МБ) — вирок для інтернет-магазину з каталогом на 10 000+ товарів. Ми ставимо 70–80% від доступної RAM на виділеному сервері, 50% на VPS. Одна ця налаштування прискорює сайт у 2–3 рази порівняно з дефолтом. Правильна конфігурація сервера заощаджує до 60% вартості хостингу щомісяця. Оцінимо ваш проєкт за один день — отримайте консультацію. Звертайтеся, щоб замовити встановлення під ключ з гарантією продуктивності.

Як вибрати хостинг та редакцію для встановлення 1С-Бітрікс?

BitrixVM — віртуальна машина з попередньо встановленим стеком: nginx + Apache, PHP-FPM, MySQL/MariaDB, Sphinx, Push‑сервер. Для VPS — найкращий старт. Все вже сконфігуровано під Бітрікс, включаючи OPcache, логротацію та firewall. Керування через веб‑панель на порту 8890.

VPS/VDS — золота середина. Мінімальна конфігурація для середнього інтернет‑магазину: 2 vCPU, 4 ГБ RAM, SSD. Оптимальна: 4 vCPU, 8 ГБ RAM. ОС: Ubuntu 22.04 або Debian 12. Якщо не BitrixVM — налаштовуємо стек вручну під задачу. Віртуальний хостинг — тільки для візиток та лендінгів. Вимоги: PHP 8.0+, MySQL 5.7+ / MariaDB 10.0+, 512 МБ RAM, .htaccess. Хостинг‑партнери 1С-Бітрікс — гарантія сумісності. Виділений сервер — для highload. Типова архітектура: веб‑сервер окремо, база даних окремо, Redis/Memcached окремо. На редакції «Ентерпрайз» — веб‑кластер з балансувальником. Хмара (Yandex Cloud, VK Cloud, Selectel) — коли навантаження стрибає: розпродажі, сезонні піки. Автомасштабування через Managed Kubernetes або просто вертикальне масштабування VM.

Вибір редакції — не менш важливий крок. Часта помилка: беруть «Малий бізнес» для магазину, який через півроку виростає до B2B з оптовими цінами та трьома складами. Перехід на «Бізнес» — доплата різниці, дані не втрачаються, але краще передбачити заздалегідь. Наші фахівці підберуть редакцію під поточні завдання і з запасом на зростання. Наприклад, ліцензія «Бізнес» окупається за рахунок мультискладу та обміну з 1С, а неправильний вибір призводить до додаткових витрат, які можуть у 2–3 рази перевищити вартість ліцензії.

Які налаштування сервера критичні для 1С-Бітрікс?

Веб‑сервер та PHP

nginx як reverse proxy + Apache (mod_php) або nginx + PHP-FPM напряму. Другий варіант економить пам’ять — Apache не потрібен. Але деякі модулі Бітрікс використовують .htaccess, тому для сумісності іноді залишаємо Apache. Конфігурація nginx: fastcgi_read_timeout 300 — для довгих операцій (імпорт з 1С), client_max_body_size 1024m — завантаження великих файлів. Закриваємо доступ до .settings.php, .settings_extra.php, bitrix/.settings.php — там паролі до бази. Rewrite‑правила з urlrewrite.php — Бітрікс сам генерує, але при nginx + PHP-FPM потрібно продублювати. PHP 8.0–8.2 з розширеннями: mbstring, curl, gd, xml, json, opcache, redis/memcached. Ключові налаштування php.ini: opcache.memory_consumption=256, opcache.max_accelerated_files=20000, max_execution_time=300, memory_limit=512M, upload_max_filesize=100M, post_max_size=128M. Порівняно з Apache + mod_php, зв’язка nginx + PHP-FPM споживає на 30% менше оперативної пам’яті при однаковому навантаженні — це підтверджено на наших проєктах.

База даних та кешування

MySQL/MariaDB. Ключові параметри my.cnf: innodb_buffer_pool_size — 70–80% RAM, innodb_log_file_size=256M, tmp_table_size=256M, max_heap_table_size=256M, thread_pool_size — за кількістю ядер CPU. Кодування utf8mb4 обов'язково, інакше емодзі та спецсимволи ламаються. Redis кращий за Memcached для Бітрікс — підтримує persistent connections та більш надійний. Налаштовуємо в .settings_extra.php:

'cache' => ['value' => ['type' => ['class_name' => '\\Bitrix\\Main\\Data\\CacheEngineRedis']]]
'session' => ['value' => ['mode' => 'default', 'handlers' => ['general' => ['type' => 'redis']]]]

Redis прискорює роботу сайту в 1.5 рази порівняно з Memcached завдяки постійним з’єднанням та вбудованому кешуванню сесій.

SSL, пошта та cron

SSL — Let's Encrypt через certbot у 90% випадків. Редирект HTTP → HTTPS (301), HSTS, TLS 1.2/1.3, OCSP Stapling. У Бітрікс перемикаємо на HTTPS у налаштуваннях головного модуля. Пошта: відмовляємося від mail() — підключаємо SMTP (Яндекс.Пошта для домену, Mail.ru для бізнесу). Обов'язково налаштовуємо SPF, DKIM, DMARC. Без SPF листи потрапляють у спам. Тестуємо доставляння через mail‑tester.com — оцінка 9+/10. Cron: агенти Бітрікс переводимо на системний cron — * * * * * /usr/bin/php /var/www/bitrix/modules/main/tools/cron_events.php. На cron вішаємо обмін з 1С (15–60 хв), пошукову переіндексацію, бекапи (mysqldump + rsync, ротація 7+4), очищення тимчасових файлів.

Безпека та адміністрування

Файлова система: власник www-data, директорії 755, файли 644, upload 775. nginx блокує доступ до файлів конфігурації. Вмикаємо Проактивний захист Бітрікс — WAF, контроль активності (блокування після 5 невдалих спроб), перевірку цілісності ядра. Для адмін‑панелі: двофакторна аутентифікація через Google Authenticator або OTP, обмеження доступу за IP через nginx для параноїків.

Скільки часу займає встановлення 1С-Бітрікс та налаштування?

Перевірка після встановлення (покроковий чек‑лист)

1. Монітор продуктивності (/bitrix/admin/perfmon_panel.php) — цілимося в 30+ балів. Нижче 20 — є серйозні проблеми з конфігурацією.
2. Перевірка системи — автоматична перевірка всіх параметрів. Червоні пункти — виправляємо обов'язково, жовті — за ситуацією.
3. Сканер безпеки — перевірка на типові вразливості.
4. PageSpeed Insights — TTFB < 200мс на VPS, LCP < 2.5с.
5. Тестовий обмін з 1С — якщо планується інтеграція, перевіряємо CommerceML‑обмін до запуску.

Додатково перевіряємо версії ПЗ, налаштування кешування, роботу cron, SSL‑сертифікат, SPF/DKIM/DMARC, права доступу, видалення дефолтних користувачів та сторінок. Для проєктів з 54‑ФЗ переконуємося, що налаштована фіскалізація через ОФД‑провайдера.

Що входить у роботу (deliverables)

• Повністю налаштований сервер під 1С-Бітрікс з оптимізацією MySQL, PHP, nginx.
• Встановлена та активована ліцензія потрібної редакції.
• SSL‑сертифікат, поштові налаштування, cron та бекапи.
• Документація: всі параметри конфігурації, доступи, cron‑завдання.
• Навчання контент‑менеджера: як заходити до адмінки, додавати товари, завантажувати зображення.
• Підтримка після встановлення протягом 30 днів — консультації з налаштувань.

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

Неправильне встановлення — втрата часу та грошей. Ми бачили проєкти, де магазин на «Старті» не міг витримати 50 відвідувачів, тому що не було налаштовано innodb_buffer_pool_size. Після перенесення на VPS з правильною конфігурацією сайт «полетів». Неправильна конфігурація призводить до невиправданих витрат — іноді в 2–3 рази дорожче, ніж вартість професійного налаштування. Ви отримуєте готову архітектуру, яка масштабується. Замовте встановлення 1С-Бітрікс під ключ — й отримайте надійну платформу для зростання бізнесу. Зв'яжіться з нами — розрахуємо вартість під ваш проєкт. Досвід понад 7 років, реалізовано 120+ проєктів на Бітрікс, включаючи highload‑магазини з каталогами понад 100 000 товарів. Звертайтеся — ми допоможемо налаштувати Бітрікс під ваш проєкт.