Настройка в админке ProPrepayer [База знаний ГК Карбис]

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== Настройка в админке ProPrepayer ======

Админка: http://<IP сервера>:11260/admin, пароль по умолчанию 051791 (см. [[external:proprepayer:01_install_and_settings:02_install|Установка службы]]).
В шапке видны версия, порт и имя службы. Над разделами показываются важные предупреждения: нет связи с платёжным шлюзом, низкий баланс SMS, нет лицензии.

Разделы настраиваются сверху вниз. В каждом разделе после изменений нажмите **«Сохранить»**.

===== Связь с r_keeper =====
  * **IP кассового сервера** и **порт XML-интерфейса**.
  * **Логин** и **пароль** пользователя r_keeper с правом на XML-интерфейс.
  * **«Проверить связь»** — запрашивает у кассового сервера сведения о системе.

{{:external:proprepayer:proprepayer_admin_rk.png?direct&900|Связь с r_keeper}}

//1 — адрес кассового сервера и порт XML-интерфейса; 2 — пользователь r_keeper; 3 — «Проверить связь».//

===== Зачисление предоплаты =====
Справочники загружаются с кассового сервера, поэтому сначала настройте связь с r_keeper. Во всех списках можно искать по части названия.
  * **Валюта предоплаты** — валюта, которой вносится аванс. Валюты типа «Зачёт аванса» не показываются.
  * **Причина внесения** — показываются только причины с галочкой «Предоплата».
  * **Станция печати чека** — касса, на которой печатается фискальный чек «Аванс». Одна для всех оплат. У станции должен быть назначен принтер «Для чеков».
  * **Сотрудник-автор** — от его имени вносится предоплата.
  * **«Сообщать официанту об успешном зачислении»** — по умолчанию включено. Официант заказа получает сообщение «Стол 15, заказ 15: получена предоплата 5 000 руб.». Сообщения о проблемах (заказ открыт на кассе, предоплата не внесена) приходят всегда.

{{:external:proprepayer:proprepayer_admin_credit.png?direct&900|Зачисление предоплаты}}

//1 — валюта предоплаты; 2 — причина внесения; 3 — станция печати чека; 4 — сотрудник-автор; 5 — сообщение официанту об успешном зачислении.//

===== Платёжный шлюз =====
Выберите шлюз — ЮKassa или Best2Pay / Paygine, введите ключи и нажмите **«Проверить ключи»**. Подробно о регистрации в шлюзах и о каждом поле — в статье [[external:proprepayer:01_install_and_settings:04_payment|Платёжные шлюзы]].

{{:external:proprepayer:proprepayer_admin_gw_yk.png?direct&900|Платёжный шлюз: ЮKassa}}

//1 — выбор шлюза; 2 — shopId и секретный ключ; 3 — страница после оплаты; 4 — «Проверить ключи».//

**Важно:** меняйте шлюз, когда нет неоплаченных ссылок. После смены ProPrepayer проверяет оплаты только у нового шлюза.

===== SMS =====
  * **Отправлять ссылку по SMS** — если выключить, на форме не будет кнопки «Отправить по SMS», ссылку передают только через QR-код.
  * **SMS-шлюз** — i-Digital.
  * **Ключ API** — ключ типа «Сообщения» из кабинета i-Digital.
  * **Имя отправителя** — по умолчанию sms_promo (общее имя тарифа «Промо» без абонплаты).
  * **Критический баланс** — если баланс ниже, на форме и в админке появляется красное предупреждение «пополните счёт». По умолчанию 1000 руб.
  * **Текущий баланс** обновляется после каждой отправки и кнопкой **«Обновить баланс»**.
  * **Тестовое SMS** — отправляет на указанный номер сообщение «ProPrepayer: тестовое сообщение». SMS платная.
Подробно — [[external:proprepayer:01_install_and_settings:05_sms|SMS: i-Digital]].

{{:external:proprepayer:proprepayer_admin_sms.png?direct&900|SMS}}

//1 — включение SMS; 2 — ключ API; 3 — имя отправителя; 4 — критический баланс; 5 — тестовое SMS; 6 — «Обновить баланс».//

===== Шаблон и сумма =====
  * **Название ресторана** — для справки, в сообщение не подставляется.
  * **Шаблон** — текст SMS и QR-кода. По умолчанию:
