Mr.Doc - Вклад участника [ru]

Загрузка данных с сайтов поставщиков

2016-11-10T13:41:57Z

Krylovia: /* Настройка модуля */

= Важно! =

Перед загрузкой данных с сайтов поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

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

Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

Модуль позволяет загружать цены и наличие товаров у поставщиков напрямую с их сайтов по расписанию.

Для этого поставщик должен предоставить ссылку на JSON или XML-файл, в котором отражены его остатки и/или его цены. Ссылка может быть как на сайт (начинается с "http://"), так и на ftp-сервер (начинается с "ftp://").

После предварительной настройки наша система будет по расписанию скачивать этот файл по ссылке и загружать из него наличие и цены товаров.

Поиск товаров для обновления цен и наличия будет осуществляться по следующему алгоритму:
# Сначала ищется товар с таким артикулом поставщика;
# Если товар не нашелся, то далее товар ищется по артикулу производителя;
# Если товар не нашелся, то по шаблону наименования формируется наименование и ищется товар с этим наименованием;

При этом есть возможность ограничить поиск товара определенной родительской группой товаров.

Если товар был найден не по артикулу поставщика, то артикул поставщика из файла будет привязан к товару автоматически.

'''Внимание!''' Модуль предназначен только для обновления цен и наличия для товаров, уже существующих в системе. Если в файле есть товары, которых нет в системе, то они не будут автоматически создаваться.

= Включение модуля =

