Обновление данных о товаре через фид


Последнее обновление 04 июля 2022
Читать 0 минут

Фид – это документ в формате YML, в котором хранится информация о всех ваших товарах на сайте. В отличие от XLS-шаблона, с его помощью не получится заводить новые позиции, зато фид поможет автоматизировать обновление остатков и цен.

# Как обновляются данные о товаре через фид

С помощь фида вы можете обновить:

  • остатки и цены;
  • только цены;
  • только остатки.

Система обновляет данные по товарам из фида с интервалом от 1 до 5 часов:

  • первая сверка — через час;
  • если отличий от предыдущей версии фида не окажется, промежуток между сверками каждый раз будет увеличиваться на 1 час — пока не достигнет 5 часов.

Когда после сверки в фиде появятся изменения, интервал вернётся к 1 часу. Если данные нужно обновлять мгновенно, рекомендуем использовать Seller API.

Система автоматически выключает фиды, в которых нет ни одного товара из личного кабинета. Чтобы это исправить, заведите товары, добавьте их в файл и включите фид.

# Какие требования к файлам с фидами

Принимаем файлы только в формате YML по протоколам HTTP или HTTPS, перенаправления на другие сайты не поддерживаем — так мы будем уверены, что всё безопасно.

# YML

YML (Yandex Market Language) — это формат файлов на основе XML, разработанный Яндексом. Он предназначен для размещения и передачи данных о товаре на маркетплейсе.

Загрузив YML-файл в систему, вы сможете автоматизировать процесс обновления цен и остатков. Это сэкономит время, потому что вам не нужно будет обновлять данные вручную.

# Протоколы HTTP и HTTPS

Перед отправкой ссылки проверьте, что сайт использует безопасные протоколы http или https — проверить это можно в адресе ссылке.

Для протоколов используем только стандартные порты:

  • 80 — для http;
  • 443 — для https.

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

# Из чего состоит фид

Внешне формат фида напоминает строки кода. Каждая строка содержит поля, в которых хранятся данные о товаре: например, старые и новые цены, артикулы и количество остатков на складе.

<yml_catalog>
    <shop>
        ...
        <offers>
            <offer id="АРТИКУЛ_В_ЛК">
                <price>9760</price>
                <oldprice>10736</oldprice>
                <min_price>8000</min_price>
                <outlets>
                    <outlet instock="10" warehouse_name="склад 1"></outlet>
                    <outlet instock="13" warehouse_name="склад 2"></outlet>
                </outlets>
            </offer>
            ...
        </offers>
    </shop>
</yml_catalog>

Вот что нужно учесть при заполнении фида:

  • поле «warehouse_name» должно полностью совпадать с тем названием, которое указано на странице складов. Если пользуетесь только одним складом, его можно не использовать;
  • если хотите обнулить «oldprice» или «instock», проставьте в них значение 0.

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

Название Описание
offer id Артикул товара на Ozon
(обязательно)
price Цена со скидкой в рублях
(обязательно для обновления цен)
oldprice Цена без скидки в рублях
(опционально)
min_price Минимальная цена в рублях
(опционально)
instock Остаток
(обязательно для обновления остатков)
warehouse_name Название вашего склада в ЛК
(опционально, если у вас только 1 склад)

# Как добавить фид в личном кабинете

Есть два способа:

# Без дополнительных настроек

  1. Откройте раздел Товары и цены → Обновить через фид.
  2. Добавьте в поле ссылку на фид и нажмите Добавить.

# С дополнительными настройками

  1. Откройте раздел раздел Товары и цены → Обновить через фид.
  2. Нажмите ссылку Формой добавления фида под полем для ссылки.
  3. Заполните в открывшемся окне обязательные поля:
    • Название;
    • Ссылка на фид;
    • Что обновлять через этот фид — одно или несколько значений.
  4. Если вы заранее ограничили доступ к фиду, отметьте Фид защищён логином и паролем и укажите логин и пароль, чтобы мы могли получить доступ. На данный момент поддерживается только Basic Auth.
  5. Нажмите Сохранить.

# Как работать с фидами

Для этого откройте раздел Товары и цены → Обновлять через фид. На странице появятся ваши фиды. В строке с нужным файлом нажмите ⋮ и выберите действие:

  • Посмотреть историю — чтобы узнать время загрузки фидов;
  • Редактировать — чтобы изменить фид;
  • Включить обновления и Отключить обновления — чтобы управлять автообновлением;
  • Скачать фид — чтобы загрузить файл на свой компьютер.

# Как исправить ошибки при загрузке фида

Если при загрузке фида возникла ошибка, наведите курсор на её статус — появится подсказка с подробностями.

Также вы можете скачать отчёт об ошибках в формате Excel в разделе:

В отчёте две вкладки: Цены и Остатки, в которых перечислены все ошибки с атрибутами. В строчках прописаны значения:

  • артикул товара — столбец В;
  • информация о характеристиках — цены и остатки;
  • описание ошибки — столбец I в ценах и столбец F в остатках.