RetailCRM + LIFE POS

 


Интеграция позволяет передавать заказы из системы RetailCRM в LIFE POS.


С какой версии работает плагин?

У RetailCRM нет версий. Плагин работает для любого аккаунта в RetailCRM


  1. Для начала необходимо зайти в личный кабинет LIFE POS
  2. Настройка интеграции
  3. Настройка триггеров
  4. Коннектор
  5. Пользовательские сценарии работы
  6. Авторизация в приложении
  7. Оплата заказа
  8. Возврат оплаты
  9. Каталог товаров и услуг в LIFE POS формируется на основе товаров в RetailCRM

1. Для начала необходимо зайти в личный кабинет LIFE POS - https://my.life-pos.ru/auth/login
Если не помните данные для входа, нажмите кнопку восстановить пароль и введите:

После того как доступ получен, необходимо провести первичную настройку в ЛК. 

Перейдите в раздел структура бизнеса и добавьте:


Создание API-ключа в RetailCRM
Для создания API-ключа необходимо авторизоваться в системе RetailCRM - Авторизация в системе.
В личном кабинете RetailCRM переходим в Настройки - Интеграция - Ключи доступа к API и создаем новый.

 

Сам ключ будет сгенерирован автоматически.

Обязательно убедитесь, что ключ активен и в чек-боксе установлена галочка.

Если в типе доступа указать не все магазины, информация по ним не будет передаваться.

Также будет заведена задача при попытке передачи данных по заказу из неразрешенного магазина в LIFE POS.

В списке разрешенных действий в API необходимы:

Заказы (получение и редактирование)

Клиенты (получение)

Склад (получение)

Справочники (получение)

Доставки (получение и редактирование)

Пользователи (получение)

Задачи (получение и редактирование)

Платежи (получение и редактирование)


Выстраивание процессов работы
На данном этапе нужно продумать логику работы организации с системой доставки через LIFE POS
Важно учесть, на каком статусе заказа он должен быть передан в систему LIFE POS, при каком статусе может быть выполнена отмена или возврат, из каких статусов может быть осуществлен переход в “триггерный статус” и какой статус указан после триггерного.
Совет: поскольку, после передачи заказа в систему, изменения, произведенные в RetaliCRM по заказу, частично не поддерживаются (кроме смены магазина) для возможности изменения размера скидки или состава заказа можно создать отдельный статус, при котором заказ будет удаляться в системе, и настроить переходы так, чтобы из статуса, при котором происходит отправка заказа в систему LIFE POS, можно было перейти в статус ошибочной отмены, а затем вернуться к статусу отправки.
На этом шаге также нужно создать/выбрать группу сотрудников, на которых будут заводиться задачи в случае ошибок работы интеграции, а также типы оплат, которые будут назначаться при оплате через LIFE POS.
Для группы пользователей необходимо указать права для работы с задачами, для типов оплаты - настроить статусы. 


Настройка триггеров
Триггер - это термин со множеством значений, обычно означает внешний стимул, который запустил какое-либо действие, реакцию или событие.
Правильная настройка триггеров позволяет выбрать, в какой момент времени данные о заказе будут передаваться в систему LIFE POS, при каких условиях заказ будет отменен или по заказу будет возвращена оплата.
Для настройки триггеров в RetaliCRM необходимо перейти в раздел “Автоматизация” - “Триггеры” и нажать кнопку добавления триггера.

У всех триггеров идентично настраивается действие - Выполнить HTTP-запрос

указываем url запроса

https://integration.life-pos.ru/retailCRM/update

 метод запроса POST

указываем urlencode

 

Добавляем параметры запроса:

параметр client_id;

значение id организации LIFE POS (D организации LIFE POS - можно взять в адресной строке в личном кабинете LIFE POS. Будет указано после …/orgs/..);

параметр order_id;

значение {{ order.getId() }} , будет автоматически передавать id заказа;

параметр status;

значение может быть new, closed, refund.


 

 

