Редактирование: ошибки-оплаты-бонусами

Путь: 08_Решение_проблем/iiko/ошибки-оплаты-бонусами.md

Содержимое (Markdown)

# Ошибки оплаты бонусами на кассе iiko

Раздел охватывает ошибки, возникающие при добавлении и проведении типа оплаты «Бонусы ПЛ» (платёжная система Remarked) на кассе iiko: отсутствие типа оплаты, нефискальная оплата, конфликты ревизий заказа, лицензионные и инициализационные ошибки.

---

## Не настроен тип оплаты «Бонусы ПЛ»

**Симптом.** На кассе отсутствует или не срабатывает тип оплаты «Бонусы ПЛ».

**Причины и решение.**

1. **Выключен плагин.** Перезагрузить кассу либо запросить видео с авторизацией гостя.
2. **Гость не авторизован в заказ**, а пытаются применить тип оплаты. Запросить видео авторизации гостя. Если авторизация есть, а ошибка осталась — снять логи.

В логах проверить, прошла ли авторизация гостя, обратив внимание на методы:
- `guest/get` — запрос информации о госте;
- `order/update` — обновление заказа.

---

## «Для оплаты "Бонусы ПЛ" установлен минимальный порог...»

**Симптом.** При оплате появляется сообщение об установленном минимальном пороге.

**Причина.** Клиент сначала ввёл сумму через окно нашего типа оплаты, а затем изменил её на циферблате справа. Так делать нельзя.

**Решение.** Удалить тип оплаты «Бонусы ПЛ» из оплаты и добавить заново.

---

## Нефискальная оплата

**Симптом.** Появляется предупреждение:

```
В заказ добавлена нефискальная оплата. Добавление фискальной оплаты не...
Вы хотите удалить данные оплаты?
RemarkedLoyalty_ - 2421 руб. 00 коп.
```

**Решение.** Поставить в настройках типа оплаты галочку **«Проводить как скидку»** или **«Фискализировать как скидку»**:

- **«Фискализировать как скидку»** — тип оплаты можно комбинировать с нефискальной предоплатой; в OLAP-отчётах отображается как тип оплаты.
- **«Проводить как скидку»** — уменьшает стоимость заказа на сумму платежа, позволяет комбинировать с другими фискальными типами оплаты; платёж уходит в ОФД как скидка и в OLAP-отчёте отображается как скидка.

---

## «Ошибка при добавлении типа оплаты Remarked payment!»

**Симптом.**

```
Ошибка при добавлении типа оплаты Remarked payment!
Error converting value {null} to type 'System.Int32'. Path 'error.code', line 1, position 37.
```

**Решение.** Снять лог с терминала и направить на разбор в отдел ПЛ (оформить задачу по инструкции «Оформление задачи в ПЛ»).

---

## Ошибка «Ревизий заказа» при оплате бонусами

**Симптом.** При оплате бонусами через платёжную систему Remarked:

```
Сущность Resto.Front.Api.V8.Data.Orders.Order была изменена до выполнения текущего действия.
Ожидаемая версия: 5884614. Фактическая версия: 5884616.
```

**Причина.** Конфликт версий сущности заказа:
- параллельное изменение заказа другим процессом или кассиром;
- гонка потоков (race condition) в плагине.

**Решение.** Не вносить параллельные правки в заказ во время оплаты; повторить операцию. При повторении — снять лог и передать в отдел ПЛ.

---

## Ошибка типа оплаты — ArgumentNullException

**Симптом.**

```
System.ArgumentNullException: Значение не может быть неопределённым.
Имя параметра: ChangePaymentItemSum.PaymentItem
```

**Решение.** Проверить тип оплаты в настройках. Убедиться, что «Бонусы ПЛ» присутствует в таблице `loyalty_payment_types`.

---

## Ошибка при инициализации оплаты — «Не удалось прочитать из IPC-порта, канал был закрыт»

**Симптом.** При инициализации оплаты типом «Бонусы ПЛ» (платёжная система Remarked): «Не удалось прочитать из IPC-порта, канал был закрыт. Обратитесь к администратору...».

**Причина.** Это внутренняя ошибка iiko.

**Решение.** Предварительно уточнить у дилера iiko. Попробовать перезагрузить терминал, либо направить клиента к дилеру iiko.

---

## Ошибка лицензий

**Симптом.**

```
Ошибка: плагин BeOpen.Front.RemarkedJsonRpc_v2_20250617 — нет действующей лицензии
```

iikoFront пытается использовать плагин `BeOpen.Front.RemarkedJsonRpc_v2_...`, но для него отсутствует действующая лицензия.

**Решение.** Направить клиента к дилеру для проверки активности лицензии:

```
API Payment Connector — ID: 21016318
```

Отмена