RetailCRM

Последние изменения: 28.07.2021

Целью данной интеграции является фискализация оплат, данные о которых пользователь добавляет в карточку заказа. Фактический функционал приема оплат остается на стороне клиента. Интеграции с LIFE PAY или LIFE POS нет.

Возможные сценарии которые поддерживает интеграция: 

  1. У одного ЮЛ/ИП один личный кабинет (домен) в RetailCRM

  2. У одного ЮЛ/ИП два и более личных кабинета (домена) в RetailCRM

  3. У двух и более ЮЛ/ИП один личный кабинет (домен) в RetailCRM

У каждого ИП/ЮЛ должен быть свой лк LIFE PAY (лицензия на ОФ), также свой api ключ в RetailCRM. Каждый магазин в RetailCRM привязан к одному ЮЛ/ИП.

Для подключения интеграции необходимо:

1. Создать APIkey в RetailCRM


2. Настроить триггер в RetailCRM (Пошаговое описание ниже)


3. Настроить параметры фискализации в лк LIFE PAY в разделе "Интеграция"- RetailCRM (Пошаговое описание ниже).

ВАЖНО!

  • В карточке заказа поле телефон и email не обязательные, если данные не указали, то электронный чек не будет отправлен покупателю.

  • Если продавец не указал код маркировки, данные не будут переданы, заглушки при отсутствии данных нет.

  • Если в одном лк RetailCRM работают несколько ЮЛ/ИП - нельзя менять магазин оформления заказа после оплаты (если магазины привязаны к разным ЮЛ/ИП). Чек предоплаты уйдет на одно ЮЛ/ИП, а полного расчета на другое ЮЛ/ИП.

  • Если была создана предоплата до подключения интеграции, но заказ не закрыт, то при подключении интеграции и добавлении оплаты или переводе заказа в выбранный статус для чека полного расчета - все зафискализируется (при соблюдении настроек).

  • Если необходимо в RetailCRM создать дополнительный тип оплаты кэш, то наименование в символьном обозначении обязательно должно начинаться с cash-и тд (например, Cash-courier).

  • Данные о кассире настраиваются на стороне LIFE PAY.


Настройка параметров в личном кабинете RetailCRM

  1. Зайдите в раздел Настройки - Интеграция - Ключи доступа к API и создайте новый ключ доступа к API. В дальнейшем его потребуется указать в личном кабинете LIFE PAY.


Если у вас несколько ЮЛ/ИП в одном лк RetailCRM (с одним доменом), необходимо указать, какому из магазинов принадлежит данный API ключ. В ином случае выберите все магазины.


Разрешены все методы API


2. В разделе Коммуникации - Триггеры создайте новый триггер.


Настройка параметров триггера:

Название - Изменение заказа

Символьный код - izmenenie-zakaza

Условие применения триггера - changeSet.hasChangedField("status") or changeSet.hasChangedField("payments") or changeSet.hasChangedField("payments.status")

Действие - Выполнить HTTP-запрос

Действие/адрес - https://api.life-pay.ru/retailcrm/notification

Действие/HTTP метод - GET

Действие/Передавать параметры - В строке запроса

Действие/Параметры

  • order_id = {{ order.getId() }}

  • domain = домен вашей crm системы (пример: your_company.retailcrm.ru)

  • event = order_updated





Сохраните настройки.


Настройка параметров в личном кабинете LIFE PAY

3. Зайдите в раздел Интеграция - RetailCRM и подключите интеграцию (с подробной инструкцией также можно ознакомиться в разделе "Документация" на рис. ниже)


В окне настроек укажите:

API ключ RetailCRM

Домен RetailCRM (адрес клиента в учетной системе RetailCRM) Если у вас несколько доменов в RetailCRM, то после настройки интеграции вернитесь к началу.

Далее настройки будут относиться к тому ЮЛ/ИП, к чьей настройке вы приступили в первую очередь.


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


Сохраненные настройки:

Каждую настройку возможно редактировать, удалить и открыть заказы из RetailCRM





Дополнение:

  • При регистрации RetailCRM отправляет ссылку для входа в лк, логин и пароль на указанный пользователем email.

  • При корректной фискализации в раздел оплаты заказа будет выгружена ссылка на чек или uuid чека.


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



Помогла ли вам статья?