Каталог товаров в формате JSON

  1. Рекомендации по работе с файлами выгрузки JSON
  2. Требования к файлу JSON
  3. Структура файла

Чтобы добавить в сервис Едадил каталог товаров в формате JSON, подготовьте файл выгрузки одного из типов:

Ссылку на файл выгрузки передайте в Яндекс через форму обратной связи.

Рекомендации по работе с файлами выгрузки JSON

Формат JSON позволяет составить несколько каталогов акционных товаров, которые имеют разные сроки действия или действуют в разных регионах.

  • В одном файле выгрузки можно передать несколько каталогов, которые имеют разные сроки действия или действуют в разных регионах.
  • В файле выгрузки могут присутствовать каталоги, которые действуют в настоящий момент или начнут действовать в ближайшем будущем — наши модераторы смогут заранее проверить каталог, и он появится в приложении, когда начнется его срок действия.
  • Если в файле выгрузки присутствует каталог, срок действия которого прошел, это допустимо. Но такой каталог увеличивает размер файла, на его обработку тратятся вычислительные ресурсы.
  • Чтобы отредактировать каталог товаров или добавить новый, следуйте рекомендациям в разделе Изменить или добавить каталог товаров.

    Важно.

    Если в течение срока действия каталога передать файл выгрузки, который содержит каталог с тем же идентификатором (параметр id) и другим составом предложений, существующий каталог будет перезаписан. В приложении Едадил будет отображаться последняя загруженная версия каталога.

Требования к файлу JSON

  • Файл должен иметь кодировку UTF-8.
  • Если в значениях параметров есть кавычки, их нужно экранировать с помощью обратной косой черты: \".
  • Файл не должен содержать синтаксических ошибок. Синтаксис можно проверить в любом JSON-валидаторе, например https://jsonlint.com.

Валидность формата данных можно поверить на странице Валидатора. Чтобы получить доступ к странице, напишите нам через форму обратной связи.

Структура файла

Файл выгрузки в формате JSON содержит 3 основных элемента:

{
  "catalogs": [
    Объекты, описывающие каталоги акционных товаров.
  ],
  "offers": [
    Объекты, описывающие акционные товары.
  ],
  "version": 2
}
Параметр Тип Описание Обязательность
catalogs array of objects

Список каталогов с акционными товарами.

Обязательный
offers array of objects

Список акционных товаров, которые содержатся в каталогах.

Обязательный
version int

Версия формата данных в файле выгрузки.

Допустимое значение: 2.

Обязательный