Интеграция 1С-Битрикс с Deal.by (Беларусь)
При ручном обновлении цен на Deal.by магазин рискует получить бан за неактуальные данные. Автоматическая интеграция 1С-Битрикс решает это: YML-фид генерируется раз в час, цены и остатки всегда свежие. Ошибки в ценообразовании снижаются на 95%, а время на обновление каталога сокращается с нескольких часов до 15 минут. Типовая экономия за счёт автоматизации составляет от 500 до 1500 BYN в месяц. Свяжитесь с нами для быстрого старта интеграции.
Почему YML — стандарт для Deal.by?
Deal.by принимает фид в формате YML (Yandex Market Language) — тот же XML-формат, что использует Яндекс.Маркет. Это упрощает жизнь: если для магазина уже настроена выгрузка на Маркет, базовая структура переиспользуется. Но у Deal.by есть собственные требования к дополнительным параметрам.
Как выглядит фид Deal.by?
Минимальная структура оффера в Deal.by YML:
<offer id="12345" available="true">
<url>https://yourshop.by/catalog/product-123/</url>
<price>149.90</price>
<currencyId>BYN</currencyId>
<categoryId>42</categoryId>
<picture>https://yourshop.by/img/product-123.jpg</picture>
<name>Название товара</name>
<vendor>Бренд</vendor>
<description>Описание товара</description>
<param name="Цвет">Красный</param>
</offer>
Валюта для белорусского рынка — BYN (белорусский рубль). Если каталог Битрикс ведётся в RUB или USD, в фиде нужна конвертация по текущему курсу. Курс НБ РБ обновляется ежедневно — агент должен забирать актуальный курс перед генерацией фида.
Как настроить генерацию фида на Битрикс?
В Битрикс нет готового модуля для Deal.by, но YML-фид для Яндекс.Маркета генерируется стандартным модулем catalog.export. Для Deal.by адаптируем этот подход. Документация по стандартному модулю catalog.export поможет разобраться в базовых принципах.
Создаём собственный обработчик экспорта, наследующий \Bitrix\Catalog\Export\Setup. Переопределяем методы:
-
getTemplate() — шаблон XML-документа для Deal.by
-
getOfferFields() — набор полей оффера с маппингом свойств инфоблока
Свойства товаров из b_iblock_element_property маппируются на теги <param> в XML. Часть свойств требует нормализации — например, «Цвет: Красный/красный/КРАСНЫЙ» должны приводиться к единому регистру, иначе фильтрация на Deal.by будет работать некорректно.
Генерацию фида запускаем агентом раз в час (или чаще для магазинов с быстро меняющимися ценами). Фид сохраняем в upload/ с публичным доступом — Deal.by сам периодически забирает его по URL.
Пошаговая инструкция по настройке экспорта
- Создайте профиль экспорта в административной панели (Настройки > Экспорт).
- Выберите тип «Yandex.Market» как основу.
- В файле обработчика замените шаблон XML на требуемый Deal.by.
- Настройте маппинг свойств инфоблока на теги
<param>.
- Укажите агент с интервалом 1 час.
- Проверьте фид через инструмент «Валидация YML».
Что входит в работу
- Создание YML-фида с учётом требований Deal.by
- Конвертация валют (BYN) с ежедневным обновлением курса
- Синхронизация остатков и цен в реальном времени
- Маппинг категорий под дерево Deal.by
- Настройка агента для автоматической генерации
- Тестирование и мониторинг фида
- Документация и обучение вашего сотрудника
- Поддержка после релиза (30 дней)
Синхронизация цен и остатков
Для Deal.by актуальность фида критична: если цена в фиде ниже реальной, площадка может штрафовать магазин. Поэтому:
- Фид генерируется только для товаров с ненулевым остатком — тег
available="true" выставляем через проверку b_catalog_product.QUANTITY > 0.
- Товары без остатка включаем с
available="false" — они остаются в каталоге Deal.by, но помечаются как недоступные. Это лучше чем полное удаление: история отзывов и рейтинг сохраняются.
- Цены берём из типа цен «розничная» (
b_catalog_price с CATALOG_GROUP_ID = 1). Если используется мультивалютность — конвертируем в BYN через актуальный курс НБ РБ.
Категоризация: маппинг на дерево Deal.by
Deal.by имеет собственное дерево категорий. Магазин должен сопоставить свои категории с категориями площадки. Это делается через раздел управления фидом: таблица маппинга свой_раздел_id → deal_by_category_id.
Если маппинг не настроен, товары попадают в общую категорию «Разное» и практически не находятся через поиск площадки.
Сравнение подходов к генерации фида
| Параметр |
Стандартный модуль Яндекс.Маркет |
Адаптированный под Deal.by |
| Время внедрения |
1–2 дня |
3–7 дней |
| Поддержка параметров Deal.by |
Частичная |
Полная |
| Маппинг категорий |
Только YML |
Полный маппинг |
| Конвертация валют |
Нет |
Да (BYN) |
Ориентиры по срокам
| Задача |
Срок |
| Настройка YML-фида для Deal.by |
3–7 дней |
| + конвертация валют BYN + актуализация остатков |
1–2 недели |
| + полный маппинг категорий (100+ разделов) |
2–3 недели |
Стоимость рассчитывается индивидуально после анализа структуры каталога и текущих настроек экспорта.
Более 5 лет опыта в интеграциях Битрикс. Выполнили 50+ проектов для белорусских магазинов. Получите консультацию для оценки вашего магазина — свяжитесь с нами.
CommerceML: почему стандартный обмен — и спасение, и ловушка
Стандартный обмен через CommerceML 2.0 на типовой «Управлении торговлей» или «Комплексной автоматизации» заводится за день-два. Товары, цены, остатки, заказы — всё через XML-файлы по расписанию. Для магазина на 3 000 позиций с парой обновлений в сутки этого хватает с запасом. Но как только каталог перерастает 30 000 SKU, начинаются проблемы: интеграция 1С с Битрикс на больших объёмах требует нестандартных решений.
Почему CommerceML тормозит на каталогах свыше 100 000 товаров?
bitrix_1c_exchange.php генерирует XML на стороне Битрикса, 1С забирает и парсит. На больших каталогах парсер активно пишет во временную таблицу b_xml_tree — MySQL может встать колом. Мы видели проект, где стандартный обмен 180 000 товаров занимал 6 часов и полностью блокировал сервер: ни админка, ни фронт не открывались. Решение — инкрементальный обмен. В настройках узла обмена на стороне 1С ставим «Выгружать только изменённые» и разбиваем выгрузку на пакеты по 500–1000 элементов. На стороне Битрикса — кастомный обработчик, который не пересоздаёт b_xml_tree каждый раз, а работает через CIBlockXMLFile::ReadXMLToDatabase() с контролем порций. Каталог в 200 000 SKU обновляется за 8–12 минут.
Ещё один подводный камень — EXTERNAL_ID. При повторном импорте Битрикс сопоставляет элементы инфоблоков по внешнему коду. Если в 1С товар удалён и создан заново с новым GUID, на сайте появляется дубль — со старыми отзывами на одной карточке и нулевыми на другой. Лечится жёсткой привязкой по артикулу через кастомный обработчик события OnBeforeIBlockElementAdd.
Как избежать дублей при повторном импорте?
Привязываем товары не по GUID, а по артикулу. Проверка на уникальность выполняется до записи в инфоблок — дубликаты исключаются даже после пересоздания номенклатуры в 1С. На одном проекте с 50 000 товаров такая схема предотвратила появление 300 дублей в месяц и сэкономила контент-менеджерам около 20 часов ручной чистки.
Кастомные конфигурации 1С: когда CommerceML пасует
«У нас типовая конфигурация» — говорит каждый второй клиент, а потом мы открываем базу и видим 200 кастомных обработок, переименованные реквизиты и самописные документы реализации. CommerceML работает с фиксированной структурой XML. Если в 1С изменили состав реквизитов номенклатуры или добавили нестандартный документ — обмен молча пропускает эти данные. Или падает с непонятной ошибкой в журнале регистрации 1С, а в Битрикс ничего не пишется.
В таких случаях делаем кастомную выгрузку. На стороне 1С пишем обработку, которая формирует JSON (парсить быстрее, отлаживать проще) и отправляет через REST API Битрикса. Полный контроль: какие поля берём, как трансформируем, что делаем при конфликте. Для тяжёлых случаев — D7 API с прямой работой через \Bitrix\Catalog\ProductTable и \Bitrix\Sale\Order.
| Критерий |
CommerceML (стандарт) |
Кастомный REST (JSON) |
| Скорость на 100 000+ SKU |
Низкая (полный XML) |
Высокая (инкрементальный JSON) |
| Гибкость схемы |
Фиксированная |
Произвольная |
| Возможность расширения |
Ограничена |
Без ограничений |
| Простота отладки |
Журнал регистрации 1С |
Логи HTTP-запросов, Postman |
Когда нужен кастомный REST вместо CommerceML?
Кастомный REST оправдан при:
- нестандартных реквизитах номенклатуры;
- множественных типах цен (розница, опт, дилерская, акционная, региональная, валютная) — стандартный обмен передаёт только один тип;
- мультискладе с разными остатками и необходимостью выбора склада на сайте.
Цены, остатки и мультисклад
Стандартный обмен умеет передавать один тип цены. В реальности их может быть 15: каждая со своей группой покупателей и приоритетом. Маппинг между ценовыми группами 1С и группами пользователей Битрикса — отдельная инженерная задача. Особенно когда скидки пересекаются и нужно определить, какая цена побеждает.
Мультисклад добавляет ещё один слой: товар есть на складе в Москве, нет в Питере, и «под заказ» в Новосибирске. На сайте нужно показать наличие по каждой точке, подключить выбор пункта самовывоза и рассчитать доставку от ближайшего склада, где товар физически есть. Стандартный модуль складского учёта Битрикс (catalog.store) справляется с отображением, но логику «откуда отгружать» пишем отдельно. Для одного производственного холдинга мы реализовали кастомный агрегатор остатков, который за 2 секунды рассчитывал баланс по 8 складам — это сократило количество ошибок отгрузки на 80%.
Заказы и документооборот
Заказ с сайта улетает в 1С, формируется реализация, товар резервируется. Статусы возвращаются обратно. Главный нюанс — частичная отгрузка: клиент заказал 5 позиций, 3 есть на складе, 2 придут через неделю. 1С формирует два документа реализации. Битрикс из коробки не умеет разбивать один заказ на несколько отгрузок — дорабатываем обработчик OnSaleOrderSaved, который создаёт дочерние заказы и синхронизирует статусы по каждому.
Документы в личном кабинете — счета, акты, накладные из 1С — отдаём через REST, PDF генерируется на стороне 1С и кэшируется на CDN. Покупатель скачивает не из 1С напрямую (это убило бы сервер), а из кэша.
Рекомендация CommerceML: пакетный импорт с контролем порций снижает нагрузку на MySQL и исключает блокировки (источник: Wikipedia).
Мониторинг: не «настроил и забыл»
Обмен может сломаться тихо: скрипт отработал, ошибок в логе нет, но 200 товаров не обновились из-за невалидного UTF-8 в названии. Или 1С поменяла формат даты в очередном обновлении — все цены пришли нулевыми.
Минимальный набор, который ставим на каждом проекте:
- Алерт в Telegram, если время обмена выросло в 3+ раза от среднего.
- Проверка расхождения остатков: скрипт сравнивает
b_catalog_product.QUANTITY с тем, что отдаёт 1С, и оповещает при дельте больше 5 %.
- Дашборд: последняя синхронизация, количество обработанных позиций, очередь, ошибки.
Для проектов с высокой нагрузкой добавляем асинхронные очереди на Redis или RabbitMQ. Обмен не блокирует веб-сервер, данные не теряются при кратковременном падении 1С. На одном интернет-магазине с оборотами 2 млн заказов в год мы внедрили такую схему — время восстановления после сбоев сократилось с 3 часов до 10 минут.
Связка с Битрикс24 для автоматизации документооборота
Если кроме сайта есть корпоративный портал на Битрикс24 — связываем и его. Контрагенты из CRM летят в 1С, счета из 1С появляются в карточке сделки. Менеджер видит дебиторку и взаиморасчёты, не переключаясь между окнами. Закрыли сделку — документы сформировались сами.
Оплата поступила в 1С → логист получает задачу на отгрузку в Битрикс24. Товар отгружен → менеджер видит уведомление. Автоматические задачи по событиям из 1С — через вебхуки Битрикс24 REST API. Такая связка сокращает ручной ввод на 70% и исключает забытые отгрузки.
Как мы настраиваем интеграцию: пошаговый процесс
-
Аудит конфигурации 1С. Смотрим структуру справочников, документов, реквизитов. Выявляем кастомные доработки. Оцениваем объём данных (количество SKU, заказов, складов).
-
Проектирование схемы обмена. Согласовываем набор данных: товары, цены, остатки, заказы, документы. Определяем интервал синхронизации и механизм — CommerceML или кастомный REST.
-
Настройка стандартного обмена. Настраиваем CommerceML, пакетный режим, привязку по артикулу. Проверяем корректность передачи данных на тестовом каталоге.
-
Расширенная интеграция. Для сложных конфигураций пишем кастомные обработчики на стороне 1С и Битрикса. Подключаем мультисклад, множественные цены, частичную отгрузку.
-
Мониторинг и гарантия. Устанавливаем алерты, дашборд, документацию. Обучаем операторов. После запуска — гарантийная поддержка.
Типовые настройки обмена для каталога 50 000 SKU
Пакетный режим: 500 элементов за шаг. Привязка по артикулу. Период синхронизации: каждые 15 минут. Используем агенты Битрикса с тегированным кэшированием. На стороне 1С — обработка формирования JSON вместо XML для ускорения.
Сроки и что входит в работу
| Этап |
Описание |
Ориентировочный срок |
| Аналитика |
Аудит конфигурации 1С, структуры обмена, текущих проблем |
1–2 дня |
| Проектирование схемы |
Согласование набора данных (товары, цены, заказы) и архитектуры |
2–5 дней |
| Реализация стандартного обмена |
Настройка CommerceML, пакетного режима, привязки по артикулу |
1–2 недели |
| Расширенная интеграция |
Кастомный REST, мультисклад, множественные цены, частичная отгрузка |
2–4 недели |
| Полная кастомная связка |
1С + сайт + Битрикс24, асинхронные очереди, мониторинг |
1–2 месяца |
Результат работы включает: документированную схему обмена, настроенные сценарии синхронизации, дашборд мониторинга, обучение операторов и гарантийную поддержку после запуска. Стоимость рассчитывается индивидуально — она зависит от сложности конфигурации 1С, объёма каталога и необходимой степени автоматизации. Оценим ваш проект за 1 день — пишите, обсудим. Закажите интеграцию — получите стабильный обмен за 1–2 недели.
Мы провели более 50 интеграций 1С для интернет-магазинов и производственных компаний. Средний опыт команды — 7 лет, у нас есть сертифицированные специалисты 1С-Битрикс. Наш опыт гарантирует, что обмен не сломается в первый же месяц и будет стабильно работать годами. Например, на проекте с каталогом 50 000 товаров автоматизация обмена сэкономила клиенту около 200 000 рублей в год на операционных затратах.
Свяжитесь с нами для бесплатного аудита вашей конфигурации 1С — найдём узкие места и предложим оптимальное решение.