- Плагин Intro
- Как установить коннектор?
- Какие первичные настройки нужно осуществить в самой IIKO для работы коннектора?
- Что такое Бэк офис? Что такое Фронт офис?
- Какие добавить сотрудника и какие права ему выдать?
- Как завести способы расчета в IIKO для работы с LIFE POS?
- Как настроить конфигурационный файл плагина IIKO?
- Как подключить аккаунт LIFE POS к плагину
- Передача заказов на доставку из IIKO в LIFE POS
- Что передает плагин IIKO в систему LIFE POS?
- Как осуществить возврат?
- Особенности отображения суммы заказа LIFE POS и в iikoFront
Инструкция описывает процесс подключения и первичной настройки IIKO к LIFE POS
Плагин предназначен для интеграции IIKO и LIFE POS c отправкой данных о продажах, выполненных с помощью терминала под управлением LIFE POS, AlfaCASH и ВТБ Касса.
Интеграция позволяет:
- Назначает заказы из iiko в LIFE POS, синхронизирует статус оплаты между системами.
- Добавляет сотрудников, рабочие места и торговые точки из iiko в 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
На скриншоте ниже можно посмотреть директория куда нужно разместить плагин на компьютере:
Какие первичные настройки нужно осуществить в самой IIKO для работы коннектора?
в самой IIKO для работы коннектора?
Для работы коннектора необходимо убедиться, что в IIKO корректно добавлены следующие сущности:
1. Торговое предприятие содержит фактический адрес.
2. Сотрудники имеют доступ к доставке заказов и у сотрудников в карточке указан номер телефона.
3. Заведены или подключены к плагину способы расчеты в системе IIKO.
4. Настроить конфигурационный файл плагина IIKO
Как должна быть заполнена карточка торгового предприятия?
В карточке настроек должны быть заполнены:
- Название:
- Юридический адрес:
- Фактический адрес.
Что такое Бэк офис? Что такое Фронт офис?
Бэк офис - это админка, куда заносят все справочники, сотрудников, управляют стоком и т.д.
Фронт офис - это интерфейс кассира, повара, курьера, официанта, это интерфейс где сотрудник делает каждый день привычную работу.
Интеграция с LIFE POS происходит с Фронт офисом, потому что именно он генерирует заказы, т.е конкретный менеджер ресторана направляет заказ курьеру в LIFE POS.
Какие добавить сотрудника и какие права ему выдать?
Корректная карточка сотрудника IIKO содержит следующие данные: ФИО, телефон, дата рождения и опционально e-mail. Галочки для настроек заполнять необязательно.
На вкладке Дополнительные сведения укажите пин-код для входа IIKO сотруднику.
Как заполнять:
1. Телефон: 8/7 и номер без скобок
2. ФИО: без ограничений
3. ПИН: без ограничений, используется для входа сотрудником в iiko
Также на экране редактирования сотрудника нужно задать права для работы сотрудника, чтобы он мог доставлять Заказы.
Нажмите Редактировать права.
И укажите права для доставки заказов:
- Отправлять внешний заказы (опц)
- Осуществлять отгрузку заказов (опц)
- Отменять доставки (опц)
- Быть курьером на доставке (*)
Как завести способы расчета в IIKO для работы с LIFE POS?
Для заполнения полей конфигурационного файла: FiscalCardPaymentTypeId, NonFiscalCardPaymentTypeId, FiscalCashPaymentTypeId, NonFiscalCashPaymentTypeId необходимо запустить iikoFront с плагином, после запуска в файле логов по пути C:\Users\topto\AppData\Roaming\iiko\CashServer\Logs\plugin-Get.Front.LifePos.log
отобразятся все доступные типы оплат с их гуидами.
Скопируйте способы оплаты в конфигурационный файл и сохраните его.
После редактирования файла конфигурации необходимо перезапустить iikoFront.
Как настроить конфигурационный файл плагина IIKO?
Все настройки производятся в файле Get.Front.LifePos.dll.config, который находится в папке с исполняемым файлов плагина, стандартно: Program Files\\iiko\\iikoRMS\\[Front.Net]()\\Plugins\\Get.Front.LifePos
- ServerAdress
Контур для разработчиков: https://api-dev.life-pos.ru , в 99% случаях его использовать не нужно, https://api.life-pos.ru продуктовая среда, адрес, который нужно использовать при интеграциях.
- OrganizationId
Id организации в системе LIFE POS. Гуид, можно взять скопировав из браузера, доступен практически на любой странице личного кабинета
- PaidOrdersCheckTimeout
- LegalEntityId
- fiscalCardPaymentType
Фискальный тип оплаты картой, который будет использоваться для добавления в успешно оплаченный заказ.
- NonFiscalCardPaymentTypeI
Нефискальный тип оплаты картой, который будет использоваться для добавления в успешно оплаченный заказ.
- FiscalCashPaymentTypeId
- NonFiscalCashPaymentTypeId
- PayExtraInCash
В какой платеж будет добавлена разница сумм при раздельной оплате. True - в тип оплаты Наличными False - в безналичный тип оплаты (по умолчанию)
Как подключить аккаунт LIFE POS к плагину
Запустите IIKO FRONT.
При первом запуске плагин попросит указать логин - телефон и пароль от аккаунта LIFE POS. Заполните данные как на скрине ниже
После ввода данных авторизации, номера телефона и пароля.
ВАЖНО! авторизация происходит только с логином по номеру телефона!) далее они сохраняются в кэш который находится по пути: \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 FRONT.
Если заказ был оплачен через LIFE POS, информация о возврате также будет передана в LIFE POS.
В iikoFront отобразится сообщение об успешном/не успешном возврате.
Если запрос не был успешно отправлен, необходимо сделать возврат вручную в архиве операций в приложении.
Особенности отображения суммы заказа LIFE POS и в iikoFront
Важно! Сумма заказа в LIFE POS может отличаться от суммы заказа в iikoFront:
Из-за округлений при передаче заказа может возникнуть ситуация, когда сумма заказа к оплате в Life Pos незначительно отличается от суммы в iikoFront. При оплате такого заказа через Life Pos, на iikoFront он будет закрыт с той суммой, которая указана в iikoFront, разница сумм не будет учитываться при закрытии заказа.
💡 Если происходит раздельная оплата по заказу, сумма которого не сходится с суммой в iikoFront, разница сумм будет добавлена в тот тип платежа, который выбран в конфигурационном файле плагина.