Правила заполнения атрибутов шаблона Ozon-XML


Система описания Ozon построена таким образом, что при описании каждого типа товара учитываются его индивидуальные характеристики.

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

В данной статье будут рассмотрены те атрибуты, которые присутствуют в большинстве шаблонов.

 Обратите внимание на то, что в шаблоне Ozon-XML нельзя изменять порядок следования тегов, удалять лишние на ваш взгляд теги, а также добавлять новые, не предусмотренные первоначальной структурой.

Блок Product

Блок Product содержит данные по одному товару.

Элемент Product вместе с атрибутами MerchantSKU и ProductTypeID является единственным обязательным элементом при любом обращении к методам POST/PUT products.

Остальные блоки и элементы могут быть не заполнены (но в этом случае и изменяться ничего не будет), но <Product MerchantSKU=”Код_товара_в_ИС_мерчанта” ProductTypeID=”код_типа”> должен быть всегда.

Рисунок 1. Блок Product в XML шаблоне описания товара

MerchantSKU - Обязательный атрибут (не показывается на сайте). Содержит уникальный буквенно-числовой идентификатор товара (артикул) в системе мерчанта.

 Не может быть двух разных товаров с одинаковым MerchantSKU. При попытке передачи в одном файле двух товаров с одинаковыми SKU может произойти следующее:

  • Т.к. файл обрабатывается потоварно и в несколько потоков, может возникнуть ситуация, когда в обработку одновременно попадет 2 товара с одинаковыми SKU, при этом возникнет ошибка и обработка данных товаров будет прервана;
  • Товары также могут обработаться последовательно, в этом случае ошибки не будет, но на сайт попадет тот товар, который был обработан последним.