Для включения модуля необходимо зайти в ваш [https://mrdoc.org/pcabinet личный кабинет на сайте mrdoc.org] и включить модуль "Интеграция с поставщиками".

[[Файл:Module supplierRestPriceImport turn on module.png|border|925px|Включение модуля в личном кабинете]]

= Настройка модуля =

После включения модуля в вашей программе появляется новый пункт меню "Настройки загрузки данных поставщиков".

Этот пункт ведет в журнал, где для каждого поставщика необходимо создать отдельную запись.

[[Файл:Module supplierRestPriceImport menu.png|border|748px|Пункт главного меню для настройки загрузки данных поставщиков]]

[[Файл:Module supplierRestPriceImport update.png|border|940px|Настройка загрузки данных с сайта поставщика]]

* '''Поставщик''' - поставщик, для которого будут загружаться цены и наличие. Цены будут загружаться по тому типу цен, который указан в карточке поставщика (в поле "Закупочный тип цен");
* '''Способ расчёта цены''' - способ вычисления итоговой цены поставщика для тех случаев, когда у поставщика несколько разных цен для одного товара (например, разные цены на разных складах);
* '''Периодичность''' - с какой периодичностью загружать данные с сайта поставщика;
* '''Валюта цен''' - валюта для загрузки цен;
* '''Сбрасывать наличие после загрузки''' - при установке этого флажка будет сбрасываться наличие для всех товаров, которых не было в файле, но по которым ранее было зафиксировано наличие у данного поставщика;
* '''Логин, пароль''' - некоторые поставщики требуют аутентификации для скачивания файла;
* '''Табличная часть "Настройки для обновления товаров"''' - это список правил для разбора файла:
** '''URL для загрузки файла''' - ссылка на файл поставщика;
** '''Узел товара''' - путь до узла товара внутри файла;
** '''Поле артикула поставщика''' - путь до поля с артикулом поставщика в рамках узла товара;
** '''Поле артикула производителя''' - путь до поля с артикулом производителя в рамках узла товара;
** '''Шаблон наименования''' - шаблон для формирования наименования, по которому будет искаться товар, если он не был найден по артикулу поставщика;
** '''Поля с кол-вами (через запятую)''' - пути до полей с количествами в рамках узла товара;
** '''Поля с ценами (через запятую)''' - пути до полей с ценами в рамках узла товара;
** '''Родительская группа для ограничения поиска''' - товары для обновления цен/наличия будут искаться только в рамках указанной родительской группы товаров;

== Пример настройки для XML-файла ==

Допустим, что поставщик предоставляет ссылку на XML-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.xml

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires>
<cae>003309</cae>
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires>
<cae>1014138</cae>
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims>
<cae>WHS152714</cae>
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims>
<cae>WHS152672</cae>
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "tires" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "rims" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

В файлах некоторых поставщиков могут использоваться атрибуты XML-узлов.

Например, в данном файле артикул товара указан в атрибуте узла товара, а не отдельным подузлом:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires cae="003309">
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires cae="1014138">
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims cae="WHS152714">
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims cae="WHS152672">
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В этом случае поле "Поле артикула" нужно заполнить так: "@cae" (символ "@" указывает на то, что это атрибут узла, а не отдельный узел).

== Пример настройки для JSON-файла ==

Допустим, что поставщик предоставляет ссылку на JSON-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.json

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
{
"tires": [
{
"cae": "003309",
"brand": "Nokian",
"size": "R19",
"model": "AH213-19",
"rest_msk": 5,
"rest_spb": 2,
"price_msk": 3650,
"price_spb": 3685
},
{
"cae": "1014138",
"brand": "Nokian",
"size": "R20",
"model": "AH213-20",
"rest_msk": 5,
"rest_spb": "более 40",
"price_msk": 4120,
"price_spb": 4120
},
...
],
"rims": [
{
"cae": "WHS152714",
"brand": "Nitro",
"model": "N20-123",
"rest_msk": 12,
"rest_spb": 2,
"price_msk": 2370,
"price_spb": 2370
},
{
"cae": "WHS152672",
"brand": "Nitro",
"model": "N20-124",
"rest_msk": 15,
"rest_spb": 7,
"price_msk": 3580,
"price_spb": 3600
},
...
]
}
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "tires";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "rims";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

= Контроль результатов загрузки данных =

После сохранения настройки автоматически создается задача, статус выполнения которой можно увидеть в отчете "Отчеты / Запланированные задачи".

В результатах задачи отображается общее количество обновленных цен/остатков, а также общее количество пропущенных товаров.

Пропущенные товары - это узлы в файле, для которых не было найдено соответствующих товаров в системе (ни по артикулу поставщика, ни по шаблону наименования).

[[Файл:Module supplierRestPriceImport task result.png|border|688px|Результат загрузки данных]]

Кроме того, есть возможность сформировать отчет по пропущенным товарам (например, для того, чтобы занести в систему новые товары поставщика).

[[Файл:Module supplierRestPriceImport report btn.png|border|500px|Кнопка для открытия отчета о пропущенных товарах]]

[[Файл:Module supplierRestPriceImport report.png|border|940px|Отчет о пропущенных товарах]]

[[Category:Интеграция с поставщиками]]

Загрузка данных с сайтов поставщиков

2016-11-10T12:50:28Z

Krylovia:

= Важно! =

Перед загрузкой данных с сайтов поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

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

Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

Модуль позволяет загружать цены и наличие товаров у поставщиков напрямую с их сайтов по расписанию.

Для этого поставщик должен предоставить ссылку на JSON или XML-файл, в котором отражены его остатки и/или его цены. Ссылка может быть как на сайт (начинается с "http://"), так и на ftp-сервер (начинается с "ftp://").

После предварительной настройки наша система будет по расписанию скачивать этот файл по ссылке и загружать из него наличие и цены товаров.

Поиск товаров для обновления цен и наличия будет осуществляться по следующему алгоритму:
# Сначала ищется товар с таким артикулом поставщика;
# Если товар не нашелся, то далее товар ищется по артикулу производителя;
# Если товар не нашелся, то по шаблону наименования формируется наименование и ищется товар с этим наименованием;

При этом есть возможность ограничить поиск товара определенной родительской группой товаров.

Если товар был найден не по артикулу поставщика, то артикул поставщика из файла будет привязан к товару автоматически.

'''Внимание!''' Модуль предназначен только для обновления цен и наличия для товаров, уже существующих в системе. Если в файле есть товары, которых нет в системе, то они не будут автоматически создаваться.

= Включение модуля =

Для включения модуля необходимо зайти в ваш [https://mrdoc.org/pcabinet личный кабинет на сайте mrdoc.org] и включить модуль "Интеграция с поставщиками".

[[Файл:Module supplierRestPriceImport turn on module.png|border|925px|Включение модуля в личном кабинете]]

= Настройка модуля =

После включения модуля в вашей программе появляется новый пункт меню "Настройки загрузки данных поставщиков".

Этот пункт ведет в журнал, где для каждого поставщика необходимо создать отдельную запись.

[[Файл:Module supplierRestPriceImport menu.png|border|748px|Пункт главного меню для настройки загрузки данных поставщиков]]

[[Файл:Module supplierRestPriceImport update.png|border|940px|Настройка загрузки данных с сайта поставщика]]

* '''Поставщик''' - поставщик, для которого будут загружаться цены и наличие. Цены будут загружаться по тому типу цен, который указан в карточке поставщика (в поле "Закупочный тип цен");
* '''Способ расчёта цены''' - способ вычисления итоговой цены поставщика для тех случаев, когда у поставщика несколько разных цен для одного товара (например, разные цены на разных складах);
* '''Периодичность''' - с какой периодичностью загружать данные с сайта поставщика;
* '''Валюта цен''' - валюта для загрузки цен;
* '''Сбрасывать наличие после загрузки''' - при установке этого флажка будет сбрасываться наличие для всех товаров, которых не было в файле, но по которым ранее было зафиксировано наличие у данного поставщика;
* '''Логин, пароль''' - некоторые поставщики требуют аутентификации для скачивания файла;
* '''Табличная часть "Настройки для обновления товаров"''' - это список правил для разбора файла:
** '''URL для загрузки файла''' - ссылка на файл поставщика;
** '''Узел товара''' - путь до узла товара внутри файла;
** '''Поле артикула''' - путь до поля с артикулом в рамках узла товара;
** '''Шаблон наименования''' - шаблон для формирования наименования, по которому будет искаться товар, если он не был найден по артикулу поставщика;
** '''Поля с кол-вами (через запятую)''' - пути до полей с количествами в рамках узла товара;
** '''Поля с ценами (через запятую)''' - пути до полей с ценами в рамках узла товара;
** '''Родительская группа для ограничения поиска''' - товары для обновления цен/наличия будут искаться только в рамках указанной родительской группы товаров;

== Пример настройки для XML-файла ==

Допустим, что поставщик предоставляет ссылку на XML-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.xml

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires>
<cae>003309</cae>
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires>
<cae>1014138</cae>
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims>
<cae>WHS152714</cae>
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims>
<cae>WHS152672</cae>
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "tires" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "rims" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

В файлах некоторых поставщиков могут использоваться атрибуты XML-узлов.

Например, в данном файле артикул товара указан в атрибуте узла товара, а не отдельным подузлом:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires cae="003309">
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires cae="1014138">
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims cae="WHS152714">
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims cae="WHS152672">
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В этом случае поле "Поле артикула" нужно заполнить так: "@cae" (символ "@" указывает на то, что это атрибут узла, а не отдельный узел).

== Пример настройки для JSON-файла ==

Допустим, что поставщик предоставляет ссылку на JSON-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.json

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
{
"tires": [
{
"cae": "003309",
"brand": "Nokian",
"size": "R19",
"model": "AH213-19",
"rest_msk": 5,
"rest_spb": 2,
"price_msk": 3650,
"price_spb": 3685
},
{
"cae": "1014138",
"brand": "Nokian",
"size": "R20",
"model": "AH213-20",
"rest_msk": 5,
"rest_spb": "более 40",
"price_msk": 4120,
"price_spb": 4120
},
...
],
"rims": [
{
"cae": "WHS152714",
"brand": "Nitro",
"model": "N20-123",
"rest_msk": 12,
"rest_spb": 2,
"price_msk": 2370,
"price_spb": 2370
},
{
"cae": "WHS152672",
"brand": "Nitro",
"model": "N20-124",
"rest_msk": 15,
"rest_spb": 7,
"price_msk": 3580,
"price_spb": 3600
},
...
]
}
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "tires";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "rims";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

= Контроль результатов загрузки данных =

После сохранения настройки автоматически создается задача, статус выполнения которой можно увидеть в отчете "Отчеты / Запланированные задачи".

В результатах задачи отображается общее количество обновленных цен/остатков, а также общее количество пропущенных товаров.

Пропущенные товары - это узлы в файле, для которых не было найдено соответствующих товаров в системе (ни по артикулу поставщика, ни по шаблону наименования).

[[Файл:Module supplierRestPriceImport task result.png|border|688px|Результат загрузки данных]]

Кроме того, есть возможность сформировать отчет по пропущенным товарам (например, для того, чтобы занести в систему новые товары поставщика).

[[Файл:Module supplierRestPriceImport report btn.png|border|500px|Кнопка для открытия отчета о пропущенных товарах]]

[[Файл:Module supplierRestPriceImport report.png|border|940px|Отчет о пропущенных товарах]]

[[Category:Интеграция с поставщиками]]

Загрузка данных с сайтов поставщиков

2016-11-10T08:06:45Z

Krylovia: /* Контроль результатов загрузки данных */

= Важно! =

Перед загрузкой данных с сайтов поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

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

Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

Модуль позволяет загружать цены и наличие товаров у поставщиков напрямую с их сайтов по расписанию.

Для этого поставщик должен предоставить ссылку на JSON или XML-файл, в котором отражены его остатки и/или его цены. Ссылка может быть как на сайт (начинается с "http://"), так и на ftp-сервер (начинается с "ftp://").

После предварительной настройки наша система будет по расписанию скачивать этот файл по ссылке и загружать из него наличие и цены товаров.

Поиск товаров для обновления цен и наличия будет осуществляться по следующему алгоритму:
# Сначала ищется товар с таким артикулом поставщика;
# Если товар не нашелся, то далее товар ищется по артикулу производителя;
# Если товар не нашелся, то по шаблону наименования формируется наименование и ищется товар с этим наименованием.

При этом есть возможность ограничить поиск товара определенной родительской группой товаров.

'''Внимание!''' Модуль предназначен только для обновления цен и наличия для товаров, уже существующих в системе. Если в файле есть товары, которых нет в системе, то они не будут автоматически создаваться.

= Включение модуля =

Для включения модуля необходимо зайти в ваш [https://mrdoc.org/pcabinet личный кабинет на сайте mrdoc.org] и включить модуль "Интеграция с поставщиками".

[[Файл:Module supplierRestPriceImport turn on module.png|border|925px|Включение модуля в личном кабинете]]

= Настройка модуля =

После включения модуля в вашей программе появляется новый пункт меню "Настройки загрузки данных поставщиков".

Этот пункт ведет в журнал, где для каждого поставщика необходимо создать отдельную запись.

[[Файл:Module supplierRestPriceImport menu.png|border|748px|Пункт главного меню для настройки загрузки данных поставщиков]]

[[Файл:Module supplierRestPriceImport update.png|border|940px|Настройка загрузки данных с сайта поставщика]]

* '''Поставщик''' - поставщик, для которого будут загружаться цены и наличие. Цены будут загружаться по тому типу цен, который указан в карточке поставщика (в поле "Закупочный тип цен");
* '''Способ расчёта цены''' - способ вычисления итоговой цены поставщика для тех случаев, когда у поставщика несколько разных цен для одного товара (например, разные цены на разных складах);
* '''Периодичность''' - с какой периодичностью загружать данные с сайта поставщика;
* '''Валюта цен''' - валюта для загрузки цен;
* '''Сбрасывать наличие после загрузки''' - при установке этого флажка будет сбрасываться наличие для всех товаров, которых не было в файле, но по которым ранее было зафиксировано наличие у данного поставщика;
* '''Логин, пароль''' - некоторые поставщики требуют аутентификации для скачивания файла;
* '''Табличная часть "Настройки для обновления товаров"''' - это список правил для разбора файла:
** '''URL для загрузки файла''' - ссылка на файл поставщика;
** '''Узел товара''' - путь до узла товара внутри файла;
** '''Поле артикула''' - путь до поля с артикулом в рамках узла товара;
** '''Шаблон наименования''' - шаблон для формирования наименования, по которому будет искаться товар, если он не был найден по артикулу поставщика;
** '''Поля с кол-вами (через запятую)''' - пути до полей с количествами в рамках узла товара;
** '''Поля с ценами (через запятую)''' - пути до полей с ценами в рамках узла товара;
** '''Родительская группа для ограничения поиска''' - товары для обновления цен/наличия будут искаться только в рамках указанной родительской группы товаров;

== Пример настройки для XML-файла ==

Допустим, что поставщик предоставляет ссылку на XML-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.xml

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires>
<cae>003309</cae>
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires>
<cae>1014138</cae>
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims>
<cae>WHS152714</cae>
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims>
<cae>WHS152672</cae>
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "tires" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "rims" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

В файлах некоторых поставщиков могут использоваться атрибуты XML-узлов.

Например, в данном файле артикул товара указан в атрибуте узла товара, а не отдельным подузлом:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires cae="003309">
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires cae="1014138">
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims cae="WHS152714">
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims cae="WHS152672">
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В этом случае поле "Поле артикула" нужно заполнить так: "@cae" (символ "@" указывает на то, что это атрибут узла, а не отдельный узел).

== Пример настройки для JSON-файла ==

Допустим, что поставщик предоставляет ссылку на JSON-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.json

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
{
"tires": [
{
"cae": "003309",
"brand": "Nokian",
"size": "R19",
"model": "AH213-19",
"rest_msk": 5,
"rest_spb": 2,
"price_msk": 3650,
"price_spb": 3685
},
{
"cae": "1014138",
"brand": "Nokian",
"size": "R20",
"model": "AH213-20",
"rest_msk": 5,
"rest_spb": "более 40",
"price_msk": 4120,
"price_spb": 4120
},
...
],
"rims": [
{
"cae": "WHS152714",
"brand": "Nitro",
"model": "N20-123",
"rest_msk": 12,
"rest_spb": 2,
"price_msk": 2370,
"price_spb": 2370
},
{
"cae": "WHS152672",
"brand": "Nitro",
"model": "N20-124",
"rest_msk": 15,
"rest_spb": 7,
"price_msk": 3580,
"price_spb": 3600
},
...
]
}
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "tires";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "rims";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

= Контроль результатов загрузки данных =

После сохранения настройки автоматически создается задача, статус выполнения которой можно увидеть в отчете "Отчеты / Запланированные задачи".

В результатах задачи отображается общее количество обновленных цен/остатков, а также общее количество пропущенных товаров.

Пропущенные товары - это узлы в файле, для которых не было найдено соответствующих товаров в системе (ни по артикулу поставщика, ни по шаблону наименования).

[[Файл:Module supplierRestPriceImport task result.png|border|688px|Результат загрузки данных]]

Кроме того, есть возможность сформировать отчет по пропущенным товарам (например, для того, чтобы занести в систему новые товары поставщика).

[[Файл:Module supplierRestPriceImport report btn.png|border|500px|Кнопка для открытия отчета о пропущенных товарах]]

[[Файл:Module supplierRestPriceImport report.png|border|940px|Отчет о пропущенных товарах]]

[[Category:Интеграция с поставщиками]]

Загрузка данных с сайтов поставщиков

2016-11-10T08:06:19Z

Krylovia: /* Контроль результатов загрузки данных */

= Важно! =

Перед загрузкой данных с сайтов поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

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

Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

Модуль позволяет загружать цены и наличие товаров у поставщиков напрямую с их сайтов по расписанию.

Для этого поставщик должен предоставить ссылку на JSON или XML-файл, в котором отражены его остатки и/или его цены. Ссылка может быть как на сайт (начинается с "http://"), так и на ftp-сервер (начинается с "ftp://").

После предварительной настройки наша система будет по расписанию скачивать этот файл по ссылке и загружать из него наличие и цены товаров.

Поиск товаров для обновления цен и наличия будет осуществляться по следующему алгоритму:
# Сначала ищется товар с таким артикулом поставщика;
# Если товар не нашелся, то далее товар ищется по артикулу производителя;
# Если товар не нашелся, то по шаблону наименования формируется наименование и ищется товар с этим наименованием.

При этом есть возможность ограничить поиск товара определенной родительской группой товаров.

'''Внимание!''' Модуль предназначен только для обновления цен и наличия для товаров, уже существующих в системе. Если в файле есть товары, которых нет в системе, то они не будут автоматически создаваться.

= Включение модуля =

Для включения модуля необходимо зайти в ваш [https://mrdoc.org/pcabinet личный кабинет на сайте mrdoc.org] и включить модуль "Интеграция с поставщиками".

[[Файл:Module supplierRestPriceImport turn on module.png|border|925px|Включение модуля в личном кабинете]]

= Настройка модуля =

После включения модуля в вашей программе появляется новый пункт меню "Настройки загрузки данных поставщиков".

Этот пункт ведет в журнал, где для каждого поставщика необходимо создать отдельную запись.

[[Файл:Module supplierRestPriceImport menu.png|border|748px|Пункт главного меню для настройки загрузки данных поставщиков]]

[[Файл:Module supplierRestPriceImport update.png|border|940px|Настройка загрузки данных с сайта поставщика]]

* '''Поставщик''' - поставщик, для которого будут загружаться цены и наличие. Цены будут загружаться по тому типу цен, который указан в карточке поставщика (в поле "Закупочный тип цен");
* '''Способ расчёта цены''' - способ вычисления итоговой цены поставщика для тех случаев, когда у поставщика несколько разных цен для одного товара (например, разные цены на разных складах);
* '''Периодичность''' - с какой периодичностью загружать данные с сайта поставщика;
* '''Валюта цен''' - валюта для загрузки цен;
* '''Сбрасывать наличие после загрузки''' - при установке этого флажка будет сбрасываться наличие для всех товаров, которых не было в файле, но по которым ранее было зафиксировано наличие у данного поставщика;
* '''Логин, пароль''' - некоторые поставщики требуют аутентификации для скачивания файла;
* '''Табличная часть "Настройки для обновления товаров"''' - это список правил для разбора файла:
** '''URL для загрузки файла''' - ссылка на файл поставщика;
** '''Узел товара''' - путь до узла товара внутри файла;
** '''Поле артикула''' - путь до поля с артикулом в рамках узла товара;
** '''Шаблон наименования''' - шаблон для формирования наименования, по которому будет искаться товар, если он не был найден по артикулу поставщика;
** '''Поля с кол-вами (через запятую)''' - пути до полей с количествами в рамках узла товара;
** '''Поля с ценами (через запятую)''' - пути до полей с ценами в рамках узла товара;
** '''Родительская группа для ограничения поиска''' - товары для обновления цен/наличия будут искаться только в рамках указанной родительской группы товаров;

== Пример настройки для XML-файла ==

Допустим, что поставщик предоставляет ссылку на XML-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.xml

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires>
<cae>003309</cae>
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires>
<cae>1014138</cae>
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims>
<cae>WHS152714</cae>
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims>
<cae>WHS152672</cae>
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "tires" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "rims" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

В файлах некоторых поставщиков могут использоваться атрибуты XML-узлов.

Например, в данном файле артикул товара указан в атрибуте узла товара, а не отдельным подузлом:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires cae="003309">
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires cae="1014138">
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims cae="WHS152714">
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims cae="WHS152672">
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В этом случае поле "Поле артикула" нужно заполнить так: "@cae" (символ "@" указывает на то, что это атрибут узла, а не отдельный узел).

== Пример настройки для JSON-файла ==

Допустим, что поставщик предоставляет ссылку на JSON-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.json

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
{
"tires": [
{
"cae": "003309",
"brand": "Nokian",
"size": "R19",
"model": "AH213-19",
"rest_msk": 5,
"rest_spb": 2,
"price_msk": 3650,
"price_spb": 3685
},
{
"cae": "1014138",
"brand": "Nokian",
"size": "R20",
"model": "AH213-20",
"rest_msk": 5,
"rest_spb": "более 40",
"price_msk": 4120,
"price_spb": 4120
},
...
],
"rims": [
{
"cae": "WHS152714",
"brand": "Nitro",
"model": "N20-123",
"rest_msk": 12,
"rest_spb": 2,
"price_msk": 2370,
"price_spb": 2370
},
{
"cae": "WHS152672",
"brand": "Nitro",
"model": "N20-124",
"rest_msk": 15,
"rest_spb": 7,
"price_msk": 3580,
"price_spb": 3600
},
...
]
}
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "tires";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "rims";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

= Контроль результатов загрузки данных =

После сохранения настройки автоматически создается задача, статус выполнения которой можно увидеть в отчете "Отчеты / Запланированные задачи".

В результатах задачи отображается общее количество обновленных цен/остатков, а также общее количество пропущенных товаров.

Пропущенные товары - это узлы в файле, для которых не было найдено соответствующих товаров в системе (ни по артикулу поставщика, ни по шаблону наименования).

[[Файл:Module supplierRestPriceImport task result.png|border|688px|Результат загрузки данных]]

Кроме того, есть возможность сформировать отчет по пропущенным товарам (например, для того, чтобы занести в систему новые товары поставщика).

[[Файл:Module supplierRestPriceImport report btn.png|border|500px|Кнопка для открытия отчета о пропущенных товарах]]
[[Файл:Module supplierRestPriceImport report.png|border|940px|Отчет о пропущенных товарах]]

[[Category:Интеграция с поставщиками]]

Файл:Module supplierRestPriceImport report.png

2016-11-10T08:04:43Z

Krylovia:

Файл:Module supplierRestPriceImport report btn.png

2016-11-10T08:04:07Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-11-10T07:06:33Z

Krylovia: /* Настройка модуля */

= Важно! =

Перед загрузкой данных с сайтов поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

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

Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

Модуль позволяет загружать цены и наличие товаров у поставщиков напрямую с их сайтов по расписанию.

Для этого поставщик должен предоставить ссылку на JSON или XML-файл, в котором отражены его остатки и/или его цены. Ссылка может быть как на сайт (начинается с "http://"), так и на ftp-сервер (начинается с "ftp://").

После предварительной настройки наша система будет по расписанию скачивать этот файл по ссылке и загружать из него наличие и цены товаров.

Поиск товаров для обновления цен и наличия будет осуществляться по следующему алгоритму:
# Сначала ищется товар с таким артикулом поставщика;
# Если товар не нашелся, то далее товар ищется по артикулу производителя;
# Если товар не нашелся, то по шаблону наименования формируется наименование и ищется товар с этим наименованием.

При этом есть возможность ограничить поиск товара определенной родительской группой товаров.

'''Внимание!''' Модуль предназначен только для обновления цен и наличия для товаров, уже существующих в системе. Если в файле есть товары, которых нет в системе, то они не будут автоматически создаваться.

= Включение модуля =

Для включения модуля необходимо зайти в ваш [https://mrdoc.org/pcabinet личный кабинет на сайте mrdoc.org] и включить модуль "Интеграция с поставщиками".

[[Файл:Module supplierRestPriceImport turn on module.png|border|925px|Включение модуля в личном кабинете]]

= Настройка модуля =

После включения модуля в вашей программе появляется новый пункт меню "Настройки загрузки данных поставщиков".

Этот пункт ведет в журнал, где для каждого поставщика необходимо создать отдельную запись.

[[Файл:Module supplierRestPriceImport menu.png|border|748px|Пункт главного меню для настройки загрузки данных поставщиков]]

[[Файл:Module supplierRestPriceImport update.png|border|940px|Настройка загрузки данных с сайта поставщика]]

* '''Поставщик''' - поставщик, для которого будут загружаться цены и наличие. Цены будут загружаться по тому типу цен, который указан в карточке поставщика (в поле "Закупочный тип цен");
* '''Способ расчёта цены''' - способ вычисления итоговой цены поставщика для тех случаев, когда у поставщика несколько разных цен для одного товара (например, разные цены на разных складах);
* '''Периодичность''' - с какой периодичностью загружать данные с сайта поставщика;
* '''Валюта цен''' - валюта для загрузки цен;
* '''Сбрасывать наличие после загрузки''' - при установке этого флажка будет сбрасываться наличие для всех товаров, которых не было в файле, но по которым ранее было зафиксировано наличие у данного поставщика;
* '''Логин, пароль''' - некоторые поставщики требуют аутентификации для скачивания файла;
* '''Табличная часть "Настройки для обновления товаров"''' - это список правил для разбора файла:
** '''URL для загрузки файла''' - ссылка на файл поставщика;
** '''Узел товара''' - путь до узла товара внутри файла;
** '''Поле артикула''' - путь до поля с артикулом в рамках узла товара;
** '''Шаблон наименования''' - шаблон для формирования наименования, по которому будет искаться товар, если он не был найден по артикулу поставщика;
** '''Поля с кол-вами (через запятую)''' - пути до полей с количествами в рамках узла товара;
** '''Поля с ценами (через запятую)''' - пути до полей с ценами в рамках узла товара;
** '''Родительская группа для ограничения поиска''' - товары для обновления цен/наличия будут искаться только в рамках указанной родительской группы товаров;

== Пример настройки для XML-файла ==

Допустим, что поставщик предоставляет ссылку на XML-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.xml

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires>
<cae>003309</cae>
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires>
<cae>1014138</cae>
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims>
<cae>WHS152714</cae>
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims>
<cae>WHS152672</cae>
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "tires" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "rims" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

В файлах некоторых поставщиков могут использоваться атрибуты XML-узлов.

Например, в данном файле артикул товара указан в атрибуте узла товара, а не отдельным подузлом:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires cae="003309">
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires cae="1014138">
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims cae="WHS152714">
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims cae="WHS152672">
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В этом случае поле "Поле артикула" нужно заполнить так: "@cae" (символ "@" указывает на то, что это атрибут узла, а не отдельный узел).

== Пример настройки для JSON-файла ==

Допустим, что поставщик предоставляет ссылку на JSON-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.json

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
{
"tires": [
{
"cae": "003309",
"brand": "Nokian",
"size": "R19",
"model": "AH213-19",
"rest_msk": 5,
"rest_spb": 2,
"price_msk": 3650,
"price_spb": 3685
},
{
"cae": "1014138",
"brand": "Nokian",
"size": "R20",
"model": "AH213-20",
"rest_msk": 5,
"rest_spb": "более 40",
"price_msk": 4120,
"price_spb": 4120
},
...
],
"rims": [
{
"cae": "WHS152714",
"brand": "Nitro",
"model": "N20-123",
"rest_msk": 12,
"rest_spb": 2,
"price_msk": 2370,
"price_spb": 2370
},
{
"cae": "WHS152672",
"brand": "Nitro",
"model": "N20-124",
"rest_msk": 15,
"rest_spb": 7,
"price_msk": 3580,
"price_spb": 3600
},
...
]
}
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "tires";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "rims";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

= Контроль результатов загрузки данных =

После сохранения настройки автоматически создается задача, статус выполнения которой можно увидеть в отчете "Отчеты / Запланированные задачи".

В результатах задачи отображается общее количество обновленных цен/остатков, а также общее количество пропущенных товаров.

Пропущенные товары - это узлы в файле, для которых не было найдено соответствующих товаров в системе (ни по артикулу поставщика, ни по шаблону наименования).

[[Файл:Module supplierRestPriceImport task result.png|border|688px|Результат загрузки данных]]

[[Category:Интеграция с поставщиками]]

Файл:Module supplierRestPriceImport update.png

2016-11-10T07:04:56Z

Krylovia: Krylovia загрузил новую версию Файл:Module supplierRestPriceImport update.png

Настройка загрузки данных с сайта поставщика

Загрузка данных с сайтов поставщиков

2016-11-09T12:37:28Z

Krylovia: /* Возможности */

= Важно! =

Перед загрузкой данных с сайтов поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

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

Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

Модуль позволяет загружать цены и наличие товаров у поставщиков напрямую с их сайтов по расписанию.

Для этого поставщик должен предоставить ссылку на JSON или XML-файл, в котором отражены его остатки и/или его цены. Ссылка может быть как на сайт (начинается с "http://"), так и на ftp-сервер (начинается с "ftp://").

После предварительной настройки наша система будет по расписанию скачивать этот файл по ссылке и загружать из него наличие и цены товаров.

Поиск товаров для обновления цен и наличия будет осуществляться по следующему алгоритму:
# Сначала ищется товар с таким артикулом поставщика;
# Если товар не нашелся, то далее товар ищется по артикулу производителя;
# Если товар не нашелся, то по шаблону наименования формируется наименование и ищется товар с этим наименованием.

При этом есть возможность ограничить поиск товара определенной родительской группой товаров.

'''Внимание!''' Модуль предназначен только для обновления цен и наличия для товаров, уже существующих в системе. Если в файле есть товары, которых нет в системе, то они не будут автоматически создаваться.

= Включение модуля =

Для включения модуля необходимо зайти в ваш [https://mrdoc.org/pcabinet личный кабинет на сайте mrdoc.org] и включить модуль "Интеграция с поставщиками".

[[Файл:Module supplierRestPriceImport turn on module.png|border|925px|Включение модуля в личном кабинете]]

= Настройка модуля =

После включения модуля в вашей программе появляется новый пункт меню "Настройки загрузки данных поставщиков".

Этот пункт ведет в журнал, где для каждого поставщика необходимо создать отдельную запись.

[[Файл:Module supplierRestPriceImport menu.png|border|748px|Пункт главного меню для настройки загрузки данных поставщиков]]

[[Файл:Module supplierRestPriceImport update.png|border|940px|Настройка загрузки данных с сайта поставщика]]

* '''Поставщик''' - поставщик, для которого будут загружаться цены и наличие. Цены будут загружаться по тому типу цен, который указан в карточке поставщика (в поле "Закупочный тип цен");
* '''Способ расчёта цены''' - способ вычисления итоговой цены поставщика для тех случаев, когда у поставщика несколько разных цен для одного товара (например, разные цены на разных складах);
* '''Периодичность''' - с какой периодичностью загружать данные с сайта поставщика;
* '''Валюта цен''' - валюта для загрузки цен;
* '''Сбрасывать наличие после загрузки''' - при установке этого флажка будет сбрасываться наличие для всех товаров, которых не было в файле, но по которым ранее было зафиксировано наличие у данного поставщика;
* '''Логин, пароль''' - некоторые поставщики требуют аутентификации для скачивания файла;
* '''Табличная часть "Настройки для обновления товаров"''' - это список правил для разбора файла:
** '''URL для загрузки файла''' - ссылка на файл поставщика;
** '''Узел товара''' - путь до узла товара внутри файла;
** '''Поле артикула''' - путь до поля с артикулом в рамках узла товара;
** '''Шаблон наименования''' - шаблон для формирования наименования, по которому будет искаться товар, если он не был найден по артикулу поставщика;
** '''Поля с кол-вами (через запятую)''' - пути до полей с количествами в рамках узла товара;
** '''Поля с ценами (через запятую)''' - пути до полей с ценами в рамках узла товара;

== Пример настройки для XML-файла ==

Допустим, что поставщик предоставляет ссылку на XML-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.xml

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires>
<cae>003309</cae>
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires>
<cae>1014138</cae>
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims>
<cae>WHS152714</cae>
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims>
<cae>WHS152672</cae>
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "tires" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "rims" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

В файлах некоторых поставщиков могут использоваться атрибуты XML-узлов.

Например, в данном файле артикул товара указан в атрибуте узла товара, а не отдельным подузлом:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires cae="003309">
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires cae="1014138">
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims cae="WHS152714">
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims cae="WHS152672">
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В этом случае поле "Поле артикула" нужно заполнить так: "@cae" (символ "@" указывает на то, что это атрибут узла, а не отдельный узел).

== Пример настройки для JSON-файла ==

Допустим, что поставщик предоставляет ссылку на JSON-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.json

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
{
"tires": [
{
"cae": "003309",
"brand": "Nokian",
"size": "R19",
"model": "AH213-19",
"rest_msk": 5,
"rest_spb": 2,
"price_msk": 3650,
"price_spb": 3685
},
{
"cae": "1014138",
"brand": "Nokian",
"size": "R20",
"model": "AH213-20",
"rest_msk": 5,
"rest_spb": "более 40",
"price_msk": 4120,
"price_spb": 4120
},
...
],
"rims": [
{
"cae": "WHS152714",
"brand": "Nitro",
"model": "N20-123",
"rest_msk": 12,
"rest_spb": 2,
"price_msk": 2370,
"price_spb": 2370
},
{
"cae": "WHS152672",
"brand": "Nitro",
"model": "N20-124",
"rest_msk": 15,
"rest_spb": 7,
"price_msk": 3580,
"price_spb": 3600
},
...
]
}
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "tires";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "rims";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

= Контроль результатов загрузки данных =

После сохранения настройки автоматически создается задача, статус выполнения которой можно увидеть в отчете "Отчеты / Запланированные задачи".

В результатах задачи отображается общее количество обновленных цен/остатков, а также общее количество пропущенных товаров.

Пропущенные товары - это узлы в файле, для которых не было найдено соответствующих товаров в системе (ни по артикулу поставщика, ни по шаблону наименования).

[[Файл:Module supplierRestPriceImport task result.png|border|688px|Результат загрузки данных]]

[[Category:Интеграция с поставщиками]]

Загрузка данных с сайтов поставщиков

2016-11-09T12:35:44Z

Krylovia: /* Возможности */

= Важно! =

Перед загрузкой данных с сайтов поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

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

Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

Модуль позволяет загружать цены и наличие товаров у поставщиков напрямую с их сайтов по расписанию.

Для этого поставщик должен предоставить ссылку на JSON или XML-файл, в котором отражены его остатки и/или его цены. Ссылка может быть как на сайт (начинается с "http://"), так и на ftp-сервер (начинается с "ftp://").

После предварительной настройки наша система будет по расписанию скачивать этот файл по ссылке и загружать из него наличие и цены товаров.

Поиск товаров для обновления цен и наличия будет осуществляться по следующему алгоритму:
# Сначала ищется товар с таким артикулом поставщика
# Если товар не нашелся, то далее товар ищется по артикулу производителя
# Если товар не нашелся, то по шаблону наименования формируется наименование и ищется товар с этим наименованием.

При этом есть возможность ограничить поиск товара определенной родительской группой товаров.

'''Внимание!''' Модуль предназначен только для обновления цен и наличия для товаров, уже существующих в системе. Если в файле есть товары, которых нет в системе, то они не будут автоматически создаваться.

= Включение модуля =

Для включения модуля необходимо зайти в ваш [https://mrdoc.org/pcabinet личный кабинет на сайте mrdoc.org] и включить модуль "Интеграция с поставщиками".

[[Файл:Module supplierRestPriceImport turn on module.png|border|925px|Включение модуля в личном кабинете]]

= Настройка модуля =

После включения модуля в вашей программе появляется новый пункт меню "Настройки загрузки данных поставщиков".

Этот пункт ведет в журнал, где для каждого поставщика необходимо создать отдельную запись.

[[Файл:Module supplierRestPriceImport menu.png|border|748px|Пункт главного меню для настройки загрузки данных поставщиков]]

[[Файл:Module supplierRestPriceImport update.png|border|940px|Настройка загрузки данных с сайта поставщика]]

* '''Поставщик''' - поставщик, для которого будут загружаться цены и наличие. Цены будут загружаться по тому типу цен, который указан в карточке поставщика (в поле "Закупочный тип цен");
* '''Способ расчёта цены''' - способ вычисления итоговой цены поставщика для тех случаев, когда у поставщика несколько разных цен для одного товара (например, разные цены на разных складах);
* '''Периодичность''' - с какой периодичностью загружать данные с сайта поставщика;
* '''Валюта цен''' - валюта для загрузки цен;
* '''Сбрасывать наличие после загрузки''' - при установке этого флажка будет сбрасываться наличие для всех товаров, которых не было в файле, но по которым ранее было зафиксировано наличие у данного поставщика;
* '''Логин, пароль''' - некоторые поставщики требуют аутентификации для скачивания файла;
* '''Табличная часть "Настройки для обновления товаров"''' - это список правил для разбора файла:
** '''URL для загрузки файла''' - ссылка на файл поставщика;
** '''Узел товара''' - путь до узла товара внутри файла;
** '''Поле артикула''' - путь до поля с артикулом в рамках узла товара;
** '''Шаблон наименования''' - шаблон для формирования наименования, по которому будет искаться товар, если он не был найден по артикулу поставщика;
** '''Поля с кол-вами (через запятую)''' - пути до полей с количествами в рамках узла товара;
** '''Поля с ценами (через запятую)''' - пути до полей с ценами в рамках узла товара;

== Пример настройки для XML-файла ==

Допустим, что поставщик предоставляет ссылку на XML-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.xml

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires>
<cae>003309</cae>
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires>
<cae>1014138</cae>
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims>
<cae>WHS152714</cae>
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims>
<cae>WHS152672</cae>
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "tires" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "rims" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

В файлах некоторых поставщиков могут использоваться атрибуты XML-узлов.

Например, в данном файле артикул товара указан в атрибуте узла товара, а не отдельным подузлом:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires cae="003309">
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires cae="1014138">
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims cae="WHS152714">
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims cae="WHS152672">
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В этом случае поле "Поле артикула" нужно заполнить так: "@cae" (символ "@" указывает на то, что это атрибут узла, а не отдельный узел).

== Пример настройки для JSON-файла ==

Допустим, что поставщик предоставляет ссылку на JSON-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.json

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
{
"tires": [
{
"cae": "003309",
"brand": "Nokian",
"size": "R19",
"model": "AH213-19",
"rest_msk": 5,
"rest_spb": 2,
"price_msk": 3650,
"price_spb": 3685
},
{
"cae": "1014138",
"brand": "Nokian",
"size": "R20",
"model": "AH213-20",
"rest_msk": 5,
"rest_spb": "более 40",
"price_msk": 4120,
"price_spb": 4120
},
...
],
"rims": [
{
"cae": "WHS152714",
"brand": "Nitro",
"model": "N20-123",
"rest_msk": 12,
"rest_spb": 2,
"price_msk": 2370,
"price_spb": 2370
},
{
"cae": "WHS152672",
"brand": "Nitro",
"model": "N20-124",
"rest_msk": 15,
"rest_spb": 7,
"price_msk": 3580,
"price_spb": 3600
},
...
]
}
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "tires";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "rims";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

= Контроль результатов загрузки данных =

После сохранения настройки автоматически создается задача, статус выполнения которой можно увидеть в отчете "Отчеты / Запланированные задачи".

В результатах задачи отображается общее количество обновленных цен/остатков, а также общее количество пропущенных товаров.

Пропущенные товары - это узлы в файле, для которых не было найдено соответствующих товаров в системе (ни по артикулу поставщика, ни по шаблону наименования).

[[Файл:Module supplierRestPriceImport task result.png|border|688px|Результат загрузки данных]]

[[Category:Интеграция с поставщиками]]

Загрузка данных с сайтов поставщиков

2016-11-09T12:34:35Z

Krylovia: /* Возможности */

= Важно! =

Перед загрузкой данных с сайтов поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

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

Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

Модуль позволяет загружать цены и наличие товаров у поставщиков напрямую с их сайтов по расписанию.

Для этого поставщик должен предоставить ссылку на JSON или XML-файл, в котором отражены его остатки и/или его цены. Ссылка может быть как на сайт (начинается с "http://"), так и на ftp-сервер (начинается с "ftp://").

После предварительной настройки наша система будет по расписанию скачивать этот файл по ссылке и загружать из него наличие и цены товаров.

Поиск товаров для обновления цен и наличия будет осуществляться по следующему алгоритму:
# Сначала ищется товар с таким артикулом поставщика
# Если товар не нашелся, то далее товар ищется по артикулу производителя
# Если товар не нашелся, то по шаблону наименования формируется наименование и ищется товар с этим наименованием.

'''Внимание!''' Модуль предназначен только для обновления цен и наличия для товаров, уже существующих в системе. Если в файле есть товары, которых нет в системе, то они не будут автоматически создаваться.

= Включение модуля =

Для включения модуля необходимо зайти в ваш [https://mrdoc.org/pcabinet личный кабинет на сайте mrdoc.org] и включить модуль "Интеграция с поставщиками".

[[Файл:Module supplierRestPriceImport turn on module.png|border|925px|Включение модуля в личном кабинете]]

= Настройка модуля =

После включения модуля в вашей программе появляется новый пункт меню "Настройки загрузки данных поставщиков".

Этот пункт ведет в журнал, где для каждого поставщика необходимо создать отдельную запись.

[[Файл:Module supplierRestPriceImport menu.png|border|748px|Пункт главного меню для настройки загрузки данных поставщиков]]

[[Файл:Module supplierRestPriceImport update.png|border|940px|Настройка загрузки данных с сайта поставщика]]

* '''Поставщик''' - поставщик, для которого будут загружаться цены и наличие. Цены будут загружаться по тому типу цен, который указан в карточке поставщика (в поле "Закупочный тип цен");
* '''Способ расчёта цены''' - способ вычисления итоговой цены поставщика для тех случаев, когда у поставщика несколько разных цен для одного товара (например, разные цены на разных складах);
* '''Периодичность''' - с какой периодичностью загружать данные с сайта поставщика;
* '''Валюта цен''' - валюта для загрузки цен;
* '''Сбрасывать наличие после загрузки''' - при установке этого флажка будет сбрасываться наличие для всех товаров, которых не было в файле, но по которым ранее было зафиксировано наличие у данного поставщика;
* '''Логин, пароль''' - некоторые поставщики требуют аутентификации для скачивания файла;
* '''Табличная часть "Настройки для обновления товаров"''' - это список правил для разбора файла:
** '''URL для загрузки файла''' - ссылка на файл поставщика;
** '''Узел товара''' - путь до узла товара внутри файла;
** '''Поле артикула''' - путь до поля с артикулом в рамках узла товара;
** '''Шаблон наименования''' - шаблон для формирования наименования, по которому будет искаться товар, если он не был найден по артикулу поставщика;
** '''Поля с кол-вами (через запятую)''' - пути до полей с количествами в рамках узла товара;
** '''Поля с ценами (через запятую)''' - пути до полей с ценами в рамках узла товара;

== Пример настройки для XML-файла ==

Допустим, что поставщик предоставляет ссылку на XML-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.xml

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires>
<cae>003309</cae>
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires>
<cae>1014138</cae>
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims>
<cae>WHS152714</cae>
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims>
<cae>WHS152672</cae>
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "tires" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "rims" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

В файлах некоторых поставщиков могут использоваться атрибуты XML-узлов.

Например, в данном файле артикул товара указан в атрибуте узла товара, а не отдельным подузлом:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires cae="003309">
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires cae="1014138">
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims cae="WHS152714">
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims cae="WHS152672">
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В этом случае поле "Поле артикула" нужно заполнить так: "@cae" (символ "@" указывает на то, что это атрибут узла, а не отдельный узел).

== Пример настройки для JSON-файла ==

Допустим, что поставщик предоставляет ссылку на JSON-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.json

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
{
"tires": [
{
"cae": "003309",
"brand": "Nokian",
"size": "R19",
"model": "AH213-19",
"rest_msk": 5,
"rest_spb": 2,
"price_msk": 3650,
"price_spb": 3685
},
{
"cae": "1014138",
"brand": "Nokian",
"size": "R20",
"model": "AH213-20",
"rest_msk": 5,
"rest_spb": "более 40",
"price_msk": 4120,
"price_spb": 4120
},
...
],
"rims": [
{
"cae": "WHS152714",
"brand": "Nitro",
"model": "N20-123",
"rest_msk": 12,
"rest_spb": 2,
"price_msk": 2370,
"price_spb": 2370
},
{
"cae": "WHS152672",
"brand": "Nitro",
"model": "N20-124",
"rest_msk": 15,
"rest_spb": 7,
"price_msk": 3580,
"price_spb": 3600
},
...
]
}
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "tires";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "rims";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

= Контроль результатов загрузки данных =

После сохранения настройки автоматически создается задача, статус выполнения которой можно увидеть в отчете "Отчеты / Запланированные задачи".

В результатах задачи отображается общее количество обновленных цен/остатков, а также общее количество пропущенных товаров.

Пропущенные товары - это узлы в файле, для которых не было найдено соответствующих товаров в системе (ни по артикулу поставщика, ни по шаблону наименования).

[[Файл:Module supplierRestPriceImport task result.png|border|688px|Результат загрузки данных]]

[[Category:Интеграция с поставщиками]]

Синхронизация с интернет-магазином Prestashop

2016-10-26T07:10:47Z

Krylovia: /* Обновление цен на сайте */

= Важно! =

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

Компания "КлаудТим" не несет ответственности за любые проблемы, прямо или косвенно связанные с синхронизацией.
Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации, однако Prestashop имеет много подверсий и модулей с различным количеством проблем и ошибок. Поэтому протестировать все их сочетания не представляется возможным.

= Возможности =

Между MrDoc и сайтом синхронизируются товары, категории, покупатели и их заказы.
Также поддерживается выгрузка на сайт цен и складских остатков товаров.

Существует возможность ограничить список синхронизируемых объектов (например, синхронизировать только справочник товаров).

Поддерживаемые версии PrestaShop: 1.5, 1.6.

== Синхронизация справочников ==

{| class="wikitable"
!colspan="2"|Соответствие объектов
|-
!style="width:50%;"|Объект на сайте
!style="width:50%;"|Объект в MrDoc
|-
|Товар
|Элемент справочника "Номенклатура"
|-
|Комбинация товара
|Элемент справочника "Модификации номенклатуры"
|-
|Категория товаров
|Группа справочника "Номенклатура"
|-
|Производитель
|Элемент справочника "Производители"
|-
|Поставщик
|Элемент справочника "Контрагенты"
|-
|Покупатель
|Элемент справочника "Контрагенты"
|}

=== Синхронизация товаров и категорий ===

Порядок первоначальной синхронизации товаров при настройке обмена с сайтом:

* Сначала с сайта загружаются все товары, их комбинации, а также все категории. При загрузке товаров и категорий система сразу пытается связать их с уже существующими товарами и категориями по наименованию, тем самым исключая дублирование товаров/категорий, вручную занесенных в MrDoc. При загрузке комбинаций система не пытается связывать их с уже существующими в MrDoc модификациями, за исключением комбинации по умолчанию - она всегда связывается с базовой модификацией товара.
* Затем на сайт выгружаются все товары и категории, отсутствующие на сайте (за исключением помеченных на удаление). При этом модификации для таких товаров на сайт не выгружаются.

Порядок последующей синхронизации товаров:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Система регистрирует изменения справочника "Номенклатура", тем самым формируя список товаров/категорий, которые необходимо выгрузить на сайт при очередной синхронизации.
* Также регистрация изменений товаров/комбинаций/категорий происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* При выполнении очередной синхронизации сначала загружаются все изменения с сайта в MrDoc, затем выгружаются изменения из MrDoc на сайт. При этом возможна ситуация, когда товар был одновременно изменен и на сайте и в MrDoc. В этом случае изменения на сайте будут иметь приоритет, так как загрузка данных с сайта происходит перед выгрузкой данных на сайт.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов товара
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Тип
|Вид номенклатуры
|Виртуальные товары загружаются в виде услуг, остальные типы - в виде товаров.
|-
|Артикул
|Артикул базовой модификации
|Максимальная длина 100 символов.
|-
|Штрихкод
|Штрихкод EAN13 для базовой модификации товара
|
|-
|Производитель
|Производитель
|
|-
|Категория по умолчанию
|Родительская группа
|Если у товара на сайте есть связи с несколькими категориями, то при смене категории в MrDoc все эти связи на сайте сохраняются. Если у товара на сайте есть связь только с одной категорией (основной), то при изменении категории в MrDoc товар потеряет связь с прошлой категорией.
|-
|Налоговые правила
|Ставка НДС
|Соответствие ставок НДС налоговым правилам осуществляется при первоначальной настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
|-
|Комбинация по умолчанию
|Базовая модификация
|Выгрузка новых модификаций на сайт не поддерживается. Новый товар всегда выгружается без модификаций.
|-
|Артикулы поставщиков
|Артикулы поставщиков
|
|}

Для всех новых товаров с сайта автоматически устанавливаются цены сайта (цены фиксируются для типа цен, указанного в настройке обмена). Для новых товаров, выгружаемых на сайт цена устанавлиается в соотвествии с типом цен, указанным в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").

Новые товары всегда выгружаются на сайт со статусом "Запрещен" и видимостью "Нигде".
При дальнейшей синхронизации статус товара не изменяется, то есть статус в Prestashop не зависит от статуса товара в MrDoc.

Для новых товаров, загруженных с сайта, автоматически устанавливается комментарий "Товар загружен с сайта Prestashop".

{| class="wikitable"
!colspan="3"|Соответствие реквизитов группы (категории)
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Родительская категория
|Родительская группа
|
|-
|Отображено
|Статус
|Отображение на сайте включается только для групп со статусом "Активен".
|}

Для новых групп (категорий), загруженных с сайта, автоматически устанавливается комментарий "Категория загружена с сайта Prestashop".

{| class="wikitable"
!colspan="3"|Соответствие реквизитов модификации (комбинации)
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Значения свойств комбинации
|Наименование модификации формируется из значений её свойств при загрузке с сайта.
|-
|Артикул
|Артикул
|
|}

Выгрузка новых модификаций на сайт не поддерживается.

Для новых модификаций (комбинаций), загруженных с сайта, автоматически устанавливается комментарий "Модификация товара загружена с сайта Prestashop".

=== Синхронизация производителей ===

Порядок первоначальной синхронизации производителей при настройке обмена с сайтом:

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

Порядок последующей синхронизации производителей:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Система регистрирует изменения справочника "Производители", тем самым формируя список производителей, которые необходимо выгрузить на сайт при очередной синхронизации.
* Также регистрация изменений производителей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* При выполнении очередной синхронизации сначала загружаются все изменения с сайта в MrDoc, затем выгружаются изменения из MrDoc на сайт. При этом возможна ситуация, когда производитель был одновременно изменен и на сайте и в MrDoc. В этом случае изменения на сайте будут иметь приоритет, так как загрузка данных с сайта происходит перед выгрузкой данных на сайт.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов производителя
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Включено
|Статус
|На сайте включаются только производители со статусом "Активен".
|}

Для новых производителей, загруженных с сайта, автоматически устанавливается комментарий "Производитель загружен с сайта Prestashop".

=== Синхронизация поставщиков ===

Порядок первоначальной синхронизации поставщиков при настройке обмена с сайтом:

* С сайта загружаются все поставщики. При загрузке поставщиков система сразу пытается связать их с уже существующими поставщиками по наименованию, тем самым исключая дублирование поставщиков, вручную занесенных в MrDoc.
* Поставщики, отсутствующие на сайте, автоматически на сайт не выгружаются.

Порядок последующей синхронизации поставщиков:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Регистрация изменений поставщиков происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Новые поставщики на сайт выгружаются только при выгрузке артикулов поставщиков для товаров.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов поставщика
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Телефон
|Телефон
|Длина телефона должна быть ровно 11 символов.
|-
|Страна, город, почтовый индекс, адрес
|Фактический адрес
|
|-
|Включено
|Статус
|На сайте включаются только производители со статусом "Активен".
|}

Для новых поставщиков, загруженных с сайта, автоматически устанавливается комментарий "Поставщик загружен с сайта Prestashop".

=== Синхронизация покупателей ===

Порядок первоначальной синхронизации покупателей при настройке обмена с сайтом:

* С сайта загружаются все покупатели. При загрузке покупателей система не пытается связать их с уже существующими покупателями, то есть каждый покупатель с сайта загружается в виде нового контрагента.
* Покупатели, отсутствующие на сайте, автоматически на сайт не выгружаются.

Порядок последующей синхронизации покупателей:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Регистрация изменений покупателей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Новые покупатели на сайт выгружаются только при выгрузке заказов покупателей. Для выгрузки нового покупателя на сайт у него должны быть заполнены следующие реквизиты: имя, фамилия, email.
* Обратите внимание, что при стандартных настройках PrestaShop новому покупателю будет отправлено письмо с регистрационными данными.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов покупателя
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Имя
|Имя
|Максимальная длина 100 символов. Обязательно к заполнению.
|-
|Фамилия
|Фамилия
|Максимальная длина 100 символов. Обязательно к заполнению.
|-
|Email
|Email
|Максимальная длина 100 символов. Обязательно к заполнению.
|-
|Телефон
|Телефон
|Длина телефона должна быть ровно 11 символов.
|-
|Адрес доставки
|Фактический адрес
|
|-
|Статус
|Статус
|На сайте разрешен вход только для покупателей со статусом "Активен".
|}

Для новых покупателей, загруженных с сайта, автоматически устанавливается следующие реквизиты:
* наименование (фамилия + имя);
* тип "Физическое лицо";
* комментарий "Покупатель загружен с сайта Prestashop".

== Синхронизация заказов покупателей ==

Порядок первоначальной синхронизации заказов покупателей при настройке обмена с сайтом:

* С сайта загружаются все заказы покупателей с датой больше даты начала обмена. При загрузке новых заказов система не пытается связать их с уже существующими в MrDoc заказами.
* Заказы покупателей, отсутствующие на сайте и с датой больше даты начала обмена, автоматически выгружаются на сайт. Вместе с заказами будут выгружаться и отсутствующие на сайте покупатели.

Порядок последующей синхронизации заказов покупателей:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Регистрация изменений заказов покупателей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Новые заказы покупателей будут выгружаться на сайт только в том случае, если их дата больше даты начала обмена.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов заказа
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Номер заказа
|Внешний номер
|Внешний номер заказа отображается на вкладке "Дополнительно" в форме заказа.
|-
|Дата
|Дата
|
|-
|Клиент
|Покупатель
|
|-
|Статус
|Дополнительный статус
|Дополнительный статус в MrDoc вычисляется по соответствию, заданному в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
|-
|Валюта
|Валюта
|
|-
|Итого
|Сумма
|
|-
|Доставка
|Услуга в табличной части "Услуги"
|Услуга в MrDoc вычисляется по соответствию, заданному в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
|-
|Товары
|Товары в табличной части "Товары"
|
|}

Для новых заказов, загруженных с сайта, автоматически устанавливаются реквизиты:
* организация, указанная в настройке обмена;
* тип цен, указанный в настройке обмена;
* комментарий вида "Заказ загружен из интернет-магазина PrestaShop (заказ PXIHJXKOZ)".

При загрузке заказа покупателя с сайта система пытается зарезервировать товары, указанные в заказе. Для этого автоматически оформляется или перезаполняется документ "Резервирование товаров". Если зарезервировать товар не удалось, то это не считается ошибкой, так как на сайте может быть выключен контроль складских остатков.

При выгрузке заказа покупателя на сайт в качестве услуги доставки используется первая услуга, для которой указано соответствие в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]"). При этом стоимость данной услуги будет являться стоимостью доставки, а адрес оказания данной услуги - адресом доставки.

== Обновление цен на сайте ==

Цена товара на сайте обновляется в следующих случаях:

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

Цены на сайт выгружаются в валюте, указанной в настройке обмена.

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

== Обновление складских остатков на сайте ==

Складские остатки выгружаются на сайт в следующих случаях:

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

Вместе со складскими остатками выгружаются данные о наличии товаров у поставщиков.
Эти данные используются для вычисления доступности товара для заказа.

Изменение складского остатка товара влияет на реквизиты товара "Доступен для заказа" и "Показать цену".
Эти флажки устанавливаются, если товар есть на складе или есть в наличии у одного из поставщиков. В противном случае эти флажки снимаются.

== Обновление курсов валют на сайте ==

Курсы валют выгружаются на сайт в следующих случаях:

* При первоначальной настройке обмена (выгружаются курсы валют по всем синхронизированным валютам);
* При изменении курса валюты.

= Настройка обмена =

Сначала необходимо включить опцию "Интеграция с Prestashop" в разделе "Настройки" личного кабинета на сайте [http://mrdoc.org MrDoc.org].

[[Файл:Mrdoc_prestashop_enable.png|border|Включение модуля в личном кабинете]]

Затем необходимо установить модуль для обмена на сайте.
Для этого необходимо открыть журнал настроек обмена "Сервис - Настройки обмена с Prestashop" и скачать модуль, соответствующий версии Prestashop, с помощью кнопок на верхней панели.

[[Файл:01_prestashop_mrdoc_get_module.png|border|1000px|Модуль для установки на сайте]]

Полученный архив необходимо указать в интерфейсе добавления нового модуля в панели администрирования сайта.

[[Файл:02_prestashop_module_install_1.png|border|1000px|Установка модуля на сайте (шаг 1)]]

[[Файл:03_prestashop_module_install_2.png|border|1000px|Установка модуля на сайте (шаг 2)]]

[[Файл:04_prestashop_module_install_3.png|border|1000px|Установка модуля на сайте (шаг 3)]]

[[Файл:05_prestashop_module_install_4.png|border|1000px|Установка модуля на сайте (шаг 4)]]

После установки модуля необходимо открыть его настройки и создать настройку обмена.

[[Файл:06_prestashop_module_install_5.png|border|1000px|Настройка модуля на сайте (шаг 1)]]

Параметры настройки:

* '''Наименование''' - наименование настройки, носит чисто информационный характер;
* '''Ключ авторизации''' - ключ, который необходимо указать в MrDoc для подключения к сайту (генерируется автоматически, его не нужно менять);
* '''Пункт выдачи''' - пункт выдачи, адрес которого будет в качестве адреса доставки для заказов без доставки, выгружаемых из MrDoc;
* '''Способ доставки''' - способ доставки, который будет подставляться в заказы без доставки, выгружаемые из MrDoc;
* '''Вид оплаты''' - вид оплаты, который будет подставляться в заказы, выгружаемые из MrDoc;

[[Файл:07_prestashop_module_install_6.png|border|1000px|Настройка модуля на сайте (шаг 2)]]

После установки и настройки модуля на сайте необходимо настроить обмен в MrDoc.
Для этого в создаем новую настройку обмена в журнале "Сервис - Настройки обмена с Prestashop".

Параметры настройки:

* '''Наименование''' - наименование настройки, носит чисто информационный характер;
* '''Статус''' - можно временно выключить обмен данными с сайтом, установив статус "Помечен на удаление";
* '''Дата начала обмена''' - заказы покупателей старше этой даты не будут синхронизироваться с сайтом;
* '''Организация для заказов с сайта''' - организация, которая будет подставляться в заказы, выгружаемые с сайта;
* '''Валюта сайта''' - валюта, которая будет подставляться в заказы, выгружаемые с сайта, а также используемая при выгрузке цен товаров;
* '''Тип продажных цен''' - тип цен, который будет подставляться в заказы, выгружаемые с сайта, а также используемый при выгрузке продажных цен товаров;
* '''Тип закупочных цен''' - тип цен, который будет использоваться при выгрузке закупочных цен товаров. Если не указан, то закупочные цены на сайте не будут изменяться. Если вы работаете с несколькими поставщиками, то для расчета итоговой закупочной цены необходимо создать новый тип цен, который будет рассчитываться на основании закупочных цен всех поставщиков.
* '''Адрес сайта''' - адрес сайта интернет-магазина;
* '''Ключ авторизации''' - ключ авторизации, указанный в модуле обмена на стороне сайта;
* '''Периодичность обмена''' - насколько часто будет запускаться задача синхронизации с сайтом;
* Блок '''Родительские группы для новых объектов, загруженных с сайта''' - родительские группы соответствующих справочников для создания в них новых объектов, загруженных с сайта;
* Блок '''Настройки синхронизации''' - здесь можно указать, какие объекты нужно синхронизировать с сайтом;

[[Файл:08_prestashop_mrdoc_setup_1.png|border|1000px|Создание настройки обмена в MrDoc (шаг 1)]]

После указания необходимых параметров необходимо нажать кнопку "Далее" для перехода к настройке соответствий ставок НДС, способов доставки и статусов заказов.
На каждой вкладке присутствует кнопка "Обновить ставки (способы доставки, статусы) c сайта", позволяющая заново запросить у сайта список вариантов.

[[Файл:09_prestashop_mrdoc_setup_2.png|border|1000px|Создание настройки обмена в MrDoc (шаг 2)]]

[[Файл:10_prestashop_mrdoc_setup_3.png|border|1000px|Создание настройки обмена в MrDoc (шаг 3)]]

[[Файл:11_prestashop_mrdoc_setup_4.png|border|1000px|Создание настройки обмена в MrDoc (шаг 4)]]

= Контроль состояния обмена =

Контроль состояния обмена осуществляется следующими способами:

* Состояние задачи синхронизации и ее результаты отражаются в отчете "Запланированные задачи";
* Подробные описания ошибок обмена выводятся в отчете "Ошибки обмена".

Кроме того, существует отчет "Оплаты по заказам на сайте", в котором отражаются все оплаты заказов, оформленные на сайте.
Сами оплаты в системе никак не отражаются.

== Отчет "Запланированные задачи" ==

Отчет доступен через главное меню "Отчеты - Запланированные задачи".

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

[[Файл:12_prestashop_mrdoc_task.png|border|1000px|Задача обмена в отчете "Запланированные задачи"]]

[[Файл:13_prestashop_mrdoc_task_result.png|border|400px|Результаты успешного выполнения задачи обмена]]

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

[[Файл:14_prestashop_mrdoc_task_error.png|border|500px|Ошибка выполнения обмена, связанная с необходимостью обновления модуля на сайте]]

== Отчет "Ошибки обмена" ==

Отчет открывается с помощью кнопки "Ошибки обмена" в форме настройки обмена.

[[Файл:15_prestashop_mrdoc_report_error_1.png|border|500px|Кнопка для открытия отчета "Ошибки обмена"]]

Отчет состоит из двух вкладок: ошибки загрузки (с сайта в MrDoc) и ошибки выгрузки (из MrDoc на сайт).

Колонки отчета на вкладке "Ошибки загрузки":

* '''Дата''' - дата фиксирования ошибки;
* '''Тип объекта во внешней системе''' - (category - категория, product - товар, combination - модификация, customer - покупатель, order - заказ покупателя, manufacturer - производитель, supplier - поставщик);
* '''ID объекта во внешней системе''' - ID объекта на сайте;
* '''Текст ошибки''' - описание ошибки.

Колонки отчета на вкладке "Ошибки выгрузки":

* '''Дата''' - дата фиксирования ошибки;
* '''Тип объекта''' - Тип объекта в MrDoc;
* '''ID объекта''' - ID объекта в MrDoc;
* '''Текст ошибки''' - описание ошибки.

[[Файл:16_prestashop_mrdoc_report_error_2.png|border|1000px|Отчет "Ошибки обмена"]]

== Отчет "Оплаты по заказам на сайте" ==

Отчет открывается с помощью кнопки "Оплаты по заказам на сайте" в форме настройки обмена.

В нем выводятся оплаты по заказам, оформленные через сайт.

[[Файл:17_prestashop_mrdoc_report_payment_1.png|border|500px|Кнопка для открытия отчета "Оплаты по заказам на сайте"]]

[[Файл:18_prestashop_mrdoc_report_payment_2.png|border|1000px|Отчет "Оплаты по заказам на сайте"]]

[[Category:Интеграция с интернет-магазинами]]

Синхронизация с интернет-магазином Prestashop

2016-10-26T07:09:29Z

Krylovia:

= Важно! =

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

Компания "КлаудТим" не несет ответственности за любые проблемы, прямо или косвенно связанные с синхронизацией.
Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации, однако Prestashop имеет много подверсий и модулей с различным количеством проблем и ошибок. Поэтому протестировать все их сочетания не представляется возможным.

= Возможности =

Между MrDoc и сайтом синхронизируются товары, категории, покупатели и их заказы.
Также поддерживается выгрузка на сайт цен и складских остатков товаров.

Существует возможность ограничить список синхронизируемых объектов (например, синхронизировать только справочник товаров).

Поддерживаемые версии PrestaShop: 1.5, 1.6.

== Синхронизация справочников ==

{| class="wikitable"
!colspan="2"|Соответствие объектов
|-
!style="width:50%;"|Объект на сайте
!style="width:50%;"|Объект в MrDoc
|-
|Товар
|Элемент справочника "Номенклатура"
|-
|Комбинация товара
|Элемент справочника "Модификации номенклатуры"
|-
|Категория товаров
|Группа справочника "Номенклатура"
|-
|Производитель
|Элемент справочника "Производители"
|-
|Поставщик
|Элемент справочника "Контрагенты"
|-
|Покупатель
|Элемент справочника "Контрагенты"
|}

=== Синхронизация товаров и категорий ===

Порядок первоначальной синхронизации товаров при настройке обмена с сайтом:

* Сначала с сайта загружаются все товары, их комбинации, а также все категории. При загрузке товаров и категорий система сразу пытается связать их с уже существующими товарами и категориями по наименованию, тем самым исключая дублирование товаров/категорий, вручную занесенных в MrDoc. При загрузке комбинаций система не пытается связывать их с уже существующими в MrDoc модификациями, за исключением комбинации по умолчанию - она всегда связывается с базовой модификацией товара.
* Затем на сайт выгружаются все товары и категории, отсутствующие на сайте (за исключением помеченных на удаление). При этом модификации для таких товаров на сайт не выгружаются.

Порядок последующей синхронизации товаров:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Система регистрирует изменения справочника "Номенклатура", тем самым формируя список товаров/категорий, которые необходимо выгрузить на сайт при очередной синхронизации.
* Также регистрация изменений товаров/комбинаций/категорий происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* При выполнении очередной синхронизации сначала загружаются все изменения с сайта в MrDoc, затем выгружаются изменения из MrDoc на сайт. При этом возможна ситуация, когда товар был одновременно изменен и на сайте и в MrDoc. В этом случае изменения на сайте будут иметь приоритет, так как загрузка данных с сайта происходит перед выгрузкой данных на сайт.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов товара
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Тип
|Вид номенклатуры
|Виртуальные товары загружаются в виде услуг, остальные типы - в виде товаров.
|-
|Артикул
|Артикул базовой модификации
|Максимальная длина 100 символов.
|-
|Штрихкод
|Штрихкод EAN13 для базовой модификации товара
|
|-
|Производитель
|Производитель
|
|-
|Категория по умолчанию
|Родительская группа
|Если у товара на сайте есть связи с несколькими категориями, то при смене категории в MrDoc все эти связи на сайте сохраняются. Если у товара на сайте есть связь только с одной категорией (основной), то при изменении категории в MrDoc товар потеряет связь с прошлой категорией.
|-
|Налоговые правила
|Ставка НДС
|Соответствие ставок НДС налоговым правилам осуществляется при первоначальной настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
|-
|Комбинация по умолчанию
|Базовая модификация
|Выгрузка новых модификаций на сайт не поддерживается. Новый товар всегда выгружается без модификаций.
|-
|Артикулы поставщиков
|Артикулы поставщиков
|
|}

Для всех новых товаров с сайта автоматически устанавливаются цены сайта (цены фиксируются для типа цен, указанного в настройке обмена). Для новых товаров, выгружаемых на сайт цена устанавлиается в соотвествии с типом цен, указанным в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").

Новые товары всегда выгружаются на сайт со статусом "Запрещен" и видимостью "Нигде".
При дальнейшей синхронизации статус товара не изменяется, то есть статус в Prestashop не зависит от статуса товара в MrDoc.

Для новых товаров, загруженных с сайта, автоматически устанавливается комментарий "Товар загружен с сайта Prestashop".

{| class="wikitable"
!colspan="3"|Соответствие реквизитов группы (категории)
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Родительская категория
|Родительская группа
|
|-
|Отображено
|Статус
|Отображение на сайте включается только для групп со статусом "Активен".
|}

Для новых групп (категорий), загруженных с сайта, автоматически устанавливается комментарий "Категория загружена с сайта Prestashop".

{| class="wikitable"
!colspan="3"|Соответствие реквизитов модификации (комбинации)
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Значения свойств комбинации
|Наименование модификации формируется из значений её свойств при загрузке с сайта.
|-
|Артикул
|Артикул
|
|}

Выгрузка новых модификаций на сайт не поддерживается.

Для новых модификаций (комбинаций), загруженных с сайта, автоматически устанавливается комментарий "Модификация товара загружена с сайта Prestashop".

=== Синхронизация производителей ===

Порядок первоначальной синхронизации производителей при настройке обмена с сайтом:

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

Порядок последующей синхронизации производителей:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Система регистрирует изменения справочника "Производители", тем самым формируя список производителей, которые необходимо выгрузить на сайт при очередной синхронизации.
* Также регистрация изменений производителей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* При выполнении очередной синхронизации сначала загружаются все изменения с сайта в MrDoc, затем выгружаются изменения из MrDoc на сайт. При этом возможна ситуация, когда производитель был одновременно изменен и на сайте и в MrDoc. В этом случае изменения на сайте будут иметь приоритет, так как загрузка данных с сайта происходит перед выгрузкой данных на сайт.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов производителя
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Включено
|Статус
|На сайте включаются только производители со статусом "Активен".
|}

Для новых производителей, загруженных с сайта, автоматически устанавливается комментарий "Производитель загружен с сайта Prestashop".

=== Синхронизация поставщиков ===

Порядок первоначальной синхронизации поставщиков при настройке обмена с сайтом:

* С сайта загружаются все поставщики. При загрузке поставщиков система сразу пытается связать их с уже существующими поставщиками по наименованию, тем самым исключая дублирование поставщиков, вручную занесенных в MrDoc.
* Поставщики, отсутствующие на сайте, автоматически на сайт не выгружаются.

Порядок последующей синхронизации поставщиков:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Регистрация изменений поставщиков происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Новые поставщики на сайт выгружаются только при выгрузке артикулов поставщиков для товаров.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов поставщика
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Телефон
|Телефон
|Длина телефона должна быть ровно 11 символов.
|-
|Страна, город, почтовый индекс, адрес
|Фактический адрес
|
|-
|Включено
|Статус
|На сайте включаются только производители со статусом "Активен".
|}

