Настройка работы с маркировкой Честный Знак на 1С-Битрикс

Настройка работы с маркировкой Честный Знак на 1С-Битрикс

Мы часто сталкиваемся с задачей интеграции интернет-магазинов на Битриксе с системой «Честный Знак». Обязательная маркировка товаров затрагивает многие категории: лекарства, табак, обувь, одежду, молочную продукцию. Техническая сторона — получать коды Data Matrix от поставщиков, хранить их и передавать в ГИС МТ при продаже. Ошибки на любом этапе грозят блокировкой оборота товаров. Оценим ваш проект за 1 день и предложим оптимальное решение.

Какие проблемы решает интеграция с Честным Знаком?

Первая и главная проблема — нестыковка форматов. Коды маркировки приходят от поставщиков в разных видах: XML, CSV, а иногда и вручную. Нужно унифицировать загрузку и проверку кодов через API markirovka.nalog.ru. Вторая — хранение миллионов уникальных кодов в Битриксе. Стандартные свойства инфоблоков не рассчитаны на такую нагрузку. Третья — своевременное уведомление ГИС МТ о выводе товара из оборота. Задержка или ошибка при отправке — и товар числится в обороте, что грозит штрафом.

Интеграция через модуль 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)
• Тестирование на тестовом контуре ГИС МТ
• Документация по поддержке и список контактов
• Обучение менеджеров работе с маркировкой

Мы работаем с Битриксом более 7 лет и выполнили 30+ интеграций с Честным Знаком. Свяжитесь с нами — получите консультацию по настройке маркировки для вашего магазина.

Официальная документация API Честного Знака: markirovka.nalog.ru

Получите консультацию — оценим ваш проект и предложим оптимальное решение.

Что включает профессиональная установка 1С-Битрикс

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

Как выбрать хостинг и редакцию для установки 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 с оптовыми ценами и тремя складами. Переход на «Бизнес» — доплата разницы, данные не теряются, но лучше предусмотреть заранее. Наши специалисты подберут редакцию под текущие задачи и с запасом на рост. Например, лицензия «Бизнес» (около 35 000 ₽) окупается за счёт мультисклада и обмена с 1С, а неправильный выбор приводит к потере до 30 000 ₽ ежемесячно на избыточных ресурсах.

Какие настройки сервера критичны для 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.

База данных и кэширование

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']]]]

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 с правильной конфигурацией сайт «полетел». Неправильная конфигурация может обходиться в 30 000 ₽ ежемесячно из‑за избыточного потребления ресурсов. Вы получаете готовую архитектуру, которая масштабируется. Закажите установку 1С-Битрикс под ключ — и получите надёжную платформу для роста бизнеса. Свяжитесь с нами — рассчитаем стоимость под ваш проект. Опыт более 7 лет, реализовано 120+ проектов на Битрикс, включая highload‑магазины с миллионными каталогами. Обращайтесь — мы поможем настроить Битрикс под ваш проект.