ProductTypeID Обязательный атрибут (не показывается на сайте). Содержит указание (идентификационный номер) на конкретный тип товара. 
Получить полный список согласованных (разрешенных) типов товаров можно с помощью метода GET merchants/products/types (подробнее здесь: http://ows.ozon.ru/merchants/products/help).

Блок SKU

Блок SKU содержит складскую информацию о товаре. В общем случае этой информации достаточно, чтобы товар был заведен в системе. Блок является обязательным при создании товара.

Если требуется изменить только данные, входящие в блок SKU, то рекомендуется использовать метод PUT merchants/products/sku/{id} (подробнее здесь: http://ows.ozon.ru/merchants/products/help).

Рисунок 2. Блок SKU в XML шаблоне описания товара

Name - Содержит наименование товара, которое затем показыватся как название в карточке товара на сайте ozon.ru. Обратите внимание, что в структуре данных есть два элемента, отвечающих на наименование товара: SKU.Name и Description.Name. Данные в этих полях обязательно должны быть равны. Значение SKU.Name используется только при создании товара (без этого элемента товар не может быть создан), а также в случаях, когда блок Description не передан.

ManufacturerIdentifier - Содержит код товара от производителя (не показывается на сайте). Например, для книг это ISBN, для электроники это серийный номер.

GrossWeight - Содержит целочисленное значение веса товара в упаковке (брутто) в граммах (показывается в цепочке оформления заказа). Поле является обязательным. На основании данного значения будет рассчитываться весовой сбор, если он включен в тариф на доставку, поэтому заполнять данное поле необходимо внимательно (в граммах), чтобы избежать некорректного расчета стоимости доставки.

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

Блок Price

Блок Price содержит информацию, влияющую на цену товара. Данные этого блока не являются обязательными для создания товара, однако товар не может быть выставлен в продажу, пока ему не установлена цена больше 0. Если требуется изменить только цену товара или скидку на товар, то рекомендуется использовать метод API PUT merchants/products/price/{id} (подробнее здесь: http://ows.ozon.ru/merchants/products/help.

Рисунок 3. Блок Price в XML шаблоне описания товара

SellingPrice - Содержит цену товара (в рублях) до скидки с точностью до двух знаков после запятой.

Пример отображения цены товара:

Discount - Содержит целочисленное значение скидки на товар в процентах. Может принимать значение от 0 до 99. Скидка равная 0 означает отсутствие скидки.
Обратите внимание, что если элемент не передан, то это не приводит к снятию скидки с товара. Для снятия с товара ранее установленной скидки необходимо передать значение <Discount>0</Discount>.

Пример отображения цены со скидкой:

Блок Availability

Блок Availability содержит информацию о доступности и статусе товара.
Данные этого блока не являются обязательными для создания товара, однако, для выставления товара в продажу все атрибуты блока должны быть заполнены.

Если требуется изменить только данные доступности или статус товара, то рекомендуется использовать метод PUT merchants/products/availability/{id} (подробнее здесь: http://ows.ozon.ru/merchants/products/help).

Рисунок 4. Блок Availability  в XML шаблоне описания товара

SellingState - Содержит информацию о статусе товара (не показывается на сайте).

 Принимает значения:

  • ForSale (В продаже) 
  • NotForSale (Снят с продажи).

Если при создании товара статус не был указан явно, он будет установлен в “Снят с продажи”.

Для выставления товара в продажу должно быть выполнено несколько условий:

  • передано значение <SellingState>ForSale</SellingState>
  • установлена цена больше нуля (в том же запросе или ранее)
  • задано описание товара (минимально необходимо наличие названия и основного изображения, полный список обязательных атрибутов описания зависит от конкретного типа товара)

SupplyPeriod - Содержит информацию о сроке поставки товара под заказ.

Поле содержит перечень значений, соответствующих надписям в блоке “Под заказ” на сайте ozon.ru:

  •  In3Days (В течение 3 дней)
  •  In10Days (В течение 10 дней)
  •  In14Days (В течение 14 дней)
  •  In45Days (В течение 45 дней)
  •  NotAvailable (Не доступен под заказ)

Qty - Содержит информацию о количестве товара (свободном остатке) на складе мерчанта (не показывается на сайте).

Свободный остаток (СО) вычисляется по следующей формуле:

СО = Х(м) - Х(з), где Х(м) - это кол-во товара переданное мерчантом; Х(з) - это количество товара в заказах в статусе "Создан".

Т.е. надпись в сейлблоке «На складе» будет только в том случае, когда кол-во, переданное мерчантом, превышает кол-во штук данного товара в заказах в статусе «Создан».

Если свободный остаток равен 0, то надпись в сейлблоке будет "Под заказ", аналогично будет в том случае, когда весь указанный свободный остаток окажется под "условным резервом" (т.е. в заказах в статусе "Создан"). 

Если в поле SupplyPeriod передано значение NotAvailable (Не доступен под заказ) и свободный остаток равен 0, товар будет снят с продажи (см. таблицу 1).

 

Таблица 1. Возможные варианты сочетания значений в полях "Свободный остаток" (Qty) и "Срок поставки под заказ" (SupplyPeriod)

Статус товараСрок поставки под заказСвободный остаток (qty)Надпись в сейлблоке на сайте ozon.ru
Продается В течение 3 дней 0

Под заказ

Продается

В течение 10 дней

0 Под заказ
Продается В течение 14 дней 0 Под заказ
Продается В течение 45 дней 0 Под заказ
Снят с продажи Недоступен под заказ 0 -
 
Продается В течение 3 дней >0 На складе
Продается В течение 10 дней >0 На складе
Продается В течение 14 дней >0 На складе
Продается В течение 45 дней >0 На складе
Продается Недоступен под заказ >0 На складе
       
Снят с продажи Не имеет значения Не имеет значения -

Блок Description

Блок Description содержит информацию об описании товара.
Данные этого блока не являются обязательными для создания товара, однако без описания товар не может быть выставлен в продажу на вебвитрине.

Обработка информации об описании товара является низкоприоритетной операцией, поэтому не рекомендуется передавать описание товара одновременно с обновлением цены или доступности – это приведет к задержкам при обновлении.

Если требуется изменить только данные описания товара, то рекомендуется использовать метод API PUT merchants/products/description/{id} (подробнее здесь: http://ows.ozon.ru/merchants/products/help).

Если же требуется изменить только доступность товара, рекомендуется использовать метод API PUT merchants/products/availability/{id} (подробнее здесь: http://ows.ozon.ru/merchants/products/help).

Для обновления цены товара, используйте метод PUT merchants/products/price/{id} (подробнее здесь: http://ows.ozon.ru/merchants/products/help).

Ипользование методов обновления цены/доступности позволит сократить время обработки запроса. Также для обновления цены/доступности есть специальные шаблоны с пометкой lite, которые можно скачать в личном кабинете мерчанта на сайте merchants.ozon.ru (Вкладка "Загрузка товаров / Шаблоны") или используя методы API, описанные здесь: http://ows.ozon.ru/merchants/templates/help.

Структура данных в блоке Description полностью зависит от типа товара, поэтому задается отдельной схемой. Для получения информации о структуре данных конкретного типа товара используйте метод API GET merchants/xsd/description/{id} (подробнее здесь: http://ows.ozon.ru/merchants/xsd/help), где в качестве {id} необходимо указать один из разрешенных вам типов товаров.

Рассмотрим наиболее распространенные атрибуты блока Description, которые присутствуют в большинстве шаблонов.

Name - Обязательный атрибут. Содержит наименование товара, которое используется для сопоставления блока SKU и блока Description (не показывается на сайте). Обратите внимание, что в структуре данных есть два элемента, отвечающих на наименование товара: SKU.Name и Description.Name, данные в этих полях обязательно должны быть равны.

Picture - Главное изображение, является обязательным и может быть только одно.

Изображение, переданное в атрибуте Picture показывается на списке товаров:

Images - Дополнительное изображение, его не обязательно передавать.

Дополнительных изображений может быть несколько (максимум 20):

<Images>url1</Images>

<Images>url2</Images>

<Images>url3</Images>

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

Пример передачи url изображения:

ReleaseYear - Год выпуска товара. Данное значение затем выводится в блоке с описанием в карточке товара на сайте ozon.ru. Обратите внимание на то, что можно передавать только один год в атрибуте, нельзя передавать период из нескольких лет. Например: 2014 - верно; 2014/2015 -  не верно.

Особенностью данного атрибута является то, что при создании товара год выпуска является обязательным и если он не передан, то по умолчанию подставляется текущий год.

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

Блок Producer

Name - Обязательный атрибут. Название производителя товара, данное значение затем выводится в блоке с описанием в карточке товара на сайте ozon.ru. Не путайте данный атрибут с атрибутом Brand (бренд), который будет описан далее. Не исключено, что в некоторых случаях атрибуты Producer.Name и Brand.Name могут совпадать.

Блок Capability

Блок Capability содержит информацию о наборе характеристик присущих конкретному типу товара или группе типов. Набор характеристик используется для повышения эффективности поиска товара. Например, мобильные телефоны разных производителей и разных цветов могут совпадать по таким характеристикам как объем памяти и/или диагональ экрана. Состав блока Capability зависит от конкретного типа товара, рассмотрим наиболее часто встречающиеся атрибуты.

 Для исключения "склеивания" нескольких товаров разных моделей в одну карточку на сайте ozon.ru, необходимо заполнять блок Capability максимально подробно. 

Name - Обязательный атрибут. Название характеристики. Здесь необходимо передать название набора характеристик присущих товару. Рекомендуемый формат передачи названия характеристик товара: Бренд + Модель, например: Salomon OutBan Mid.

 Обратите внимание на то, что название характеристики будет выводиться на сайте ozon.ru в списке товаров:

Type - Обязательный атрибут. Тип характеристики. Выбирается из справочника, значения которого можно получить из таблицы TypeTable в XSD схеме. 

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

Если вы описываете товар, в атрибутах которого присутствует RingSize, обратите внимание на следующие особенности работы с данным атрибутом:

RingSize - Размер кольца. Данный атрибут встречается в шаблонах для ювелирных украшений и используется в фильтре по размеру колец в каталоге товаров на сайте ozon.ru. Если необходимо разместить на сайте несколько колец одной модели , но разных размеров, данный атрибут необходимо передавать следующим образом:

  • Характеристики таких товаров должны совпадать, т.е. информация в блоке Capability должна быть одинаковой для всех колец, относящихся к одной модели.
  • Поле с размером кольца (RingSize) необходимо заполнять значением #Asp# (Аспект), а непосредственно сам размер кольца указывать в поле Aspect:


Пример:

Таким образом, товары с одинаковыми характеристиками будут доступны из одной карточки товара на сайте ozon.ru, при этом будет возможность выбора конкретного товара по размеру:

ExternalID - Обязательный атрибут и внешний идентификатор товара, значение которого может совпадать со значением MerchantSKU. Данный атрибут может использоваться в качестве общего признака, объединяющего товары с одинаковыми характеристиками. Т.е. у нескольких товаров с одинаковыми характеристиками атрибут ExternalID может совпадать. В случае совпадения характеристик товара он будет объединен в одну карточку, а различающиеся характеристики будут доступны в виде переключателей свойств данного товара.

Weight - Содержит целочисленное значение веса товара (нетто) в граммах. Данное значение затем выводится в блоке с описанием в карточке товара на сайте ozon.ru.

 Обратите также внимание на заполнение атрибута GrossWeight, который находится в блоке SKU.

Блок Brand

Name - Обязательный атрибут. Название бренда. Данное значение затем используется для поиска товара в каталоге на сайте ozon.ru. Значение данного поля может совпадать со значением поля Producer.Name. Например, производителем бренда Panasonic будет Panasonic Corporation.

Dimensions - Размеры товара, мм. Поле должно быть заполнено в формате ДxШxВ (без пробелов), например: 140,2x72,4x8,8.

Блок Color

Name - Обязательный атрибут. Название цвета, в отличие от привязанного к справочнику атрибута Color, заполняется произвольно, это сделано для тех случаев, когда к значению цвета, указанного при помощи справочника, требуется уточнение. Например, в атрибуте Color выбран цвет "Белый", а в атрибуте Name можно уточнить что цвет с оттенком слоновой кости.

Color - Обязательный атрибут. Значение цвета, выбирается из справочника, значения которого можно получить из таблицы Color_ColorTable в XSD схеме. 

Пример:

TDimensions - Габариты упаковки, см. Поле должно быть заполнено в формате Д x Ш x В (с пробелами), например: например: 15.5 x 16 x 3.7.

  Примеры заполнения шаблона с описанием товара можно посмотреть зедсь: http://merchant-platform.ozon.ru/структура-ozon-xml/