Введите ваш вопрос

Импорт из XML (Price.ua) (новый кабинет)

Примеры и назначение основных тегов при импорте в формате XML

Внимание! Поля, не описанные в данной документации игнорируются во время импорта.

Пример поля Описание
Кодировка файла XML
<?xml version="1.0" encoding="Название_кодировки"?> Возможные значения: windows-1251, UTF-8.
Курс валюты
<currency code="USD" rate="Множитель_курса_USD"/> Множитель_курса_USD используется для пересчета цены на позицию в UAH по данному курсу, если цена на товар/услугу указана в USD.
Группы на сайте компании
<catalog> Начало описания блока групп товаров. На основе названий групп в данном файле импорта:
  • На сайте вашей компании будут созданы группы и подгруппы для импортируемых товаров.
  • На портале (в каталоге) Prom.ua для входящих в группы/подгруппы позиций будут автоматически определены категории (рубрики каталога).
  • Настоятельно рекомендуем вам указывать названия групп в файле импорта так, как они называются в каталоге Prom.ua.
<category id="Номер_группы"> Название_группы</category> Название группы на сайте компании, а также уникальный номер группы в файле импорта.
<category id="Номер_группы/подгруппы" parentId="Номер_родительской_группы" portal_id="ID_категории_на_портале" portal_url="Cсылка_на_категорию_портала" > Название_группы/подгруппы</category>
  • Название_группы/подгруппы — название группы или подгруппы товаров на сайте компании.
  • Номер_группы/подгруппы — уникальный номер группы или подгруппы товаров в файле импорта.
  • Номер_родительской_группы — номер родительской группы товаров в файле импорта. Используется для создания вложенной структуры групп на сайте компании.
  • ID_категории_на_портале — уникальный идентификатор категории портала, в которой будут опубликованы все товары данной группы после импорта.
  • Cсылка_на_категорию_портала — ссылка на категорию портала, в которой будут опубликованы все товары данной группы после импорта.
    Примечания:
    • Если указаны оба значения 'portal_id' и 'portal_url', будет использовано значение первого верного параметра.
    • Тег 'portal_id' имеет приоритет перед 'portal_url'.
    Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы.
Товары и услуги
<items> Начало описания блока импортируемых товаров/услуг.
<item id="ID_позиции" selling_type="Тип_товара"> Начало описания блока товарной позиции. Указывается уникальный порядковый номер товара/услуги в файле импорта (ID), по которому в дальнейшем будет выполняться обновление данной позиции. 
Параметр selling_type - это тип товара на Prom.ua. Тип_товара определяет размещение товара в каталоге по признаку оптовой продажи. Тип «Услуга» предназначен для размещения услуг, предоставляемых частным лицам или компаниям. 
Внимание! Данный параметр используется только на Prom.ua. Файл с данным параметром может вызывать ошибку при импорте в другие системы. 
Возможные значения: r, w, u, s.
  • 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>
Розничная_цена
</price>
<prices>
  <price>
    <value>Оптовая_цена</value>
   <quantity>Количество</quantity>
  </price>
</prices>

Указание оптовых цен для типов товаров «Товар продается оптом и в розницу». 
Внимание! Данный параметр используется только на 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> Конец описания блока импортируемых товаров/услуг.
</catalog> Конец описания блока групп.