31  /  109

Документация Сотбит: Маркетплейс. Работа с товарами. Импорт товаров. Импорт товаров из фида

Товарный фид – это специальный файл, в котором содержится информация об ассортименте товаров поставщика, который обновляется по мере необходимости. В решении предусмотрена возможность загрузки товарных фидов с указанием ссылки на загрузку файла в интернете или посредством API запроса к площадке.
Импорт товаров через товарный фид Поставщиком осуществляется из раздела: Импорт товаров > Загрузка по фиду.
Раздел содержит настройки для указания ссылок в интернете, по которым будут скачиваться товарные фиды в систему, а также персональный API-ключ поставщика для использования при загрузке фида. Кроме того, раздел включает таблицу с записями обработки загруженных товарных фидов.
В системе поддерживаются несколько способов загрузки товарного фида:

  • по ссылке, указанной поставщиком;

  • путем загрузки товарного фида через API-запрос;

  • путем загрузки товарного фида через API с использованием разрешения 1С.

Для товарного фида поддерживаются форматы XML или Excel.
Шаблоны с фидами разделяются на:
  • Шаблон на добавление — добавление новых товаров или обновление значений свойств, цен и остатков товаров;
  • Шаблон на обновление  — обновления только цен и остатков ранее созданных товаров.
Шаблон на обновление — это облегченная версия шаблона, созданная для более быстрой обработки товаров. Поставщики могут работать как с одним удобным для них шаблоном, так и с двумя одновременно.
Документация Сотбит: Сотбит: Маркетплейс. Импорт товаров из фида. Картинка 1

Загрузка по ссылке

Для обновления или изменения товаров через ссылку необходимо:
  1. Скачать необходимый шаблон (на обновление товаров или на добавление) товарного фида;
  2. Заполнить товарный фид данными;
  3. Загрузить товарный фид в интернет;
  4. Перейти на вкладку Загрузка по ссылке;
  5. Указать публичную ссылку на загрузку файла в соответствующее шаблону поле;
  6. Нажать кнопку Сохранить.
Система автоматически будет скачивать товарный фид по указанной ссылке и вносить изменения в товары.
Подробнее о настройке скачивания и обработки товарных фидов указано в разделе Общие настройки.

Загрузка по API-запросу

Для загрузки товарного фида по API используются HTTP POST запросы.
Виды запросов:
  • На обновление цен и остатков товаров – [адрес сайта]/marketplace_api/product/update;
  • На добавление или изменение товаров – [адрес сайта]/marketplace_api/product/add.
Авторизация поставщика происходит по API ключу, который необходимо указывать в заголовке запроса.
Для каждого поставщика в системе создается свой API ключ. Сгенерированный API ключ необходимо указывать в каждом API запросе. Если необходима перегенерация API ключа необходимо нажать на кнопку Сгенерировать ключ на странице Импорт товаров > Загрузка по фиду > Загрузка по API.
Документация Сотбит: Сотбит: Маркетплейс. Импорт товаров из фида. Картинка 2
При загрузке по API товарный фид может быть представлен в формате:
  • Полное содержимое XML файла;
    Формат запроса - application/xml.
  • Содержимое файла Excel в формате base64;
    Формат запроса - text/plain.
  • Ссылка на загрузку файла;
    Формат запроса - text/plain.
Для обновления, или изменения товаров посредством API запроса необходимо:
  1. Скачать необходимый шаблон товарного фида (на обновление товаров или на добавление);
  2. Заполнить товарный фид;
  3. Скопировать API ключ;
  4. Указать адрес запроса на добавление или обновление товаров;
  5. Указать в заголовке запроса API ключ;
  6. Указать в теле запроса значение выбранного формата товарного фида;
  7. Направить API запрос.

Загрузка по API-запросу с использованием разрешения 1С

Подробная документация по настройки загрузки фида с использованием разрешения 1С доступна по адресу: Документация Сотбит: Синхронизация с Маркетплейс.

Обработка товарных фидов

После получения товарного фида система ставит файл в очередь на обработку. Отслеживание статуса и ошибок обработки фидов Поставщик может производить в таблице на странице Импорт товаров > Загрузка по фиду.
Документация Сотбит: Сотбит: Маркетплейс. Импорт товаров из фида. Картинка 3
Параметры таблицы обработки фидов
Поле
Описание
Номер импорта
Номер по порядку загруженного файла.
Дата загрузки
Дата и время загрузки файла на сервер.
Название файла
Название файла.
Тип файла
Отображается тип шаблона фида (Обновление или Добавление).
Статус
Отображается статус обработки файла (В процессе / Завершено).
Всего / Обработано / С ошибкой
Отображается, через символ слэш, количество товаров в файле, количество обработанный товаров, количество товаров, которые не были обработаны из-за ошибки.
Для просмотра списка товаров с ошибками можно нажать на иконку справка.
.
Документация Сотбит: Сотбит: Маркетплейс. Импорт товаров из фида. Картинка 4
Ошибка файла
Выводится текст ошибки обработки файла.
Описание курса