IPrice minimart - руководство пользователя

С помощью экспорта вы можете выгрузить товары, категории и заказы из базы данных. В настоящий момент поддерживается экспорт товаров и категорий в формате YML (Яндекс.Маркет) и экспорт заказов в формате XML для загрузки в 1C и другие системы учета.

Экспорт товаров и категорий в формате YML (Яндекс.Маркет)

Для экспорта товаров и категорий зайдите в админке компонента в управление товарами (Админка->Компоненты->IPrice minimart->Товары). При необходимости задайте фильтр по категориям, статусу товаров, подстроке поиска и нажмите кнопку "Экспорт в Яндекс.Маркет". Текущий список товаров с учетом текущих фильтров будет выгружен в YML файл экспорта items-yandex-market.xml. Так же в этом файле будут содержаться все категории товаров, а так же все опубликованные валюты компонента. Файл экспорта будет записан в каталог сайта, заданный в настройках компонента на вкладке "Экспорт" в параметре "Директория экспорта". Если этот параметр не задан, то файл экспорта будет записан в каталог сайта по умолчанию: /administrator/components/com_ipricecalc/export/

Перед эскортом товаров в Яндекс.Маркет вам необходимо настроить шаблон файла экспорта /administrator/components/com_ipricecalc/export/template-items-yandexyml.xml. В шаблоне необходимо задать имя магазина, компании, а так же ссылку на сайт компании, например:

<name>Имя магазина</name>
<company>Название компании</company>
<url>http://сайт-магазина.ru</url>

Так же в шаблоне можно редактировать формат вывода валют. Шаблон вывода списка используемых валют задается между тэгами:

[LOOPCURR]
  ***
[/LOOPCURR]

Места для вывода категорий и товаров в шаблоне отмечены тэгами [LOOPCATEGORY][/LOOPCATEGORY] и [LOOPITEM][/LOOPITEM] соответственно. Вывод категорий и товаров производится в файле \administrator\components\com_ipricecalc\helpers\export-items-yandexyml.php функциями ip_getCatsBlock() и ip_renderItemsBlock().
Вы можете задавать дополнительные константные поля для товара в файле шаблона между тэгами [LOOPITEM][/LOOPITEM], например:

[LOOPITEM]
<pickup>true</pickup>
<delivery>true</delivery>
<sales_notes>Необходима предоплата</sales_notes>
[/LOOPITEM]

данные константные поля будут добавлены к основной информации о товаре, фомрируемой процедурой экспорта ip_renderItemsBlock() в файле \administrator\components\com_ipricecalc\helpers\export-items-yandexyml.php.

Перечень основных полей товара формируемых процедурой экспорта:

• <url>...</url> - URL товара на сайте магазина
• <price>...</price> - цена товара
• <oldprice>...</oldprice> - старая цена товара без скидки (если у товара есть скидка)
• <currencyId>...</currencyId> - код валюты
• <categoryId>...</categoryId> - ID категории
• <picture>...</picture> - URL изображения товара
• <store>...</store> - товар есть (true) или нет (false) в наличии
• <name>...</name> - наименование товара
• <vendorCode>...</vendorCode> - артикул товара
• <vendor>...</vendor> - производитель
• <description>...</description> - описание товара (берется из поля краткого описания товара)
• список характеристик товара с их значениями в формате:
  <param name="имя характеристики 1" >значение харакетристики 1</param>
  ...
  <param name="имя характеристики N" >значение харакетристики N</param>
  

Незаполненные для товара поля не будут включены в файл эспорта.

Экспорт заказов в формате XML для загрузки в 1C и другие системы учета

Вы можете настроить автоматическую выгрузку заказа в XML файл, когда пользователь отправляет заказ. Для этого необходимо в параметрах компонента на вкладке "Заказ" установить параметр "Сохранить заказ в XML" в "Да". Так же можно разрешить вложение XML файла с заказом в письмо-заказ, отправляемое менеджеру заказов при оформлении заказа пользователем с помощью параметра "Вложить XML файл с заказом к письму заказа для менеджеров". XML файл экспорта заказа будет записан в каталог сайта, заданный в настройках компонента на вкладке "Экспорт" в параметре "Директория экспорта". Если этот параметр не задан, то файл экспорта будет записан в каталог сайта по умолчанию: /administrator/components/com_ipricecalc/export/. Название XML файла заказа имеет формат order_N_DATA.xml, где N это номер заказа, DATA - дата заказа в формате ГОД-МЕСЯЦ-ДЕНЬ.
Шаблон XML файла заказа вы можете отредактировать для собственных нужд в файле /administrator/components/com_ipricecalc/export/template-order-xml.xml. Файл может иметь свободный формат с любым синтаксисом, поддерживаемым вашей системой учета. Для вставки данных о заказе используйте доступные переменные.

Переменные информации о заказе, доступные для использования в XML шаблоне заказа:

• [orderno] - номер заказа
• [orderdate] - дата заказа
• [orderdate] - дата заказа
• [grandtotal] - общая сумма по заказу
• [taxamount] - общая сумма НДС по заказу
• так же вы можете использовать любые дополнительные поля заказа, добавленные в управлении полями заказа, заключив системное имя поля в квадратные скобки, например [inn]

Для вставки позиций заказа в XML шаблоне заключите данные о позиции заказа в тэги

[LOOPITEM]
  ***
[/LOOPITEM]

(см. файл XML шаблона заказа).
Переменные информации о позиции заказа, доступные для использования в XML шаблоне заказа:

• [orderno] - номер заказа
• [itemid] - ID позиции
• [name] - артикул товара
• [shortdesc] - наименование товара
• [unit] - единица измерения
• [salestax] - ставка НДС %
• [cost] - цена товара
• [count] - количество товара
• [item_total] - обзая сумма по позиции
• [taxamount] - общая сумма НДС по позиции