Объекты массива offers

Массив offers содержит список объектов с параметрами акционных товаров, которые присутствуют в каталогах.

Ограничение

Описание товара должно быть уникальным.

В каталог нельзя добавлять один и тот же товар с разными параметрами, например ценой или датами акции. Иначе в приложении и на сайте такие товары будут объединены в один.

Если для товара нужно добавить несколько акций с разными сроками действия, создайте отдельные каталоги и добавьте в них этот товар с разными датами начала и окончания акций.

Пример

   {
      "barcode": "7501031311309",
      "date_end": "2020-06-10",
      "date_start": "2020-06-05",
      "description": "Молоко \"Домик в деревне\" 3,2% 0,93 л",
      "discount_label": "1+1",
      "id": "11111",
      "image": "https://retailer1234.ru/offers/1234567.jpg",
      "price_is_from": false,
      "price_new": 50,
      "price_old": 100
    }

Описание параметров

Параметр

Тип

Описание

Обязательность

id

string

Идентификатор товара в каталоге со стороны сети.

Требования к идентификатору:

  • максимальная длина — 32 символа;

  • содержит только буквы и цифры из кодировки ACSII;

  • уникален в пределах одного файла выгрузки.

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

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

barcode

string

Штрихкод товара. Служит для получения дополнительной информации из базы товаров сервиса Едадил.

Необязательный

description

string

Описание акционного товара. Должно содержать:

  • Категорию товара, например Молоко.
  • Бренд, например \"Домик в деревне\".
  • Количество — вес, объем или количество штук.

Нельзя использовать одинаковое описание для разных товаров.

В описании запрещено неоправданное использование сокращений и заглавных букв.

Примечание

Не следует добавлять в описание товара условия акции после символа «звездочка», такой формат записи больше не поддерживается.
Укажите условия акции в описании каталога или в параметре discount_label.

Примеры корректного заполнения параметра description:

Описание содержит вес товара

Горошек зеленый Принцесса вкуса ж/б 310 г

Грудка куриная Наша птичка охлаждённая, 1 кг

Эскимо Магия холода в ассортименте 65 г

Шоколад Аленка 60 г

Яблоки Гренни 1 кг

Описание содержит количество единиц и вес товара

Печенье глазированное CHOCO PIE 12 шт. 336 г

Чистящее средство для унитаза Bref Сила-Актив Свежесть Лаванды 3*50 г

Блок для унитаза Bref Сила-Актив Океанский Бриз 4 в 1 3х50 г

Чай Майский Отборный черный 100*2 г

Чай Curtis Sunny Lemon черный листовой 20 пирамидок по 1.7 г

Описание содержит объем

Масло подсолнечное рафинированное Олейна 1 л

Пиво Хайнекен 5% 0,5 л стеклянная бутылка

Банка стеклянная 1500 мл

Товар имеет несколько разновидностей с разным весом

Например, нужно добавить описание для стейка, который имеет две разновидности. Такое описание будет некорректно:

«Стейк Мираторг из мраморной говядины охлаждённый - Оливер, 470 г - Топ Блед, 300 г»

В этом случае следует оформить предложение как два отдельных товара:

  • Стейк Мираторг из мраморной говядины охлаждённый - Оливер, 470 г
  • Стейк Мираторг из мраморной говядины охлаждённый - Топ Блед, 300 г
Описание содержит количество упаковок и количество товара в упаковке

Подгузники-трусики YokoSun М (6-10 кг) 3 пачки * 58 шт

Подгузники-трусики YokoSun М (6-10 кг) 3 пачки по 58 шт

Подгузники-трусики YokoSun М (6-10 кг) 3 пачки х 58 шт

Подгузники-трусики YokoSun М (6-10 кг) 3 упаковки х 58 шт

Подгузники-трусики YokoSun М (6-10 кг) 3 упаковки * 58 шт

Подгузники-трусики YokoSun М (6-10 кг) 3 упаковки по 58 шт

Примечание

В итоговом описании товара в приложении количество будет указано в штуках.

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

image

string

Ссылка на файл с изображением товара.

Требования к размещению изображения:

  • Ссылка на изображение должна иметь формат корректного URI. Hапример: https://retailer1234.ru/catalogs/1234.jpg.
  • Изображение не должно быть размещено на публичных ресурсах, таких как альбом в ВК, Яндекс Диск, Dropbox и так далее.
  • Изображение должно быть доступно по портам 80, 443 или 8080.
  • В ответ на запрос GET или HEAD в заголовке content-type сервер должен возвращать значение image/png или image/jpeg.

Требования к изображению:

  • Формат: файлы с расширением .jpg, .jpeg, .png или .webp.

  • Минимальный размер изображения 400×400 точек.

  • Размер файла не более 1 МБ.

  • Изображение PNG должно иметь непрозрачный фон.

  • Изображение не должно иметь водяных знаков.

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

price_old

float

Розничная цена до начала акции («старая цена»). Не должна быть меньше розничной цены по акции price_new.

Скидка на товар в процентах будет рассчитана автоматически, если указаны параметры price_new и price_old.

Примечание

Параметры discount и discount_unit больше не используются.

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

Необязательный

price_new

float

Розничная цена по акции. Не должна быть больше «старой цены» price_old (если она указана).

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

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

price_is_from

boolean

Признак начальной акционной цены («цена от»). Допустимые значения: true, false.

Необязательный

discount_label

string

Короткое описание акции. Допустимы значения не длиннее 12 символов, удовлетворяющие следующим шаблонам (числа можно менять в соответствии с условиями акции):

  • По карте
  • Заказ онлайн (для онлайн-магазинов)
  • 1+1
  • 2 по цене 1
  • 2=1
  • От 2 шт
  • Кратно 2 шт

Помимо короткого описания акции, добавьте подробные условия акции в описание каталога.

Необязательный

date_start

string

Дата начала действия акции на товар в формате ГГГГ-ММ-ДД. Заполняется в случае, если даты действия акции не совпадают с датами действия каталога. Должна быть не позже даты окончания действия акции на товар.

Например: "2020-06-05"

Даты начала и окончания акции на товар (при их указании) не должны выходить за пределы дат действия каталога.

Необязательный

date_end

string

Дата окончания действия акции на товар в формате ГГГГ-ММ-ДД. Заполняется в случае, если даты действия акции не совпадают с датами действия каталога. Должна быть не раньше даты начала действия акции на товар.

Например: "2020-06-12"

Даты начала и окончания акции на товар (при их указании) не должны выходить за пределы дат действия каталога.

Необязательный

Написать в службу поддержки