Документация Сотбит: Маркетплейс. Работа с товарами. Импорт товаров. Импорт товаров из фида
Импорт товаров из фида
Импорт товаров через товарный фид
Товарный фид – это специальный файл, в котором содержится информация об ассортименте товаров поставщика, который обновляется по мере необходимости. В решении предусмотрена возможность загрузки товарных фидов с указанием ссылки на загрузку файла в интернете или посредством API запроса к площадке.
Импорт товаров через товарный фид Поставщиком осуществляется из раздела: Импорт товаров > Загрузка по фиду.
Для товарного фида поддерживаются форматы XML или Excel.
Шаблоны с фидами разделяются на:
Шаблон на добавление— добавление новых товаров или обновление значений свойств, цен и остатков товаров.
Шаблон на обновление— обновления только цен и остатков ранее созданных товаров.
Шаблон на обновление — это облегченная версия шаблона, созданная для более быстрой обработки товаров. Поставщики могут работать как с одним удобным для них шаблоном, так и с двумя одновременно.
Загрузка по ссылке
Для обновления или изменения товаров через ссылку необходимо:
Скачать необходимый шаблон (на обновление товаров или на добавление) товарного фида.
Подготовить товарный фид.
Загрузить товарный фид в интернет.
Перейти на вкладку Загрузка по ссылке.
Указать публичную ссылку на загрузку файла в соответствующее шаблону поле.
Нажать кнопку Сохранить.
Система автоматически будет скачивать товарный фид по указанной ссылке и вносить изменения в товары.
Параметры скачивания и обработки товарных фидов устанавливаются Администратором на странице Настройки > [id сайта] Сотбит: Маркетплейc > Загрузка по фиду.
Загрузка по API
Для загрузки товарного фида по API используются HTTP POST запросы.
Виды запросов:
На обновление цен и остатков товаров – [адрес сайта]/marketplace_api/product/update
На добавление или изменение товаров –[адрес сайта]/marketplace_api/product/add
Авторизация поставщика происходит по API ключу, который необходимо указывать в заголовке запроса.
Для каждого поставщика в системе создается свой API ключ. Сгенерированный API ключ необходимо указывать в каждом API запросе. Если необходима перегенерация API ключа необходимо нажать на кнопку Сгенерировать ключ на странице Импорт товаров > Загрузка по фиду > Загрузка по API.
При загрузке по API товарный фид может быть представлен в формате:
Полное содержимое XML файла
Формат запроса - application/xml
Содержимое файла Excel в формате base64
Формат запроса - text/plain
Ссылка на загрузку файла
Формат запроса - text/plain
Для обновления, или изменения товаров посредством API запроса необходимо:
Скачать необходимый шаблон товарного фида (на обновление товаров или на добавление).
Подготовить товарный фид.
Скопировать API ключ.
Указать адрес запроса на добавление или обновление товаров.
Указать в заголовке запроса API ключ.
Указать в теле запроса значение выбранного формата товарного фида.
Направить API запрос.
Обработка товарных фидов
После получения товарного фида система ставит файл в очередь на обработку. Отслеживание статуса и ошибок обработки фидов Поставщик может производить в таблице на странице Импорт товаров > Загрузка по фиду.
Параметры таблицы обработки фидов
Поле
Описание
Номер импорта
Номер по порядку загруженного файла.
Дата загрузки
Дата и время загрузки файла на сервер.
Название файла
Название файла.
Тип файла
Отображается тип шаблона фида (Обновление или Добавление)
Статус
Отображается статус обработки файла (В процессе / Завершено)
Всего/ Обработано / С ошибкой
Отображается, через символ слэш, количество товаров в файле, количество обработанный товаров, количество товаров, которые не были обработаны из-за ошибки.
Для просмотра списка товаров с ошибками можно нажать на иконку справка.
