Интеграция с 1С CommerceML [Olvery]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
<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|]]