Прайс-лист — это файл с информацией о товарах, с помощью которого можно загрузить объявления на сайт.
Прайс-листы автоматически проверяются на наличие изменений один раз в день. Изменить периодичность проверки прайс-листа нельзя.
Для размещения объявлений необходимо составить прайс-лист в одном из форматов:
Формат основан на стандарте XML. XML не позволяет использовать первые 32 ASCII-символа в текстовых полях. Исключения — табуляция, перевод строки, возврат каретки. Также стандарт строго требует кодировать в тексте следующие символы:
| Символ, который нужно заменить | Код для файла XML |
|---|---|
| " | " |
| & | & |
| > | > |
| < | < |
| ' | ' |
Кодировка: UTF-8 или cp1251.
В названии файла можно использовать буквы латинского алфавита, цифры и символы.Документ XML должен начинаться с нулевого символа первой строки со стандартного заголовка.
<?xml version="1.0" encoding="utf-8"?>| Элемент | Обязательный элемент | Описание |
|---|---|---|
id
|
Идентификатор товара в базе продавца. | |
title
|
Название товара. Чтобы объявление попало в нужную категорию (аккумуляторы, аксессуары, колеса и т.п.), укажите ее в названии товара. Если категория не указана в названии, объявление попадет в категорию Разное. Название категории и запчасти следует указывать полностью, иначе при обработке прайс-листа могут возникнуть ошибки. Например, объявление с названием «Диск торм.» попадет в категорию «Шины и диски», но с названием «Диск тормозной» — в категорию «Тормозные диски». |
|
vendorCode |
Коды товара в каталоге производителя. | |
manufacturer
|
Название производителя запчасти. | |
description
|
Описание товара в свободной форме. | |
price
|
Цена товара в рублях без копеек. | |
isAvailable
|
Наличие товара.
Строго ограниченные значения:
|
|
images
|
Фотографии товара. Можно передавать несколько элементов. При обработке прайс-листа фотографии скачиваются один раз. Чтобы обновить фотографии в объявлении, загрузите их по новым ссылкам. Новые фотографии по старым ссылкам не будут загружены. Оптимальное соотношение сторон изображения — 4 : 3. |
Информация о каждом товаре передается отдельной строкой с набором элементов. В качестве разделителя между элементами используется символ «;».
В названии файла можно использовать буквы латинского алфавита, цифры и символы.
Технические требования| Элемент | Обязательный элемент | Описание |
|---|---|---|
id
|
Идентификатор товара в базе продавца. | |
title
|
Название товара. Чтобы объявление попало в нужную категорию (аккумуляторы, аксессуары, колеса и т.п.), укажите ее в названии товара. Если категория не указана в названии, объявление попадет в категорию Разное. Название категории и запчасти следует указывать полностью, иначе при обработке прайс-листа могут возникнуть ошибки. Например, объявление с названием «Диск торм.» попадет в категорию «Шины и диски», но с названием «Диск тормозной» — в категорию «Тормозные диски». |
|
vendorCode |
Коды товара в каталоге производителя. | |
manufacturer
|
Название производителя запчасти. | |
description
|
Описание товара в свободной форме. | |
price
|
Цена товара в рублях без копеек. | |
isAvailable
|
Наличие товара.
Строго ограниченные значения:
|
|
images
|
Фотографии товара.
Можно передавать несколько элементов. В качестве разделителя между значениями используется символ «,».При обработке прайс-листа фотографии скачиваются один раз. Чтобы обновить фотографии в объявлении, загрузите их по новым ссылкам. Новые фотографии по старым ссылкам не будут загружены. Оптимальное соотношение сторон изображения — 4 : 3. |
Формат YML основан на стандарте XML. YML не позволяет использовать первые 32 ASCII-символа в текстовых полях. Исключения — табуляция, перевод строки, возврат каретки. Также стандарт строго требует кодировать в тексте следующие символы:
| Символ, который нужно заменить | Код для файла YML |
|---|---|
| " | " |
| & | & |
| > | > |
| < | < |
| ' | ' |
Кодировка: UTF-8 или cp1251.
В названии файла можно использовать буквы латинского алфавита, цифры и символы.Документ YML должен начинаться с нулевого символа первой строки со стандартного заголовка.
<?xml version="1.0" encoding="utf-8"?>| Элемент | Описание |
|---|---|
xml header |
Стандартный |
yml_catalog |
Любой XML-документ может содержать только один корневой элемент. Формат YML в качестве корневого использует элемент |
Элементы, входящие в yml_catalog |
|
categories |
Элемент содержит список категорий с товаром Обязательный элемент. |
shop |
Элемент содержит описание магазина и его товарных предложений. Обязательный элемент. |
Элементы, входящие в shop |
|
|
|
Список предложений магазина. Каждое предложение описывается в отдельном элементе Обязательный элемент. |
offers
| Элемент | Обязательный элемент | Описание |
|---|---|---|
id
|
Идентификатор товара в базе продавца. | |
name
|
Название товара. | |
categoryId
|
Внимание. Используется только в формате YML. Идентификатор категории товара, присвоенный магазином (целое число). Товарное предложение может принадлежать только одной категории. |
|
vendorCode |
Коды товара в каталоге производителя. | |
description
|
Описание товара в свободной форме. | |
price
|
Цена товара в рублях без копеек. | |
picture
|
Фотографии товара.
Можно передавать несколько элементов. При обработке прайс-листа фотографии скачиваются один раз. Чтобы обновить фотографии в объявлении, загрузите их по новым ссылкам. Новые фотографии по старым ссылкам не будут загружены. Оптимальное соотношение сторон изображения — 4 : 3. |