¶ Параметры
Все настройки расположены в файле «Config.xml» в папке с MobileService. Откройте файл и заполните все необходимые поля. Некоторые из них используются для BarsPay, но не используются для EPay
¶ Настройка службы
Config.xml - основной файл конфигурации службы
<Config xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Connection>Server=localhost;Database=baseName;User ID=sa;Password=12345</Connection>
<Port>8881</Port>
<CashID>297</CashID>
<AdditionalCashIds>248, 1839</AdditionalCashIds>
<DefaultCardMediaId>92296</DefaultCardMediaId>
<FrontierCardMediaId>113788</FrontierCardMediaId>
<DatabaseUpdateTime>1</DatabaseUpdateTime>
<!-- Настройки для оплат через BarsPay -->
<EnableCardSupportForSbp>true</EnableCardSupportForSbp>
<EnableCardFallbackForSbp>true</EnableCardFallbackForSbp>
<PaymentServiceAcquiringId>6</PaymentServiceAcquiringId>
<PaymentServiceSBPAcquiringId>7</PaymentServiceSBPAcquiringId>
<GetAcquirersUrl>http://expo-on-line.ru:5125/api/acquirings</GetAcquirersUrl>
<CreatePaymentUrl>http://expo-on-line.ru:5125/api/payments</CreatePaymentUrl>
<RegisterPaymentUrl>http://expo-on-line.ru:5125/api/payments/{id}/register</RegisterPaymentUrl>
<CheckPaymentUrl>http://expo-on-line.ru:5125/api/payments/{id}</CheckPaymentUrl>
<PaymentReturnUrl>http://192.168.0.1:8881/Api/orderStatus</PaymentReturnUrl>
<!-- Настройки автопроверки заказов -->
<!-- Время, в течение которого сервис проверяет неоплаченные заказы на предмет оплаты -->
<!-- Проверка происходит в момент запроса истории заказов пользователем -->
<!-- Если заказ старее указанного количества часов, то он считается ошибочным и игнорируется. 0 - функционал отключен -->
<HighPriorityMaxOrderAgeInHoursToCheck>2</HighPriorityMaxOrderAgeInHoursToCheck>
<HighPriorityAutoCheckOrdersIntervalInSecs>30</HighPriorityAutoCheckOrdersIntervalInSecs>
<LowPriorityMaxOrderAgeInHoursToCheck>24</LowPriorityMaxOrderAgeInHoursToCheck>
<LowPriorityAutoCheckOrdersIntervalInSecs>600</LowPriorityAutoCheckOrdersIntervalInSecs>
<!-- Настройки привязки аккаунтов -->
<DisableCreateNewAccounts>false</DisableCreateNewAccounts>
<CreatePairingRecordInFrontierUri>http://expo-on-line.ru:5123/api/BarsInteraction/PairUser</CreatePairingRecordInFrontierUri>
<RemovePairingRecordInFrontierUri>http://localhost:5008/api/BarsInteraction/RemovePairUser</RemovePairingRecordInFrontierUri>
<GetPairingRecordStatusInFrontierUri>http://localhost:5008/api/BarsInteraction/PairStatus</GetPairingRecordStatusInFrontierUri>
<!-- Адрес, по которому доступна служба. Для того, чтобы Frontier мог понять, от какого объекта пришел запрос на привязку -->
<ThisCenterAddress>http://127.0.0.1:8881</ThisCenterAddress>
<!-- Прочие настройки -->
<FrontierAddress>http://expo-on-line.ru:1234</FrontierAddress>
<ReturnPolice>Политика возврата</ReturnPolice>
<ConfidencialPolice>Политика конфиденциальности</ConfidencialPolice>
<!-- LeaseBooking -->
<MaxReservePeriodHours>120</MaxReservePeriodHours>
<MinHoursAddition>1</MinHoursAddition>
<OrderMediaTypeId>91693</OrderMediaTypeId>
<OrganisationSuperAccountId>3</OrganisationSuperAccountId>
<!-- Настройки для запуска без Frontier -->
<OrganizationName>Название организации</OrganizationName>
<OrganizationPhone>88005553535</OrganizationPhone>
<EnableDeposite>true</EnableDeposite>
<EnableDebts>true</EnableDebts>
<EnableBooking>true</EnableBooking>
<EnableTrainers>true</EnableTrainers>
<EnableLease>true</EnableLease>
<EnableChangeObject>true</EnableChangeObject>
<CashlessPayType>2</CashlessPayType>
<DepositePrinterID>3</DepositePrinterID>
<UseFlashCall>false</UseFlashCall>
<CustomerRequisities1008>1</CustomerRequisities1008>
</Config>
¶ Описание параметров
Connection - строка подключения к БД
Port - порт, через который работает служба Mobile.Service
CashID - идентификатор основной кассы из справочника точек обслуживания
AdditionalCashIds - идентификатор вложенных касс из справочника точек обслуживания. Если их несколько, они перечисляются через запятую. Если их нет, теги <AdditionalCashIds> </AdditionalCashIds> удаляются из конфига.
Настройки карт
DefaultCardMediaId - идентификатор карты из справочника видов карт
FrontierCardMediaId - идентификатор карты из справочника видов карт, как правило он совпадает с с идентификатором из DefaultCardMediaId
Настройки для оплат через BarsPay
EnableCardSupportForSbp - отображать кнопку оплатить картой в виджете СБП
EnableCardFallbackForSbp - отображать кнопку оплатить картой в виджете СБП, если оплата по СБП не удалась
PaymentServiceAcquiringId - ИД эквайринга из вкладки внешние платежи Администратора для оплаты картой.
PaymentServiceSBPAcquiringId- ИД эквайринга для оплаты по СБП. Может совпадать с ИД из PaymentServiceSBPAcquiringId.
GetAcquirersUrl - URL-адрес получения списка эквайрингом.
CreatePaymentUrl - URL-адрес создания платежа.
RegisterPaymentUrl - URL-адрес регистрации платежа.
CheckPaymentUrl - URL-адрес проверки статуса платежа.
В GetAcquirersUrl, CreatePaymentUrl, RegisterPaymentUrl, CheckPaymentUrl вписывается локальный адрес и порт службы платежей.
PaymentReturnUrl - URL-адрес редиректа после успешной оплаты заказа. Вписывается белый айпи и порт службы мобильных приложений
Настройки автопроверки заказов
HighPriorityMaxOrderAgeInHoursToCheck - время в часах, в течение которого проверяются заказы с высоким приоритетом
HighPriorityAutoCheckOrdersIntervalInSecs - время в секундах автоматической проверки заказов с высоким приоритетом
LowPriorityMaxOrderAgeInHoursToCheck - время в часах, в течение которого проверяются заказы с низким приоритетом
LowPriorityAutoCheckOrdersIntervalInSecs - время в секундах автоматической проверки заказов с низким приоритетом
Настройки привязки аккаунтов
DisableCreateNewAccounts - отключить регистрацию новых пользователей
CreatePairingRecordInFrontierUri
RemovePairingRecordInFrontierUri
GetPairingRecordStatusInFrontierUri
ThisCenterAddress - белый айпи и порт службы мобильных приложений
Прочие настройки
FrontierAddress - адрес службы Frontier. Не заполняется
ReturnPolice - политика возвратов и другая информация про возврат товаров
ConfidencialPolice - политика конфиденциальности
Настройки проката
MaxReservePeriodHours - максимальный период бронирования инвентаря
MinHoursAddition
OrderMediaTypeId>
OrganisationSuperAccountId
Настройки дополнительный опций при использовании собственных приложений (без Frontier)
OrganizationName - название организации.
OrganizationPhone - телефон организации
EnableDeposite - включить возможность пополнения и оплаты с депозита
EnableDebts - включить возможность расплачиваться в долг
EnableBooking - включить возможность бронирования инвентаря, либо инструкторов
EnableTrainers - включить возможность оформлять занятия с инструкторами
EnableLease - включить возможность брать инвентарь в прокат
Каждая опция добавляет отдельную иконку на главный экран
EnableChangeObject - включить возможность клиентам смены объектов в приложении
UseFlashCall - Включить функционал FlashCall для авторизации пользователей в BarsPay
При использовании общего приложения Barspay дополнительные опции настраиваются на стороне сервера Frontier
Настройка мероприятий (если не указаны в конфиге, то по умолчанию считаются false)
AllowSellManyTicketForOneActivity - разрешить продажу нескольких билетов на одно мероприятие для одного счёта
AllowSellActivityByMoney - разрешить продажу броней на мероприятия за рубли
AllowFreeActivities - отображать тарифы на мероприятия с нулевой ценой
AllowClientPayMeansMissingInCashDesk - разрешить оплату платёжными средствами на счету клиента, которые отсутствуют в заданной кассе
Настройка передачи клиентских реквизитов
CustomerRequisities1008 - параметр определяет, какой реквизит клиента передастся в тег 1008.
Значения в параметре числа от 0 до 4.
Возможные значение:
| Значение | Описание |
|---|---|
| 0 | в чек ничего не передаётся |
| 1 | в чек в приоритете передается почта |
| 2 | в чек в приоритете передается телефон |
| 3 | в чек всегда передаётся только почта |
| 4 | в чек всегда передаётся только телефон |
¶ Настройка типов оплат для печати чеков через нашу службу фискализации
Для пополнения депозита и оплаты товаров банковской картой используется тип оплаты Безнал
Для оплаты товаров с депозита используется тип оплаты Депозит
Значение это берется
- сначала из конфига службы мобильных приложений
- CashlessPayType - значение типа оплаты для безнала
- DepositePrinterID - значение типа оплаты для траты с депозита
- если эти значения не заданы, берется значение
код принтераиз справочника кассовых валют в Администраторе (для безнала и депозита соответсвенно)
Это значение помещается в задачу на печать чека, далее печать осуществляется в соответствии с настройками службы фискализации
¶ Настройка в модуле "Администратор"
Для того, чтобы MobileService мог понимать, какой аккаунт Frontier привязан к счёту пользователя на объекте, необходимо создать особый вид карты, который в дальнейшем будет использоваться службой.
Для создания нового вида карты можно воспользоваться «Барс. Администратор»
- Войдите в аккаунт администратора и в верхней панели выберите раздел «Справочники», а в нём подраздел «Виды карт»;
- В открывшейся вкладке нажмите на кнопку «плюс» , у вас появится новая строчка с названием вида «Новый тип карты». Запишите куда-нибудь значение поля «идентификатор» нового вида карты, он понадобится далее при конфигурировании Bars.MobileService;
- Задайте настройки вида карты: Шаблон – «Латиница и цифры, длины 36»; Название - любое; например «Аккаунт Frontier»; Оформление карты – «Продавать»; В руки одна карта – отмечено.
Необходимо корректно настроить все параметры, влияющие на чек, для билетов, абонементов и депозита, такие как:
- СНО
- Налог
- Секция
- Признак предмета расчета
Необходимо создать советующую кассу в Барсе и установить необходимые к продаже товары
Заполнить все реквизиты организации, к которой привязана касса мобильного приложения на данный момент не требуется. Эта информация заполняется в БД Фронтира
Для правильной работы приложения необходимо установить контроль уникальности номеров телефонов и Email в Барс
¶ Настройка SMS для Barspay, работающих не через Frontier
- В верхней панели выберите раздел "Сервис", в нём подраздел "Настройки".
- На странице "Глобальные настройки" выбрать вкладку "Сервис SMS".
- Сейчас корректная работа возможна только с Sms Aero. Нужно выбрать следующие настройки:
Разрешить отправку SMS-уведомлений - галочку поставить
API-Ключ(Личный кабинет): *API, который берётся из ЛК на сайте SMS-aero*
Email(Личный кабинет): *Email, который берётся из ЛК на сайте SMS-aero*
Подпись отправителя: SMS Aero
URL для отправки смс: https://gate.smsaero.ru/v2/sms/send
URL для получения статуса доставки смс: https://gate.smsaero.ru/v2/sms/status
URL для проверки авторизации: https://gate.smsaero.ru/v2/auth
- Сохранить,закрыть настройки, перезапустить службу Mobile.Service
Успешность настроек можно проверить, если в приложении после ввода номера телефона произошёл переход на страницу ввода кода из смс.
¶ Частые ошибки:
Неправильно введена подпись отправителя. Решение: в поле "Подпись отправителя" ввести "SMS Aero"(без кавычек), либо если подпись другая, посмотреть её в личном кабинете SMS-aero
Закончились деньги. Решение: пополнить счёт в личном кабинете SMS-aero.