IVO
Назад в центр помощи
Интеграция мерчанта

Формат товарного фида

Поддерживаемые форматы JSON, XML и CSV, сопоставление полей, изображения, значения по умолчанию и варианты.

Поддерживаемые URL фидов

IVO может читать товарные фиды по публичному URL в формате JSON, XML, Google Shopping RSS/XML или CSV. URL должен напрямую возвращать содержимое фида и быть доступен crawler-у IVO.md.

Структура JSON

Фид может быть массивом товаров или объектом со списком товаров, например {"products": [...]}, {"product": [...]}, {"offers": [...]} или вложенным списком. Если структура вложенная, IVO ищет самый большой список товаров.

Структура XML

IVO поддерживает обычные XML-фиды, включая Google Shopping RSS и простые каталоги товаров.

Структура CSV

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

Обязательные поля

Минимально обязательные поля: name и price. Валюта может быть частью цены, отдельным полем currency или значением по умолчанию.

Сопоставление полей

В предпросмотре интеграции IVO показывает все ключи из фида. Назначьте каждый ключ нужному полю IVO. Несколько ключей можно назначить одному полю. Для текстовых полей, например name или description, значения объединяются. Для image собираются все валидные URL изображений.

Изображения

Используйте одно целевое поле: image. Можно сопоставить ключи image, images, image_1, image_2, image_link или gallery. Массивы URL изображений поддерживаются.

Значения по умолчанию

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

Варианты

Для характеристик вариантов сопоставляйте только явные измерения, например color, size, memory или display, с variant_option. Несколько исходных ключей можно сопоставить с variant_option.

{
  "name": "Laptop 14 Ultra / 32GB / Silver",
  "price": 15999,
  "variant_option": ["memory:32GB", "color:Silver"]
}

Если фид уже содержит надежный item_group_id, IVO может прочитать его внутренне, но не будет определять его автоматически, потому что ошибочная группировка может объединить разные товары как варианты.

Идентификация crawler-а

Запросы к фиду используют этот User-Agent:

IVO.md (+https://ivo.md/help/merchant-integration/ivo-md-crawler)

Была ли эта статья полезной?

Поделитесь короткой обратной связью, чтобы мы улучшили статью.

Похожие статьи

Интеграция мерчанта

Справочник Merchant API

Полный справочник Merchant API: аутентификация, все эндпоинты и значение каждого поля запроса и ответа.

Интеграция мерчанта

Расширения: как они работают

Общий обзор того, как расширения IVO устанавливаются, авторизуются, синхронизируют данные и показывают статус.

Интеграция мерчанта

Расширение Magento 2: установка

Установите расширение Magento 2 для IVO Marketplace и подключите магазин к IVO.

Интеграция мерчанта

Расширение OpenCart 4: установка

Установите расширение OpenCart для IVO Marketplace и подключите магазин к IVO.