Настройка XML-импорта и экспорта 1С-Битрикс
Стандартный модуль «Торговый каталог» (catalog) поддерживает обмен с 1С через протокол CommerceML 2.x — XML-файлы с номенклатурой, ценами и остатками. На практике этот механизм ломается в трёх типовых сценариях: кодировка файла не UTF-8, нестандартная структура узлов <Классификатор> от 1С и превышение лимита времени выполнения при файлах больше 50 МБ.
Как работает штатный обмен
Битрикс ожидает файлы строго в формате CommerceML 2.08. Обмен идёт через /bitrix/admin/1c_exchange.php — скрипт-приёмник, который читает сессию обмена из $_SESSION['BX_CML2_IMPORT'] и последовательно обрабатывает чанки через CCatalogImport.
Таблицы, которые затрагивает импорт:
-
b_iblock_element— элементы каталога -
b_catalog_price— цены по типам -
b_catalog_store_product— остатки по складам -
b_iblock_element_property— свойства элементов
Типичные проблемы и их решение
Проблема 1: таймаут при больших файлах
1С выгружает один XML на 200 000 позиций — файл весит 180 МБ. set_time_limit(0) не спасает, если PHP-FPM настроен с request_terminate_timeout. Решение — включить пошаговый режим: в настройках модуля «1С-Битрикс: Управление сайтом → Настройки → Настройки продукта → 1С» выставить «Размер файла для пошаговой обработки» (параметр CATALOG_IMPORT_STEP_SIZE). Битрикс сам разрежет файл на части по SAX-парсеру.
Проблема 2: дубли товаров
Импорт идентифицирует товар по XML-атрибуту Ид из тега <Товар>. Если в 1С сменили GUID номенклатуры, Битрикс создаёт новый элемент. Проверьте поле XML_ID в b_iblock_element — там хранится этот идентификатор. Чиним через прямое обновление или пересвязку через CIBlockElement::Update().
Проблема 3: цены не обновляются
Частая причина — тип цены в 1С называется «Основная», а в Битриксе создан тип «Розничная». Маппинг задаётся в /bitrix/admin/cat_price_type.php. Убедитесь, что XML-тег <ТипЦены><Наименование> совпадает с полем NAME в таблице b_catalog_price_type.
Настройка экспорта из Битрикса в 1С
Для обратного потока (заказы → 1С) работает тот же endpoint с параметром type=sale. Битрикс формирует orders.xml со структурой <Документ>, включающей позиции заказа. Критично проверить, что в настройках обмена включён флаг «Выгружать реализации» и указан нужный статус заказов для выгрузки.
Параметры тонкой настройки через CBitrixComponent bitrix:catalog.import.1c:
IBLOCK_ID — инфоблок каталога
PRICE_TYPE — тип цены по умолчанию
STORE_ID — склад по умолчанию
USE_CML2_DESCRIPTION — брать описание из XML
Таймлайн работ
| Этап | Срок |
|---|---|
| Диагностика текущей схемы обмена | 2–4 часа |
| Настройка маппинга типов цен и складов | 3–6 часов |
| Настройка пошагового импорта | 2–4 часа |
| Тестовый прогон + отладка | 4–8 часов |
Полная настройка под нестандартную структуру 1С занимает 1–2 рабочих дня. Если нужна кастомная обработка событий OnSuccessCatalogImport или OnBeforeCatalogImport — добавляйте ещё день на разработку обработчика.