Примеры и назначение основных тегов при импорте в формате XML
Внимание! Поля, не описанные в данной документации, игнорируются во время импорта.
Пример поля | Описание |
---|---|
Кодировка файла XML | |
<?xml version="1.0" encoding="Название_кодировки"?> | Возможные значения: windows-1251, UTF-8. |
<shop> | Начало описания файла импорта |
Курс валюты | |
<currency code="USD" rate="Множитель_курса_USD"/> | Множитель_курса_USD используется для пересчета цены на позицию в UAH по данному курсу, если цена на товар/услугу указана в USD. |
Группы на сайте компании | |
<catalog> | Начало описания блока групп товаров. На основе названий групп в данном файле импорта:
|
<category id="Номер_группы"> Название_группы</category> | Название группы на сайте компании, а также уникальный номер группы в файле импорта. |
<category id="Номер_группы/подгруппы" parentId="Номер_родительской_группы" portal_id="ID_категории_на_портале" portal_url="Cсылка_на_категорию_портала" > Название_группы/подгруппы</category> |
Примечания: • Если указаны оба значения 'portal_id' и 'portal_url', будет использовано значение первого верного параметра. • Тег 'portal_id' имеет приоритет перед 'portal_url'. Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
</catalog> | Конец описания блока групп. |
Товары и услуги | |
<items> | Начало описания блока импортируемых товаров/услуг. |
<item id="ID_позиции" selling_type="Тип_товара"> | Начало описания блока товарной позиции. Указывается уникальный порядковый номер товара/услуги в файле импорта (ID), по которому в дальнейшем будет выполняться обновление данной позиции. Параметр selling_type - это тип товара на Prom.ua. Тип_товара определяет размещение товара в каталоге по признаку оптовой продажи. Тип «Услуга» предназначен для размещения услуг, предоставляемых частным лицам или компаниям. Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. Возможные значения: r, w, u, s.
|
<name>Название_товара</name> | Название товара, обязательное поле. |
<categoryId>Номер_группы</categoryId> | Номер группы (подгруппы), в которой будет размещена позиция на сайте компании после импорта; соответствует номеру группы или номеру группы в блоке описания групп <catalog> в начале данного файла импорта. Обязательное поле. |
<portal_category_id> ID_категории_на_портале </portal_category_id> | ID_категории_на_портале — уникальный идентификатор категории портала, в которой будет опубликован данный товар после импорта. |
<portal_category_url> Cсылка_на_категорию_портала </portal_category_url> | Cсылка_на_категорию_портала — ссылка на категорию портала, в которой будет опубликован данный товар после импорта. Примечания: Если в описании товара указаны оба тега 'portal_category_id' и 'portal_category_url', будет использовано значение первого верного тега. Тег 'portal_category_id' имеет приоритет перед 'portal_category_url'. Теги описания товара 'portal_category_id' и 'portal_category_url' имеют приоритет перед тегами описания группы 'portal_id' и 'portal_url'. Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
<priceusd>Цена_доллар</priceusd> | Цена товара в USD. Необязательное поле. |
<priceuah>Цена_гривна</priceuah> | Цена товара в гривнах. Необязательное поле. Всегда отображается по умолчанию. |
<prices> <price> <value>Оптовая_цена1</value> <quantity>Количество1</quantity> </price> <price> <value>Оптовая_цена2</value> <quantity>Количество2</quantity> </price> </prices> |
Указание оптовых цен для типов товаров «Товар продается только оптом». Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
<price> |
Указание оптовых цен для типов товаров «Товар продается оптом и в розницу». Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. |
<image>Ссылка</image> | Ссылка на изображение позиции. Необязательное поле. |
<vendor>Название_производителя</vendor> | Необязательное поле. Бренд, торговая марка или название предприятия-производителя, под знаком которого изготовлен товар (возможно значение «Собственное производство»). Название производителя импортируется в атрибут «Производитель» в описании товара. Внимание! Указываемый вами производитель будет импортирован только если он есть в базе производителей портала. Проверить его наличие и добавить нового производителя можно при добавлении/редактировании товара в поле «Производитель» (блок «Портальные характеристики»). |
<vendorCode>Код(Артикул)</vendorCode> или <barcode>Код(Артикул)</barcode> | Код товара (артикул) необходим для быстрого и удобного поиска нужной позиции на сайте компании и в личном кабинете при телефонном обращении клиента. Длина артикула - 25 символов (цифры, кириллица, латиница, знаки «-», «_», «.», «/» и пробел). |
<country>Страна_производитель</country> | Необязательное поле. Импортируется в атрибут «Страна производитель» в описании товара. |
<param name="Название_характеристики" unit="Единица_измерения_значения"> Значение_характеристики_товара</param> | Названия характеристик и единицы измерения значений необходимо скопировать из блока 'Портальные характеристики' на странице добавления/редактирования товара в Кабинете Компании. Значение характеристики может быть простым или множественным. Например, множественная характеристика «Материал корпуса» (Алюминий, Пластмасса) или «Стандарт связи» (GSM, CDMA). Значения множественных характеристик в файле импорта разделяйте символом «|». Внимание! Данный тег используется только на нашем портале. При попытке импортировать файл с тегом «param» в другую систему может возникнуть ошибка." |
<description>Описание_товара</description> | Описание товара. Обязательное поле. Текст описания товара может содержать HTML-теги и обязательно должен быть заключён в тег <![CDATA[...]]>. Пример:<description><![CDATA[<p>Сапоги, как сапоги.<br>Материал верха: юфть, юфть с кирзой.<br>Подошва — резина.</p>]]></description> |
<available>Наличие</available> |
Указание наличия для товара. Значение «склад» или «true» соответствует статусу товара «В наличии», значение «false» — статусу «Под заказ». Если в данном поле пусто — товар будет импортирован в статусе «Нет в наличии». Параметр presence_sure="true"указывает статус «Гарантированное наличие». Пример: <offer available="true" id="660912008" presence_sure="true">. |
<keywords>Ключевое_слово_1, Ключевое_слово_2, ..., Ключевое_слово_N</keywords> | Ключевые слова (поисковые запросы, теги) товарной позиции или услуги. |
</item> | Конец описания блока позиции. |
</items> | Конец описания блока импортируемых товаров/услуг. |
</shop> | Конец описания файла импорта. |