Центр документации
Карта сайта

Создай визитку сам!


Самоучитель по интеграции дизайна и настройке Amiro.CMS на примере демонстрационной версии пакета Визитка »


Формат обмена данными о товарах

Объект «Товар» это товарное предложение магазина.

Формат данных о товарах:

<offer id=”id_external”>
     <categoryId>Category id</categoryId> 
     <name>Name</name>
     <description>Description</description>
     <currencyId>Currency id</currencyId>
     <price>Price</price>
     <picture>Picture</picture>
</offer>

Список возможных полей для обмена данных о товарах:

Название Тип Свойства Назначение
id_external Строка (255) ** Внешний идентификатор товара
Category id   *, ** Внешний идентификатор категории
Name Строка (255) **, 1) Название товара
Description Строка (16777215) 2) Описание товара
Currency id     Внешний идентификатор валюты
Price Дробное 3) Фиксированное значение цены в указанной валюте
Picture Строка (128) 4) Путь до файла изображения

* Обязательное поле для создания/изменения категории

** Обязательное поле для создания/изменения товара

  1. Если товарное предложение определено через «vendor.model», то наименование товара задается элементом.
  2. Могут содержать целостный HTML код. Если данные столбцы не заданы в настройках импорта, то соответствующие данные, заполненные через панель администратора, не будут удалены. Если столбцы заданы в настройках импорта, а импортируемый файл содержит пустой значение в столбце, то информация, заполненная через панель администратора, будет утеряна.
  3. Правила вычисления дополнительных цен определятся настройками модуля.
  4. Файлы изображений должны быть либо доступны для загрузки на сервер, либо загружены на сервер. При самостоятельной загрузке файлов на сервер необходимо выбрать значение «только наименование» параметра «Загружать изображения».

Пример объекта «Товар»

Если товар имеет дополнительные цены, то необходимо повторить описание товара с указанием дополнительной цены из списка валют.

<offer id="1054”>
      <url>http://best.seller.ru/product_page.asp?pid=12348</url>
      <price>210.54</price> <currencyId>Руб</currencyId>
      <categoryId>6</categoryId>
      <picture>http://www.stroi.ru/pc/imgs/popular/printers/hpLaserJet1100.jpg</picture>
      <name>Принтер HP Laser Jet 1100</name>
      <description>Лазерный принтер, А4, 8 стр. в минуту, разрешение 600х600</description>
</offer>
<offer id="1054”>
      <url>http://best.seller.ru/product_page.asp?pid=12348</url>
      <price>8.09</price>
      <currencyId>USD</currencyId>
      <categoryId>6</categoryId> 
      <picture>http://www.stroi.ru/pc/imgs/popular/printers/hpLaserJet1100.jpg</picture>
      <name>Принтер HP Laser Jet 1100</name>
      <description>Лазерный принтер, А4, 8 стр. в минуту, разрешение 600х600</description>
</offer>

Пример файла обмена данными о товарах

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

<?xml version="1.0" encoding="windows-1251"?>
<!DOCTYPE yml_catalog SYSTEM "shops.dtd">
<yml_catalog date="2000-11-16 20:17">
<shop>
     <name>Каталог Товаров</name>
     <company>Компания</company>
     <url>http://best.seller.ru/</url>
     <currencies>
          <currency id=”Руб” rate=”1” />
          <currency id=”USD” rate=”27.3” />
     </currencies>

     <categories>
          <category id=”ext_cat_1”>Category 1</category>
          <category id=”ext_cat_2” parentId=”ext_cat_1”> Category 2</category>
     </categories>

     <offers>
          <offer id=”item_2_1”> 
                <categoryId>ext_cat_2</categoryId>
                <name>Item 2.1</name>
                <description>Item 2.1, description</description>
                <currencyId>Руб</currencyId> 
                <price>150</price>

<picture>http://www.stroi.ru/pc/imgs/popular/printers/hpLaserJet1100.jpg</picture> 
          </offer> 
          <offer id=”item_2_2”>
                <categoryId>ext_cat_2</categoryId>
                <name>Item 2.2</name>
                <description>Item 2.2, description</description> 
                <currencyId>Руб</currencyId>
                <price>150</price>

<picture>http://www.stroi.ru/pc/imgs/popular/printers/hpLaserJet1100.jpg</picture>
           </offer>
           <offer id="item_2_2"> 
               <categoryId>ext_cat_2</categoryId>
               <name>Item 2.2</name>
               <description>Item 2.2, description</description>
               <currencyId>USD</currencyId>
               <price>5</price> 

<picture>http://www.stroi.ru/pc/imgs/popular/printers/hpLaserJet1100.jpg</picture>
            </offer> 
      </offers>
</shop>
</yml_catalog>

Результатом работы данного примера должны быть 2 категории «Category 1» и «Category 2», последняя из которых содержит 2 товара «Item 2.1» и «Item 2.2». Для товара «Item 2.2» указана цена в рублях и USD.

Версия для печати

Установка и настройка Руководство пользователя Интеграция дизайна Разработчикам (API)
 2000 – 2021 © Amiro.CMS Все права защищены.