Подробная инструкция по установке и активации

Содержание

1. Создание Ключа доступа к API
2. Вход в настройки модуля
3. Регистрация модуля
4. Магазины
5. Настройка на стороне Megagroup
   5.1. Заказ
   5.2. Формы
6. Настройка магазина
7. Логи
   Приложение 1

 1. Создание Ключа доступа к API

1. Войдите под своей учетной записью в RetailCRM с правами администратора.
2. Перейдите в Настройки/Интеграции/Ключи доступа к API.

3. Нажмите кнопку «Добавить».

4. Выберите тип доступа к магазину.

5. Отметьте магазин из списка, с которым будет работать модуль.
6. Отметьте методы из списка Разрешенные методы API. (Нужные методы указаны в Приложении 1).
7. Скопируйте ключ.
8.Нажмите “Сохранить”. 

2. Вход в настройки модуля

1. Перейдите в Настройки/Интеграции/Маркетплейс.
2.  Выберите модуль.

3. Нажмите кнопку «Перейти в личный кабинет». При первом входе откроется страница регистрации.

3. Регистрация модуля

1. Вставляем скопированный ранее API-ключ и ссылку на RetailCRM.
2. Нажимаем «Сохранить»

4. Магазины

1. Переходим на вкладку Магазины и нажимаем «Добавить магазин»
2. Вводим домен магазина Megagroup и сопоставляем его с магазином в RetailCRM.
3. Нажимаем «Сохранить»

5. Настройка на стороне Megagroup

     5.1. Заказ

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

 5.1.1.Переходим в ЛК Megagroup.ru и нажимаем на раздел “Магазин”.

 5.1.2. Переходим на вкладку “Заказы” и заходим в “Уведомления”.

 5.1.3. Нажимаем «Создать».

    Нам открывается полный список возможных уведомлений. Далее в настройке вид уведомления будет приравниваться к статусу заказа, т.е. при получении письма “Заказ Новый” будет создаваться заказ с статусом “Новый заказ” (настройка соответствия статусов предусмотрена). Рассмотрим на примере уведомления о новом заказе как необходимо проводить настройку.

 5.1.4. Нажимаем “Заказ Новый”

 5.1.5. Проставляем активность, выключаем поддержку HTML, адрес ОБЯЗАТЕЛЬНО проставляем почту megagroup@im-business.com, “Тему” и “Сообщение” МЕНЯЕМ на текст из этого документа Исправленный шаблон иначе некоторые данные могут потеряться/некорректно отображаться.  

 5.1.6. Нажимаем “Сохранить”

 5.1.7. Далее делаем тестовый заказ, ждём когда он отобразится в ЛК.

     5.2. Формы

    Если на вашем сайте присутствую формы, например, “Купить в 1 клик”, то можно создавать заказы с данными из форм.

5.2.1. Заходим в редактирование сайта.

5.2.2. “Настройки сайта” и выбираем необходимую форму, в нашем случае это “Купить в 1 клик”.

5.2.3. Заходим в форму.

5.2.4. Переходим в уведомления.

5.2.5. Нажимаем на “+” и выбираем настройки как на скриншоте. Нажимаем далее.

 5.2.6. Снимаем активность с “Поддержка HTML” и добавляем почту megagroup@im-business.com, “Тему” и “Сообщение” НЕ МЕНЯЕМ, иначе некоторые данные могут потеряться/некорректно отображаться.

 5.2.7. Нажимаем “Сохранить”.

Шаблон письма заказов:
Megagroup: Заказ новый

6. Настройка магазина

1. Нажимаем на значок «гаечный ключ».
2. На вкладке «Основные» заполняем:
   — Домен магазина. Можно взять тут:
   
   — Магазин RetailCRM. Выбираем магазин доступный API ключу;
   — Тип заказа для Физических лиц. Выбираем тип заказа, который будет заполняться при оформлении заказа Физическими лицами;
   — Тип заказа для Юридических лиц. Выбираем тип заказа, который будет заполняться при оформлении заказа Юридическими  лицами;
   — Чек-бокс «Передавать номер заказа как в Megagroup». Активируем, если нужна передача номера заказа как в Megagroup;
   — Префикс к номеру заказа. Можно прописать любой префикс для добавления его к номеру заказа.

   ПЕРЕД ЗАПОЛНЕНИЕМ СЛЕДУЮЩИХ ВКЛАДОК СДЕЛАЙТЕ ТЕСТОВЫЙ ЗАКАЗ

    

3. Вкладка «Поля заказа»
   Данная вкладка предназначена для сопоставления передачи информации в пользовательские поля, основные данные передаются «на свои места».
        — Выставите все необходимые соответствия;
        — Нажмите «Сохранить».
   
   
   
4. На вкладке «Оплаты»:
   — Выставляем статус успешной оплаты;
   — Выставляем тип оплаты по умолчанию (настройка нужна для оплат Megagroup, которые не сопоставлены ниже);
   — Устанавливаем соответствие типов оплаты Megagroup c типами оплат RetailCRM;
   — После нажмите «Сохранить».
   
   Добавлять можно несколько типов доставки. Для добавления нажмите «Добавить».
5. На вкладке доставки «Доставки»:
   — Выставляем тип доставки по умолчанию (настройка нужна для доставок Megagroup, которые не сопоставлены ниже);
   — Устанавливаем соответствие типов доставки Megagroup c доставкой в RetailCRM;
   — После нажмите «Сохранить».Добавлять можно несколько типов доставки. Для добавления нажмите «Добавить ».
6. Вкладка «Статусы»
   — Необходимо выставить сопоставления статусов Megagroup статусам RetailCRM;

   ПЕРЕД ЗАПОЛНЕНИЕМ СЛЕДУЮЩИХ ВКЛАДОК СДЕЛАЙТЕ ТЕСТОВЫЙ ЗАКАЗ НА КАЖДУЮ НОВУЮ ФОРМУ

7. На вкладке «Формы»:Данная вкладка предназначена для выбора соответствий между полями в Megagroup и RetailCRM.-Для каждого формата письма выбираем сопоставление и нажимаем на кнопку «Сохранить».

7. Логи

Данная вкладка предназначена для просмотра ошибок, возникающих при работе.

Приложение 1

Необходимые методы API для ключа RetailCRM: