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