Интеграция по API

Инструкция по компоновке фида

Зачем нужен фид от вас?

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

Требования к фиду

Общую информацию можно посмотреть по данной ссылке: https://yandex.ru/support/partnermarket/export/yml.html.

Наши специфические требования заключаются в следующем:

  1. Фид должен быть доступен по ссылке, предоставляемой клиентом;
  2. Фид не должен быть заархивирован;
  3. Фид не должен быть защищен паролем;
  4. Фид должен содержать все товары;
  5. Каждый offer должен иметь атрибут available, который принимает одно из двух значений: true (товар в наличии) или false (товар не в наличии/под заказ);
  6. Товары, находящиеся в статусе «не в наличии» более 30 дней, можно удалять из фида;
  7. При обновлении фида важно передавать по ссылке весь фид целиком, а не только обновленные товары;
  8. Важно передавать фид по прямой ссылке, без использования редиректа.

Описание параметров в фиде

В фиде нас интересуют следующие теги:

  1. Теги <category> в родительском блоке <categories> (до <offers>). Иерархия каталога в фиде должна совпадать с иерархией на сайте. id категорий должен совпадать с id, который мы можем забрать посредством трекинга с соответствующей категорийной страницы на сайте. Желательно, но не обязательно если категория будет иметь атрибут url со ссылкой на нее.
  2. Все теги <offer>, внутри которых:
  • <name> — имя, которое мы распарсим себе в базу для дальнейшего использования. Допускается (но не рекомендуется) отсутствие тега <name>; в таком случае имя составляется из тегов <typePrefix> + <vendor> + <model>. При отсутствии одного из перечисленных тегов, имя составляется из других доступных. Порядок неизменяем, после парсинга имя неконфигурируемо;
  • <url> — ссылка на товар;
  • <price> — текущая цена на товар;
  • <vendor> — бренд товара;
  • <picture> — картинка товара;
  • <categoryId> — id категории товара. При наличии нескольких категорий их нужно обернуть в тег <categories>. Товар надо присвоить только к самой конечной (дочерней) категории (ям), не нужно присваивать его во все родительские.

Дополнительная проверка готового фида

Мы настоятельно рекомендуем дополнительно проверять готовый фид в валидаторе, например на https://codebeautify.org/xmlvalidator.

Пример готового фида https://taigaclothing.ru/files/yml.xml.