<code>
Ресторан НАЗВАНИЕ. Платёжная ссылка для внесения аванса: {LINK}
</code>
Переменные: {SUM} — сумма аванса, {LINK} — ссылка (обязательна). Название ресторана пишите прямо в тексте и в начале: на тарифе «Промо» гость видит отправителем имя общего маршрута, а не ресторан. Под полем показывается длина и число частей SMS — ссылка в SMS сокращается до вида 9ap.ru/…, поэтому шаблон по умолчанию занимает одну часть.
  * **Сумма по умолчанию** — что подставляется в поле суммы на форме:
    * пусто;
    * фиксированная сумма, руб.;
    * остаток по заказу (сумма заказа минус уже внесённые предоплаты);
    * процент от суммы заказа — округляется вниз до 100 руб. (3 166,50 → 3 100); если получается 0 — до рубля.

{{:external:proprepayer:proprepayer_admin_tpl.png?direct&900|Шаблон и сумма}}

//1 — название ресторана; 2 — шаблон сообщения; 3 — сумма по умолчанию.//

===== Системные настройки =====
Изменения применяются сразу, перезапуск службы не нужен. Значения по умолчанию подходят большинству ресторанов.
^ Параметр ^ По умолчанию ^ Допустимо ^ Что означает ^
| Опрос об оплатах | 12 с | 5–60 с | Как часто ProPrepayer спрашивает платёжный шлюз о новых оплатах. Запросы идут, только пока есть неоплаченные ссылки |
| Повтор зачисления | 30 с | 10–300 с | Как часто повторять внесение, если заказ открыт на кассе или не печатается чек |
| Сообщение и окно на кассе | 60 с | 0–600 с | Через сколько после неудачной попытки сообщить официанту и открыть окно «выйдите из заказа» на кассе, где открыт заказ |
| Перенос в «Требует внимания» | 600 с | 60–3600 с | Сколько пытаться внести, прежде чем оплата попадёт в «Требует внимания». Заказ, открытый на кассе, ждёт сколько угодно |
| Уровень логирования | Обычный | Обычный / Подробный | «Подробный» дополнительно пишет полные запросы и ответы r_keeper, ЮKassa и i-Digital. Включайте на время разбора проблемы |
| Размер файла лога | 5 МБ | | |
| Хранить файлов | 10 | | Файлы logs\proprepayer.log.N |
| Статистика | Включено | Включено / выключено | «Отправлять анонимную статистику в Карбис» — см. ниже |

{{:external:proprepayer:proprepayer_admin_sys.png?direct&900|Системные настройки}}

//1 — уровень логирования: «Подробный» включайте только на время разбора проблемы; 2 — отправка анонимной статистики; 3 — время последней отправки или ошибка.//

**Анонимная статистика** (с версии 1.3.0). Раз в сутки ночью ProPrepayer отправляет в Карбис статистику за прошедшие дни: сколько создано ссылок, отправлено SMS, получено оплат и внесено предоплат, их сумму, число ошибок, а также какой шлюз выбран и включены ли SMS. Телефоны и e-mail гостей, заказы, адреса, ключи и пароли не отправляются. Статистика помогает нам развивать программу. Отправка идёт только при действующей лицензии. Чтобы отключить, снимите галочку «Отправлять анонимную статистику в Карбис» и нажмите «Сохранить»: статистика перестанет собираться, а уже собранная будет удалена. Под галочкой видно время последней отправки или ошибка.

===== Журнал и «Требует внимания» =====
Эти разделы нужны в работе, а не при настройке — см. [[external:proprepayer:03_journal|Журнал и «Требует внимания»]].

===== Лицензия =====
Объект и срок лицензии lic.carbis.ru, связь с сервером лицензирования, кнопка **«Проверить лицензию»**. Подробно — [[external:proprepayer:01_install_and_settings:06_license|Лицензирование]].

===== Проверка после настройки =====
  - Откройте заказ на кассе, нажмите клавишу «Предоплата по ссылке» — откроется форма с суммой заказа.
  - Создайте ссылку на небольшую сумму (например, 10 руб.) с вашим телефоном и e-mail, отправьте SMS.
  - Оплатите по ссылке и **выйдите из заказа**.
  - В течение минуты предоплата появится в заказе, напечатается чек «Аванс», официант получит сообщение.
  - Верните тестовую оплату в кабинете шлюза и удалите предоплату штатно в r_keeper.