Различия

Показаны различия между двумя версиями страницы.

--- help:z_admin:z_settings:y_integrations:сommerceml [2025/04/07 11:16] – создано Марина Спиридонова
+++ help:z_admin:z_settings:y_integrations:сommerceml [2025/04/11 10:54] (текущий) – Марина Спиридонова
@@ Строка 1: / Строка 1: @@
+<alert type="warning" dismiss="true" icon="glyphicon glyphicon-exclamation-sign">Страница находится в разработке</alert>
 ====== Интеграция с 1С CommerceML ======
+Для обеспечения обмена данными между платформой Olvery и конфигурацией 1С CommerceML предусмотрена возможность интеграции данных систем. При этом обеспечивается передача информации о заказах, по которым были изменения или которые были созданы на платформе Olvery за период с последней успешной выгрузки по текущее время, в 1С CommerceML. На основании полученного списка заказов 1С CommerceML формирует счета и связанные операции оплаты.
+==== Настройка интеграции с 1С CommerceML в системе Olvery ====
+Настройка интеграции с системой 1С CommerceML осуществляется в разделе «**Управление экосистемой > Настройки системы**» на вкладке «**Интеграции**».
+<alert type="info">**Примечание**. Управление интеграциями доступно только в веб-приложении для пользователя с ролью «**[[help:z_admin:a_model_role|Администратор локации]]**».</alert>
+<panel type="info" title="Как перейти в интерфейс управления интеграциями">
+Для перехода в интерфейс управления интеграциями:
+  - Войдите в веб-приложение Olvery. \\ \\
+  - В боковом меню в переключателе интерфейсов выберите «**Управление экосистемой**». \\ В результате будет осуществлён переход в интерфейс администрирования. \\ \\
+  - Перейдите в раздел «**Настройки системы**». \\ \\
+  - Перейдите на вкладку «**Интеграции**».
+</panel>
+По умолчанию на вкладке «**Интеграции**» не отображаются интеграции: {{:help:z_admin:z_settings:y_integrations:location_integrations.png?800|}}
+Для создания интеграции с системой 1С CommerceML:
+  - Нажмите на кнопку «**Добавить интеграцию**». \\ В результате откроется окно создания интеграции, в котором в поле «**Класс интеграции**» установлено значение по умолчанию CommerceML: \\ {{:help:z_admin:z_settings:y_integrations:location_integrations_add3.png?400|}} \\ \\
+  - Заполните поля: \\ \\
+    * **Наименование**. Обязательное поле. Укажите наименование интеграции; \\ \\
+    * **Настройки (JSON)**. Обязательное поле. Укажите строку с JSON, в которой содержатся параметры для обмена данными между системой 1С CommerceML и платформой Olvery:  \\ \\
+      * **Способ оплаты**. Точное наименование способа оплаты из 1С; \\ \\
+      * **Параметры фильтрации заказов**. Параметры фильтрации в виде json массива payment_rules; \\ \\ <alert type="info">**Примечание**. Пример строки JSON: {"payment_rules":[{"status":"purchased","gateway":"CKassa"}],"payment_method_name":"Оплата картой внешняя"}.</alert>
+    * **Компания**. Обязательное поле. Выберите из раскрывающегося списка компанию, для которой создается интеграция с 1С и которая является поставщиком услуги. \\ \\
+  - Нажмите кнопку «**Сохранить**».
+После создания интеграции формируется hash для формирования URL скрипта интеграции, который необходимо прописать на стороне [[help:z_admin:z_settings:y_integrations:сommerceml#настройка_интеграции_на_стороне_1с_commerceml|1С CommerceML]].
+Для копирования URL скрипта интеграции:
+  - Выберите пункт «**Редактировать**» в контекстном меню созданной ранее интеграции. \\ В результате откроется окно редактирования интеграции: \\ {{:help:z_admin:z_settings:y_integrations:location_integrations_edit3.png?400|}}  \\ \\
+  - Скопируйте URL из поля «**Адрес скрипта**» с помощью кнопки «**Копировать**» {{:help:z_admin:z_settings:y_integrations:copy.png?20|}}.
+Помимо этого, в форме редактирования интеграции появляется поле «**Дата последней синхронизации**», в котором сохраняется дата и время последней проведенной операции загрузки информации о заказах в систему 1С CommerceML. \\ \\
+==== Настройка интеграции на стороне 1С CommerceML ====
+На стороне 1С CommerceML необходимо настроить обмен данными с интернет-магазином:
+  - Зайдите в радел «**Администрирование**», пункт меню «**Настройка обмена с интернет-магазином**»: \\ {{:help:z_admin:z_settings:y_integrations:commerceml_1.png?600|}}  \\ \\
+  - В результате откроется блок настройки обмена с интернет-магазином. \\ Заполните поля:\\ \\
+    * **CMS магазина** – выбираем «Другая»; \\ \\
+    * **Адрес скрипта** – это адрес обмена со стороны модуля. Получение адреса скрипта осуществляется в системе Olvery; \\ \\
+    * **Логин** – любой; \\ \\
+    * **Пароль** – любой; \\ \\
+    * **Префикс для нумерации загруженных счетов** – это префикс создаваемых заказов при загрузке из интернет-магазина. Префикс состоит из 2-х символов (букв, цифр). Он позволяет отдельно нумеровать документы, загруженные с сайта и включается в состав номера документа «Счет покупателю»; \\ \\
+    * **Организация** - организация по умолчанию для подстановки в заказ, загруженный с сайта; \\ \\
+    * **Склад** - склад по умолчанию для подстановки в заказ, загруженный с сайта; \\ \\
+    * **Группа для новых контрагентов** - группа, куда по умолчанию попадают покупатели из заказов, загруженных с сайта; \\ \\
+    * **Номенклатура** – здесь указываются реквизиты для новой номенклатуры, которая приходит из магазина; \\ \\
+    * **Загружать заказы с** – установим, заказы с какой датой создания загружать. Заказы, созданные ранее указанной даты загружены не будут; \\ \\
+    * **Запрещено создавать счет**, если статус заказа: ХХХ – активируем запрет создавать счет при определенном статусе, если это необходимо; \\ \\
+    * **Создавать новых контрагентов автоматически** – при активной настройке покупатели из заказов создаются автоматически; \\ \\
+    * **Создавать новую номенклатуру автоматически** – при активной настройке номенклатура из заказов создается автоматически.\\ \\
+  - Нажмите «**Записать и закрыть**». \\ \\
+  - После получения адреса скрипта в системе Olvery перейдите к редактированию настроек и в поле адрес скрипта введите необходимое значение: \\  {{:help:z_admin:z_settings:y_integrations:commerceml_2.png?600|}} \\ \\
+  - В поле «**Загружать онлайн-оплаты**» настройте наименование способа онлайн-оплаты интернет-магазина: \\  {{:help:z_admin:z_settings:y_integrations:commerceml_3.png?600|}}   \\ \\
+==== Обмен данными между Olvery и 1С CommerceML ====
+Для выполнения обмена данными с интернет-магазином необходимо:
+  - В интерфейсе 1С CommerceML перейти к пункту меню «**Продажи - Счета покупателям**»: \\  {{:help:z_admin:z_settings:y_integrations:commerceml_4.png?600|}} \\ \\
+  - В открывшемся окне «**Счета покупателям**» нажмите на кнопку «**Загрузить из интернет-магазина**»: \\ {{:help:z_admin:z_settings:y_integrations:commerceml_5.png?800|}}  \\ \\
+Если на стороне Olvery совершен заказ с частичной оплатой – в 1С он отображается как два счета: \\  {{:help:z_admin:z_settings:y_integrations:commerceml_6.png?600|}} \\ \\
+----
+См. также: [[help:z_admin:z_settings|]] | [[help:z_admin:z_settings:location|]] | [[help:z_admin:z_settings:stucture|]]