Інтеграція з Честним Знаком на 1С-Бітрікс: повний гайд

Покрокова інструкція: інтеграція з Честним Знаком на 1С-Бітрікс

Ми часто стикаємося із завданням інтеграції з Честним Знаком на Бітріксі. Обов'язкове маркування товарів торкається багатьох категорій: ліки, тютюн, взуття, одяг, молочну продукцію. Технічна сторона — отримувати коди Data Matrix від постачальників, зберігати їх і передавати в ГІС МТ при продажу. Помилки на будь-якому етапі загрожують блокуванням обігу товарів. Офіційна документація API Честного Знака Оцінимо ваш проєкт за 1 день і запропонуємо оптимальне рішення. Маркування чесний знак бітрікс вимагає правильної інтеграції. Маємо понад 7 років досвіду та 30+ успішних інтеграцій — гарантія якості.

Кроки налаштування інтеграції

1. Аудит поточної схеми — перевіряємо, як зараз зберігаються та передаються коди.
2. Проєктування структури — створюємо таблицю для зберігання кодів в Бітріксі.
3. Реалізація обміну — налаштовуємо імпорт з 1С або розробляємо клієнт API.
4. Налаштування обробників — підключаємо події оплати для виведення з обігу.
5. Тестування — перевіряємо на тестовому контурі ГІС МТ.
6. Документація та навчання — передаємо менеджерам інструкції.

Вартість проєкту від 15 000 грн, термін — від 5 днів. Точна вартість залежить від обсягу товарів: від 15 000 до 30 000 грн. Економія на штрафах може скласти до 50 000 грн на місяць. Середня вартість інтеграції 20 000 грн.

Які проблеми вирішує інтеграція з Честним Знаком?

Перша і головна проблема — неузгодженість форматів. Коди маркування надходять від постачальників у різних видах: XML, CSV, а іноді й вручну. Потрібно уніфікувати завантаження та перевірку кодів через API markirovka.nalog.ru. Друга — зберігання мільйонів унікальних кодів у Бітріксі. Стандартні властивості інфоблоків не розраховані на таке навантаження. Третя — своєчасне повідомлення ГІС МТ про виведення з обігу товару. Затримка або помилка при відправці — і товар значиться в обігу, що загрожує штрафом до 50 000 грн. Прямий API у 5-10 разів ефективніший за обмін через 1С.

Інтеграція через модуль 1С + Бітрікс

Стандартний шлях для більшості інтернет-магазинів: облік маркованих товарів ведеться в 1С, Бітрікс виступає вітриною. Синхронізація через штатний модуль обміну bitrix:catalog.import.1c (CommerceML).

При такому підході коди маркування (Data Matrix) зберігаються в 1С, передаються в Бітрікс разом із залишками через XML-вивантаження. У XML CommerceML поля для кодів маркування не стандартизовані — їх передають як додаткові реквізити товару:

<ЗначениеРеквизита>
    <Наименование>КодМаркировки</Наименование>
    <Значение>010460406000600021N4N57RSCBUZTJZ</Значение>
</ЗначениеРеквизита>

У Бітріксі налаштовуєте властивість каталогу MARKING_CODE та мапінг реквізиту в налаштуваннях обміну.

Пряма інтеграція з API Чесного Знака

Для інтернет-магазинів, що працюють напряму з ГІС МТ без 1С, потрібна пряма інтеграція через API markirovka.nalog.ru. API використовує OAuth2 авторизацію з УКЕП (кваліфікований електронний підпис). Для авторизації потрібен УКЕП сертифікат.

Основні методи API, які зачіпає e-commerce:

• POST /api/v3/facade/identifyDocument — перевірка коду маркування
• POST /api/v3/facade/send — повідомлення про виведення товару з обігу при продажу

У Бітріксі реалізуєте сервісний клас для роботи з API:

namespace Local\MarkingCode;

class ChestnyZnakClient {
    private string $apiUrl = 'https://markirovka.nalog.ru/api/v3';
    private \Bitrix\Main\Web\HttpClient $http;

    public function verifyCode(string $code): array {
        $this->http->setHeader('Authorization', 'Bearer ' . $this->getToken());
        $response = $this->http->post($this->apiUrl . '/facade/identifyDocument', ['code' => $code]);
        return json_decode($response, true);
    }
}

Токен отримуєте через УКЕП — це вимагає криптографічної бібліотеки (КриптоПро CSP) на сервері.

Як зберігати коди маркування в Бітріксі?

Кожен екземпляр товару має унікальний код маркування. Зберігання у властивості елемента каталогу (b_iblock_element_prop_m*) не підходить — в одного товару сотні екземплярів із різними кодами.

Створюєте окрему таблицю через ORM D7:

class MarkingCodeTable extends \Bitrix\Main\Entity\DataManager {
    public static function getTableName() { return 'b_local_marking_code'; }
    public static function getMap() {
        return [
            new \Bitrix\Main\Entity\IntegerField('ID', ['primary' => true, 'autocomplete' => true]),
            new \Bitrix\Main\Entity\IntegerField('PRODUCT_ID'),
            new \Bitrix\Main\Entity\StringField('CODE', ['size' => 200]),
            new \Bitrix\Main\Entity\StringField('STATUS'), // 'active', 'sold', 'returned'
            new \Bitrix\Main\Entity\DatetimeField('CREATED_AT'),
        ];
    }
}

При продажу товару (подія OnSaleOrderPaid) змінюєте статус коду з active на sold і відправляєте повідомлення в ГІС МТ.

Що робити при продажу товару?

При успішній оплаті замовлення потрібно повідомити систему маркування про виведення товару з обігу. Це асинхронна операція — не блокуйте процес оформлення замовлення очікуванням відповіді від API.

Реалізуйте через агент або чергу: при OnSaleOrderPaid записуєте задачу у власну таблицю b_local_marking_queue, агент з інтервалом 1 хвилина обробляє чергу та відправляє запити в ГІС МТ.

Порівняння підходів: через 1С vs прямий API

Пряма інтеграція через API швидша за обмін з 1С у 5–10 разів, але потребує більше розробки. Ми рекомендуємо її, якщо у вас >10 000 товарів і мінімальна затримка критична.

Що входить у налаштування?

• Аудит поточної схеми обліку товарів та обміну з постачальниками
• Проєктування структури зберігання кодів (ORM-таблиця)
• Реалізація інтеграції з API Чесного Знака (або налаштування обміну з 1С)
• Налаштування обробників подій (OnSaleOrderPaid)
• Тестування на тестовому контурі ГІС МТ
• Документація з підтримки та список контактів
• Навчання менеджерів роботі з маркуванням

При фіскалізації 54-ФЗ коди маркування передаються до ОФД. ОФД чесний знак забезпечує передачу даних про продаж.

Ми працюємо з Бітріксом понад 7 років і виконали 30+ інтеграцій з Честним Знаком. Зв'яжіться з нами — отримайте консультацію з налаштування маркування для вашого магазину. Вартість проєкту від 15 000 грн, термін — від 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 товарів. Звертайтеся — ми допоможемо налаштувати Бітрікс під ваш проєкт.