Выгрузка товаров в YML для Яндекс Маркета и ВКонтакте

YML — это стандартный формат файла-каталога, который понимают Яндекс Маркет, ВКонтакте и многие другие площадки и сервисы сравнения цен. Addshop собирает такой файл из вашего каталога сам и выдаёт на него постоянную ссылку. Вы один раз вставляете ссылку на площадке, а дальше площадка сама регулярно забирает файл и обновляет товары, цены и наличие. Ничего выгружать вручную не нужно: файл всегда собирается из текущего состояния каталога в момент обращения.

Вы можете создать интернет магазин за 1 вечер. Просто выберите готовый шаблон интернет магазина и установите его. Останется только наполнить его своими товарами.

Что понадобится

• Любой тариф Addshop, кроме бесплатного Free. На тарифе Free выгрузки на площадки отключены, и ссылка отвечает «страница не найдена».
• Включённые товары с ценой больше нуля.
• Аккаунт продавца на Яндекс Маркете или сообщество ВКонтакте с включёнными товарами.
• Желательно — заполненные категории, производители, артикулы, фото и описания: чем полнее карточка на сайте, тем полнее она на площадке.

Шаг 1. Получите ссылку в Addshop

Откройте Настройки → Интеграции и нажмите плитку YML или плитку «ВКонтакте Товары» — обе ведут на одну страницу Яндекс.Маркет.

На странице есть поле со ссылкой вида https://ваш-домен/yml_набор-символов.xml и кнопка Скопировать ссылку. После нажатия появится уведомление «Ссылка скопирована». Других настроек у выгрузки нет — её содержимое целиком определяется каталогом.

Ссылка подписана секретным ключом: угадать её по номеру магазина нельзя. Не публикуйте её открыто, если не хотите, чтобы кто-то забирал ваш каталог целиком.

Если вы видите сообщение «Ссылка на выгрузку изменилась»

Раньше ссылка строилась по другому правилу. Если на странице есть надпись «Ссылка на выгрузку изменилась… прежняя работает до …», значит вы, возможно, уже вставляли старую ссылку на площадке. Замените её на новую до указанной даты (старые ссылки принимаются до 31 января 2027 года), иначе площадка перестанет получать каталог.

Шаг 2. Вставьте ссылку на площадке

Яндекс Маркет

В кабинете продавца Маркета найдите раздел загрузки товаров (ассортимента) и выберите загрузку прайс-листа или фида по ссылке. Вставьте скопированную ссылку и сохраните. Маркет проверит файл и покажет ошибки, если они есть. Точные названия пунктов меню в кабинете Маркета периодически меняются — ориентируйтесь на слова «прайс-лист», «фид» или «загрузка по ссылке».

Если вы продаёте со своего склада и хотите, чтобы остатки, цены и заказы синхронизировались чаще и точнее, дополнительно подключите Яндекс Маркет через API.

ВКонтакте

В сообществе откройте «Товары» → «Загрузить товары» → «Из YML-файла по ссылке» (так этот путь подсказывает и сама страница в Addshop) и вставьте ссылку. ВКонтакте загрузит товары и будет обновлять их по ссылке.

Что попадает в выгрузку

Какие товары

• Только включённые и не удалённые товары.
• Только варианты с ценой больше нуля. Вариант с нулевой ценой в файл не попадает.
• Каждый вариант товара (сочетание цвета и размера) — отдельное предложение в файле. Варианты одного товара связаны общим номером группы, поэтому площадка может показать их одной карточкой с выбором.

Какие поля

• Название — название товара, к нему через пробел добавляются размер и цвет варианта.
• Ссылка — адрес карточки товара на вашем сайте.
• Цена — цена варианта с учётом скидки товара (в процентах или в рублях).
• Старая цена — передаётся, только если есть скидка: это цена без скидки, площадка покажет её зачёркнутой.
• Валюта — валюта магазина.
• Категория — категория товара. В начале файла передаётся всё дерево категорий магазина с вложенностью.
• Фото — до 5 первых фотографий товара в размере 800 пикселей по ширине.
• Производитель — если у товара указан производитель.
• Модель — сюда записывается артикул варианта, если он заполнен.
• Цвет, Размер — параметры варианта.
• Длина, ширина, высота — габариты товара в миллиметрах, если заполнены.
• Описание — описание товара. Из него убираются скрипты и сложная вёрстка, остаются абзацы, переносы строк, жирный и курсив, списки.

