Маркет для производителей

Формат XLS

Если информация об ассортименте на вашем сайте обновляется редко, вам больше подойдет упрощенный способ передачи данных — в формате XLS.

Общие требования к данным в формате XLS

  1. Файл состоит из одного листа.

  2. На листе представлены две таблицы: таблица с описанием категорий и таблица с описанием моделей.

  3. Не допускается использовать символы табуляции и переноса строки.

  4. В таблицах не должно быть пустых столбцов.

Валидация файла

При чтении файла проверяются следующие условия:

  • все названия элементов (столбцов) корректны;

  • присутствуют все обязательные элементы;

  • каждый элемент представлен в таблице один раз;

  • ID категорий и моделей не пересекаются и не повторяются в рамках файла;

  • для каждой модели указан элемент category_id.

При невыполнении любого из этих условий файл отклоняется.

Особенности передачи данных в формате XLS

Производитель обновляет файл XLS каждый раз при выпуске новой модели и размещает его на своем сайте. Робот Маркета регулярно скачивает этот файл с сайта производителя, и обновленные данные автоматически импортируются в базу Яндекс.Маркета.

При передаче XLS-файла необходимо соблюдать Требования к методу передачи данных и Требования к данным.

Описание элементов и пример файла

Скачать пример файла

Таблица с описанием категорий

Заголовок столбца: название элемента

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

Содержимое столбца: описание элемента

Тип

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

Category, Категория или Category/Категория (на ваш выбор).

Пример: Категория.

id

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

Идентификатор категории.

Пример: 2.

parent_id

Обязательный элемент для всех категорий, кроме корневой

Идентификатор родительской категории.

Пример: 1.

name

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

Название категории.

Пример: Электроника.

Таблица с описанием моделей

Заголовок столбца: название элемента

Обязательный / необязательный элемент

Содержимое столбца: описание элемента

Тип

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

Model, Модель или Модель/Model (на ваш выбор).

Пример: Модель.

id

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

Идентификатор модели.

Пример: 34121.

category_id

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

Идентификатор категории.

Пример: 14.

name

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

Название модели.

Пример: Canon EOS 60D Body.

vendorCode

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

Код производителя (артикул). Может дублировать значение элемента name.

Пример: EOS 60D W/O LENS.

promoUrl

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

Ссылка на страницу товара на сайте производителя.

Пример: http://www.canon.ru/For_Home/Product_Finder/Cameras/Digital_SLR/EOS_60D.

pictureUrl

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

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

Пример: http://www.canon.ru/Images/EOS_60D_Angle2_tcm203-932831.jpg.

instructionUrl

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

Ссылка на инструкцию по эксплуатации товара на сайте производителя.

Пример: http://gdlp01.c-wss.com/gds/9/0300010279/01/EOS_60D_Instruction_Manual_RU.pdf.

barcode

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

Штрихкод товара, указанный производителем.

Пример: 1234567890123.

announceDate

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

Дата добавления модели в файл или дата выхода модели.

Пример: 2014-04-01.

param_name

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

Название параметра товара.

Связан с param_value и param_unit. Если задан параметр param_name, то обязательно должен быть задан param_value. Параметр param_unit должен быть задан, если применима единица изменения.

Пример: Вес.

param_value

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

Значение параметра товара.

Связан с параметрами param_name и param_unit. Если задан параметр param_name, то обязательно должен быть задан param_value. Параметр param_unit должен быть задан, если применима единица изменения.

Пример: 750.

param_unit

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

Единица измерения параметра товара.

Связан с параметрами param_name и param_value.

Пример: г.