YML-фид
Что должно быть в фиде, как часто мы его читаем и как защищено удаление товаров.
Фид — это файл YML (Yandex Market Language) по публичной ссылке. Большинство платформ — 1С-Битрикс, InSales, плагины WooCommerce — уже выгружают его для маркетплейсов; тот же файл подходит и нам.
Как мы его читаем
- Каждые 60 минут. Если ваш сервер отдаёт
ETagилиLast-Modified, проверка неизменённого фида стоит одного короткого запроса. - Ограничения: до 500 МБ, загрузка не дольше 120 секунд, не больше 3 перенаправлений, до 1 000 000 предложений.
- Только публичный адрес. Фиды на адресах внутренней сети не загружаются.
- Кодировка берётся из XML-декларации; фиды в
windows-1251подходят. - Изменения цен и остатков быстро попадают в поиск; изменения названий, описаний и характеристик переиндексируются в том же проходе.
Что мы берём из предложения
| Элемент | Обязателен | Пояснение |
|---|---|---|
<offer id> | да | ID товара у вас. Это externalId, который используется везде |
<offer group_id> | Общий у вариантов одного товара | |
<offer available> | false — нет в наличии; если атрибута нет — в наличии | |
<name> | да | Или <typePrefix> + <vendor> + <model>, собираются как у Яндекса |
<url> | да | Абсолютная ссылка http(s) на страницу товара |
<price> | да | В основных единицах, не больше 2 знаков после запятой |
<oldprice> | Цена до скидки | |
<currencyId> | да | Валюта вашего магазина: RUR или RUB, KZT, UZS, KGS, BYN |
<categoryId> | Ссылка на <categories> в разделе магазина | |
<picture> | Сколько угодно | |
<vendor>, <model> | Бренд и модель | |
<description> | HTML удаляется | |
<param name unit> | Характеристики. Названия и единицы нормализуются для поиска, например «ГБ» и «Gb». Если у товара меньше трёх распознанных характеристик, остальные модель читает из названия и описания; присланный <param> всегда главнее | |
<outlets><outlet id instock> | Остаток по пункту выдачи |
Предложение без обязательного поля, в другой валюте или с некорректной ценой пропускается. В отчёте синхронизации указано каждое пропущенное предложение и причина.
Названий, адресов и часов работы пунктов выдачи в YML нет. Передайте их через PUT /v1/catalog/outlets или вашему контакту в LockStock.
Удаление и защита 30%
Товар, которого нет в фиде, убирается из поиска. Чтобы защитить вас от сломанной выгрузки: если фид убрал бы больше 30% активных товаров, удаление не применяется, и вы получаете предупреждение. Товары, которые есть в фиде, при этом всё равно обновляются. Если товары действительно убраны, например вы переехали на другую платформу и ID сменились, владелец магазина может нажать «Применить всё равно» на странице Каталог в личном кабинете.
Отклонённый фид остаётся отклонённым, пока вы не опубликуете другой: исправьте выгрузку, и следующий проход её применит.