Документация Сотбит: Маркетплейс. Работа с товарами. Импорт товаров. Импорт товаров из фида
Импорт товаров из фида
Импорт товаров через товарный фид
Товарный фид – это специальный файл, в котором содержится информация об ассортименте товаров поставщика, который обновляется по мере необходимости. В решении предусмотрена возможность загрузки товарных фидов с указанием ссылки на загрузку файла в интернете или посредством 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 запрос.
Обработка товарных фидов
После получения товарного фида система ставит файл в очередь на обработку. Отслеживание статуса и ошибок обработки фидов Поставщик может производить в таблице на странице Импорт товаров > Загрузка по фиду.
Параметры таблицы обработки фидов
|
Поле
|
Описание
|
|
Номер импорта
|
Номер по порядку загруженного файла.
|
|
Дата загрузки
|
Дата и время загрузки файла на сервер.
|
|
Название файла
|
Название файла.
|
|
Тип файла
|
Отображается тип шаблона фида (Обновление или Добавление)
|
|
Статус
|
Отображается статус обработки файла (В процессе / Завершено)
|
|
Всего/ Обработано / С ошибкой
|
Отображается, через символ слэш, количество товаров в файле, количество обработанный товаров, количество товаров, которые не были обработаны из-за ошибки.
Для просмотра списка товаров с ошибками можно нажать на иконку справка.
.
 |
|
Ошибка файла
|
Выводится текст ошибки обработки файла.
|
Свяжитесь с нами
Заполните простую форму, чтобы обсудить ваш проект