Парсинг YML-фидов для импорта товаров в 1С-Битрикс

Парсинг YML-фидов для импорта товаров в 1С-Битрикс

Поставщик прислал YML-файл на 50 000 товаров — а в Битрикс нужно загрузить всё за выходные. Стандартные инструменты не справляются: кривая кодировка, пропущенные категории, дубли офферов и таймауты при загрузке картинок. Мы автоматизируем этот процесс так, чтобы вы забыли о ручном импорте. За 10+ лет работы с Битрикс мы обработали более 500 000 товаров через YML-фиды и наработали проверенные решения, которые экономят до 70% времени на каждом импорте.

Почему YML лучше Excel для импорта?

Excel-файлы от поставщиков часто содержат объединённые ячейки, макросы, нестандартные форматы дат и валют. YML (спецификация YML) — это строгий XML-формат, задокументированный и легко парсимый. Он поддерживает иерархию категорий, множественные изображения, характеристики и признак наличия. В отличие от Excel, YML не требует ручных преобразований и позволяет полностью автоматизировать импорт.

Структура YML-фида

YML — это XML-формат для товарных фидов от Яндекса. Поставщики часто предоставляют именно YML: структура задокументирована, данных достаточно для полноценного импорта. Это проще, чем парсить произвольный Excel, но своих нюансов хватает.

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">
<yml_catalog date="2025-03-15 10:30">
  <shop>
    <name>Название магазина</name>
    <currencies>
      <currency id="RUR" rate="1"/>
    </currencies>
    <categories>
      <category id="1">Электроника</category>
      <category id="2" parentId="1">Смартфоны</category>
    </categories>
    <offers>
      <offer id="12345" available="true">
        <url>https://shop.ru/product/12345</url>
        <price>29990</price>
        <currencyId>RUR</currencyId>
        <categoryId>2</categoryId>
        <picture>https://shop.ru/img/12345.jpg</picture>
        <name>Смартфон Samsung Galaxy A54</name>
        <vendor>Samsung</vendor>
        <vendorCode>SM-A546</vendorCode>
        <description>Описание товара</description>
        <param name="Цвет">Чёрный</param>
        <param name="Объём памяти">128 ГБ</param>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Ключевые элементы: offer id — уникальный идентификатор (аналог XML_ID в Битрикс), available — признак наличия, categoryId — ссылка на категорию, param — произвольные характеристики.

Парсинг категорий и построение дерева

Категории в YML образуют иерархию через атрибут parentId. При импорте нужно создать соответствующую структуру разделов в инфоблоке. Алгоритм:

1. Загрузить все категории в ассоциативный массив [id => ['name' => ..., 'parentId' => ...]].
2. Рекурсивно построить дерево.
3. Для каждой категории: найти раздел по XML_ID = 'yml_cat_{id}' или создать новый.
4. Сохранить маппинг [yml_id => bitrix_section_id].

$sectionId = CIBlockSection::GetList(
    [],
    ['IBLOCK_ID' => $iblockId, 'XML_ID' => 'yml_cat_' . $cat['id']],
    false,
    ['ID']
)->Fetch()['ID'];

if (!$sectionId) {
    $bs = new CIBlockSection();
    $sectionId = $bs->Add([
        'IBLOCK_ID' => $iblockId,
        'XML_ID'    => 'yml_cat_' . $cat['id'],
        'NAME'      => $cat['name'],
        'IBLOCK_SECTION_ID' => $parentBitrixId,
        'ACTIVE'    => 'Y',
    ]);
}

Импорт товаров (offers) и работа с изображениями

Основной цикл обработки — обход всех офферов в XML. Для каждого создаётся или обновляется элемент инфоблока. Особое внимание — загрузка изображений: при фиде на 10 000 товаров это 10 000 HTTP-запросов. Мы используем проверку хэша URL и параллельную загрузку через агенты, чтобы сократить время в 3–5 раз.

foreach ($xml->shop->offers->offer as $offer) {
    $xmlId = (string)$offer['id'];
    $available = (string)$offer['available'] === 'true';

    $params = [];
    foreach ($offer->param as $param) {
        $params[(string)$param['name']] = (string)$param;
    }

    $fields = [
        'IBLOCK_ID'         => $iblockId,
        'NAME'              => (string)$offer->name,
        'XML_ID'            => $xmlId,
        'ACTIVE'            => $available ? 'Y' : 'N',
        'IBLOCK_SECTION_ID' => $sectionMap[(string)$offer->categoryId] ?? null,
        'PROPERTY_VALUES'   => [
            'VENDOR'  => (string)$offer->vendor,
            'ARTICLE' => (string)$offer->vendorCode,
        ],
    ];

    $existId = getElementByXmlId($xmlId, $iblockId);
    $el = new CIBlockElement();
    if ($existId) {
        $el->Update($existId, $fields);
    } else {
        $el->Add($fields);
    }
    updatePrice($existId ?: $el->LAST_ID, (float)$offer->price);
}

Какие типы офферов поддерживает YML?

YML различает несколько типов, каждый со своими обязательными полями:

На практике 80% поставщиков используют простой тип. Специфические типы требуют дополнительного маппинга свойств.

Как ускорить импорт товаров с изображениями?

Изображения — самое узкое место. Наш подход: перед скачиванием сравниваем хэш URL с предыдущим импортом (храним в свойстве). Если URL не изменился — изображение не загружаем. Для новых товаров — фоновые агенты с ограничением 5 одновременных потоков. Это экономит до 70% времени на партии из 50 000 товаров.

Типичные ошибки при парсинге и как их избежать

• Проблема с кодировкой — YML приходит в UTF-8, а Битрикс может ожидать windows-1251. Решение: конвертация через iconv() перед парсингом.
• Отсутствующие категории — когда в YML указан categoryId, которого нет в блоке категорий. Решение: создавать отсутствующие категории с пометкой «Временная».
• Дубли офферов — несколько записей с одинаковым id. Решение: использовать XML_ID и проверять наличие перед добавлением.

Пример из практики

Недавно настроили импорт для интернет-магазина электроники — 30 000 товаров от 5 поставщиков. Основная проблема: разные схемы категорий (у одного — вложенность 2 уровня, у другого — 4). Решили через промежуточный маппинг: таблица-словарь в HL-блоке. За 4 дня разработали универсальную обвязку, которая сейчас обновляет каталог ежедневно по Cron.

Что входит в работу

Сроки разработки

Под ключ разрабатываем как простые интеграции, так и сложные мульти-фиды. Хотите настроить парсинг YML под свой магазин? Свяжитесь — оценим проект за 1 день. Гарантируем качество и соблюдение сроков. Закажите парсинг YML — и забудьте о ручном импорте навсегда.