Наличие

Вариант считается в наличии, если у него стоит «без ограничения», или товар отмечен «под заказ», или остаток больше нуля и не меньше минимального количества в заказе. Остальные варианты попадают в файл с отметкой «нет в наличии» — площадка покажет их недоступными, но не удалит.

Что не переносится

• Выключенные товары и варианты без цены.
• Фото сверх пятого.
• Свойства товара из фильтров (кроме цвета, размера и габаритов).
• Остатки в штуках — в YML передаётся только «есть» или «нет». Точные остатки на Маркет можно передавать через API.
• Заказы. Заказы с Маркета загружаются только через API, а с ВКонтакте — не загружаются.

Обновление выгрузки

Файл не хранится заранее, а собирается заново при каждом обращении. Поменяли цену, фото или описание на сайте — при следующем обращении площадки она получит уже новые данные. Как часто площадка забирает файл, решает она сама. Если нужно быстрее, в кабинете площадки обычно есть кнопка повторной проверки или загрузки.

Номер предложения в файле — это внутренний номер варианта на сайте. Он не меняется, пока вы не удалите вариант. Если удалить вариант и создать заново, для площадки это будет новый товар.

Как проверить

1. Скопируйте ссылку и откройте её в браузере. Должен открыться XML-файл, начинающийся с каталога и названия вашего магазина.
2. Найдите в файле знакомый товар (поиск по странице) и проверьте цену, название и наличие.
3. Проверьте, что у товара есть фото: адреса картинок можно открыть в отдельной вкладке.
4. Посмотрите отчёт о проверке файла в кабинете Маркета или ВКонтакте.

Частые проблемы и решения

По ссылке открывается «страница не найдена»

Причины две: магазин на бесплатном тарифе Free, на котором выгрузки отключены, или ссылка старая и срок её действия истёк. Перейдите на другой тариф или скопируйте актуальную ссылку со страницы YML.

Товара нет в выгрузке

Проверьте, что товар включён, не удалён и у его вариантов цена больше нуля. Варианты с нулевой ценой не выгружаются.

Товар выгружается как «нет в наличии»

Остаток варианта равен нулю или меньше минимального количества в заказе. Укажите остаток, включите «без ограничения» или «под заказ».

Площадка ругается на отсутствие фото

У товара нет загруженных изображений. Добавьте фото в карточку товара — в выгрузку пойдут первые пять.

Неправильная цена или нет зачёркнутой цены

В выгрузку идёт цена со скидкой товара. Старая цена появляется только при скидке. Проверьте поля цены варианта и скидки товара.

Маркет не сопоставляет товары с API-обменом

В YML номер предложения — внутренний номер варианта, а API ищет товары по артикулу. Если вы используете оба способа, приведите SKU в кабинете Маркета к артикулам сайта.

Вопросы и ответы

Можно ли выгрузить на Маркет только часть товаров?

Отдельного выбора товаров для YML нет — выгружаются все включённые товары с ценой. Товар, который не должен попасть на площадки, придётся выключить.

Одна ссылка подходит и для Маркета, и для ВКонтакте?

Да, это одна и та же ссылка. Её можно вставлять и в другие сервисы, которые принимают формат YML.

Ссылка поменяется, если я подключу свой домен?

Ссылка строится от адреса магазина. После смены основного домена скопируйте ссылку заново и обновите её на площадках.

Сколько стоит выгрузка?

Отдельной платы в Addshop нет, выгрузка доступна на всех тарифах, кроме Free. Условия размещения на площадке устанавливает сама площадка.

Как часто обновляются товары на площадке?

Файл всегда актуален в момент запроса, а частоту запросов задаёт площадка.