Пакетное создание товаров в виде файла


   

Для пакетного создания товаров необходимо подготовить файл с данными о товарах и разместить его на вашем сайте или внешнем сервисе по URL, который будет доступен Торговой площадке Ozon.RU.

Кроме того, возможна загрузка локальных файлов (расположенных на вашем компьютере) через пользовательский интерфейс в личном кабинете на merchants.ozon.ru.

Общая схема подготовки и отправки на обработку файла с товарами с помощью Merchants API приведена ниже.

Последовательность вызовов

  1. Авторизация и получение токена: GET https://api.ozon.ru/auth/token/merchants
    1. В заголовке запроса должны быть переданы идентификатор (x-ApplicationId), подпись запроса (x-Sign) и номер версии (X-ApiVersion: 0.1).
    2. В ответе возвращается значение токена и время его жизни в секундах. Значение токена необходимо сохранить для использования при дальнейших обращениях к API.
  2. Получение структуры файла с товарами: GET https://api.ozon.ru/merchants/xsd/products
    1. В заголовке запроса должны быть переданы идентификатор (x-ApplicationId), полученный на предыдущем шаге токен (x-Token) и номер версии (X-ApiVersion: 0.1).
    2. В ответе возвращается XSD с полной структурой файла, за исключением элемента Description.
  3. Получение структуры элемента с описанием товара: GET https://api.ozon.ru/merchants/xsd/description/{id}
    1. В заголовке запроса должны быть переданы идентификатор (x-ApplicationId), токен (x-Token) и номер версии (X-ApiVersion: 0.1).
    2. В качестве {id} необходимо передать код типа товара. Набор разрешенных для работы типов товаров указан в перечислимом типе ProductTypeTable файла XSD, полученного на предыдущем шаге. Структура описания товаров из разных типов различна, поэтому для каждого типа товара, с которым предстоит работать, должна быть запрошена индивидуально.
  4. Формирование файла с товарами.
    1. Файл формируется в формате XML согласно полученным XSD схемам.
    2. Обязательно должны быть указаны атрибуты MerchantSKU и ProductTypeID, а также данные в элементе SKU. Остальные элементы не являются обязательными для создания товара в системе, однако для выставления товара в продажу он обязательно должен иметь описание и, как минимум, заглавное изображение (элемент Picture внутри элемента Description).
    3. Для всех полей, значения которых ограничены справочниками, допустимые значения приведены в XSD файлах.
  5. Размещение файла на ресурсе, доступном Торговой площадке Ozon.RU по URL.
  6. Добавление сформированного файла в очередь на обработку: POST https://api.ozon.ru/merchants/files
    1. В заголовке запроса должны быть переданы идентификатор (x-ApplicationId), токен (x-Token) и номер версии (X-ApiVersion: 0.1).
    2. В теле запроса необходимо передать URL, по которому доступен файл (FileUrl).
    3. В ответе возвращается идентификатор файла в очереди на обработку. Для контроля результата обработки необходимо сохранить это значение (необязательно).
  7. Получение статуса обработки файла: GET https://api.ozon.ru/merchants/jobs/{id}
    1. В заголовке запроса должны быть переданы идентификатор (x-ApplicationId), токен (x-Token) и номер версии (X-ApiVersion: 0.1).
    2. В параметре {id} необходимо передать идентификатор файла, полученный на предыдущем этапе.
    3. В ответе будет возвращена информация о текущем статусе обработки и признак наличия ошибок.
  8. Получение детальной информации об ошибках, возникших во время обработки: GET https://api.ozon.ru/merchants/jobs/{id}/log
    1. В заголовке запроса должны быть переданы идентификатор (x-ApplicationId), токен (x-Token) и номер версии (X-ApiVersion: 0.1).
    2. В параметре {id} необходимо передать идентификатор файла.
    3. В ответе будет возвращен массив результатов обработки. В элементе Entities содержится XML со списком ошибочно обработанных файлов/товаров и информацией об ошибке.