Диагностика

Эти чек-листы нужны для быстрой первичной проверки. Если проблема не решается после базовой диагностики, приложите собранные данные к задаче разработчикам.

Проблемы входа в dashboard

Проверьте:

• правильный dashboard URL;
• логин;
• активность пользователя;
• пароль был изменен или нет;
• is_deleted;
• retailer;
• группы пользователя;
• привязку к точке;
• ошибки API авторизации в браузере.

Dashboard различает неверные учётные данные и временную сетевую/серверную ошибку. При сетевой ошибке не сбрасывайте пароль до проверки доступности API.

Клиент не может войти на сайт или в приложение

1. Уточните проект, платформу и способ входа: звонок, SMS, MAX или другой OAuth.
2. Для входа звонком проверьте AppSettings.waitcall_login, таймер и совпадение номера звонящего с номером формы.
3. Для сайта проверьте прохождение CAPTCHA.
4. Для MAX попросите начать новую попытку из нужного брендированного приложения, а не использовать старую ссылку.
5. Проверьте резервный вход по SMS.
6. Не запрашивайте одноразовый код, callback secret или полный номер клиента.

Подробности: Вход клиентов.

Пользователь не видит роль

1. Проверить User.groups.
2. Проверить User.department.
3. Проверить Department.modules.
4. Проверить, что точка активна.
5. Проверить, что пользователь вошел в нужный retailer.

Нет заказов

Проверить:

• выбранный город и точку;
• дату в header;
• фильтры;
• статус заказов;
• источник заказов;
• Department.is_active;
• City.is_accepting_orders;
• сетевые ошибки API;
• есть ли заказы в Django admin.

Не создается заказ

Проверить:

• включен модуль Creating order button;
• включен нужный тип доставки: delivery, takeaway или stay;
• город принимает заказы;
• точка активна;
• минимальную сумму доставки;
• зоны доставки;
• доступность блюд;
• способ оплаты;
• ошибки API checkout.

Не видно блюдо

Проверить:

• категория активна;
• блюдо активно;
• есть привязка к городу/точке;
• цена заполнена;
• блюдо не архивировано;
• остатки, если включен показ складских остатков;
• модификаторы не блокируют добавление.

Ошибка печати

Собрать:

• номер заказа;
• тип чека: фискальный или пречек;
• способ оплаты;
• текст ошибки;
• лог команды KKMServer;
• состояние ККТ;
• состояние ОФД;
• настройки Department по KKM.

Проверить:

1. window.KkmServer доступен в браузере.
2. ККТ включена.
3. Бумага есть.
4. KKMServer видит устройство.
5. Тестовый чек печатается из KKMServer.
6. Номер терминала совпадает с настройкой, если используется kkm_pay_by_processing.

Проблемы оплаты

Проверить:

• включен ли способ оплаты в выбранном Department; для старых точек затем проверить запасное значение City;
• правильно ли выбран способ в заказе;
• CloudPayments credentials для online;
• webhook оплаты;
• kkm_pay_by_processing для terminal/QR;
• была ли смена типа оплаты после фискального чека.

Если заказ уже успешно оплачен онлайн, смена оплаты и изменения итоговой стоимости блокируются намеренно.

Проблемы интеграций

• для iiko проверить настройку конкретной точки, организацию, меню и mapping оплаты;
• для Яндекс.Еды проверить активность группы и варианта модификатора у конкретного блюда;
• для Telegram-темы проверить отрицательный chat ID, положительный topic ID и право бота писать в тему;
• для call center сравнить настройки выбранной точки с городом;
• зафиксировать последнюю синхронизацию, безопасный код ошибки и внешний ID без секретов.

Проблемы кухни или упаковки

Проверить:

• модули Cooking и Packing;
• группы пользователя;
• ответственные категории повара;
• статус заказа;
• show_order_to_cooker_and_packer_synchronously;
• удалялись ли приготовленные позиции;
• включены ли звуковые сигналы.

Проблемы склада

Проверить:

• включено ли списание товаров;
• разрешен ли отрицательный баланс;
• видит ли оператор остатки;
• есть ли приходные накладные;
• корректны ли единицы измерения;
• поставщик активен;
• списание не заблокировано статусом документа.

Что прикладывать разработчикам

• точный URL страницы;
• роль пользователя;
• город и точку;
• номер заказа или id сущности;
• скрин ошибки;
• HAR или ошибки Network, если проблема в API;
• лог KKMServer, если проблема в кассе;
• шаги воспроизведения;
• ожидаемый и фактический результат.