Редактирование: ошибки-api-лояльности

Путь: 08_Решение_проблем/Лояльность_и_чекин/ошибки-api-лояльности.md

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

# Ошибки API и обмена с сервером лояльности

Раздел описывает ошибки уровня API и сетевого обмена между кассой и сервером ReMarked: ошибка 520, недоступность сервера/БД, отсутствие успешного ответа. Диагностика ведётся по логам API лояльности.

> **Где искать логи.** `app_logs` → `loyalty_api_e.log` (и опционально `loyalty_api_rr.log`). В файле `_e` запрос ищется по `Request-Id`.

---

## Ошибка 520 в запросах к лояльности

**Симптом.** В ответах API лояльности возвращается код 520.

**Диагностика.**

1. Открыть `loyalty_api_e.log` (опционально `loyalty_api_rr.log`).
2. Найти запрос по `Request-Id`.
3. Посмотреть тип ошибки.

**Распространённые причины.**

- **`mes:Item Is Not Found line:998`** — в базе нет блюда из заказа. Блюдо добавили в iiko, но не перезагружали терминал.
  *Решение:* перезапустить iiko (достаточно одного терминала в заведении или чейне).
- **`Can Not Refill Cashback Bonus`** — ошибка пополнения кэшбэка.

---

## Не удалось получить успешный ответ от сервера Remarked

**Симптом.** Касса сообщает «Не удалось получить успешный ответ от сервера Remarked». В большинстве случаев такая ошибка возникает массово у нескольких клиентов — это значит, что наш сервер недоступен либо отправляет некорректные ответы плагину.

**Причины.**
- Нет интернета на кассе.
- Сервер ReMarked недоступен.

**Решение.**

1. Уточнить, есть ли интернет на кассе.
2. Проверить пинг с кассы до `app.remarked.ru`.
3. Если интернет есть и пинг идёт — снять логи и передать на разбор в отдел ПЛ.

**Дополнение.** Ошибка может быть вызвана тем, что гость не соответствует условиям ПЛ — например, у гостя несколько конфликтующих категорий, применяемых к карте.

---

## «Система лояльности. Произошла ошибка при отправке запроса» (БД ReMarked недоступна)

**Симптом.** На кассе: «Система лояльности. Произошла ошибка при отправке запроса». (На R-Keeper аналог — «Сервер ReMarked ответил ошибкой».)

**Причина.** Недоступна БД ReMarked, поэтому на кассу возвращается ошибка о недоступности плагина.

**Решение.** Написать в чат ПЛ и приложить:
- скриншот ошибки;
- № поинта, на котором ошибка;
- Shard, на котором расположен поинт.

Отмена