Генерация фида товаров для Яндекс.Маркет (YML)

Генерация фида товаров для Яндекс.Маркет (YML)

YML (Yandex Market Language) — XML-диалект со своими правилами валидации, которые существенно строже стандартного RSS. Яндекс регулярно обновляет требования к категориям: одежда, электроника и автозапчасти имеют расширенные обязательные наборы атрибутов. Неправильно сформированный фид блокирует всю кампанию, а не отдельные позиции.

Форматы передачи данных в Яндекс.Маркет

Яндекс поддерживает два способа:

1. YML-фид — файл по URL, который Яндекс скачивает по расписанию (минимум раз в 24 ч, максимум раз в час)
2. Price API — программный интерфейс для обновления только цен и наличия без полной перегенерации фида

Для большинства магазинов достаточно YML-фида. Price API подключается дополнительно, если цены меняются несколько раз в сутки.

Структура YML-документа

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">
<yml_catalog date="2026-03-28 14:00">
  <shop>
    <name>Название магазина</name>
    <company>ООО Компания</company>
    <url>https://example.com</url>
    <currencies>
      <currency id="RUR" rate="1"/>
    </currencies>
    <categories>
      <category id="10">Смартфоны</category>
      <category id="11" parentId="10">Apple iPhone</category>
    </categories>
    <delivery-options>
      <option cost="299" days="1"/>
    </delivery-options>
    <offers>
      <offer id="12345" available="true">
        <url>https://example.com/products/iphone-15</url>
        <price>89990</price>
        <oldprice>99990</oldprice>
        <currencyId>RUR</currencyId>
        <categoryId>11</categoryId>
        <picture>https://cdn.example.com/iphone-15-1.jpg</picture>
        <picture>https://cdn.example.com/iphone-15-2.jpg</picture>
        <name>Смартфон Apple iPhone 15 128GB черный</name>
        <vendor>Apple</vendor>
        <vendorCode>MTP03LL/A</vendorCode>
        <barcode>0194253401353</barcode>
        <description>Смартфон Apple iPhone 15 с процессором A16...</description>
        <param name="Цвет">Чёрный</param>
        <param name="Встроенная память" unit="ГБ">128</param>
        <param name="Операционная система">iOS</param>
      </offer>
    </offers>
  </shop>
</yml_catalog>

Специфика типов оферов

Яндекс различает несколько типов товарных предложений:

Генератор на PHP

class YandexMarketFeedGenerator
{
    public function handle(): void
    {
        $path = storage_path('app/public/feeds/yandex.xml');
        $writer = new \XMLWriter();
        $writer->openUri($path); // пишем сразу в файл, не в память
        $writer->setIndent(true);
        $writer->startDocument('1.0', 'UTF-8');
        $writer->writeDtd('yml_catalog', null, 'shops.dtd');
        $writer->startElement('yml_catalog');
        $writer->writeAttribute('date', now()->format('Y-m-d H:i'));

        $this->writeShopHeader($writer);
        $this->writeCurrencies($writer);
        $this->writeCategories($writer);
        $this->writeOffers($writer);

        $writer->endElement();
        $writer->endDocument();
        $writer->flush();
    }

    private function writeOffers(\XMLWriter $w): void
    {
        $w->startElement('offers');

        Product::with(['category', 'brand', 'images', 'attributes'])
            ->where('is_active', true)
            ->chunk(500, function ($products) use ($w) {
                foreach ($products as $p) {
                    $w->startElement('offer');
                    $w->writeAttribute('id', $p->sku);
                    $w->writeAttribute('available', $p->stock > 0 ? 'true' : 'false');

                    $w->writeElement('url', route('products.show', $p->slug));
                    $w->writeElement('price', (string) $p->price);
                    if ($p->compare_price > $p->price) {
                        $w->writeElement('oldprice', (string) $p->compare_price);
                    }
                    $w->writeElement('currencyId', 'RUR');
                    $w->writeElement('categoryId', $p->category_id);
                    $w->writeElement('name', $p->name);
                    $w->writeElement('vendor', $p->brand?->name ?? '');
                    $w->writeElement('barcode', $p->barcode ?? '');

                    foreach ($p->images as $img) {
                        $w->writeElement('picture', $img->cdn_url);
                    }

                    foreach ($p->attributes as $attr) {
                        $w->startElement('param');
                        $w->writeAttribute('name', $attr->name);
                        if ($attr->unit) {
                            $w->writeAttribute('unit', $attr->unit);
                        }
                        $w->text($attr->value);
                        $w->endElement();
                    }

                    $w->endElement(); // offer
                }
            });

        $w->endElement(); // offers
    }
}

Настройка обновления

Фид обновляется через Laravel Scheduler:

// app/Console/Kernel.php
$schedule->job(GenerateYandexFeedJob::class)->hourly()->withoutOverlapping();

Файл фида отдаётся через выделенный роут или напрямую из public/feeds/. Если каталог превышает 500 МБ в XML, Яндекс рекомендует дробить фид на несколько файлов и регистрировать каждый отдельно в кабинете.

Диагностика ошибок

Яндекс.Маркет возвращает детальный отчёт по каждому офферу. Наиболее распространённые проблемы:

• Цена равна нулю или отсутствует — товар исключается из индекса автоматически
• Несоответствие цены на сайте — Яндекс сверяет цену в фиде с ценой на странице товара. Разница более 1% блокирует оффер
• Изображение недоступно — проверяется при первичной загрузке и повторно при каждом обходе
• Слишком длинное описание — допустимо 3000 символов для большинства категорий

Сроки

Базовый генератор для стандартного каталога — 2–4 рабочих дня. Сложные категории (одежда с размерной сеткой, электроника с расширенными атрибутами) — 4–6 рабочих дней.