Интеграция Эвотор и RetailCRM

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

1. Войдите под своей учетной записью в RetailCRM с правами администратора.

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

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

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

5. Отметьте магазин из списка, с которым будет работать модуль.

6. Отметьте методы из списка Разрешенные методы API. (Нужные методы указаны в Приложении 1).

7. Скопируйте ключ, он понадобится в следующем пункте настроек.

8. Нажмите «Сохранить».

1. Перейдите в Настройки/Интеграции/Маркетплейс.

2. Выберите модуль Терминал Эвотор.

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

4. Вставьте скопированный ранее Api-ключ.

5. Вставьте ссылку на RetailCRM.

6. Скопируйте идентификатор клиента, находящийся в верхней части модуля.

1. Активируйте приложение на маркетплейсе Эвотор. Для этого необходимо зайти в Ваш личный кабинет Эвотор, перейти по данной прямой ссылке: https://clck.ru/3QVUj3. Открыть приложение «Заказы из RetailCRM»(кликабельное поле).

В разделе «настройки» нужно ввести идентификатор клиента, который был скопирован в шаге 2.4. Далее необходимо установить приложение на терминалы, на которых будет использоваться оплата заказов из RetailCRM.

2. Заполнение настроек модуля со стороны RetailCRM. Во вкладке «Магазины» настраивается соответствие терминалов Эвотор и магазинов RetailCRM.

Магазины RetailCRM — какие магазины RetailCRM сопоставлены с терминалом Эвотор. Заказы этих магазинов будут доступны на терминале.

Признак агента по предмету расчёта — Перечень возможных к передаче признаков агента.

Тип маркируемого продукта — Обязателен, если планируется продавать маркированный товар. В каталоге, который привязан к соответствующему магазину Retail должно быть свойство «mark», а сама маркировка в товаре заказа RetailCRM при его передаче в Эвотор.

3. Создание типа оплаты в RetailCRM для оплаты через терминал Эвотора. Тип оплаты создаётся в разделе «Настройки» → «Справочники» → «Типы оплат» → «Добавить». На терминале будут отображаться только заказы с данным типом оплаты и доступны к оплате только те, у которых статус оплаты «не оплачено».

Также можно не создавать новые типы оплаты, а использовать уже имеющиеся.

Если активировать галочку «по умолчанию в системе», то всем заказам в RetailCRM будет присваиваться данный тип оплаты.

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

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

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

4. Сопоставление типа оплаты и статусов оплаты.

Тип оплаты в RetailCRM — выставляем с каким типом оплаты будет синхронизироваться.

Статус оплачен — выставляем статус ,который будет передаваться после оплаты заказа.

Статус к оплате — выставляем статус, который будет передаваться при ожидании оплаты.

Статус товара в заказе, удаленного через терминал Эвотор.

Статус товара после продажи через терминал Эвотор.

После внесения данных настроек можно пользоваться оплатой через терминал(-ы).

Необходимые методы API RetailCRM для работы модуля

Достаточно в заказе RetailCRM создать только 1 тип оплаты Эвотор. При оплате частями, фактические суммы оплат необходимо ввести на терминале.

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

Отредактировать состав заказа можно прямо на терминале:

1. 1. Увеличение/уменьшение количества. Теперь можно открыть заказ, нажать на цифру количества и прописать новое значение, затем нажимаем на галочку. Вся информация передаётся в ритейл, а в комментарии указывается какие именно были изменения.

1. 1. Удаление позиций в заказе. Чтобы удалить товар из заказа достаточно провести в бок, но стоит учесть, что можно удалять позиции с количеством 1, а если количество больше, то сначала меняем его, а потом удаляем. Информация о отмененных товарах будет передаваться в ритейл и иметь статус «Возврат».

Действия на терминале

Действия в RetailCRM

Модуль умеет автоматически переносить в RetailCRM возвраты, пробитые на терминале. Функция включается на вкладке «Основные настройки».

• Забирать возвраты из Эвотор — модуль каждые 15 минут проверяет терминалы и переносит новые возвраты в исходный заказ RetailCRM. Возвращённый товар помечается статусом со вкладки «Статусы». При частичном возврате строка заказа делится: у исходной позиции количество уменьшается, а на возвращённое количество добавляется отдельная строка с этим статусом.
• Оформлять возврат по оплате заказа — дополнительно отражает возврат на оплате заказа. Возвращённая сумма получает статус возврата со вкладки «Статусы»: при полном совпадении статус ставится на сам платёж, при частичном возврате платёж делится — оплаченный остаток сохраняется, а на возвращённую сумму создаётся отдельный платёж со статусом возврата. Возврат оформляется только по оплатам интеграционных типов (из списка на вкладке «Оплаты»); если подходящей оплаты в заказе нет, товарная часть всё равно переносится, а оплата не трогается.

Чтобы возвраты переносились, на вкладке «Статусы» должны быть выбраны «Статус товара, возвращённого через терминал Эвотор» и «Статус платежа при возврате через терминал Эвотор». Без первого не переносится товарная часть, без второго — не оформляется возврат по оплате.

Что означает каждая настройка модуля

Вкладка «Основные настройки»

• Ссылка на RetailCRM и API-ключ — доступ модуля к вашему аккаунту. Ключу нужны права на чтение и запись заказов, чтение справочников и запись интеграции.
• Идентификатор клиента — код, который вводится в приложении на терминале Эвотор, чтобы он связался с вашим аккаунтом.
• Отправлять свойства товаров в названии — к названию товара на терминале добавляются его свойства из каталога.
• Забирать возвраты из Эвотор — включает автоматический перенос возвратов, оформленных на терминале, в заказ RetailCRM.
• Оформлять возврат по оплате заказа — дополнительно отражает возврат на оплате заказа. Без этой опции помечается только товар.
• Прикладывать чек к заказу в виде PDF — необязательная функция. После чека на терминале к заказу прикладывается PDF с составом покупки, суммами, способом оплаты и фискальными реквизитами. Требует у API-ключа право file_write: если оно не выдано, настройка недоступна, о чём написано прямо в блоке прав ключа. Вид документа отличается от бумажного чека — он формируется модулем и юридической силы фискального документа не имеет.

Вкладка «Магазины»

• Магазин RetailCRM — к какому магазину привязан терминал. Заказы этого магазина будут доступны на терминале. К одному магазину можно привязать несколько терминалов.
• Тип маркируемого продукта — вид маркировки, который передаётся на кассу для товаров со свойством «mark».

Вкладка «Оплаты»

• Типы оплат, отображаемых в терминале заказов — заказы с этими типами оплаты попадают на терминал. По ним же модуль понимает, какие оплаты в заказе принадлежат интеграции — в том числе при возврате.
• Тип платежа после оплаты — в какой тип оплаты RetailCRM превращается оплата на терминале: отдельно для карты, наличных и остальных способов.

Вкладка «Статусы»

• Статус оплаченного платежа — какой статус получает оплата после успешной оплаты на терминале.
• Статус платежа к оплате — статус оплаты, ожидающей оплаты на терминале.
• Статус товара после продажи через терминал — статус позиции заказа после продажи.
• Статус товара заказа, удалённого через терминал — статус позиции, которую убрали из заказа на терминале.
• Статус товара, возвращённого через терминал — статус, которым помечается возвращённый товар. Без него товарная часть возврата не переносится.
• Статус платежа при возврате — статус, который получает возвращённая сумма. Без него возврат по оплате не оформляется.