Подключение магазинов к shop.i.ua

Мы предлагаем подключить Ваш действующий интернет-магазин к каталогу товаров. Для этого требуется создать автоматически XML-файл, в котором перечислены актуальные товарные позиции и категории.

Файл экспорта

Структура файла следующая:

<?xml version="1.0" encoding="windows-1251"?>
<price date="2007-01-16 16:44">
  <name>eMagazinchik</name>
  <url>http://www.eMagazinchik.com.ua/</url>
  <currency code="UAH"/>
  <region>Украина</region>

  <catalog>
    <category id="17">Бытовая техника</category>
    <category id="25" parentID="17">Телевизоры</category>
    <category id="34" parentID="17">DVD-проигрыватели</category>
    <category id="16">Компьютеры</category>
    <category id="19" parentID="16">Материнские платы</category>
  </catalog>

  <items>
    <item id="138">
      <name>Телевизор SAMSUNG LE40R71B</name>
      <url>http://www.eMagazinchik.com.ua/backet/?pid=138&amp;сid=25&amp;ref=iua</url>
      <price>9576.00</price>
      <categoryId>25</categoryId>
      <image>http://www.eMagazinchik.com.ua/img/138.jpg</image>
      <vendor>Samsung</vendor>
      <description>Дисплей: диагональ, дм. (см) 40, соотношение сторон экрана 16:9
      </description>
    </item>
  </items>
</price>
		

Заголовок файла, описание магазина

<?xml version="1.0" encoding="windows-1251"?>
		

Обязательное начало XML файла экспорта. Пробелы или переводы строки недопустимы в начале файла, кодировка "windows-1251".

<price date="2007-01-16 16:44">
		

price

Корневой элемент XML-файла. Обязательно закрыть его в конце файла. Атрибут date содержит дату и время генерации файла экспорта в формате YYYY-MM-DD HH-MM. Если в shop.i.ua обрабатывался файл с такой датой, повторная обработка не производится.

<name>eMagazinchik</name>
<url>http://www.eMagazinchik.com.ua/</url>
<currency code="UAH"/>
<region>Украина</region>
		

name

Cодержит название магазина-партнёра. Запрещается размещать в названии магазина любую рекламную информацию, как то лозунги, телефоны и прочее.

Не забывайте про то, что надо преобразовывать символы & и " в названии.

url

Cодержит ссылку на главную страницу магазина-партнёра.

Заменяйте & на &amp;

currency

Атрибут code указывает на то в какой валюте указаны цены в файле экспорта. Допустимые значения "USD", "EUR", "UAH".

Атрибут rate указывает на курс валюты, по которому будут рассчитываться цены в гривне для отображения в системе shop.i.ua, если атрибут rate отсутствует — будет использоваться курс НБУ для указанной валюты. Разделитель целой и дробной части — точка.

Примеры:

<currency code="USD" rate="5.15" /> — все цены в доларах США, курс 5.15 грн/доллар
<currency code="UAH" /> — цены в украинской гривне

region

Содержит название региона в котором магазин-партнёр осуществляет доставку. Допустимые значения: "Украина", "Винница", "Днепропетровск", "Донецк", "Житомир", "Закарпатье", "Запорожье", "Ивано-Франковск", "Киев", "Кировоград", "Крым", "Луганск", "Луцк", "Львов", "Николаев", "Одесса", "Полтава", "Ровно", "Сумы", "Тернополь", "Харьков", "Херсон", "Хмельницкий", "Черкассы", "Чернигов", "Черновцы", "Россия".

Используйте отдельный тэг для каждого региона.

Пример (регионы доставки Киев, Днепропетровск):

<region>Киев</region>
<region>Днепропетровск</region>

Структура каталога

<catalog>
  <category id="17">Бытовая техника</category>
  <category id="25" parentID="17">Телевизоры</category>
  <category id="34" parentID="17">DVD-проигрыватели</category>
  <category id="16">Компьютеры</category>
  <category id="19" parentID="16">Материнские платы</category>
</catalog>
		

catalog

Содержит описание дерева категорий, используемого в файле экспорта (корневой тэг).

category

Название описываемой категории дерева категорий.

Атрибут id содержит уникальный (неповторяющийся более в данном блоке) id категории, целое число от 1 до 2147483647. Необходимо, чтобы id категории был постоянным, и не изменялся от экспорта к экспорту.