Для новых поставщиков, загруженных с сайта, автоматически устанавливается комментарий "Поставщик загружен с сайта Prestashop".

=== Синхронизация покупателей ===

Порядок первоначальной синхронизации покупателей при настройке обмена с сайтом:

* С сайта загружаются все покупатели. При загрузке покупателей система не пытается связать их с уже существующими покупателями, то есть каждый покупатель с сайта загружается в виде нового контрагента.
* Покупатели, отсутствующие на сайте, автоматически на сайт не выгружаются.

Порядок последующей синхронизации покупателей:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Регистрация изменений покупателей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Новые покупатели на сайт выгружаются только при выгрузке заказов покупателей. Для выгрузки нового покупателя на сайт у него должны быть заполнены следующие реквизиты: имя, фамилия, email.
* Обратите внимание, что при стандартных настройках PrestaShop новому покупателю будет отправлено письмо с регистрационными данными.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов покупателя
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Имя
|Имя
|Максимальная длина 100 символов. Обязательно к заполнению.
|-
|Фамилия
|Фамилия
|Максимальная длина 100 символов. Обязательно к заполнению.
|-
|Email
|Email
|Максимальная длина 100 символов. Обязательно к заполнению.
|-
|Телефон
|Телефон
|Длина телефона должна быть ровно 11 символов.
|-
|Адрес доставки
|Фактический адрес
|
|-
|Статус
|Статус
|На сайте разрешен вход только для покупателей со статусом "Активен".
|}