Триггер на новый заказ (статус new)

В событии указываем “Изменение заказа”.

В условии указываем конструктор, выбираем тип условия “Статус заказа”.

Указываем статусы заказа, при переходе в который/ые будет отправлен запрос на создания заказ в LIFE POS.

В действии задаем значение параметра Статус - new.

Триггер на отмену неоплаченного заказа в LIFE POS (статус - closed)

В событии указываем “Изменение заказа”.

В условии указываем конструктор, выбираем тип условия “Статус заказа”.

Указываем статусы заказа, при переходе в который заказ будет отменен в системе LIFE POS, если заказ не был закрыт через LIFE POS, в дефолте “Возвращен” или “Отменен”.

В действии задаем значение параметра Статус - closed.

Триггер на возврат оплаченного заказ в LIFE POS (статус - refund)

В событии указываем “Изменение заказа”.

В условии указываем конструктор, выбираем тип условия “Статус оплаты”

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

Влияет только на кол-во запросов отправляемых на сервер, если по заказу со стороны LIFE POS не было платежа, то ответ на запрос будет с ошибкой.

“Новое значение” - указывается статус/ы возвращенной оплаты, может быть указан Ваш/и статус/ы возврата, в дефолте “Возвращен”.

В действии задаем значение параметра Статус - refund.


Коннектор

После окончания всех настроек можно переходить к подключению интеграции.

Для подключения интеграции перейдите в раздел “Настройки” - “Маркетплейс” и найдите LIFE POS.

Откройте карточку приложения и нажмите “Подключить”, далее будет открыта страница авторизации в LIFE POS. Если у вас уже есть зарегистрированная организация в LIFE POS, введите логин и пароль от личного кабинета, или пройдите регистрацию (см. Шаг 1 и Шаг 2).

После успешной авторизации в приложении откроется страница с полями для настройки интеграции:

Заполните поля:

Организация LIFE POS - поле будет выведено в том случае, если в LIFE POS зарегистрировано несколько организаций на одного пользователя. Из выпадающего списка выберите одну, для которой настраивается интеграция.

Ссылка на контур RetailCRM - можно взять в адресной строке, войдя в личный кабинет RetailCRM в формате https://my-company.retailcrm.ru/

API ключ Retail - создать можно в разделе “Настройки” - ”Интеграция” - ”Ключи доступа к API”, у ключа должны быть разрешения: "customer_read", "store_read", "reference_read", "delivery_read", "delivery_write", "user_read", "task_read", "task_write", "payments_read", "payments_write", "order_read", "order_write".

Группа пользователей для задач RetailCRM - код группы пользователей. Используется в случаях возникновения проблем с интеграцией, на сотрудников данный группы в RetailCRM коннектор будет создавать задачи с описанием возникших проблем.

Код типа оплаты наличными - код типа оплаты, для проведения оплаты через LIFE POS наличными денежными средствами. Код типа оплаты можно узнать, перейдя в Настройки - Справочники - Типы оплат.

Код типа оплаты безналичные - код типа оплаты, для проведения оплаты через LIFE POS безналичным способом. Код типа оплаты можно узнать, перейдя в Настройки - Справочники - Типы оплат.

Дефолтные коды типов оплат подтягиваются автоматически.

Указываем коды статусов оплат и заказов, если они отличаются от дефолтных. Статусы находятся в разделе Справочники - Статусы оплат. Дефолтные статусы подтягиваются в коннектор автоматически.

Код статуса проведенного платежа - статус успешной оплаты.

Код статуса возвращенного платежа - статус успешного возврата.

Код статуса оплаченного заказа - финальный статус успешно оплаченного заказа.

Мультимерчант - возможность принимать оплату с одного терминала на разные юридические лица. 
Для подключения обратитесь в LIFE PAY.

После заполнения всех полей формы сервер обработает их.

В случае успешной обработки, данные по организации сохранятся в БД коннектора и коннектор подпишется на получение обновлений со стороны организации LIFE POS.

