Для начала работы необходимо скачать архив с модулем (retailcrm-версия_модуля.zip), который доступен по ссылке GitHub.
Загрузка модуля интеграции
Скачанный модуль необходимо загрузить в PrestaShop. Для этого, в разделе «Модули», перейдите в «Module Manager» и нажмите на кнопку «Загрузить модуль». Выберите недавно скачанный модуль на компьютере и загрузите его в PrestaShop. После успешной загрузки будет показано сообщение: Модуль установлен. Далее, нажмите «Настроить», откроется окно с настройками модуля.
Перейти на данную страницу также можно с помощью меню: в блоке «Улучшения» - «Модули» - «Module Manager», в строке поиска введите «Simla.com». После того, как модуль будет найден, нажмите «Настроить».
Подключение аккаунта к модулю интеграции
Если аккаунт CRM еще не зарегистрирован, кликните «Получить Simla.com бесплатно», и в соседней вкладке откроется сайт для регистрации нового аккаунта.
Если аккаунт CRM уже в наличии, нажмите «У меня есть учетная запись в Simla.com», чтобы перейти к настройке модуля. Во вкладке «FAQ» можно ознакомиться с описанием модуля и с часто возникающими вопросами.
Первым шагом по настройке модуля является ввод данных подключаемой системы. В первом поле укажите полный URL системы (например, https://demo.simla.com). Во втором, ранее созданный API-ключ. Нажмите «Сохранить».
Настройки модуля
Примечание
В случае, если в PrestaShop включена мультисайтовость, то не забудьте настроить соответствие магазинов в системе сайтам PrestaShop.
После сохранения откроется окно с основными настройками модуля. В блоке «Соединение» будут отображены данные подключенной системы.
Далее необходимо указать соответствие значений справочников интернет-магазина и системы.
Типы доставок
В блоке «Типы доставок» необходимо сопоставить службу доставки на сайте c типом доставки в системе. Значения для выбора соответствий подгружаются из справочника «Типы доставок» в системе. Обратите внимание, из справочника выгружаются все типы доставок, в том числе и неактивные. После установки соответствия всем способам доставки, сохраните изменения.
Примечание
Если в дальнейшем подключите новую службу доставки на стороне PrestaShop, не забудьте добавить ей сопоставление в настройках модуля для корректной работы. При оформлении заказа с типом доставки, которому нет соответствия, заказ выгрузится в систему, но в карточке данного заказа не будет выбран тип доставки.
Типы оплат
В блоке «Типы оплат» необходимо установить соответствия типам оплат между подключаемой системой и PrestaShop. В выборе доступны все перечисленные типы оплат, в том числе и неактивные.
Примечание
После настройки модуля, проверьте доступность способов оплат для имеющихся типов доставки. Для этого перейдите в административную панель сайта «PrestaShop» - «Улучшения» - «Оплата» - «Настройки», внизу указан блок «Ограничения перевозчика». Также обратите внимание, если оплата заказа будет производится «Наличными», то размер оплаты должен быть равен стоимости заказа.
Статусы заказов
В блоке «Статусы заказов» необходимо установить соответствия статусам между подключаемой системой и PrestaShop. Если в процессе работы на стороне PrestaShop будет добавлен новый статус, его необходимо сопоставить со статусом в системе в настройках модуля для корректной работы.
Примечание
Необходимо, чтобы значения в сопоставлениях не повторялись, иначе корректная работа модуля не будет гарантирована. Также, если заказ в PrestaShop перейдет в статус, которому не выбрано соответствие в настройках модуля, то в системе дальнейшее обновление статуса по этому заказу происходить не будет.
Дополнительно
Расширенные настройки модуля
Опция «Выгружать услуги в ICML». При включении опции все товары с типом «виртуальный» и для которых не добавлены файлы для скачивания, будут рассматриваться как услуги и загружаться в Систему как услуги.
Примечание
Выгрузка услуг через ICML файл доступна с версии 3.6.4.
Для включения функционала корпоративных клиентов, активируйте галочку «Поддержка корпоративных клиентов».
Подробнее про корпоративных клиентов читайте в соответствующем разделе.
При активации опции «Отправка номера заказа в Simla.com» номер заказа будет соответствовать полю Reference в заказе PrestaShop. Если опция деактивирована, то при выгрузке заказа из PrestaShop в CRM, номер заказа будет соответствовать шаблону генерации номера заказа, созданного через API.
Если активировать опцию «Получение номера заказа из Simla.com», то при выгрузке заказа из CRM в PrestaShop, номер заказа (поле Reference) будет соответствовать номеру заказа в CRM. Если данная опция деактивирована, то номер заказа не будет транслироваться из CRM в PrestaShop.
Примечание
В случае, если требуется передавать ID заказа как номер заказа в CRM, то в поле «Шаблон генерации номера заказа из API» в настройках CRM (Настройки →Системные → Общие), укажите значение
{external_id}.
После ввода всех необходимых данных, нажмите Сохранить.
Двусторонняя синхронизация
Для того, чтобы при изменении данных заказа или клиента на стороне системы произошло обновление данных на стороне PrestaShop, необходимо включить опцию «Синхронизировать заказы из CRM».
После активации опции необходимо заполнить параметры по умолчанию для типа доставки и типа оплаты, если при оформлении заказа в системе в нем не будет указан тип оплаты или доставки. Параметры обязательны к заполнению.
PrestaShop вызывает событие изменения заказа в трёх случаях:
- При добавлении товара в заказ;
- При изменении существующего в заказе товара (например, изменении его количества);
- При удалении товара из заказа.
Во всех остальных случаях событие не вызывается. Таким образом, в силу специфики платформы PrestaShop, мы не можем передавать изменение, если были добавлены или изменены только скидки в заказе. Для передачи изменений по скидкам в систему необходимо, чтобы произошло дополнительное изменение из вышеуказанного списка.
Работа с остатками
Для получения актуальной информации по остаткам из CRM, нужно активировать галочку «Получать остатки из Simla.com».
В поле «Если заказ оплачен» необходимо указать статус заказа, который будет автоматически проставлен в случае, если какого-то товара нет в наличии и заказ оплачен.
В поле «Если заказ не оплачен» необходимо указать статус заказа, который будет автоматически проставлен, когда какого-то товара нет в наличии и заказ не оплачен.
В PrestaShop настройка разрешения покупки товара, когда его нет в наличии, устанавливается либо в карточке самого товара (раздел «Настройки наличия»), либо в параметрах магазина («Настройки товаров» - «Запасы товаров» - «Разрешить заказ товаров с нулевым остатком на складе»)
Брошенные корзины
Для выгрузки брошенных корзин в CRM необходимо активировать опцию «Выгружать брошенные корзины. Время, по прошествию которого в систему будет выгружена брошенная корзина, составляет 15 минут для корректной работы модуля.
Далее установите время, спустя которое корзина будет считаться «брошенной».
Сервис сбора данных
В данном блоке необходимо указать ключ сайта для отслеживания онлайн-статуса пользователей. Отслеживание происходит при помощи внутреннего сервиса Daemon collector.
Ключ можно найти в настройках системы по пути Настройки → Интеграция → Collector.
Онлайн-консультант
При необходимости использования на сайте виджета «Онлайн-консультант», вставьте в данный блок скрипт из настроек модуля консультанта и сохраните изменения.
Работа с заказами
Выгрузка заказов
В блоке «Выгрузка заказов» возможна выгрузка нескольких заказов единовременно - при этом идентификаторы заказов указываются либо через запятую (1,2,3,4,5), либо диапазоном (1-5). Единовременно можно выгрузить до 10 заказов.
Невыгруженные заказы
В данной вкладке можно повторно запустить выгрузку невыгруженных заказов.
Ниже расположена таблица «Работа с заказами». С ее помощью можно проверить результат синхронизации заказов из PrestaShop в систем. В ней указывается дата и время выгрузки, номер заказа в PrestaShop и соответствующий ему номер заказа на стороне системы, а также статус - «Выгружен» или «Ошибка» в случае, если в заказе указаны некорректные данные.
Каталог товаров
В данном блоке указана следующая информация: подключен ли каталог в системе, сколько времени прошло с момента последней генерации ICML-файла и количество Товаров и Торговых предложений в сгенерированном каталоге. При нажатии на кнопку «Генерировать сейчас», будет запущена команда генерации ICML-файла каталога.
Для того, чтобы загрузить каталог в систему, требуется в настройках магазина, в системе, указать опцию «Загрузить каталог из ICML сейчас», либо каталог загрузится автоматически по расписанию (~ 4 часа).
Примечание
Обратите внимание, что по умолчанию модуль передает вес в граммах, а габариты в сантиметрах.
Если в каталоге, на стороне PrestaShop, товар имеет атрибуты (товар с комбинациями), то в CRM варианты данного товара будут выгружены как торговые предложения.