Атрибут parentID содержит id родительской категории, целое число от 1 до 2147483647. Если атрибут parentID не указан, либо равен нулю — родительской категорией для описываемой считается корневая.

Максимальная допустимая вложенность категорий — шесть уровней.

Структура товарных позиций

<items>
  <item id="138">
    <name>Телевизор SAMSUNG LE40R71B</name>
    <url>http://www.eMagazinchik.com.ua/backet/?pid=138&amp;сid=25&amp;ref=iua</url>
    <price>9576.00</price>
    <categoryId>25</categoryId>
    <image>http://www.eMagazinchik.com.ua/img/138.jpg</image>
    <vendor>Samsung</ vendor >
    <description>Дисплей: диагональ, дм. (см) 40, соотношение сторон экрана 16:9
    </description>
  </item>
</items>
		

items

Содержит перечисление товарных позиций (корневой тэг).

item

Атрибут id содержит уникальный (неповторяющийся более в данном блоке) идентификатор позиции, целое число от 1 до 2147483647. Необходимо, чтобы id товара был постоянным, и не изменялся от экспорта к экспорту. Если вы используете буквенный код товара, можно использовать функцию хеширования для получения довольно уникального цифрового значения, например функцию crc32

name

Название товара (150 символов), если название больше, оно обрезается, и в его конце ставится троеточие. Обязательный параметр.

url

Ссылка на страницу товара на сайте магазина-партнёра. Обязательный параметр. Не забываем заменять & на &amp; Для отслеживания переходов с нашего сайта рекомендуем добавить к URL строку вида &amp;ref=iua.

price

Цена описываемого товара, число, разделитель целой и дробной части — точка. Не допускаются товары с нулевой ценой, а также не приветствуются цены не соответствующие действительности. При необходимости указать валюту цены, используйте аттрибут cid, например <price cid="EUR">

categoryId

id категории из дерева категорий <catalog>, к которой относится данный товар.

image

Cсылка на изображение товара в формате gif, jpg или png. Не обязательное поле. Не поощряется указание вместо изображения товара каких либо заглушек. Изображения закачиваются к нам на сервер и уменьшаются при необходимости.

vendor

Название производителя. Не обязательное поле.

description

Описание товара (до 65535 символов). Не обязательное поле.

Допускаются следующие HTML-тэги:

<p>, <br>, <li>, <table>, <tr>, <td>, <ol>, <ul>, <nobr>.

Размещение файла, и обработка его shop.i.ua

Файл экспорта должен быть доступен с вашего домена по протоколу http или ftp. Вы можете генерировать как статический файл(периодически), так и динамический, который выдаст результат при запросе к нему. Система shop.i.ua выкачивает и обрабатывает его автоматически, раз в сутки, утром.

Пример генерации файла на PHP

<?
function toXML($str)
{
  return htmlspecialchars($str, ENT_QUOTES);
}
Header("Content-Type: \"text/xml\"; charset=windows-1251");
echo '<?xml version="1.0" encoding="windows-1251"?>';
?>
<price date="<?=date('Y-m-d H:i')?>">
<name>eMagazinchik</name>
<url>http://www.eMagazinchik.com.ua/</url>
<currency code='USD'/>
  <region>Украина</region>
  <catalog>
<?
foreach ($categories as $row)
{
  echo '<category id="', $row['id'], '" parentID="', $row['parentID'], '">',
  toXML($row['name']), '</category>';
}
?>
  </catalog>
  <items>
<?
$res = mysql_query("SELECT
id, name, catalogID, description, image_path, extern_url, price, vendor
FROM price WHERE price_uah!=0");
while($row = mysql_fetch_array($res))
{
?>
    <item id="<?=(int)$row['id']?>">
      <name><?=toXML($row['name'])?></name>
      <categoryId><?=(int)$row['catalogID']?></categoryId>
      <price><?=(float)$row['price']?></price>
      <url><?=toXML($row['extern_url'])?></url>
      <image><?=toXML($row['image_path'])?></image>
      <vendor><?=toXML($row['vendor'])?></vendor>
      <description><?=toXML($row['description'])?></description>
    </item>
<?
}
?>
  </items>
</price>
		

закрыть Паспорт

Логин (Регистрация):
Пароль:

Забыл свой пароль…