При неудачной обработке полей формы, будет выведено информационное сообщение с ошибкой.


Пользовательские сценарии работы
Создание первой доставки и отправка данных по ней
После того, как все настройки будут завершены, для передачи данных в систему необходимо инициировать первую отправку заказа в LIFE POS.
Для этого переходим в раздел “Заказы” и создаем новый заказ.

 

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

Далее в разделе “Доставка” указываем курьера. Если в доставке нет курьера, то при передаче заказа в RetaliCRM он будет создан на дефолтного пользователя (на того, кто зарегистрировал организацию в LIFE POS). Подробнее про курьеров будет описано дальше.

После заполнения всех необходимых полей, сохраняем заказ.

После этого переводим заказ по статусам, до статуса, который указан в триггере на создание заказа в LIFE POS. 

После перевода заказа в статус, при котором происходит отправка заказа в LIFE POS, данные по торговым точкам, единицам измерения и по товарам, входящим в состав заказа будут переданы.

Посмотреть созданные торговые точки можно авторизовавшись в LIFE POSи перейдя в раздел “Структура Бизнеса” - “Торговые точки”.

Увидеть созданную продажу можно перейдя в раздел “Журналы” - “Продажи”.

В RetaliCRM при успешной передаче заказа укажется комментарий об отправке

Реализована возможность изменить магазин в уже отправленном заказе. Для этого в карточке заказа нужно выбрать магазин и сохранить изменения. 

При успешной смене магазина в комментарии оператора будет отображена информация.

Также есть возможность переназначить курьера, выполняющего заказ. Для этого нужно выбрать нового курьера в заказе в RetaliCRM и сохранить изменения.

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


Отмена заказа
Отмена отправленного в LIFE POS заказа возможна при переводе заказа в RetaliCRM в статус, указанный в триггере на отмену.

 

 

При этом, в LIFE POS заказ будет удален, в RetaliCRM отобразится комментарий об отмене заказа.

При переводе заказа снова в статус, при котором происходит создание заказа в LIFE POS, заказ будет отправлен повторно.


Создание рабочих мест и сотрудников
При указании курьера в доставке в RetailCRM, если курьер не зарегистрирован в LIFE POS, происходит создание нового рабочего места и курьера в системе.
Поиск курьера в системе LIFE POS осуществляется по номеру телефона 
При создании доставки с указанием существующего в LIFE POS курьера, создание нового сотрудника и рабочего места не происходит.

Номер телефона берется из карточки сотрудника в RetailCRM. При неверном формате номера телефона в RetailCRM сотрудник не будет создан, а заказ создастся на дефолтного пользователя. При этом заводится соответствующая задача на смену номера в RetailCRM. Формат номера, начинающийся с “8” заменяется на “+7”.

При создании нового сотрудника и рабочего места на номер телефона сотрудника отправляются СМС, содержащие данные для авторизации в ЛК, код активации приложения и пин для входа в приложение

Изменения по данным курьера в RetailCRM не передаются в LIFE POS после того, как сотрудник был создан (кроме номера телефона) При смене номера телефона в LIFE POS будет создан новый сотрудник.
При создании доставки без указания курьера, заказ передается на дефолтного сотрудника.

После того, как курьер активирует приложение по коду из СМС и выберет магазин для работы, ему будет доступна оплата заказа.


Авторизация в приложении

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

1. Откройте приложение LIFE POS и введите код-активации (8 цифр) для входа в приложение и привязки устройства к рабочему месту. Код активации приходит в смс на телефон от LIFE POS.

Активация устройства (привязка его к организации) в рамках приложения LIFE POS производится единоразово.

Если сообщение удалили, можно восстановить код активации, инструкция по ссылке.

2. Введите пин-код сотрудника (6 цифр)

Пин-код используется для идентификации сотрудника на рабочем месте т.е. на одном устройстве под своим личным пин-кодом могут работать разные сотрудники.

