- Плагин Intro
- Как установить коннектор?
- Какие первичные настройки нужно осуществить в самой IIKO для работы коннектора?
- Какие добавить сотрудника и какие права ему выдать?
- Как завести способы расчета в IIKO для работы с LIFE POS?
- Как настроить конфигурационный файл плагина IIKO?
- Как подключить аккаунт LIFE POS к плагину
- Передача заказов на доставку из IIKO в LIFE POS
- Что передает плагин IIKO в систему LIFE POS?
- Как осуществить возврат?
- Особенности отображения суммы заказа Life Pos и в IikoFront
- Возможные ошибки
До начала настройки интеграции нужно чтобы у вас была пройдена авторизация в системе IIKO офис и имелись доступы во все системы IIKO
Установите на ваше устройство IIKO офис и IIKO фронт. Как это сделать можно узнать у поддержки IIKO.
Бэк офис (Iiko Office) - это админка, куда заносят все справочники, сотрудников, управляют стоком и т.д.
Фронт офис (Iiko Front) - это интерфейс кассира, повара, курьера, официанта, это пространство, где сотрудник делает каждый день привычную работу.
Интеграция с LIFE POS происходит с фронт офисом, потому что именно он генерирует заказы, т.е конкретный менеджер ресторана направляет заказ определённому курьеру в LIFE POS.
Плагин предназначен для интеграции IIKO и LIFE POS c отправкой данных о продажах, выполненных с помощью терминала под управлением LIFE POS, AlfaCASH и ВТБ Касса.
Интеграция позволяет:
- Назначать заказы из iiko в LIFE POS, синхронизирует статус оплаты между системами.
- Добавлять сотрудников, рабочие места и торговые точки из iiko в life pos.
ВАЖНО! Перед настройкой интеграции не создавайте самостоятельно что-либо в личном кабинете LIFE POS. Если же что-то установили самостоятельно, удалите. - Автоматически закрывать заказы в iiko, если в LIFE POS осуществлена оплата.
- Отражать в iiko выручку по способам расчета, которые были выбраны при оплате через LIFE POS
Установка плагина происходит в папку iikoFront.
Путь: Program Files\\iiko\\iikoRMS\\[Front.Net]()\\Plugins
После запуска iikoFront происходит формирование файла логов по пути: C:\\Users\\username\\AppData\\Roaming\\iiko\\CashServer\\Logs\\plugin-Get.Front.LifePos.log
Скачать плагин можно по ссылке https://download.ru/files/ZDL5nEnC
Его нужно разархивировать. Вот пример, как это сделать через winrar:
В истории скачиваний в браузере нажмите лкм на загруженный файл. Архиватор откроется автоматически. Если у вас нет архиватора, установите самостоятельно (желательно winrar).
После открытия файла в архиваторе, нажмите на "Извлечь"
Выберите любую папку для извлечения. Желательно заранее создать пустую и туда извлечь плагин.
После разархивирования плагина нажмите правую кнопку мышки на IIKO Front, далее на "Расположение файла"
Найдите папку "Plagins" и откройте её
Теперь нужно ранее разархивированный плагин перенести в Plagins
На скриншоте ниже можно посмотреть как в итоге должен выглядеть перенесённый плагин и по какому пути он будет расположен
Какие первичные настройки нужно осуществить в самой IIKO Office для работы коннектора?
Для работы коннектора необходимо добавить информацию в IIKO Office.
Зайдите в раздел "Администрирование" -> "Настройки торгового предприятия"
Заполните следующие поля. Вся информация должна быть полностью идентична той, что в личном кабинете LIFE POS в разделе "Структура бизнеса" - "Юридические лица"
Название - это ваше юр лицо.
Юридический адрес
Фактический адрес
Для корректной передачи заказов из IIKO Front в систему LIFE POS нужно зайти в раздел "Доставка" -> "Общие"
Проставьте следующие настройки:
Печать накладной доставки - при отправке заказа
Проводить оплату - при закрытии доставки
Проводить внешние платежи при добавлении
Настройки выше подходят только для тех случаев, когда оплата производится в приложении LIFE POS/AlfaCASH/ВТБ Касса.
Если же вам нужно принимать и в самом IIKO оплату, и в нашем приложении, то нужны такие настройки:
Печать накладной доставки - при оплате заказа
Проводить оплату - при отправке доставки
Проводить внешние платежи при добавлении - убрать галочку
Чтобы сохранить настройки, справа внизу нажмите на кнопку "Сохранить и закрыть"
Какие добавить сотрудника и какие права ему выдать?
Важно добавить сотрудника, на устройство которого будут падать заказы в систему LIFE POS.
Нельзя добавить сотрудника, который уже заведён как владелец в личном кабинете LIFE POS.
Перейдите в раздел "Сотрудники" -> "Cписок сотрудников". Нажмите на кнопку "Добавить"
Появляется карточка для заполнения данных сотрудников. Нужно заполнить следующие пункты:
Имя в системе - укажите ФИО сотрудника
Телефон и моб телефон - укажите телефон сотрудника, строго начиная с 7 и без скобок.
Если не стоит галочка в пункте "Сотрудник" - поставьте.
Далее перейдите в подраздел "Дополнительные сведения"
Сгенерируйте ПИН-код (он нужен для входа в iiko front)
И любой пароль. Повторите этот же пароль в строке ниже.
Пароль внешнего API - нажмите обновить.
После применения изменений нажмите справа внизу кнопку "Сохранить"
Также на экране редактирования сотрудника нужно задать права для работы сотрудника, чтобы он мог доставлять заказы.
Нажмите слева внизу в окошке на "Редактировать права"
Справа внизу в пустом поле введите "Быть курьером"
Появляется результат поиска "Быть курьером для доставки", нажмите на него.
Произойдёт автоматический перевод на таблицу. На эту ячейку нажмите пкм и выберите "Разрешено"
Далее перейдите в раздел "Сотрудники" -> "Должности". Нажмите на "Добавить" и создайте должность с наименование Курьер, краткое наименование D_DCO, сохраните.
Вернитесь в персональную карточку сотрудника. В поле "Должность" выберите по умолчанию "Курьер", нажмите справа внизу сохранить.
Как завести способы оплаты в IIKO для работы с LIFE POS?
Перейдите в раздел "Розничные продажи" -> "Типы оплат"
У вас будут созданы всего 2 способа оплаты. Их нужно перенастроить.
Нажмите 2 раза лкм на безналичную оплату и проведите настройки как на скриншоте ниже.
Нажмите сохранить.
Далее нажмите 2 раза лкм на наличную оплату. Также измените данные, чтобы они соответствовали скриншоту ниже. Не забудьте сохранить.
После изменения существующих способов оплаты нужно добавить два дополнительных. Нажмите на кнопку "Добавить"
Добавьте 2 новых способа оплаты как на скриншотах ниже:
1. Нефискальный безналичный способ оплаты
2. Нефискальный наличный способ оплаты
Как настроить конфигурационный файл плагина IIKO?
После настройки способов оплаты зайдите в приложение IIKO Front. Авторизуйтесь в нём, а потом полностью закройте приложение.
Нажмите пкм на IIKO Front -> Расположение файла
Зайдите в папку PlaginsДалее Get.Front.LifePosPlugin
Нажмите пкм на Get.Front.LifePos.dll.config -> открыть с помощью -> блокнот
У вас появится код плагина в формате блокнота
Найдите строку ServerAdress. Под между словами<value>напишите https://api.life-pos.ru как на скриншоте.
Далее строка OrganizationId. В пунктах <value> нужно вставить ID вашей организации. Его можно взять, скопировав из браузера на сайте LIFE POS в адресной строке как на скрине ниже.
Строка PaidOrdersCheckTimeout (не обязательно) отвечает за таймаут в секундах через который будет проверяться статус уже отправленных в LIFE POS заказов. Рекомендуется не устанавливать ниже 15.
Строка LegalEntityId. В пунктах <value> нужно вставить id юридического лица в системе LIFE POS. Егоможно взять скопировав из браузера, в левом меню выберите Структура бизнеса - Юридические лица.
Строка PayExtraInCash (не обязательно). В какой платеж будет добавлена разница сумм при раздельной оплате. True - в тип оплаты Наличными False - в безналичный тип оплаты (по умолчанию)
Зайдите на рабочий стол вашего устройства в папку "Этот компьютер" и нажмите на диск, куда вы установили IIKO Front и IIKO Office (диск С или же D)
В поисковой строке введите %Appdata%, нажмите Enter
Зайдите в папку iiko
Далее CashServer
Откройте файл plugin-Get.Front.LifePosPlugin с помощью блокнота
У вас открылись логи IIKO Front. Нажмите сочетание клавиш Ctrl + F, в строке введите Нал > направление "Вниз" > "Найти далее"
У вас отобразятся ранее созданные способы оплаты LifePosNonFiscal, LifePosFiscal, Наличные, NНаличные
У определённого типа оплаты свой ID. Каждый ID нужно скопировать и вставить в конфигурационный плагин (где вы ранее редактировали строки между <value>), т.е. вам нужно нажать пкм на программу IIKO Front ->Расположение файла -> Plagins -> Get.Front.LifePosPlugin -> открыть с помощью блокнота
FiscalCardPaymentTypeId - фискальная оплата по карте
NonFiscalCardPaymentTypeId - нефискальная оплата по карте
FiscalCashPaymentTypeId - фискальная оплата наличными
NonFiscalCashPaymentTypeId - нефискальная оплата наличными
Как подключить аккаунт LIFE POS к плагину
Запустите IIKO Front.
Справа внизу нажмите на "Дополнения", далее "LifePOS Настройка:". Введите логин (без +, начиная с 7) и пароль от личного кабинета Life Pos.
После ввода данных авторизации, номера телефона и пароля перезайдите в IIKO Front для сохранения настроек.
ВАЖНО! авторизация происходит только с логином по номеру телефона! Далее они сохраняются в кэш который находится по пути: \AppData\Roaming\iiko\CashServer\EntitiesStorage\Plugins\Get.Front.LifePos в файле AutorizationData.json
Если по каким либо причинам необходимо изменить логин или пароль, проделайте вышеописанные шаги, тогда перед отображением окна для ввода данных авторизации плагин выведет информацию о перезаписи данных, нажмите "да", если вам действительно необходимо обновить данные.
Передача заказов на доставку из IIKO в LIFE POS
В интерфейсе IIKO Front нужно перейти в раздел Доставка.
В нижнем угле пользователь должен создать заказ на Доставку.
Пользователю необходимо оформить карточку заказа:
- Указать получателя заказа
- Назначить курьера на доставку
- Указать позиции в заказе
- Указать адрес доставки
Заказ в статусе ОТПРАВИТЬ направляется в систему LIFE POS.
После нажатия на экране IIKO отобразится нотификация об успешной отправке заказа
При успешной отправке заказа в левом верхнем углу появится информационное pop-up сообщение со следующим текстом: “Доставка номер {deliveryOrder.Number} успешно отправлена в LIFE POS”.
В противном случае сообщение об ошибке: "Не удалось отправить доставку {deliveryOrder.Number} в систему LIFE POS, пожалуйста, обратитесь в службу технической поддержки!”, а так же сообщение об ошибке будет выведено в лог плагина.
Далее данный заказ будет добавлен в кэш очереди на проверку его статуса в системе LIFE POS (ВАЖНО! При удалении заказа или его закрытии, а так же закрытии кассовой смены, заказы удаляются из кэша.
Если заказ не был оплачен в LIfe Pos, а в iikoFront его удалили или закрыли, то он будет удален из списка открытых продаж в приложении).
При смене курьера у уже отправленного заказа, курьер будет заменен в Life Pos.
Если замещающий курьер не зарегистрирован в системе и его номер в iikoOffice невалиден, заказ будет удален из приложения.
Если замещающий курьер не зарегистрирован в системе, но имеет валидный номер, ему буден отправлено сообщение с кодом активации приложения, а в заказе изменится курьер.
Если замещающий курьер зарегистрирован в системе и имеет валидный номер, в заказе изменится курьер
Статус заказа проверяется относительно таймаута заданного в конфигурационном файле плагина(см. настройка конфигурации).
После того как заказ перейдет в LIFE POS в один из следующих статусов “Paid” или “Closed”, на фронте доставка будет оплачена типами оплаты настроенными в конфигурационном файле плагина.
Допустимо закрытие на наличные, банковские карты или комбинацию этих типов оплат. Суммы для оплаты платежа плагин получает от api LIFE POS.
Статус “Paid” заказ оплачен курьеру но не зафискализирован системой LIFE POS, плагин добавит проведенные ФИСКАЛЬНЫЕ платежи в заказ исходя из настроек типов оплат в конфиге.
Статус “Closed” заказ оплачен курьеру и зафискализирован системой LIFE POS, плагин добавит проведенные НЕФИСКАЛЬНЫЕ платежи в заказ.
ВАЖНО! Работа с предоплатами не предусмотрена и не поддерживается.
Что передает плагин IIKO в систему LIFE POS?
Данные о торговой точке, доставке, номер доставки, когда была отправлена.
Данные для торговой точки
- Торговая точка - если ранее торговой точки на которой установлен плагин не было в LIFE POS, она будет создана плагином, при создании за основу берется информация из настроек группы и торгового предприятия:
- Имя: имя группы на которой установлен плагин
- Юр. лицо: id указанный в конфиге плагина
ФИО
Номер телефона(ВАЖНО! У курьера должно быть заполнено поле мобильный телефон в карточке сотрудника, и номер должен быть актуальным!), так как в случае, если ранее данного курьера не было в системе LIFE POS он будет создан, на номер телефона придет смс сообщение с кодом активации мобильного приложения и пин-кодом для входа в него.
Если ранее у курьера не было привязки к рабочему месту(логическая связка курьера и платежного терминала) или курьера не было в системе LIFE POS, рабочее место будет создано плагином.
Данные номенклатур
ВАЖНО! Модификаторы не передаются, отправляется только позиция и итоговая сумма в которую включена стоимость всех модификаторов добавленных к ней!), название, описание, ставка ндс, предмет расчета из карточки блюда.
Следующие справочники будут созданы в LIFE POS, если ранее данных по ним не было в базе: категория товара, единица измерения.
Если ранее справочники были добавлены, будут использоваться id уже существующих объектов в системе.
По закрытому заказу можно сделать возврат только из архива самого приложения, из Iiko не работает возврат.
Зайдите в архив продаж, нажмите на нужную операцию, внизу кнопка "Возврат"
Особенности отображения суммы заказа LIFE POS и в iikoFront
Важно! Сумма заказа в LIFE POS может отличаться от суммы заказа в iikoFront:
Из-за округлений при передаче заказа может возникнуть ситуация, когда сумма заказа к оплате в Life Pos незначительно отличается от суммы в iikoFront. При оплате такого заказа через Life Pos, на iikoFront он будет закрыт с той суммой, которая указана в iikoFront, разница сумм не будет учитываться при закрытии заказа.
💡 Если происходит раздельная оплата по заказу, сумма которого не сходится с суммой в iikoFront, разница сумм будет добавлена в тот тип платежа, который выбран в конфигурационном файле плагина.
Возможные ошибки
При отправке заказала в Life Pos будет появляться всего одно описание ошибки:
Ошибка при отправке заказа в Life Pos, обратитесь в службу технической поддержки!
Возможные причины:
1. Проверьте, правильно ли введены данные от личного кабинета Life Pos в системе Iiko Front
2. Проверьте, чтобы курьер, на телефон которого вы создаёте заказ, не был заранее создан вручную в Life Pos. Плагин сам должен создать курьера, если он не был создан ранее. Удалите сотрудника в Life Pos, если же создали его самостоятельно.
3. Изначально созданная торговая точка не должна быть как-либо изменена либо удалена. Заказы отправляются только на ту точку, которую создал Iiko. Если же вы удалили торговую точку в личном кабинете Life Pos, для восстановления обратитесь в службу поддержки
Если вы всё проверили, но ошибка не решилась, то можно посмотреть логи (детализацию) самой ошибки и её описание. Чтобы это сделать:
Зайдите в папку "Компьютер", далее в диск где установлен плагин Iiko. В поисковой строке введите %Appdata%. Провалитесь в папку Iiko -> CashServer -> Logs -> plugin-Get.Front.LifePosPlugin.
Пролистайте в самый низ, найдите нужное вам время, когда была воспроизведена ошибка. Ниже пример ошибки когда были неправильно введены авторизационные данные в Iiko Front
Исходя из описания ошибки можно понять в чём проблема. Если не удалось решить проблему самостоятельно, обратитесь в службу поддержки.