Настройка модуля интеграции происходит с участием 3 систем.

1. Настройка на стороне RetailCRM.
2. Настройка группы (сообщества ) на стороне VK.
3. Настройка самого модуля интеграции.

Каждый блок настроек рассмотрен отдельно.
ВНИМАНИЕ ! Блок 2 и блок 3 нужно производить в параллели. В инструкции указаны, где какие данные необходимо использовать.

Настройка на стороне RetailCRM для подключения модуля интеграции VK.

В RetailCRM должен  быть созданы:

1. Магазин, с которым будет интегрирована группа с VK.
   
2. Сгенерирован и загружен каталог c номенклатурой.
   Важно:
   • — Фотографии к товарам в каталоге сгенерированном для синхронизации с VK Market должны быть размерами не менее 400 px x 400 px
     — Допустимые форматы: JPG, PNG, GIF
     — Сумма высоты и ширины не более 14000px
     — Файл объемом не более 50 МБ
     — Минимальная длина описания 10 символов (Описание берется из файла ICML тег — <description>…</description>
     — У товаров должно быть не более 2-х свойств.На скрине приведен пример. В верхней части — как отображается в ВК , в нижней части пример товара со свойствами Размер и Цвет. Сами свойства могут быть разными, но количество этих свойств не более двух.
     
   • Значения количества свойств  товара должно быть не более 30 . Т.е. если свойство Размер , то размеров в файле обмена не должно быть более 30
     
     

   Обратите внимание! Для объединения карточек товаров по свойствам, необходимо чтобы они были заполнены в соответствии с примером выше.

   Расположение поля для добавление ссылки на каталог:

1. Необходимо создать API — ключ.
   — Добавьте новый API — ключ
   — Подпишите назначение API -ключа в разделе комментарий.
   — Тип доступа. Разрешите доступ к магазину, который будет синхронизирован с VK.
   — Разрешенные следующие методы API:

— Сохраните.

Используйте созданный API — ключ только для интеграции с VK .

Настройка группы(сообщества) на стороне VK.

Для работы с модулем необходимо создать приложение, оно позволит Вашей CRM работать с VK.
Для создания приложения авторизуйтесь в социальной сети под тем аккаунтом, к которому будет привязано приложение.
ВНИМАНИЕ: Ваш аккаунт должен иметь права администратора в группе(сообществе) которая будет подключено к модулю.

Зайдите в группу , которую хотите подключить к RetailCRM . Зайдите в Управление — пункт Разделы —  включите функционал товаров.

Перейдите в настройки магазина

Настройки :
1. Регионы . Выберите страну (страны) и города в которых работает магазин.
2. Валюта магазина .Выберите соответствующую вашей валюте на сайте валюту, т.к. цены из CRM будут передаваться в валюте CRM, а ВК будет их воспринимать в соответствии с этой настройкой.
3. Контакт для связи — Сообщения сообщества . Тип кнопки — написать продавцу, тогда будет открыто окно для сообщения.

До тех пор, пока товаров в группе нет, блок с товарами не будет виден никому кроме администраторов группы.

Создание приложения VK

Для работы модуля интеграции необходимо создать приложение, для этого  переходим по ссылке https://vk.com/editapp?act=create откроется страница:

Необходимо указать :
1.  Название вашего приложения ,название произвольное , например Интеграция ВК и RetailCRM .
2. Выбираем  платформу Сайт.
3. Адрес сайта  : https://vk.imb-service.ru
4. Базовый домен : vk.imb-service.ru

Нажимаем —  Подключить сайт.

В разделе Информация обязательно необходимо выбрать группу, к которой подключаете.
Нажимаем 

Переходим в раздел настройки приложения. Open API.

В настройках   :
1. Адрес сайта : https://vk.imb-service.ru
2. Базовый домен : vk.imb-service.ru
3. Доверенный redirect URI: https://vk.imb-service.ru/setting/code
Нажимаем 

Передача заказов настройка на стороне сообщества и одновременно необходимы будут данные с модуля. Настройку можете проводить в параллели с модулем интеграции (Блок : Настройка модуля интеграции ) . Для удобства последовательности  настроек тут описываем именно часть из VK, а блок модуля отдельно, но какие строки берем из модуля ниже будет указано и продемонстрировано на скринах.

Переходите в сообщество. Управление — Настройка — Работа с API — Callback API .

Перед настройкой добавьте новый сервер: нажимаете на поля с названием данного сервера и затем «Добавить сервер»

Вносим настройку : Версия API : 5.124

Внимание ! Перед следующим шагом обязательно должна быть выполнена настройка из модуля интеграции Модуль и Магазин (Блок инструкции 3. Настройка самого модуля интеграции.)

Далее необходимо настроить Сallback API и получить подтверждение корректности ссылки Сallback .
На скрине продемонстрирована: слева — страница с настройками модуля (данный раздел по настройкам описан ниже) , справа — настройки на стороне VK.

Вносим настройку :
1. Копируем код из VK , переносим во вкладку настроек модуля интеграции — вкладка Настройки callback,
в строку, которую должен вернуть  сервер (callback)
Нажимаем  
2. Копируем Адрес callback на  стороне настроек модуля и переносим в Адрес на стороне VK
3. Нажимаем
4. Если синхронизация прошла корректно, то напротив Адреса callback появится подтверждающая галочка
5. Придет сервисное сообщение от VK что группа подключена. Одобрите запрашиваемое подключение .

Перейдите на стороне сообщества в пункт настроек Работы с API — Типы событий
Дойдите до раздела работы с товарами и поставьте галочки на два пункта Создание Заказа и Редактирование Заказа.

Дойдите до раздела работы с товарами и поставьте галочки на два пункта Создание Заказа и Редактирование Заказа  

Настройка  модуля интеграции

Для первого входа в настройки модуля перейдите :  https://vk.imb-service.ru.  Настройте Первый раздел — Модуль (описание подключения ниже) Нажмите Сохранить. После того как будет произведено подключение данное приложение появится на Маркетплейс RetailCRM вашего аккаунта. Продолжайте настройку там.
Администрирование — Интеграции — Маркетплейс — Магазин ВКонтакте — Перейти в личный кабинет.
Данная схема подключения будет актуально до момента модерации и размещения интеграционного модуля сразу на Маркетплейс RetailCRM . После размещения на Маркетплейс RetailCRM подключение будет происходить сразу там.
Hаздел — Модуль

1. Ссылка на аккаунт RetailCRM — внесите данные своего аккаунта retailCRM. На примере введен тестовый аккаунт.
2. АPI — ключ — вносим API — ключ созданный в п.3 Настройки на стороне retailCRM.
   
3. ID приложения — вносим данные из настроек приложения VK , которое ранее создавали (см. на скрине)
4. ID группы — вносим данные из настроек Callback API (см. на скрине). Обращаем внимание что ID группы можно посмотреть и другим способом, согласно документации в  https://vk.com/faq18062 . Но для удобства пользователей мы предлагаем посмотреть его уже на вкладке, которая уже используется при подключении. Если Вы настраиваете модуль в другом порядке действий, то используйте наиболее удобное Вам место.
5. Защищенный ключ — вносим данные из настроек приложения VK , которое ранее создавали (см. на скрине).

Сохраните изменения .
После сохранения может появится сервисное сообщение:
Если это произошло , зайдите в свой аккаунт RetailCRM .

Путь — Администрирование — Интеграция -Маркетплейс -Настройки интеграции с Магазин ВКонтакте — 

Раздел — Магазин

Раздел —Настройки callback

В разделе заказы станет доступна информация по Callback, которую необходимо ввести в настройках на стороне VK .

Синхронизируйте системы :
1. Копируем код из VK , переносим во вкладку настроек модуля интеграции — вкладка Настройки callback,
в строку, которую должен вернуть  сервер (callback)
Нажимаем  
2. Копируем Адрес callback на  стороне настроек модуля и переносим в Адрес на стороне VK
3. Нажимаем
4. Если синхронизация прошла корректно, то напротив Адреса callback появится подтверждающая галочка  
5. Придет сервисное сообщение от VK что группа подключена. Одобрите запрашиваемое подключение .

Продолжайте настройки на стороне модуля.

Раздел — Категории

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

Для сопоставления выберите соответствующую категорию в ВК маркете из выпадающего списка , напротив нужно категории retailCRM.

Повторите процесс для остальных категорий.  

Раздел — Заказы

В разделе  Заказы сопоставьте статусы заказов в своей группе ВК с статусами заказов в CRM

Для того чтобы выбрать соответствующий статус в CRM нажмите на пустое поле напротив нужного статуса ВК .

После окончания настройки сопоставления, нажмите

Раздел — Товары

Взаимодействие с данным разделом можно производить только после заполнения вкладки Категории.

Для запуска выгрузки товаров нажмите «Выгрузка товаров в VK»

Для удаление товаров, выгруженных модулем нажимаем «Удаление товаров выгруженных модулем»

Для удаление всех товаров с магазина нажимаем «Удаление Всех товаров Маркета»

Отслеживать работу по выгрузке/удалению товаров можно на вкладке «Логи товаров»

Раздел — Остатки

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

Остатки можно передавать как общие по всем складам, так и и с отдельного склада — для выбора склада нажмите на с надписью «Передавать общие остатки» 

После настройки нажимаем «Сохранить настройки» и только потом «Запустить задачу обновления остатков в VK»

Особенности реализации .

1.В случае, если вы на стороне Retailcrm произвели Очистку каталога , необходимо заново сделать связку категорий товаров в модулей в вкладке Каталог.
2. Если при активации или обновлении модуля интеграции видите ошибку :

Это ошибка означает что не произошла синхронизация между модулем интеграции и VK.
Для устранения перепроверьте :
1. Являетесь ли Вы администратором в сообществе VK, которое подключаете. Или предоставлен и в настоящий момент актуален доступ в приложение VK , которое создал администратор сообщества.

2. Правильно ли указаны данные  в созданном  приложении. Особенно обратите  внимание указана ли верно подключаемая группа и  на Доверенный redirect URI: https://vk.imb-service.ru/setting/code.

После устранения ошибок, продолжить настройку можно перейдя в модуль https://vk.imb-service.ru/settings  или через Ваш аккаунт RetailCRM.
Путь — Администрирование — Интеграция -Маркетплейс -Настройки интеграции с Магазин ВКонтакте — 

О поддержке модуля Вы можете узнать в разделе Поддержка

Особенности обмена:

1. Заказа из VK market поступает в RetailCRM со статусом Новый . Название статуса в RetailCRM может отличаться, в зависимости от выбранных настроек при установке модуля. Далее изменения по статусам заказа приходят из RetailCRM, смена статуса в VK market не передается в RetailCRM.
2. Для того чтоб синхронизировать товары, справочник товаров должен соответствовать правилам синхронизации. Требования к справочнику описаны подробно в разделе Установка.
3. Тип оплат и тип доставок не передается в текущей версии модуля. Но данные доработки планируются , как только будет техническая возможность со стороны VK market .
4. Статус заказа из RetailCRM в VKmarket передается каждые 15 минут. Если заказ перешел в конечный статус — отменен, завершен, возврат или статус не менялся более 20 дней, после этого статусы в VK-market не меняются.