Для новых покупателей, загруженных с сайта, автоматически устанавливается следующие реквизиты:
* наименование (фамилия + имя);
* тип "Физическое лицо";
* комментарий "Покупатель загружен с сайта Prestashop".

== Синхронизация заказов покупателей ==

Порядок первоначальной синхронизации заказов покупателей при настройке обмена с сайтом:

* С сайта загружаются все заказы покупателей с датой больше даты начала обмена. При загрузке новых заказов система не пытается связать их с уже существующими в MrDoc заказами.
* Заказы покупателей, отсутствующие на сайте и с датой больше даты начала обмена, автоматически выгружаются на сайт. Вместе с заказами будут выгружаться и отсутствующие на сайте покупатели.

Порядок последующей синхронизации заказов покупателей:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Регистрация изменений заказов покупателей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Новые заказы покупателей будут выгружаться на сайт только в том случае, если их дата больше даты начала обмена.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов заказа
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Номер заказа
|Внешний номер
|Внешний номер заказа отображается на вкладке "Дополнительно" в форме заказа.
|-
|Дата
|Дата
|
|-
|Клиент
|Покупатель
|
|-
|Статус
|Дополнительный статус
|Дополнительный статус в MrDoc вычисляется по соответствию, заданному в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
|-
|Валюта
|Валюта
|
|-
|Итого
|Сумма
|
|-
|Доставка
|Услуга в табличной части "Услуги"
|Услуга в MrDoc вычисляется по соответствию, заданному в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
|-
|Товары
|Товары в табличной части "Товары"
|
|}

Для новых заказов, загруженных с сайта, автоматически устанавливаются реквизиты:
* организация, указанная в настройке обмена;
* тип цен, указанный в настройке обмена;
* комментарий вида "Заказ загружен из интернет-магазина PrestaShop (заказ PXIHJXKOZ)".

При загрузке заказа покупателя с сайта система пытается зарезервировать товары, указанные в заказе. Для этого автоматически оформляется или перезаполняется документ "Резервирование товаров". Если зарезервировать товар не удалось, то это не считается ошибкой, так как на сайте может быть выключен контроль складских остатков.

При выгрузке заказа покупателя на сайт в качестве услуги доставки используется первая услуга, для которой указано соответствие в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]"). При этом стоимость данной услуги будет являться стоимостью доставки, а адрес оказания данной услуги - адресом доставки.

== Обновление цен на сайте ==

Цена товара на сайте обновляется в следующих случаях:

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

Цены на сайт выгружаются в валюте, указанной в настройке обмена.

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

== Обновление складских остатков на сайте ==

Складские остатки выгружаются на сайт в следующих случаях:

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

Вместе со складскими остатками выгружаются данные о наличии товаров у поставщиков.
Эти данные используются для вычисления доступности товара для заказа.

Изменение складского остатка товара влияет на реквизиты товара "Доступен для заказа" и "Показать цену".
Эти флажки устанавливаются, если товар есть на складе или есть в наличии у одного из поставщиков. В противном случае эти флажки снимаются.

== Обновление курсов валют на сайте ==

Курсы валют выгружаются на сайт в следующих случаях:

* При первоначальной настройке обмена (выгружаются курсы валют по всем синхронизированным валютам);
* При изменении курса валюты.

= Настройка обмена =

