Каталог товаров в формате JSON
Чтобы добавить в сервис Едадил каталог товаров в формате JSON, подготовьте файл выгрузки одного из типов:
-
Каталог с полным описанием.
Формат для товарных предложений с изображениями и полным описанием акции. -
Упрощенный формат, который не требует описания акции и загрузки изображений: достаточно передать штрихкод и цену товара.
-
Каталог онлайн-магазина.
Формат каталога для онлайн-магазинов.
Ссылку на файл выгрузки передайте в Яндекс через форму обратной связи.
Рекомендации по работе с файлами выгрузки JSON
Формат JSON позволяет составить несколько каталогов акционных товаров, которые имеют разные сроки действия или действуют в разных регионах.
-
В одном файле выгрузки можно передать несколько каталогов, которые имеют разные сроки действия или действуют в разных регионах.
-
В файле выгрузки могут присутствовать каталоги, которые действуют в настоящий момент или начнут действовать в ближайшем будущем — наши модераторы смогут заранее проверить каталог, и он появится в приложении, когда начнется его срок действия.
-
Если в файле выгрузки присутствует каталог, срок действия которого прошел, это допустимо. Но такой каталог увеличивает размер файла, на его обработку тратятся вычислительные ресурсы.
-
Чтобы отредактировать каталог товаров или добавить новый, следуйте рекомендациям в разделе Изменить или добавить каталог товаров.
Важно
Если в течение срока действия каталога передать файл выгрузки, который содержит каталог с тем же идентификатором (параметр
id
) и другим составом предложений, существующий каталог будет перезаписан. В приложении Едадил будет отображаться последняя загруженная версия каталога.
Требования к файлу JSON
- Файл должен иметь кодировку UTF-8.
- Если в значениях параметров есть кавычки, их нужно экранировать с помощью обратной косой черты:
\"
. - Файл не должен содержать синтаксических ошибок. Синтаксис можно проверить в любом JSON-валидаторе, например https://jsonlint.com/.
Валидность формата данных можно поверить на странице Валидатора. Чтобы получить доступ к странице, напишите нам через форму обратной связи.
Структура файла
Файл выгрузки в формате JSON содержит 3 основных элемента:
{
"catalogs": [
Объекты, описывающие каталоги акционных товаров.
],
"offers": [
Объекты, описывающие акционные товары.
],
"version": 2
}
Параметр |
Тип |
Описание |
Обязательность |
|
array of objects |
Список каталогов с акционными товарами. |
Обязательный |
|
array of objects |
Список акционных товаров, которые содержатся в каталогах. |
Обязательный |
|
int |
Версия формата данных в файле выгрузки. Допустимое значение: |
Обязательный |