Если сообщение удалили, можно восстановить код активации, инструкция по ссылке.

Как восстановить ПИН код сотрудника?

В LIFE POS сотрудник может восстановить пин-код от организации, под которой у сотрудника активировано рабочее место. 
ВАЖНО -  если сотрудник добавлен в разных организациях, то восстановление пина в приложении будет невозможным, требуется восстановление пин-кода по старому процесса из Личного кабинета администратором.

Для восстановления пин-кода, сотруднику требуется:
1.  На экране ввода пин-кода сотруднику нужно нажать кнопку для восстановления

2. Клиенту нужно указать свой номер телефона

3. Если телефон корректный, клиенту придет код подтверждения операции в СМС, его нужно ввести в приложении. 

4. На номер телефона клиента придет смс с новым пин-кодом


Оплата заказа
После того, как заказ будет передан в LIFE POS, оплата по нему возможна только на стороне LIFE POS.
Важно! В LIFE POS формируется рабочее место для каждого сотрудника. Сотрудник, при активации рабочего места, привязывается к магазину и в дальнейшем не может изменить его. При формировании заказа в RetaliCRM нужно учитывать, что для курьера, назначенного в заказ, в приложении будут отображаться ТОЛЬКО заказы на выбранный при активации магазин.
Для оплаты заказа курьеру необходимо перейти в заказ, далее в оплату и выбрать тип оплаты.

 

 

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

После того, как заказ будет оплачен в LIFE POS, информация об оплате будет добавлена и в RetaliCRM. При оплате наличными в LIFE POS, в RetaliCRM будет добавлен платеж с типом, который был указан при заполнении коннектора как тип для оплаты наличными. При оплате безналичным способом, добавится платеж с типом, указанным в коннекторе как безналичный.


Возврат оплаты
Возврат оплаты возможен как в RetaliCRM, так и через LIFE POS.
Для возврата оплаты в RetaliCRM необходимо выбрать статус платежа, который прописан в триггере на отмену и сохранить изменения.
Для возврата оплаты через приложение LIFE POS необходимо перейти в “Архив”, выбрать заказ и перейти в него. Далее выбрать возврат.

 

 

После того, как возврат будет произведен в приложении, в RetaliCRM платеж по заказу будет переведен в статус из триггера, в комментарии к платежу будет указан возврат, а в комментарии оператора будет прописано, что возврат был сделан из приложения.

 

 

При возврате через LIFE POS поддерживается только полный возврат денежных средств.

Для возврата оплаты через RetailCRM необходимо у соответствующего платежа изменить статус на тот, который указан в триггере на возврат.

 

 

После этого возврат будет произведен в LIFE POS, в комментарии оператора будет указана информация по возврату.


Каталог товаров и услуг в LIFE POS формируется на основе товаров в RetailCRM
При отправке доставки каталог дополняется товарами из доставки если их нет в LIFE POS. При наличии соответствующих товаров в каталоге LIFE POS, новые товары не создаются, а используются уже созданные
При формировании новой позиции в LIFE POS указываются ее наименование, цена, описание, единица измерения, и НДС.
Поле “наименование” ограничено в RetailCRM 255 символами, но в LIFE POS максимальная длина 128 символов. В случае, если в RetailCRM заведен товар, который не проходит валидацию, при формировании доставки, наименование обрезается до допустимого значения.. При передаче поддерживаются латиница, кириллица и спец.символы
Цена товара передается единственный раз при создании товара и указывается исходя из цены товара в заказе RetailCRM без учета скидок.
НДС равен НДС товара в RetailCRM? НДС 18% будет заменен на 20%
При любом изменении в товаре в RetailCRM после его создания в LIFE POS, изменения не будут перенесены.
В случае, если у доставки есть цена в RetailCRM, в LIFE POS будет создан товар для передачи суммы доставки. Наименование такого товара - “Услуга доставки”, цена - не указывается, единица измерения - по умолчанию, НДС не облагается.