Сначала необходимо включить опцию "Интеграция с Prestashop" в разделе "Настройки" личного кабинета на сайте [http://mrdoc.org MrDoc.org].

[[Файл:Mrdoc_prestashop_enable.png|border|Включение модуля в личном кабинете]]

Затем необходимо установить модуль для обмена на сайте.
Для этого необходимо открыть журнал настроек обмена "Сервис - Настройки обмена с Prestashop" и скачать модуль, соответствующий версии Prestashop, с помощью кнопок на верхней панели.

[[Файл:01_prestashop_mrdoc_get_module.png|border|1000px|Модуль для установки на сайте]]

Полученный архив необходимо указать в интерфейсе добавления нового модуля в панели администрирования сайта.

[[Файл:02_prestashop_module_install_1.png|border|1000px|Установка модуля на сайте (шаг 1)]]

[[Файл:03_prestashop_module_install_2.png|border|1000px|Установка модуля на сайте (шаг 2)]]

[[Файл:04_prestashop_module_install_3.png|border|1000px|Установка модуля на сайте (шаг 3)]]

[[Файл:05_prestashop_module_install_4.png|border|1000px|Установка модуля на сайте (шаг 4)]]

После установки модуля необходимо открыть его настройки и создать настройку обмена.

[[Файл:06_prestashop_module_install_5.png|border|1000px|Настройка модуля на сайте (шаг 1)]]

Параметры настройки:

* '''Наименование''' - наименование настройки, носит чисто информационный характер;
* '''Ключ авторизации''' - ключ, который необходимо указать в MrDoc для подключения к сайту (генерируется автоматически, его не нужно менять);
* '''Пункт выдачи''' - пункт выдачи, адрес которого будет в качестве адреса доставки для заказов без доставки, выгружаемых из MrDoc;
* '''Способ доставки''' - способ доставки, который будет подставляться в заказы без доставки, выгружаемые из MrDoc;
* '''Вид оплаты''' - вид оплаты, который будет подставляться в заказы, выгружаемые из MrDoc;

[[Файл:07_prestashop_module_install_6.png|border|1000px|Настройка модуля на сайте (шаг 2)]]

После установки и настройки модуля на сайте необходимо настроить обмен в MrDoc.
Для этого в создаем новую настройку обмена в журнале "Сервис - Настройки обмена с Prestashop".

Параметры настройки:

* '''Наименование''' - наименование настройки, носит чисто информационный характер;
* '''Статус''' - можно временно выключить обмен данными с сайтом, установив статус "Помечен на удаление";
* '''Дата начала обмена''' - заказы покупателей старше этой даты не будут синхронизироваться с сайтом;
* '''Организация для заказов с сайта''' - организация, которая будет подставляться в заказы, выгружаемые с сайта;
* '''Валюта сайта''' - валюта, которая будет подставляться в заказы, выгружаемые с сайта, а также используемая при выгрузке цен товаров;
* '''Тип продажных цен''' - тип цен, который будет подставляться в заказы, выгружаемые с сайта, а также используемый при выгрузке продажных цен товаров;
* '''Тип закупочных цен''' - тип цен, который будет использоваться при выгрузке закупочных цен товаров. Если не указан, то закупочные цены на сайте не будут изменяться. Если вы работаете с несколькими поставщиками, то для расчета итоговой закупочной цены необходимо создать новый тип цен, который будет рассчитываться на основании закупочных цен всех поставщиков.
* '''Адрес сайта''' - адрес сайта интернет-магазина;
* '''Ключ авторизации''' - ключ авторизации, указанный в модуле обмена на стороне сайта;
* '''Периодичность обмена''' - насколько часто будет запускаться задача синхронизации с сайтом;
* Блок '''Родительские группы для новых объектов, загруженных с сайта''' - родительские группы соответствующих справочников для создания в них новых объектов, загруженных с сайта;
* Блок '''Настройки синхронизации''' - здесь можно указать, какие объекты нужно синхронизировать с сайтом;

[[Файл:08_prestashop_mrdoc_setup_1.png|border|1000px|Создание настройки обмена в MrDoc (шаг 1)]]

После указания необходимых параметров необходимо нажать кнопку "Далее" для перехода к настройке соответствий ставок НДС, способов доставки и статусов заказов.
На каждой вкладке присутствует кнопка "Обновить ставки (способы доставки, статусы) c сайта", позволяющая заново запросить у сайта список вариантов.

[[Файл:09_prestashop_mrdoc_setup_2.png|border|1000px|Создание настройки обмена в MrDoc (шаг 2)]]

[[Файл:10_prestashop_mrdoc_setup_3.png|border|1000px|Создание настройки обмена в MrDoc (шаг 3)]]

[[Файл:11_prestashop_mrdoc_setup_4.png|border|1000px|Создание настройки обмена в MrDoc (шаг 4)]]

= Контроль состояния обмена =

Контроль состояния обмена осуществляется следующими способами:

* Состояние задачи синхронизации и ее результаты отражаются в отчете "Запланированные задачи";
* Подробные описания ошибок обмена выводятся в отчете "Ошибки обмена".

Кроме того, существует отчет "Оплаты по заказам на сайте", в котором отражаются все оплаты заказов, оформленные на сайте.
Сами оплаты в системе никак не отражаются.

== Отчет "Запланированные задачи" ==

Отчет доступен через главное меню "Отчеты - Запланированные задачи".

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

[[Файл:12_prestashop_mrdoc_task.png|border|1000px|Задача обмена в отчете "Запланированные задачи"]]

[[Файл:13_prestashop_mrdoc_task_result.png|border|400px|Результаты успешного выполнения задачи обмена]]

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

[[Файл:14_prestashop_mrdoc_task_error.png|border|500px|Ошибка выполнения обмена, связанная с необходимостью обновления модуля на сайте]]

== Отчет "Ошибки обмена" ==

Отчет открывается с помощью кнопки "Ошибки обмена" в форме настройки обмена.

[[Файл:15_prestashop_mrdoc_report_error_1.png|border|500px|Кнопка для открытия отчета "Ошибки обмена"]]

Отчет состоит из двух вкладок: ошибки загрузки (с сайта в MrDoc) и ошибки выгрузки (из MrDoc на сайт).

Колонки отчета на вкладке "Ошибки загрузки":

* '''Дата''' - дата фиксирования ошибки;
* '''Тип объекта во внешней системе''' - (category - категория, product - товар, combination - модификация, customer - покупатель, order - заказ покупателя, manufacturer - производитель, supplier - поставщик);
* '''ID объекта во внешней системе''' - ID объекта на сайте;
* '''Текст ошибки''' - описание ошибки.

Колонки отчета на вкладке "Ошибки выгрузки":

* '''Дата''' - дата фиксирования ошибки;
* '''Тип объекта''' - Тип объекта в MrDoc;
* '''ID объекта''' - ID объекта в MrDoc;
* '''Текст ошибки''' - описание ошибки.

[[Файл:16_prestashop_mrdoc_report_error_2.png|border|1000px|Отчет "Ошибки обмена"]]

== Отчет "Оплаты по заказам на сайте" ==

Отчет открывается с помощью кнопки "Оплаты по заказам на сайте" в форме настройки обмена.

В нем выводятся оплаты по заказам, оформленные через сайт.

[[Файл:17_prestashop_mrdoc_report_payment_1.png|border|500px|Кнопка для открытия отчета "Оплаты по заказам на сайте"]]

[[Файл:18_prestashop_mrdoc_report_payment_2.png|border|1000px|Отчет "Оплаты по заказам на сайте"]]

[[Category:Интеграция с интернет-магазинами]]

Синхронизация с интернет-магазином Prestashop

2016-10-26T07:00:27Z

Krylovia:

= Важно! =

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

Компания "КлаудТим" не несет ответственности за любые проблемы, прямо или косвенно связанные с синхронизацией.
Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации, однако Prestashop имеет много подверсий и модулей с различным количеством проблем и ошибок. Поэтому протестировать все их сочетания не представляется возможным.

= Возможности =

Между MrDoc и сайтом синхронизируются товары, категории, покупатели и их заказы.
Также поддерживается выгрузка на сайт цен и складских остатков товаров.

Существует возможность ограничить список синхронизируемых объектов (например, синхронизировать только справочник товаров).

Поддерживаемые версии PrestaShop: 1.5, 1.6.

== Синхронизация справочников ==

{| class="wikitable"
!colspan="2"|Соответствие объектов
|-
!style="width:50%;"|Объект на сайте
!style="width:50%;"|Объект в MrDoc
|-
|Товар
|Элемент справочника "Номенклатура"
|-
|Комбинация товара
|Элемент справочника "Модификации номенклатуры"
|-
|Категория товаров
|Группа справочника "Номенклатура"
|-
|Производитель
|Элемент справочника "Производители"
|-
|Поставщик
|Элемент справочника "Контрагенты"
|-
|Покупатель
|Элемент справочника "Контрагенты"
|}

=== Синхронизация товаров и категорий ===

Порядок первоначальной синхронизации товаров при настройке обмена с сайтом:

* Сначала с сайта загружаются все товары, их комбинации, а также все категории. При загрузке товаров и категорий система сразу пытается связать их с уже существующими товарами и категориями по наименованию, тем самым исключая дублирование товаров/категорий, вручную занесенных в MrDoc. При загрузке комбинаций система не пытается связывать их с уже существующими в MrDoc модификациями, за исключением комбинации по умолчанию - она всегда связывается с базовой модификацией товара.
* Затем на сайт выгружаются все товары и категории, отсутствующие на сайте (за исключением помеченных на удаление). При этом модификации для таких товаров на сайт не выгружаются.

Порядок последующей синхронизации товаров:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Система регистрирует изменения справочника "Номенклатура", тем самым формируя список товаров/категорий, которые необходимо выгрузить на сайт при очередной синхронизации.
* Также регистрация изменений товаров/комбинаций/категорий происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* При выполнении очередной синхронизации сначала загружаются все изменения с сайта в MrDoc, затем выгружаются изменения из MrDoc на сайт. При этом возможна ситуация, когда товар был одновременно изменен и на сайте и в MrDoc. В этом случае изменения на сайте будут иметь приоритет, так как загрузка данных с сайта происходит перед выгрузкой данных на сайт.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов товара
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Тип
|Вид номенклатуры
|Виртуальные товары загружаются в виде услуг, остальные типы - в виде товаров.
|-
|Артикул
|Артикул базовой модификации
|Максимальная длина 100 символов.
|-
|Штрихкод
|Штрихкод EAN13 для базовой модификации товара
|
|-
|Производитель
|Производитель
|
|-
|Категория по умолчанию
|Родительская группа
|
|-
|Налоговые правила
|Ставка НДС
|Соответствие ставок НДС налоговым правилам осуществляется при первоначальной настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
|-
|Комбинация по умолчанию
|Базовая модификация
|Выгрузка новых модификаций на сайт не поддерживается. Новый товар всегда выгружается без модификаций.
|-
|Артикулы поставщиков
|Артикулы поставщиков
|
|}

Для всех новых товаров с сайта автоматически устанавливаются цены сайта (цены фиксируются для типа цен, указанного в настройке обмена). Для новых товаров, выгружаемых на сайт цена устанавлиается в соотвествии с типом цен, указанным в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").

Новые товары всегда выгружаются на сайт со статусом "Запрещен" и видимостью "Нигде".
При дальнейшей синхронизации статус товара не изменяется, то есть статус в Prestashop не зависит от статуса товара в MrDoc.

Для новых товаров, загруженных с сайта, автоматически устанавливается комментарий "Товар загружен с сайта Prestashop".

{| class="wikitable"
!colspan="3"|Соответствие реквизитов группы (категории)
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Родительская категория
|Родительская группа
|
|-
|Отображено
|Статус
|Отображение на сайте включается только для групп со статусом "Активен".
|}

Для новых групп (категорий), загруженных с сайта, автоматически устанавливается комментарий "Категория загружена с сайта Prestashop".

{| class="wikitable"
!colspan="3"|Соответствие реквизитов модификации (комбинации)
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Значения свойств комбинации
|Наименование модификации формируется из значений её свойств при загрузке с сайта.
|-
|Артикул
|Артикул
|
|}

Выгрузка новых модификаций на сайт не поддерживается.

Для новых модификаций (комбинаций), загруженных с сайта, автоматически устанавливается комментарий "Модификация товара загружена с сайта Prestashop".

=== Синхронизация производителей ===

Порядок первоначальной синхронизации производителей при настройке обмена с сайтом:

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

Порядок последующей синхронизации производителей:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Система регистрирует изменения справочника "Производители", тем самым формируя список производителей, которые необходимо выгрузить на сайт при очередной синхронизации.
* Также регистрация изменений производителей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* При выполнении очередной синхронизации сначала загружаются все изменения с сайта в MrDoc, затем выгружаются изменения из MrDoc на сайт. При этом возможна ситуация, когда производитель был одновременно изменен и на сайте и в MrDoc. В этом случае изменения на сайте будут иметь приоритет, так как загрузка данных с сайта происходит перед выгрузкой данных на сайт.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов производителя
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Включено
|Статус
|На сайте включаются только производители со статусом "Активен".
|}

Для новых производителей, загруженных с сайта, автоматически устанавливается комментарий "Производитель загружен с сайта Prestashop".

=== Синхронизация поставщиков ===

Порядок первоначальной синхронизации поставщиков при настройке обмена с сайтом:

* С сайта загружаются все поставщики. При загрузке поставщиков система сразу пытается связать их с уже существующими поставщиками по наименованию, тем самым исключая дублирование поставщиков, вручную занесенных в MrDoc.
* Поставщики, отсутствующие на сайте, автоматически на сайт не выгружаются.

Порядок последующей синхронизации поставщиков:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Регистрация изменений поставщиков происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Новые поставщики на сайт выгружаются только при выгрузке артикулов поставщиков для товаров.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов поставщика
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Телефон
|Телефон
|Длина телефона должна быть ровно 11 символов.
|-
|Страна, город, почтовый индекс, адрес
|Фактический адрес
|
|-
|Включено
|Статус
|На сайте включаются только производители со статусом "Активен".
|}

Для новых поставщиков, загруженных с сайта, автоматически устанавливается комментарий "Поставщик загружен с сайта Prestashop".

=== Синхронизация покупателей ===

Порядок первоначальной синхронизации покупателей при настройке обмена с сайтом:

* С сайта загружаются все покупатели. При загрузке покупателей система не пытается связать их с уже существующими покупателями, то есть каждый покупатель с сайта загружается в виде нового контрагента.
* Покупатели, отсутствующие на сайте, автоматически на сайт не выгружаются.

Порядок последующей синхронизации покупателей:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Регистрация изменений покупателей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Новые покупатели на сайт выгружаются только при выгрузке заказов покупателей. Для выгрузки нового покупателя на сайт у него должны быть заполнены следующие реквизиты: имя, фамилия, email.
* Обратите внимание, что при стандартных настройках PrestaShop новому покупателю будет отправлено письмо с регистрационными данными.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов покупателя
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Имя
|Имя
|Максимальная длина 100 символов. Обязательно к заполнению.
|-
|Фамилия
|Фамилия
|Максимальная длина 100 символов. Обязательно к заполнению.
|-
|Email
|Email
|Максимальная длина 100 символов. Обязательно к заполнению.
|-
|Телефон
|Телефон
|Длина телефона должна быть ровно 11 символов.
|-
|Адрес доставки
|Фактический адрес
|
|-
|Статус
|Статус
|На сайте разрешен вход только для покупателей со статусом "Активен".
|}

Для новых покупателей, загруженных с сайта, автоматически устанавливается следующие реквизиты:
* наименование (фамилия + имя);
* тип "Физическое лицо";
* комментарий "Покупатель загружен с сайта Prestashop".

== Синхронизация заказов покупателей ==

Порядок первоначальной синхронизации заказов покупателей при настройке обмена с сайтом:

* С сайта загружаются все заказы покупателей с датой больше даты начала обмена. При загрузке новых заказов система не пытается связать их с уже существующими в MrDoc заказами.
* Заказы покупателей, отсутствующие на сайте и с датой больше даты начала обмена, автоматически выгружаются на сайт. Вместе с заказами будут выгружаться и отсутствующие на сайте покупатели.

Порядок последующей синхронизации заказов покупателей:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Регистрация изменений заказов покупателей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Новые заказы покупателей будут выгружаться на сайт только в том случае, если их дата больше даты начала обмена.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов заказа
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Номер заказа
|Внешний номер
|Внешний номер заказа отображается на вкладке "Дополнительно" в форме заказа.
|-
|Дата
|Дата
|
|-
|Клиент
|Покупатель
|
|-
|Статус
|Дополнительный статус
|Дополнительный статус в MrDoc вычисляется по соответствию, заданному в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
|-
|Валюта
|Валюта
|
|-
|Итого
|Сумма
|
|-
|Доставка
|Услуга в табличной части "Услуги"
|Услуга в MrDoc вычисляется по соответствию, заданному в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
|-
|Товары
|Товары в табличной части "Товары"
|
|}

Для новых заказов, загруженных с сайта, автоматически устанавливаются реквизиты:
* организация, указанная в настройке обмена;
* тип цен, указанный в настройке обмена;
* комментарий вида "Заказ загружен из интернет-магазина PrestaShop (заказ PXIHJXKOZ)".

При загрузке заказа покупателя с сайта система пытается зарезервировать товары, указанные в заказе. Для этого автоматически оформляется или перезаполняется документ "Резервирование товаров". Если зарезервировать товар не удалось, то это не считается ошибкой, так как на сайте может быть выключен контроль складских остатков.

При выгрузке заказа покупателя на сайт в качестве услуги доставки используется первая услуга, для которой указано соответствие в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]"). При этом стоимость данной услуги будет являться стоимостью доставки, а адрес оказания данной услуги - адресом доставки.

== Обновление цен на сайте ==

Цена товара на сайте обновляется в следующих случаях:

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

Цены на сайт выгружаются в валюте, указанной в настройке обмена.

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

== Обновление складских остатков на сайте ==

Складские остатки выгружаются на сайт в следующих случаях:

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

Вместе со складскими остатками выгружаются данные о наличии товаров у поставщиков.
Эти данные используются для вычисления доступности товара для заказа.

Изменение складского остатка товара влияет на реквизиты товара "Доступен для заказа" и "Показать цену".
Эти флажки устанавливаются, если товар есть на складе или есть в наличии у одного из поставщиков. В противном случае эти флажки снимаются.

== Обновление курсов валют на сайте ==

Курсы валют выгружаются на сайт в следующих случаях:

* При первоначальной настройке обмена (выгружаются курсы валют по всем синхронизированным валютам);
* При изменении курса валюты.

= Настройка обмена =

Сначала необходимо включить опцию "Интеграция с Prestashop" в разделе "Настройки" личного кабинета на сайте [http://mrdoc.org MrDoc.org].

[[Файл:Mrdoc_prestashop_enable.png|border|Включение модуля в личном кабинете]]

Затем необходимо установить модуль для обмена на сайте.
Для этого необходимо открыть журнал настроек обмена "Сервис - Настройки обмена с Prestashop" и скачать модуль, соответствующий версии Prestashop, с помощью кнопок на верхней панели.

[[Файл:01_prestashop_mrdoc_get_module.png|border|1000px|Модуль для установки на сайте]]

Полученный архив необходимо указать в интерфейсе добавления нового модуля в панели администрирования сайта.

[[Файл:02_prestashop_module_install_1.png|border|1000px|Установка модуля на сайте (шаг 1)]]

[[Файл:03_prestashop_module_install_2.png|border|1000px|Установка модуля на сайте (шаг 2)]]

[[Файл:04_prestashop_module_install_3.png|border|1000px|Установка модуля на сайте (шаг 3)]]

[[Файл:05_prestashop_module_install_4.png|border|1000px|Установка модуля на сайте (шаг 4)]]

После установки модуля необходимо открыть его настройки и создать настройку обмена.

[[Файл:06_prestashop_module_install_5.png|border|1000px|Настройка модуля на сайте (шаг 1)]]

Параметры настройки:

* '''Наименование''' - наименование настройки, носит чисто информационный характер;
* '''Ключ авторизации''' - ключ, который необходимо указать в MrDoc для подключения к сайту (генерируется автоматически, его не нужно менять);
* '''Пункт выдачи''' - пункт выдачи, адрес которого будет в качестве адреса доставки для заказов без доставки, выгружаемых из MrDoc;
* '''Способ доставки''' - способ доставки, который будет подставляться в заказы без доставки, выгружаемые из MrDoc;
* '''Вид оплаты''' - вид оплаты, который будет подставляться в заказы, выгружаемые из MrDoc;

[[Файл:07_prestashop_module_install_6.png|border|1000px|Настройка модуля на сайте (шаг 2)]]

После установки и настройки модуля на сайте необходимо настроить обмен в MrDoc.
Для этого в создаем новую настройку обмена в журнале "Сервис - Настройки обмена с Prestashop".

Параметры настройки:

* '''Наименование''' - наименование настройки, носит чисто информационный характер;
* '''Статус''' - можно временно выключить обмен данными с сайтом, установив статус "Помечен на удаление";
* '''Дата начала обмена''' - заказы покупателей старше этой даты не будут синхронизироваться с сайтом;
* '''Организация для заказов с сайта''' - организация, которая будет подставляться в заказы, выгружаемые с сайта;
* '''Валюта сайта''' - валюта, которая будет подставляться в заказы, выгружаемые с сайта, а также используемая при выгрузке цен товаров;
* '''Тип продажных цен''' - тип цен, который будет подставляться в заказы, выгружаемые с сайта, а также используемый при выгрузке продажных цен товаров;
* '''Тип закупочных цен''' - тип цен, который будет использоваться при выгрузке закупочных цен товаров. Если не указан, то закупочные цены на сайте не будут изменяться. Если вы работаете с несколькими поставщиками, то для расчета итоговой закупочной цены необходимо создать новый тип цен, который будет рассчитываться на основании закупочных цен всех поставщиков.
* '''Адрес сайта''' - адрес сайта интернет-магазина;
* '''Ключ авторизации''' - ключ авторизации, указанный в модуле обмена на стороне сайта;
* '''Периодичность обмена''' - насколько часто будет запускаться задача синхронизации с сайтом;
* Блок '''Родительские группы для новых объектов, загруженных с сайта''' - родительские группы соответствующих справочников для создания в них новых объектов, загруженных с сайта;
* Блок '''Настройки синхронизации''' - здесь можно указать, какие объекты нужно синхронизировать с сайтом;

[[Файл:08_prestashop_mrdoc_setup_1.png|border|1000px|Создание настройки обмена в MrDoc (шаг 1)]]

После указания необходимых параметров необходимо нажать кнопку "Далее" для перехода к настройке соответствий ставок НДС, способов доставки и статусов заказов.
На каждой вкладке присутствует кнопка "Обновить ставки (способы доставки, статусы) c сайта", позволяющая заново запросить у сайта список вариантов.

[[Файл:09_prestashop_mrdoc_setup_2.png|border|1000px|Создание настройки обмена в MrDoc (шаг 2)]]

[[Файл:10_prestashop_mrdoc_setup_3.png|border|1000px|Создание настройки обмена в MrDoc (шаг 3)]]

[[Файл:11_prestashop_mrdoc_setup_4.png|border|1000px|Создание настройки обмена в MrDoc (шаг 4)]]

= Контроль состояния обмена =

Контроль состояния обмена осуществляется следующими способами:

* Состояние задачи синхронизации и ее результаты отражаются в отчете "Запланированные задачи";
* Подробные описания ошибок обмена выводятся в отчете "Ошибки обмена".

Кроме того, существует отчет "Оплаты по заказам на сайте", в котором отражаются все оплаты заказов, оформленные на сайте.
Сами оплаты в системе никак не отражаются.

== Отчет "Запланированные задачи" ==

Отчет доступен через главное меню "Отчеты - Запланированные задачи".

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

[[Файл:12_prestashop_mrdoc_task.png|border|1000px|Задача обмена в отчете "Запланированные задачи"]]

[[Файл:13_prestashop_mrdoc_task_result.png|border|400px|Результаты успешного выполнения задачи обмена]]

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

[[Файл:14_prestashop_mrdoc_task_error.png|border|500px|Ошибка выполнения обмена, связанная с необходимостью обновления модуля на сайте]]

== Отчет "Ошибки обмена" ==

Отчет открывается с помощью кнопки "Ошибки обмена" в форме настройки обмена.

[[Файл:15_prestashop_mrdoc_report_error_1.png|border|500px|Кнопка для открытия отчета "Ошибки обмена"]]

Отчет состоит из двух вкладок: ошибки загрузки (с сайта в MrDoc) и ошибки выгрузки (из MrDoc на сайт).

Колонки отчета на вкладке "Ошибки загрузки":

* '''Дата''' - дата фиксирования ошибки;
* '''Тип объекта во внешней системе''' - (category - категория, product - товар, combination - модификация, customer - покупатель, order - заказ покупателя, manufacturer - производитель, supplier - поставщик);
* '''ID объекта во внешней системе''' - ID объекта на сайте;
* '''Текст ошибки''' - описание ошибки.

Колонки отчета на вкладке "Ошибки выгрузки":

* '''Дата''' - дата фиксирования ошибки;
* '''Тип объекта''' - Тип объекта в MrDoc;
* '''ID объекта''' - ID объекта в MrDoc;
* '''Текст ошибки''' - описание ошибки.

[[Файл:16_prestashop_mrdoc_report_error_2.png|border|1000px|Отчет "Ошибки обмена"]]

== Отчет "Оплаты по заказам на сайте" ==

Отчет открывается с помощью кнопки "Оплаты по заказам на сайте" в форме настройки обмена.

В нем выводятся оплаты по заказам, оформленные через сайт.

[[Файл:17_prestashop_mrdoc_report_payment_1.png|border|500px|Кнопка для открытия отчета "Оплаты по заказам на сайте"]]

[[Файл:18_prestashop_mrdoc_report_payment_2.png|border|1000px|Отчет "Оплаты по заказам на сайте"]]

[[Category:Интеграция с интернет-магазинами]]

Файл:08 prestashop mrdoc setup 1.png

2016-10-26T06:54:06Z

Krylovia: Krylovia загрузил новую версию Файл:08 prestashop mrdoc setup 1.png

Создание настройки обмена в MrDoc (шаг 1)

Категория:Интеграция с поставщиками

2016-10-20T12:31:45Z

Krylovia: Новая страница: «Данный раздел описывает возможности интеграции с сайтами поставщиков.»

Данный раздел описывает возможности интеграции с сайтами поставщиков.

Категория:Интеграция с интернет-магазинами

2016-10-20T12:30:55Z

Krylovia: Новая страница: «Данный раздел посвящен интеграции с интернет-магазинами.»

Данный раздел посвящен интеграции с интернет-магазинами.

Загрузка данных с сайтов поставщиков

2016-10-20T12:28:02Z

Krylovia:

= Важно! =

Перед загрузкой данных с сайтов поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

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

Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

Модуль позволяет загружать цены и наличие товаров у поставщиков напрямую с их сайтов по расписанию.

Для этого поставщик должен предоставить ссылку на JSON или XML-файл, в котором отражены его остатки и/или его цены. Ссылка может быть как на сайт (начинается с "http://"), так и на ftp-сервер (начинается с "ftp://").

После предварительной настройки наша система будет по расписанию скачивать этот файл по ссылке и загружать из него наличие и цены товаров.

'''Внимание!''' Модуль предназначен только для обновления цен и наличия для товаров, уже существующих в системе. Если в файле есть товары, которых нет в системе, то они не будут автоматически создаваться.

= Включение модуля =

Для включения модуля необходимо зайти в ваш [https://mrdoc.org/pcabinet личный кабинет на сайте mrdoc.org] и включить модуль "Интеграция с поставщиками".

[[Файл:Module supplierRestPriceImport turn on module.png|border|925px|Включение модуля в личном кабинете]]

= Настройка модуля =

После включения модуля в вашей программе появляется новый пункт меню "Настройки загрузки данных поставщиков".

Этот пункт ведет в журнал, где для каждого поставщика необходимо создать отдельную запись.

[[Файл:Module supplierRestPriceImport menu.png|border|748px|Пункт главного меню для настройки загрузки данных поставщиков]]

[[Файл:Module supplierRestPriceImport update.png|border|940px|Настройка загрузки данных с сайта поставщика]]

* '''Поставщик''' - поставщик, для которого будут загружаться цены и наличие. Цены будут загружаться по тому типу цен, который указан в карточке поставщика (в поле "Закупочный тип цен");
* '''Способ расчёта цены''' - способ вычисления итоговой цены поставщика для тех случаев, когда у поставщика несколько разных цен для одного товара (например, разные цены на разных складах);
* '''Периодичность''' - с какой периодичностью загружать данные с сайта поставщика;
* '''Валюта цен''' - валюта для загрузки цен;
* '''Сбрасывать наличие после загрузки''' - при установке этого флажка будет сбрасываться наличие для всех товаров, которых не было в файле, но по которым ранее было зафиксировано наличие у данного поставщика;
* '''Логин, пароль''' - некоторые поставщики требуют аутентификации для скачивания файла;
* '''Табличная часть "Настройки для обновления товаров"''' - это список правил для разбора файла:
** '''URL для загрузки файла''' - ссылка на файл поставщика;
** '''Узел товара''' - путь до узла товара внутри файла;
** '''Поле артикула''' - путь до поля с артикулом в рамках узла товара;
** '''Шаблон наименования''' - шаблон для формирования наименования, по которому будет искаться товар, если он не был найден по артикулу поставщика;
** '''Поля с кол-вами (через запятую)''' - пути до полей с количествами в рамках узла товара;
** '''Поля с ценами (через запятую)''' - пути до полей с ценами в рамках узла товара;

== Пример настройки для XML-файла ==

Допустим, что поставщик предоставляет ссылку на XML-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.xml

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires>
<cae>003309</cae>
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires>
<cae>1014138</cae>
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims>
<cae>WHS152714</cae>
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims>
<cae>WHS152672</cae>
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "tires" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "rims" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

В файлах некоторых поставщиков могут использоваться атрибуты XML-узлов.

Например, в данном файле артикул товара указан в атрибуте узла товара, а не отдельным подузлом:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires cae="003309">
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires cae="1014138">
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims cae="WHS152714">
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims cae="WHS152672">
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В этом случае поле "Поле артикула" нужно заполнить так: "@cae" (символ "@" указывает на то, что это атрибут узла, а не отдельный узел).

== Пример настройки для JSON-файла ==

Допустим, что поставщик предоставляет ссылку на JSON-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.json

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
{
"tires": [
{
"cae": "003309",
"brand": "Nokian",
"size": "R19",
"model": "AH213-19",
"rest_msk": 5,
"rest_spb": 2,
"price_msk": 3650,
"price_spb": 3685
},
{
"cae": "1014138",
"brand": "Nokian",
"size": "R20",
"model": "AH213-20",
"rest_msk": 5,
"rest_spb": "более 40",
"price_msk": 4120,
"price_spb": 4120
},
...
],
"rims": [
{
"cae": "WHS152714",
"brand": "Nitro",
"model": "N20-123",
"rest_msk": 12,
"rest_spb": 2,
"price_msk": 2370,
"price_spb": 2370
},
{
"cae": "WHS152672",
"brand": "Nitro",
"model": "N20-124",
"rest_msk": 15,
"rest_spb": 7,
"price_msk": 3580,
"price_spb": 3600
},
...
]
}
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "tires";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "rims";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

= Контроль результатов загрузки данных =

После сохранения настройки автоматически создается задача, статус выполнения которой можно увидеть в отчете "Отчеты / Запланированные задачи".

В результатах задачи отображается общее количество обновленных цен/остатков, а также общее количество пропущенных товаров.

Пропущенные товары - это узлы в файле, для которых не было найдено соответствующих товаров в системе (ни по артикулу поставщика, ни по шаблону наименования).

[[Файл:Module supplierRestPriceImport task result.png|border|688px|Результат загрузки данных]]

[[Category:Интеграция с поставщиками]]

Загрузка данных с сайтов поставщиков

2016-10-20T12:26:01Z

Krylovia:

= Важно! =

Перед загрузкой данных с сайтов поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

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

Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

Модуль позволяет загружать цены и наличие товаров у поставщиков напрямую с их сайтов по расписанию.

Для этого поставщик должен предоставить ссылку на JSON или XML-файл, в котором отражены его остатки и/или его цены. Ссылка может быть как на сайт (начинается с "http://"), так и на ftp-сервер (начинается с "ftp://").

После предварительной настройки наша система будет по расписанию скачивать этот файл по ссылке и загружать из него наличие и цены товаров.

= Включение модуля =

Для включения модуля необходимо зайти в ваш [https://mrdoc.org/pcabinet личный кабинет на сайте mrdoc.org] и включить модуль "Интеграция с поставщиками".

[[Файл:Module supplierRestPriceImport turn on module.png|border|925px|Включение модуля в личном кабинете]]

= Настройка модуля =

После включения модуля в вашей программе появляется новый пункт меню "Настройки загрузки данных поставщиков".

Этот пункт ведет в журнал, где для каждого поставщика необходимо создать отдельную запись.

[[Файл:Module supplierRestPriceImport menu.png|border|748px|Пункт главного меню для настройки загрузки данных поставщиков]]

[[Файл:Module supplierRestPriceImport update.png|border|940px|Настройка загрузки данных с сайта поставщика]]

* '''Поставщик''' - поставщик, для которого будут загружаться цены и наличие. Цены будут загружаться по тому типу цен, который указан в карточке поставщика (в поле "Закупочный тип цен");
* '''Способ расчёта цены''' - способ вычисления итоговой цены поставщика для тех случаев, когда у поставщика несколько разных цен для одного товара (например, разные цены на разных складах);
* '''Периодичность''' - с какой периодичностью загружать данные с сайта поставщика;
* '''Валюта цен''' - валюта для загрузки цен;
* '''Сбрасывать наличие после загрузки''' - при установке этого флажка будет сбрасываться наличие для всех товаров, которых не было в файле, но по которым ранее было зафиксировано наличие у данного поставщика;
* '''Логин, пароль''' - некоторые поставщики требуют аутентификации для скачивания файла;
* '''Табличная часть "Настройки для обновления товаров"''' - это список правил для разбора файла:
** '''URL для загрузки файла''' - ссылка на файл поставщика;
** '''Узел товара''' - путь до узла товара внутри файла;
** '''Поле артикула''' - путь до поля с артикулом в рамках узла товара;
** '''Шаблон наименования''' - шаблон для формирования наименования, по которому будет искаться товар, если он не был найден по артикулу поставщика;
** '''Поля с кол-вами (через запятую)''' - пути до полей с количествами в рамках узла товара;
** '''Поля с ценами (через запятую)''' - пути до полей с ценами в рамках узла товара;

== Пример настройки для XML-файла ==

Допустим, что поставщик предоставляет ссылку на XML-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.xml

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires>
<cae>003309</cae>
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires>
<cae>1014138</cae>
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims>
<cae>WHS152714</cae>
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims>
<cae>WHS152672</cae>
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "tires" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "rims" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

В файлах некоторых поставщиков могут использоваться атрибуты XML-узлов.

Например, в данном файле артикул товара указан в атрибуте узла товара, а не отдельным подузлом:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires cae="003309">
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires cae="1014138">
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims cae="WHS152714">
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims cae="WHS152672">
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В этом случае поле "Поле артикула" нужно заполнить так: "@cae" (символ "@" указывает на то, что это атрибут узла, а не отдельный узел).

== Пример настройки для JSON-файла ==

Допустим, что поставщик предоставляет ссылку на JSON-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.json

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
{
"tires": [
{
"cae": "003309",
"brand": "Nokian",
"size": "R19",
"model": "AH213-19",
"rest_msk": 5,
"rest_spb": 2,
"price_msk": 3650,
"price_spb": 3685
},
{
"cae": "1014138",
"brand": "Nokian",
"size": "R20",
"model": "AH213-20",
"rest_msk": 5,
"rest_spb": "более 40",
"price_msk": 4120,
"price_spb": 4120
},
...
],
"rims": [
{
"cae": "WHS152714",
"brand": "Nitro",
"model": "N20-123",
"rest_msk": 12,
"rest_spb": 2,
"price_msk": 2370,
"price_spb": 2370
},
{
"cae": "WHS152672",
"brand": "Nitro",
"model": "N20-124",
"rest_msk": 15,
"rest_spb": 7,
"price_msk": 3580,
"price_spb": 3600
},
...
]
}
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "tires";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "rims";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

= Контроль результатов загрузки данных =

После сохранения настройки автоматически создается задача, статус выполнения которой можно увидеть в отчете "Отчеты / Запланированные задачи".

В результатах задачи отображается общее количество обновленных цен/остатков, а также общее количество пропущенных товаров.

Пропущенные товары - это узлы в файлы, для которых не было найдено соответствующих товаров в системе (ни по артикулу поставщика, ни по шаблону наименования).

[[Файл:Module supplierRestPriceImport task result.png|border|688px|Результат загрузки данных]]

[[Category:Интеграция с поставщиками]]

Файл:Module supplierRestPriceImport task result.png

2016-10-20T12:22:11Z

Krylovia: Результат загрузки данных

Результат загрузки данных

Загрузка данных с сайтов поставщиков

2016-10-20T12:14:48Z

Krylovia:

= Важно! =

Перед загрузкой данных с сайтов поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

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

Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

Модуль позволяет загружать цены и наличие товаров у поставщиков напрямую с их сайтов по расписанию.

Для этого поставщик должен предоставить ссылку на JSON или XML-файл, в котором отражены его остатки и/или его цены. Ссылка может быть как на сайт (начинается с "http://"), так и на ftp-сервер (начинается с "ftp://").

После предварительной настройки наша система будет по расписанию скачивать этот файл по ссылке и загружать из него наличие и цены товаров.

= Включение модуля =

Для включения модуля необходимо зайти в ваш [https://mrdoc.org/pcabinet личный кабинет на сайте mrdoc.org] и включить модуль "Интеграция с поставщиками".

[[Файл:Module supplierRestPriceImport turn on module.png|border|925px|Включение модуля в личном кабинете]]

= Настройка модуля =

После включения модуля в вашей программе появляется новый пункт меню "Настройки загрузки данных поставщиков".

Этот пункт ведет в журнал, где для каждого поставщика необходимо создать отдельную запись.

[[Файл:Module supplierRestPriceImport menu.png|border|748px|Пункт главного меню для настройки загрузки данных поставщиков]]

[[Файл:Module supplierRestPriceImport update.png|border|940px|Настройка загрузки данных с сайта поставщика]]

* '''Поставщик''' - поставщик, для которого будут загружаться цены и наличие. Цены будут загружаться по тому типу цен, который указан в карточке поставщика (в поле "Закупочный тип цен");
* '''Способ расчёта цены''' - способ вычисления итоговой цены поставщика для тех случаев, когда у поставщика несколько разных цен для одного товара (например, разные цены на разных складах);
* '''Периодичность''' - с какой периодичностью загружать данные с сайта поставщика;
* '''Валюта цен''' - валюта для загрузки цен;
* '''Сбрасывать наличие после загрузки''' - при установке этого флажка будет сбрасываться наличие для всех товаров, которых не было в файле, но по которым ранее было зафиксировано наличие у данного поставщика;
* '''Логин, пароль''' - некоторые поставщики требуют аутентификации для скачивания файла;
* '''Табличная часть "Настройки для обновления товаров"''' - это список правил для разбора файла:
** '''URL для загрузки файла''' - ссылка на файл поставщика;
** '''Узел товара''' - путь до узла товара внутри файла;
** '''Поле артикула''' - путь до поля с артикулом в рамках узла товара;
** '''Шаблон наименования''' - шаблон для формирования наименования, по которому будет искаться товар, если он не был найден по артикулу поставщика;
** '''Поля с кол-вами (через запятую)''' - пути до полей с количествами в рамках узла товара;
** '''Поля с ценами (через запятую)''' - пути до полей с ценами в рамках узла товара;

== Пример настройки для XML-файла ==

Допустим, что поставщик предоставляет ссылку на XML-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.xml

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires>
<cae>003309</cae>
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires>
<cae>1014138</cae>
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims>
<cae>WHS152714</cae>
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims>
<cae>WHS152672</cae>
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "tires" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "rims" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

В файлах некоторых поставщиков могут использоваться атрибуты XML-узлов.

Например, в данном файле артикул товара указан в атрибуте узла товара, а не отдельным подузлом:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires cae="003309">
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires cae="1014138">
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims cae="WHS152714">
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims cae="WHS152672">
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В этом случае поле "Поле артикула" нужно заполнить так: "@cae" (символ "@" указывает на то, что это атрибут узла, а не отдельный узел).

== Пример настройки для JSON-файла ==

Допустим, что поставщик предоставляет ссылку на JSON-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.json

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
{
"tires": [
{
"cae": "003309",
"brand": "Nokian",
"size": "R19",
"model": "AH213-19",
"rest_msk": 5,
"rest_spb": 2,
"price_msk": 3650,
"price_spb": 3685
},
{
"cae": "1014138",
"brand": "Nokian",
"size": "R20",
"model": "AH213-20",
"rest_msk": 5,
"rest_spb": "более 40",
"price_msk": 4120,
"price_spb": 4120
},
...
],
"rims": [
{
"cae": "WHS152714",
"brand": "Nitro",
"model": "N20-123",
"rest_msk": 12,
"rest_spb": 2,
"price_msk": 2370,
"price_spb": 2370
},
{
"cae": "WHS152672",
"brand": "Nitro",
"model": "N20-124",
"rest_msk": 15,
"rest_spb": 7,
"price_msk": 3580,
"price_spb": 3600
},
...
]
}
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "tires";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "rims";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

[[Category:Интеграция с поставщиками]]

Загрузка данных с сайтов поставщиков

2016-10-20T12:14:14Z

Krylovia:

= Важно! =

Перед загрузкой данных с сайтов поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

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

Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

Модуль позволяет загружать цены и наличие товаров у поставщиков напрямую с их сайтов по расписанию.

Для этого поставщик должен предоставить ссылку на JSON или XML-файл, в котором отражены его остатки и/или его цены. Ссылка может быть как на сайт (начинается с "http://"), так и на ftp-сервер (начинается с "ftp://").

После предварительной настройки наша система будет по расписанию скачивать этот файл по ссылке и загружать из него наличие и цены товаров.

= Включение модуля =

Для включения модуля необходимо зайти в ваш [https://mrdoc.org/pcabinet личный кабинет на сайте mrdoc.org] и включить модуль "Интеграция с поставщиками".

[[Файл:Module supplierRestPriceImport turn on module.png|border|925px|Включение модуля в личном кабинете]]

= Настройка модуля =

После включения модуля в вашей программе появляется новый пункт меню "Настройки загрузки данных поставщиков".

Этот пункт ведет в журнал, где для каждого поставщика необходимо создать отдельную запись.

[[Файл:Module supplierRestPriceImport menu.png|border|748px|Пункт главного меню для настройки загрузки данных поставщиков]]

[[Файл:Module supplierRestPriceImport update.png|border|940px|Настройка загрузки данных с сайта поставщика]]

* '''Поставщик''' - поставщик, для которого будут загружаться цены и наличие. Цены будут загружаться по тому типу цен, который указан в карточке поставщика (в поле "Закупочный тип цен");
* '''Способ расчёта цены''' - способ вычисления итоговой цены поставщика для тех случаев, когда у поставщика несколько разных цен для одного товара (например, разные цены на разных складах);
* '''Периодичность''' - с какой периодичностью загружать данные с сайта поставщика;
* '''Валюта цен''' - валюта для загрузки цен;
* '''Сбрасывать наличие после загрузки''' - при установке этого флажка будет сбрасываться наличие для всех товаров, которых не было в файле, но по которым ранее было зафиксировано наличие у данного поставщика;
* '''Логин, пароль''' - некоторые поставщики требуют аутентификации для скачивания файла;
* '''Табличная часть "Настройки для обновления товаров"''' - это список правил для разбора файла:
** '''URL для загрузки файла''' - ссылка на файл поставщика;
** '''Узел товара''' - путь до узла товара внутри файла;
** '''Поле артикула''' - путь до поля с артикулом в рамках узла товара;
** '''Шаблон наименования''' - шаблон для формирования наименования, по которому будет искаться товар, если он не был найден по артикулу поставщика;
** '''Поля с кол-вами (через запятую)''' - пути до полей с количествами в рамках узла товара;
** '''Поля с ценами (через запятую)''' - пути до полей с ценами в рамках узла товара;

== Пример настройки для XML-файла ==

Допустим, что поставщик предоставляет ссылку на XML-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.xml

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires>
<cae>003309</cae>
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires>
<cae>1014138</cae>
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims>
<cae>WHS152714</cae>
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims>
<cae>WHS152672</cae>
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "tires" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.xml";
** Узел товара: "rims" (путь к узлу товара не учитывает корневой узел "data");
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

В файлах некоторых поставщиков могут использоваться атрибуты XML-узлов.

Например, в данном файле артикул товара указан в атрибуте узла товара, а не отдельным подузлом:
<pre>
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<data>
<tires cae="003309">
<brand>Nokian</brand>
<size>R19</size>
<model>AH213-19</model>
<rest_msk>5</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>3650</rest_sk3>
<price_spb>3685</rest_sk4>
</tires>
<tires cae="1014138">
<brand>Nokian</brand>
<size>R20</size>
<model>AH213-20</model>
<rest_msk>5</rest_mkrs>
<rest_spb>более 40</rest_sk2>
<price_msk>4120</rest_sk3>
<price_spb>4120</rest_sk4>
</tires>
...
<rims cae="WHS152714">
<brand>Nitro</brand>
<model>N20-123</model>
<rest_msk>12</rest_mkrs>
<rest_spb>2</rest_sk2>
<price_msk>2370</rest_sk3>
<price_spb>2370</rest_sk4>
</rims>
<rims cae="WHS152672">
<brand>Nitro</brand>
<model>N20-124</model>
<rest_msk>15</rest_mkrs>
<rest_spb>7</rest_sk2>
<price_msk>3580</rest_sk3>
<price_spb>3600</rest_sk4>
</rims>
...
</data>
</pre>

В этом случае поле "Поле артикула" нужно заполнить так: "@cae" (символ "@" указывает на то, что это атрибут узла, а не отдельный узел).

== Пример настройки для JSON-файла ==

Допустим, что поставщик предоставляет ссылку на JSON-файл с ценами и остатками: https://pro.4tochki.ru/export_data/rest_other.json

Если открыть эту ссылку в браузере, то увидим следуюшее содержимое файла:
<pre>
{
"tires": [
{
"cae": "003309",
"brand": "Nokian",
"size": "R19",
"model": "AH213-19",
"rest_msk": 5,
"rest_spb": 2,
"price_msk": 3650,
"price_spb": 3685
},
{
"cae": "1014138",
"brand": "Nokian",
"size": "R20",
"model": "AH213-20",
"rest_msk": 5,
"rest_spb": "более 40",
"price_msk": 4120,
"price_spb": 4120
}
],
"rims": [
{
"cae": "WHS152714",
"brand": "Nitro",
"model": "N20-123",
"rest_msk": 12,
"rest_spb": 2,
"price_msk": 2370,
"price_spb": 2370
},
{
"cae": "WHS152672",
"brand": "Nitro",
"model": "N20-124",
"rest_msk": 15,
"rest_spb": 7,
"price_msk": 3580,
"price_spb": 3600
}
]
}
</pre>

В данном случае у поставщика разные узлы для разных типов товаров: '''tires''' - для шин, '''rims''' - для дисков.

Соответственно, необходимо создать две записи в табличной части "Настройки для обновления товаров":

'''Строка 1:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "tires";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {size} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nokian R19 AH213-19");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

'''Строка 2:'''
** URL для загрузки файла: "https://pro.4tochki.ru/export_data/rest_other.json";
** Узел товара: "rims";
** Поле артикула: "cae";
** Шаблон наименования: "{brand} {model}" (то есть наименования для поиска будут принимать следующий вид: "Nitro N20-123");
** Поля с кол-вами (через запятую): "rest_msk,rest_spb";
** Поля с ценами (через запятую): "price_msk,price_spb";

[[Category:Интеграция с поставщиками]]

Загрузка данных с сайтов поставщиков

2016-10-20T12:05:01Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T12:04:22Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T11:59:06Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T11:58:32Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T11:48:22Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T11:47:46Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T11:47:29Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T11:41:22Z

Krylovia:

Создание заказа покупателя через API

2016-10-20T09:35:30Z

Krylovia:

[[Category:API]]
Данная статья посвящена обмену данными с системой Mr.Doc через REST API интерфейс на примере создания заказа покупателя.

== Доступ к API ==
Перед выполнением операций с системой через API необходимо настроить права доступа для учетной записи, от которой будут производиться запросы. Подробнее об этом можно прочитать в разделе [[Настройка доступа к API]].

== Структура запроса ==
Создание заказа осуществляется посредством POST-запроса на один из адресов:
* ''https://company_name.mrdoc.org/api/1/DocSaleOrder.json''
* ''https://company_name.mrdoc.org/api/1/DocSaleOrder.xml''
в зависимости от того, в каком формате будет производиться обмен (JSON или XML соответственно).
В теле запроса должна содержаться информация о новом документе в выбранном формате.
=== Пример JSON ===
<pre>
{
"date_time": "2014-01-01 12:00:00",
"number": "SF-00001",
"status_id": "Черновик",
"organization_id": 1,
"contractor_id": 50,
"contract_id": 55,
"currency_id": 1,
"price_type_id": 2,
"is_price_include_vat": false,
"external_number": "SF-00001",
"products": [
{
"product_id": 113,
"sku_id": 145,
"unit_id": 113,
"factor": 1,
"quantity": 8,
"price": 250,
"sum": 2000,
"vat_rate_id": "БезНДС",
"vat_sum": 0
},
{
"product_id": 245,
"sku_id": 645,
"unit_id": 245,
"factor": 1,
"quantity": 1,
"price": 540,
"sum": 540,
"vat_rate_id": "БезНДС",
"vat_sum": 0
}
],
"services": [
{
"service_id": 5,
"sku_id": 5,
"unit_id": 5,
"factor": 1,
"quantity": 1,
"price": 550,
"sum": 550,
"vat_rate_id": "БезНДС",
"vat_sum": 0,
"execution_address_id": 198,
"execution_date_time": "2014-01-05 16:30:00"
}
]
}
</pre>

=== Пример XML ===
<pre>
<?xml version="1.0" encoding="utf-8"?>
<root>
<date_time>2014-01-01 12:00:00</date_time>
<number>SF-00001</number>
<status_id>Черновик</status_id>
<organization_id>1</organization_id>
<contractor_id>50</contractor_id>
<contract_id>55</contract_id>
<currency_id>1</currency_id>
<price_type_id>2</price_type_id>
<is_price_include_vat>0</is_price_include_vat>
<external_number>SF-00001</external_number>
<products list="true">
<item>
<product_id>113</product_id>
<sku_id>145</sku_id>
<unit_id>113</unit_id>
<factor>1</factor>
<quantity>8</quantity>
<price>250</price>
<sum>2000</sum>
<vat_rate_id>БезНДС</vat_rate_id>
<vat_sum>0</vat_sum>
</item>
<item>
<product_id>245</product_id>
<sku_id>645</sku_id>
<unit_id>245</unit_id>
<factor>1</factor>
<quantity>1</quantity>
<price>540</price>
<sum>540</sum>
<vat_rate_id>БезНДС</vat_rate_id>
<vat_sum>0</vat_sum>
</item>
</products>
<services list="true">
<item>
<service_id>5</service_id>
<sku_id>5</sku_id>
<unit_id>5</unit_id>
<factor>1</factor>
<quantity>1</quantity>
<price>550</price>
<sum>550</sum>
<vat_rate_id>БезНДС</vat_rate_id>
<vat_sum>0</vat_sum>
<execution_address_id>198</execution_address_id>
<execution_date_time>2014-01-05 16:30:00</execution_date_time>
</item>
</services>
</root>
</pre>

=== Атрибуты ===
Следующие атрибуты являются обязательными к заполнению:
* contractor_id
* products.product_id
* products.quantity
* products.price
* products.vat_rate_id
* services.service_id
* services.quantity
* services.price
* services.vat_rate_id
Остальные атрибуты в случае их отсутствия будут вычислены автоматически заполнены значениями по умолчанию.
Отсутствующим атрибутом считается тот, для которого отсутствует соответствующий ключ в переданных данных, а не только его значение. В примере ниже атрибут '''number''' является отсутствующим, а '''date_time''' просто с пустым значением.
<pre>
{
"date_time": "",
"status_id": "Черновик",
"organization_id": 1
}
</pre>

{| class="wikitable"
|-
!Имя атрибута
!Описание

|-
!date_time
|Дата заказа покупателю в формате SQL. В случае отсутствия в переданных данных будет заполнена текущей датой.

|-
!number
|Учетный номер документа. В случае отсутствия в переданных данных будет сгенерирован автоматически.

|-
!status_id
|Статус заказа. Возможные значения: ПомеченНаУдаление, Черновик, Проведен. Значение по умолчанию - Черновик.

|-
!organization_id
|Идентификатор собственной организации из справочника '''RefOrganization'''. В случае отсутствия в переданных данных будет заполнен идентификатором первой организации в системе.

|-
!contractor_id
|Идентификатор покупателя из справочника '''RefContractor'''.

|-
!contract_id
|Идентификатор договора с покупателем из справочника '''RefContract'''. В случае отсутствия в переданных данных будет заполнен идентификатором первого договора с указанным покупателем в системе. При отсутствии такового, будет автоматически создан новый договор.

|-
!currency_id
|Идентификатор валюты из справочника '''RefCurrency'''. Значение по умолчанию - идентификатор валюты "Российский рубль".

|-
!price_type_id
|Идентификатор типа цен из справочника '''RefPriceType''' - необязательный атрибут.

|-
!is_price_include_vat
|Булево значение - признак включение НДС в стоимость товаров и услуг.

|-
!external_number
|Номер заказа покупателя из внешней системы.

|-
!products.product_id
|Идентификатор товара из справочника '''RefNomenclature'''.

|-
!products.sku_id
|Идентификатор модификации товара из справочника '''RefSku'''. В случае отсутствия в переданных данных будет заполнен идентификатором основной модификации указанного товара.

|-
!products.unit_id
|Идентификатор единицы измерения товара из справочника '''RefUnit'''. В случае отсутствия в переданных данных будет заполнен идентификатором базовой единицы измерения указанного товара.

|-
!products.factor
|Коэффициент - кол-во базовых единиц измерения номенклатуры в текущей единице измерения. В случае отсутствия в переданных данных будет заполнен коэффициентом указанной единицы измерения.

|-
!products.quantity
|Количество заказанного товара.

|-
!products.price
|Цена заказанного товара.

|-
!products.sum
|Сумма заказанного товара. В случае отсутствия в переданных данных будет рассчитана автоматически на основании количества, цены и ставки НДС.

|-
!products.vat_rate_id
|Ставка НДС. Возможные значения: НДС18, НДС18_118, НДС10, НДС10_110, НДС0, БезНДС.

|-
!products.vat_sum
|Сумма НДС заказанного товара. В случае отсутствия в переданных данных будет рассчитана автоматически на основании количества, цены и ставки НДС.

|-
!services.service_id
|Идентификатор услуги из справочника '''RefNomenclature'''.

|-
!services.sku_id
|Идентификатор модификации услуги из справочника '''RefSku'''. В случае отсутствия в переданных данных будет заполнен идентификатором основной модификации указанной услуги.

|-
!services.unit_id
|Идентификатор единицы измерения услуги из справочника '''RefUnit'''. В случае отсутствия в переданных данных будет заполнен идентификатором базовой единицы измерения указанной услуги.

|-
!services.factor
|Коэффициент - кол-во базовых единиц измерения номенклатуры в текущей единице измерения. В случае отсутствия в переданных данных будет заполнен коэффициентом указанной единицы измерения.

|-
!services.quantity
|Количество заказанных услуг.

|-
!services.price
|Цена заказанной услуги.

|-
!services.sum
|Сумма заказанных услуг. В случае отсутствия в переданных данных будет рассчитана автоматически на основании количества, цены и ставки НДС.

|-
!services.vat_rate_id
|Ставка НДС. Возможные значения: НДС18, НДС18_118, НДС10, НДС10_110, НДС0, БезНДС.

|-
!services.vat_sum
|Сумма НДС заказанных услуг. В случае отсутствия в переданных данных будет рассчитана автоматически на основании количества, цены и ставки НДС.

|-
!services.execution_address_id
|Идентификатор адреса из справочника '''RefAddress''', по которому будет оказана услуга. Например, адрес доставки.

|-
!services.execution_date_time
|Планируемая дата и время оказания услуги в SQL формате.

|}

== Получение идентификаторов атрибутов-ссылок ==
Так как в качестве большинства атрибутов используются идентификаторы, целесообразно предварительно получить эти идентификаторы.
Рассмотрим получение идентификатора на примере атрибута '''"Покупатель"'''.
=== Поиск элемента в справочнике ===
Получение списка покупателей осуществляется посредством GET-запроса на один из адресов:
* ''https://company_name.mrdoc.org/api/1/RefContractor.json''
* ''https://company_name.mrdoc.org/api/1/RefContractor.xml''
в зависимости от того, в каком формате будет производится обмен (JSON или XML соответственно).
В качестве GET-параметров стоит указать набор полей, который необходимо вернуть и фильтр, по которому необходимо найти требуемого покупателя.
==== Пример JSON ====
URL: ''https://company_name.mrdoc.org/api/1/RefContractor.json?fields[]=id&fields[]=type_id&filters[email][]="sale@askona.ru"''

Ответ:
<pre>
{
"result": [
{
"id": "2",
"type_id": "ЮрЛицо"
}
]
}
</pre>

==== Пример XML ====
URL: ''https://company_name.mrdoc.org/api/1/RefContractor.xml?fields[]=id&fields[]=type_id&filters[email][]="sale@askona.ru"''

Ответ:
<pre>
<?xml version="1.0" encoding="utf-8"?>
<root>
<result list="true">
<item>
<id><![CDATA[2]]></id>
<type_id><![CDATA[ЮрЛицо]]></type_id>
</item>
</result>
</root>
</pre>

=== Создание элемента справочника ===
В случае отсутствия необходимого покупателя в справочнике, его можно создать посредством POST-запроса на эти же адреса, аналогично созданию заказа покупателя, описанного в данной статье.
Ответом на POST-запрос будет идентификатор вновь созданной записи.
==== Пример JSON ====
<pre>
{
"result": {
"id": 583
}
}
</pre>
==== Пример XML ====
<pre>
<?xml version="1.0" encoding="utf-8"?>
<root>
<result>
<id><![CDATA[583]]></id>
</result>
</root>
</pre>
Более подробно о атрибутах объектов системы можно прочитать в статье [[Описание объектов API]]

Загрузка данных с сайтов поставщиков

2016-10-20T09:25:56Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T09:24:59Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T09:24:43Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T09:06:12Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T09:05:47Z

Krylovia:

Файл:Module supplierRestPriceImport update.png

2016-10-20T09:05:12Z

Krylovia: Настройка загрузки данных с сайта поставщика

Настройка загрузки данных с сайта поставщика

Загрузка данных с сайтов поставщиков

2016-10-20T08:50:11Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T08:48:40Z

Krylovia:

Справочная система Mr.Doc

2016-10-20T08:47:37Z

Krylovia:

;Начало работы
:[[Регистрация]]
:[[Общие принципы работы с документами]]
:[[Общие принципы работы со справочниками]]
:[[Заполнение данных организации]]
:[[Наполнение справочника контрагентов]]
:[[Наполнение справочника товаров]]
:[[Установка цен и наличия]]
:[[Ввод начальных остатков]]
;Справочники
:[[Договоры]]
:[[Модификации]]
:[[Статьи движения денежных средств]]
:[[Дополнительные статусы]]
;API
:[[Настройка доступа к API|Настройка доступа]]
:[[Создание заказа покупателя через API|Как создать заказ покупателя]]
;Интеграция с интернет-магазинами
:[[Синхронизация с интернет-магазином Prestashop]]
;Интеграция с поставщиками
:[[Загрузка данных с сайтов поставщиков‎‎]]

Загрузка данных с сайтов поставщиков

2016-10-20T08:46:07Z

Krylovia:

Файл:Module supplierRestPriceImport menu.png

2016-10-20T08:45:03Z

Krylovia: Пункт главного меню для настройки загрузки данных поставщиков

Пункт главного меню для настройки загрузки данных поставщиков

Загрузка данных с сайтов поставщиков

2016-10-20T08:41:16Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T08:40:01Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T08:39:48Z

Krylovia:

Файл:Module supplierRestPriceImport turn on module.png

2016-10-20T08:38:47Z

Krylovia: Включение модуля в личном кабинете

Включение модуля в личном кабинете

Синхронизация с сайтами поставщиков

2016-10-20T08:28:51Z

Krylovia: Krylovia переименовал страницу Синхронизация с сайтами поставщиков в Загрузка данных с сайтов поставщиков

#перенаправление [[Загрузка данных с сайтов поставщиков]]

Загрузка данных с сайтов поставщиков

2016-10-20T08:28:51Z

Krylovia: Krylovia переименовал страницу Синхронизация с сайтами поставщиков в Загрузка данных с сайтов поставщиков

= Важно! =

Перед синхронизацией данных с сайтами поставщиков настоятельно рекомендуется внимательно прочитать данное руководство.

Компания "КлаудТим" не несет ответственности за любые проблемы, прямо или косвенно связанные с синхронизацией.
Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации.

= Возможности =

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

= Настройка синхронизации =

[[Category:Интеграция с поставщиками]]

Загрузка данных с сайтов поставщиков

2016-10-20T08:28:17Z

Krylovia:

Загрузка данных с сайтов поставщиков

2016-10-20T08:23:21Z

Krylovia: Новая страница: «= Важно! = Перед синхронизацией данных с Prestashop настоятельно рекомендует…»

= Важно! =

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

Компания "КлаудТим" не несет ответственности за любые проблемы, прямо или косвенно связанные с синхронизацией.
Со своей стороны мы стараемся сделать все возможное для обеспечения правильной и надежной синхронизации, однако Prestashop имеет много подверсий и модулей с различным количеством проблем и ошибок. Поэтому протестировать все их сочетания не представляется возможным.

= Возможности =

Между MrDoc и сайтом синхронизируются товары, категории, покупатели и их заказы.
Также поддерживается выгрузка на сайт цен и складских остатков товаров.

Существует возможность ограничить список синхронизируемых объектов (например, синхронизировать только справочник товаров).

Поддерживаемые версии PrestaShop: 1.5, 1.6.

== Синхронизация справочников ==

{| class="wikitable"
!colspan="2"|Соответствие объектов
|-
!style="width:50%;"|Объект на сайте
!style="width:50%;"|Объект в MrDoc
|-
|Товар
|Элемент справочника "Номенклатура"
|-
|Комбинация товара
|Элемент справочника "Модификации номенклатуры"
|-
|Категория товаров
|Группа справочника "Номенклатура"
|-
|Производитель
|Элемент справочника "Производители"
|-
|Поставщик
|Элемент справочника "Контрагенты"
|-
|Покупатель
|Элемент справочника "Контрагенты"
|}

=== Синхронизация товаров и категорий ===

Порядок первоначальной синхронизации товаров при настройке обмена с сайтом:

* Сначала с сайта загружаются все товары, их комбинации, а также все категории. При загрузке товаров и категорий система сразу пытается связать их с уже существующими товарами и категориями по наименованию, тем самым исключая дублирование товаров/категорий, вручную занесенных в MrDoc. При загрузке комбинаций система не пытается связывать их с уже существующими в MrDoc модификациями, за исключением комбинации по умолчанию - она всегда связывается с базовой модификацией товара.
* Затем на сайт выгружаются все товары и категории, отсутствующие на сайте (за исключением помеченных на удаление). При этом модификации для таких товаров на сайт не выгружаются.

Порядок последующей синхронизации товаров:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Система регистрирует изменения справочника "Номенклатура", тем самым формируя список товаров/категорий, которые необходимо выгрузить на сайт при очередной синхронизации.
* Также регистрация изменений товаров/комбинаций/категорий происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* При выполнении очередной синхронизации сначала загружаются все изменения с сайта в MrDoc, затем выгружаются изменения из MrDoc на сайт. При этом возможна ситуация, когда товар был одновременно изменен и на сайте и в MrDoc. В этом случае изменения на сайте будут иметь приоритет, так как загрузка данных с сайта происходит перед выгрузкой данных на сайт.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов товара
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Тип
|Вид номенклатуры
|Виртуальные товары загружаются в виде услуг, остальные типы - в виде товаров.
|-
|Артикул
|Артикул базовой модификации
|Максимальная длина 100 символов.
|-
|Штрихкод
|Штрихкод EAN13 для базовой модификации товара
|
|-
|Производитель
|Производитель
|
|-
|Категория по умолчанию
|Родительская группа
|
|-
|Налоговые правила
|Ставка НДС
|Соответствие ставок НДС налоговым правилам осуществляется при первоначальной настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
|-
|Комбинация по умолчанию
|Базовая модификация
|Выгрузка новых модификаций на сайт не поддерживается. Новый товар всегда выгружается без модификаций.
|-
|Артикулы поставщиков
|Артикулы поставщиков
|
|}

Для всех новых товаров с сайта автоматически устанавливаются цены сайта (цены фиксируются для типа цен, указанного в настройке обмена). Для новых товаров, выгружаемых на сайт цена устанавлиается в соотвествии с типом цен, указанным в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").

Новые товары всегда выгружаются на сайт со статусом "Запрещен" и видимостью "Нигде".
При дальнейшей синхронизации статус товара не изменяется, то есть статус в Prestashop не зависит от статуса товара в MrDoc.

Для новых товаров, загруженных с сайта, автоматически устанавливается комментарий "Товар загружен с сайта Prestashop".

{| class="wikitable"
!colspan="3"|Соответствие реквизитов группы (категории)
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Родительская категория
|Родительская группа
|
|-
|Отображено
|Статус
|Отображение на сайте включается только для групп со статусом "Активен".
|}

Для новых групп (категорий), загруженных с сайта, автоматически устанавливается комментарий "Категория загружена с сайта Prestashop".

{| class="wikitable"
!colspan="3"|Соответствие реквизитов модификации (комбинации)
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Значения свойств комбинации
|Наименование модификации формируется из значений её свойств при загрузке с сайта.
|-
|Артикул
|Артикул
|
|}

Выгрузка новых модификаций на сайт не поддерживается.

Для новых модификаций (комбинаций), загруженных с сайта, автоматически устанавливается комментарий "Модификация товара загружена с сайта Prestashop".

=== Синхронизация производителей ===

Порядок первоначальной синхронизации производителей при настройке обмена с сайтом:

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

Порядок последующей синхронизации производителей:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Система регистрирует изменения справочника "Производители", тем самым формируя список производителей, которые необходимо выгрузить на сайт при очередной синхронизации.
* Также регистрация изменений производителей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* При выполнении очередной синхронизации сначала загружаются все изменения с сайта в MrDoc, затем выгружаются изменения из MrDoc на сайт. При этом возможна ситуация, когда производитель был одновременно изменен и на сайте и в MrDoc. В этом случае изменения на сайте будут иметь приоритет, так как загрузка данных с сайта происходит перед выгрузкой данных на сайт.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов производителя
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Включено
|Статус
|На сайте включаются только производители со статусом "Активен".
|}

Для новых производителей, загруженных с сайта, автоматически устанавливается комментарий "Производитель загружен с сайта Prestashop".

=== Синхронизация поставщиков ===

Порядок первоначальной синхронизации поставщиков при настройке обмена с сайтом:

* С сайта загружаются все поставщики. При загрузке поставщиков система сразу пытается связать их с уже существующими поставщиками по наименованию, тем самым исключая дублирование поставщиков, вручную занесенных в MrDoc.
* Поставщики, отсутствующие на сайте, автоматически на сайт не выгружаются.

Порядок последующей синхронизации поставщиков:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Регистрация изменений поставщиков происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Новые поставщики на сайт выгружаются только при выгрузке артикулов поставщиков для товаров.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов поставщика
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Наименование
|Наименование
|Максимальная длина 100 символов.
|-
|Телефон
|Телефон
|Длина телефона должна быть ровно 11 символов.
|-
|Страна, город, почтовый индекс, адрес
|Фактический адрес
|
|-
|Включено
|Статус
|На сайте включаются только производители со статусом "Активен".
|}

Для новых поставщиков, загруженных с сайта, автоматически устанавливается комментарий "Поставщик загружен с сайта Prestashop".

=== Синхронизация покупателей ===

Порядок первоначальной синхронизации покупателей при настройке обмена с сайтом:

* С сайта загружаются все покупатели. При загрузке покупателей система не пытается связать их с уже существующими покупателями, то есть каждый покупатель с сайта загружается в виде нового контрагента.
* Покупатели, отсутствующие на сайте, автоматически на сайт не выгружаются.

Порядок последующей синхронизации покупателей:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Регистрация изменений покупателей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Новые покупатели на сайт выгружаются только при выгрузке заказов покупателей. Для выгрузки нового покупателя на сайт у него должны быть заполнены следующие реквизиты: имя, фамилия, email.
* Обратите внимание, что при стандартных настройках PrestaShop новому покупателю будет отправлено письмо с регистрационными данными.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов покупателя
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Имя
|Имя
|Максимальная длина 100 символов. Обязательно к заполнению.
|-
|Фамилия
|Фамилия
|Максимальная длина 100 символов. Обязательно к заполнению.
|-
|Email
|Email
|Максимальная длина 100 символов. Обязательно к заполнению.
|-
|Телефон
|Телефон
|Длина телефона должна быть ровно 11 символов.
|-
|Адрес доставки
|Фактический адрес
|
|-
|Статус
|Статус
|На сайте разрешен вход только для покупателей со статусом "Активен".
|}

Для новых покупателей, загруженных с сайта, автоматически устанавливается следующие реквизиты:
* наименование (фамилия + имя);
* тип "Физическое лицо";
* комментарий "Покупатель загружен с сайта Prestashop".

== Синхронизация заказов покупателей ==

Порядок первоначальной синхронизации заказов покупателей при настройке обмена с сайтом:

* С сайта загружаются все заказы покупателей с датой больше даты начала обмена. При загрузке новых заказов система не пытается связать их с уже существующими в MrDoc заказами.
* Заказы покупателей, отсутствующие на сайте и с датой больше даты начала обмена, автоматически выгружаются на сайт. Вместе с заказами будут выгружаться и отсутствующие на сайте покупатели.

Порядок последующей синхронизации заказов покупателей:

* Последующая синхронизация выполняется с периодичностью, указанной в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Регистрация изменений заказов покупателей происходит на стороне сайта (с помощью подключаемого модуля, см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
* Новые заказы покупателей будут выгружаться на сайт только в том случае, если их дата больше даты начала обмена.

{| class="wikitable"
!colspan="3"|Соответствие реквизитов заказа
|-
!style="width:20%;"|Реквизит на сайте
!style="width:20%;"|Реквизит в MrDoc
!Особенности
|-
|Номер заказа
|Внешний номер
|Внешний номер заказа отображается на вкладке "Дополнительно" в форме заказа.
|-
|Дата
|Дата
|
|-
|Клиент
|Покупатель
|
|-
|Статус
|Дополнительный статус
|Дополнительный статус в MrDoc вычисляется по соответствию, заданному в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
|-
|Валюта
|Валюта
|
|-
|Итого
|Сумма
|
|-
|Доставка
|Услуга в табличной части "Услуги"
|Услуга в MrDoc вычисляется по соответствию, заданному в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]").
|-
|Товары
|Товары в табличной части "Товары"
|
|}

Для новых заказов, загруженных с сайта, автоматически устанавливаются реквизиты:
* организация, указанная в настройке обмена;
* тип цен, указанный в настройке обмена;
* комментарий вида "Заказ загружен из интернет-магазина PrestaShop (заказ PXIHJXKOZ)".

При загрузке заказа покупателя с сайта система пытается зарезервировать товары, указанные в заказе. Для этого автоматически оформляется или перезаполняется документ "Резервирование товаров". Если зарезервировать товар не удалось, то это не считается ошибкой, так как на сайте может быть выключен контроль складских остатков.

При выгрузке заказа покупателя на сайт в качестве услуги доставки используется первая услуга, для которой указано соответствие в настройке обмена (см. раздел "[[Синхронизация с интернет-магазином Prestashop#Настройка обмена|Настройка обмена]]"). При этом стоимость данной услуги будет являться стоимостью доставки, а адрес оказания данной услуги - адресом доставки.

== Обновление цен на сайте ==

Цена товара на сайте обновляется в следующих случаях:

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

Цены на сайт выгружаются в валюте, указанной в настройке обмена.

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

== Обновление складских остатков на сайте ==

Складские остатки выгружаются на сайт в следующих случаях:

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

Вместе со складскими остатками выгружаются данные о наличии товаров у поставщиков.
Эти данные используются для вычисления доступности товара для заказа.

Изменение складского остатка товара влияет на реквизиты товара "Доступен для заказа" и "Показать цену".
Эти флажки устанавливаются, если товар есть на складе или есть в наличии у одного из поставщиков. В противном случае эти флажки снимаются.

== Обновление курсов валют на сайте ==

Курсы валют выгружаются на сайт в следующих случаях:

* При первоначальной настройке обмена (выгружаются курсы валют по всем синхронизированным валютам);
* При изменении курса валюты.

= Настройка обмена =

Сначала необходимо включить опцию "Интеграция с Prestashop" в разделе "Настройки" личного кабинета на сайте [http://mrdoc.org MrDoc.org].

[[Файл:Mrdoc_prestashop_enable.png|border|Включение модуля в личном кабинете]]

Затем необходимо установить модуль для обмена на сайте.
Для этого необходимо открыть журнал настроек обмена "Сервис - Настройки обмена с Prestashop" и скачать модуль, соответствующий версии Prestashop, с помощью кнопок на верхней панели.

[[Файл:01_prestashop_mrdoc_get_module.png|border|1000px|Модуль для установки на сайте]]

Полученный архив необходимо указать в интерфейсе добавления нового модуля в панели администрирования сайта.

[[Файл:02_prestashop_module_install_1.png|border|1000px|Установка модуля на сайте (шаг 1)]]

[[Файл:03_prestashop_module_install_2.png|border|1000px|Установка модуля на сайте (шаг 2)]]

[[Файл:04_prestashop_module_install_3.png|border|1000px|Установка модуля на сайте (шаг 3)]]

[[Файл:05_prestashop_module_install_4.png|border|1000px|Установка модуля на сайте (шаг 4)]]

После установки модуля необходимо открыть его настройки и создать настройку обмена.

[[Файл:06_prestashop_module_install_5.png|border|1000px|Настройка модуля на сайте (шаг 1)]]

Параметры настройки:

* '''Наименование''' - наименование настройки, носит чисто информационный характер;
* '''Ключ авторизации''' - ключ, который необходимо указать в MrDoc для подключения к сайту (генерируется автоматически, его не нужно менять);
* '''Пункт выдачи''' - пункт выдачи, адрес которого будет в качестве адреса доставки для заказов без доставки, выгружаемых из MrDoc;
* '''Способ доставки''' - способ доставки, который будет подставляться в заказы без доставки, выгружаемые из MrDoc;
* '''Вид оплаты''' - вид оплаты, который будет подставляться в заказы, выгружаемые из MrDoc;

[[Файл:07_prestashop_module_install_6.png|border|1000px|Настройка модуля на сайте (шаг 2)]]

После установки и настройки модуля на сайте необходимо настроить обмен в MrDoc.
Для этого в создаем новую настройку обмена в журнале "Сервис - Настройки обмена с Prestashop".

Параметры настройки:

* '''Наименование''' - наименование настройки, носит чисто информационный характер;
* '''Статус''' - можно временно выключить обмен данными с сайтом, установив статус "Помечен на удаление";
* '''Дата начала обмена''' - заказы покупателей старше этой даты не будут синхронизироваться с сайтом;
* '''Организация для заказов с сайта''' - организация, которая будет подставляться в заказы, выгружаемые с сайта;
* '''Тип цен сайта''' - тип цен, который будет подставляться в заказы, выгружаемые с сайта, а также используемый при выгрузке цен товаров;
* '''Валюта сайта''' - валюта, которая будет подставляться в заказы, выгружаемые с сайта, а также используемая при выгрузке цен товаров;
* '''Адрес сайта''' - адрес сайта интернет-магазина;
* '''Ключ авторизации''' - ключ авторизации, указанный в модуле обмена на стороне сайта;
* '''Периодичность обмена''' - насколько часто будет запускаться задача синхронизации с сайтом;
* '''Настройки синхронизации''' - здесь можно указать, какие объекты нужно синхронизировать с сайтом;

[[Файл:08_prestashop_mrdoc_setup_1.png|border|1000px|Создание настройки обмена в MrDoc (шаг 1)]]

После указания необходимых параметров необходимо нажать кнопку "Далее" для перехода к настройке соответствий ставок НДС, способов доставки и статусов заказов.
На каждой вкладке присутствует кнопка "Обновить ставки (способы доставки, статусы) c сайта", позволяющая заново запросить у сайта список вариантов.

[[Файл:09_prestashop_mrdoc_setup_2.png|border|1000px|Создание настройки обмена в MrDoc (шаг 2)]]

[[Файл:10_prestashop_mrdoc_setup_3.png|border|1000px|Создание настройки обмена в MrDoc (шаг 3)]]

[[Файл:11_prestashop_mrdoc_setup_4.png|border|1000px|Создание настройки обмена в MrDoc (шаг 4)]]

= Контроль состояния обмена =

Контроль состояния обмена осуществляется следующими способами:

* Состояние задачи синхронизации и ее результаты отражаются в отчете "Запланированные задачи";
* Подробные описания ошибок обмена выводятся в отчете "Ошибки обмена".

Кроме того, существует отчет "Оплаты по заказам на сайте", в котором отражаются все оплаты заказов, оформленные на сайте.
Сами оплаты в системе никак не отражаются.

== Отчет "Запланированные задачи" ==

Отчет доступен через главное меню "Отчеты - Запланированные задачи".

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

[[Файл:12_prestashop_mrdoc_task.png|border|1000px|Задача обмена в отчете "Запланированные задачи"]]

[[Файл:13_prestashop_mrdoc_task_result.png|border|400px|Результаты успешного выполнения задачи обмена]]

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

[[Файл:14_prestashop_mrdoc_task_error.png|border|500px|Ошибка выполнения обмена, связанная с необходимостью обновления модуля на сайте]]

== Отчет "Ошибки обмена" ==

Отчет открывается с помощью кнопки "Ошибки обмена" в форме настройки обмена.

[[Файл:15_prestashop_mrdoc_report_error_1.png|border|500px|Кнопка для открытия отчета "Ошибки обмена"]]

Отчет состоит из двух вкладок: ошибки загрузки (с сайта в MrDoc) и ошибки выгрузки (из MrDoc на сайт).

Колонки отчета на вкладке "Ошибки загрузки":

* '''Дата''' - дата фиксирования ошибки;
* '''Тип объекта во внешней системе''' - (category - категория, product - товар, combination - модификация, customer - покупатель, order - заказ покупателя, manufacturer - производитель, supplier - поставщик);
* '''ID объекта во внешней системе''' - ID объекта на сайте;
* '''Текст ошибки''' - описание ошибки.

Колонки отчета на вкладке "Ошибки выгрузки":

* '''Дата''' - дата фиксирования ошибки;
* '''Тип объекта''' - Тип объекта в MrDoc;
* '''ID объекта''' - ID объекта в MrDoc;
* '''Текст ошибки''' - описание ошибки.

[[Файл:16_prestashop_mrdoc_report_error_2.png|border|1000px|Отчет "Ошибки обмена"]]

== Отчет "Оплаты по заказам на сайте" ==

Отчет открывается с помощью кнопки "Оплаты по заказам на сайте" в форме настройки обмена.

В нем выводятся оплаты по заказам, оформленные через сайт.

[[Файл:17_prestashop_mrdoc_report_payment_1.png|border|500px|Кнопка для открытия отчета "Оплаты по заказам на сайте"]]

[[Файл:18_prestashop_mrdoc_report_payment_2.png|border|1000px|Отчет "Оплаты по заказам на сайте"]]

[[Category:Интеграция с поставщиками]]