Интеграции

Интеграции настраиваются поддержкой и разработчиками. Клиенту можно сообщать только операционные действия и результат, без ключей и внутренних URL.

CloudPayments

Используется для онлайн-оплат. Настройки хранятся в CloudPaymentsCredential.

Проверяйте:

• public_id;
• наличие secret_key;
• привязку к городу или точке;
• retailer;
• webhook на стороне CloudPayments;
• результат тестовой оплаты;
• платежные webhook в backend.

Не отправляйте secret_key в чаты и тикеты без защищенного канала.

iiko

Настройки находятся в IikoRetailerSettings и IikoDepartmentSettings. Общая учётная запись хранится у ритейлера, а рабочее подключение организации, меню, цен и оплат настраивается отдельно для каждой точки.

Ключевые поля ритейлера:

• api_login;
• is_mock_sync;
• источник меню: nomenclature или external_menu;
• external menu id/version;
• organization id;
• price category;
• payment cash/card code и id;
• статус и история синхронизации.

Ключевые поля точки:

• account profile и organization binding;
• включение синхронизации;
• источник и версия меню;
• category_as_menu_id;
• address_format_type;
• payment cash/card overrides;
• discounts и delivery premium identifiers.

При сохранении точки проверьте выбранные город, организацию, внешнее меню, ценовую категорию и способы оплаты. Для перенесённых старых настроек сначала сравните автоматически созданную конфигурацию с прежней retailer-настройкой, затем выполните тестовую синхронизацию.

Заказы с оплатой QR-код и Банковский перевод передаются в iiko как наличный тип расчёта. Терминал остаётся карточным типом, Онлайн — онлайн-типом. Если внешний регламент iiko требует другую схему, не меняйте mapping вслепую: согласуйте его с интегратором.

Диагностика:

1. Проверить последние IikoSyncRun.
2. Проверить текст последней ошибки.
3. Проверить доступность api_login.
4. Проверить, выбрано ли внешнее меню и организация.
5. Проверить payment type ids.
6. Запустить повторную синхронизацию из admin, если проблема связана с устаревшим меню.
7. Для ошибки заказа проверить его тип оплаты и результат формирования payload.

Яндекс.Еда

Отдельный FastAPI-сервис адаптирует данные Dostavix под API Яндекс.Еды.

Проверяйте:

• y_client_id и y_client_secret точки;
• пользователя y_user;
• доступность ресторанов;
• меню и availability;
• создание заказа;
• checkout;
• отмену и статусы.

Группы и варианты модификаторов выгружаются для конкретного блюда. При обратном чтении заказа сервис принимает как внутренний ID связи, так и ID модификатора, сохраняет группу и количество и отбрасывает неактивные связи.

Если в заказе Яндекс.Еды отсутствует модификатор:

1. Проверьте активность группы, модификатора и связи с конкретным блюдом.
2. Сравните ID группы и варианта в выгруженном меню.
3. Проверьте, что модификатор был в исходном payload заказа.
4. Сверьте состав в основном backend и ответе сервиса Яндекс.Еды.

MAX-бот

MAX-бот привязывает MAX ID к управляющему аккаунту и управляет уведомлениями.

Проверяйте:

• логин управляющего;
• группу manager;
• привязку MAX ID;
• is_receive_bot_alerts;
• список привязанных аккаунтов.

Это канал уведомлений для сотрудника. Клиентский вход через MAX — другой сценарий: его выполняют мобильное приложение и MAX mini app. Диагностика клиентского входа описана на странице Вход клиентов.

Темы Telegram

Уведомления можно направлять в заранее созданную тему Telegram-супергруппы. Настройка доступна только superuser и относится к конкретной привязке UserTelegramId.

Поддерживаются уведомления:

• о новом заказе;
• об отмене;
• о подозрительной активности;
• о низкой оценке заказа.

Как настроить:

1. Создайте тему в супергруппе и добавьте notification-бота.
2. Убедитесь, что бот может публиковать сообщения в этой теме.
3. Откройте пользователя в Django admin и найдите Telegram-привязку.
4. В telegram_id укажите отрицательный ID супергруппы.
5. В ID темы Telegram укажите положительный ID существующей темы.
6. Сохраните и проверьте тестовое уведомление без персональных данных.

Пустой ID темы сохраняет прежнюю отправку в личный или основной чат. Если указанная тема недоступна, сообщение фиксируется как ошибка и не отправляется в General. В карточке привязки проверяйте Последняя попытка отправки и безопасный код в Ошибка последней отправки.

Чтобы вернуть отправку в основной чат, очистите ID темы. Чтобы полностью остановить сообщения, удалите привязку по согласованному регламенту; очистка ID темы для этого не подходит.

Низкие оценки

Оценка заказа от 1 до 3 создаёт уведомление в dashboard и отдельные доставки в доступные Telegram/MAX-каналы. Каждый канал обрабатывается независимо и повторяет временно неудачную отправку, поэтому сбой бота не должен скрыть отзыв в dashboard.

Если уведомление не пришло:

1. Проверьте оценку, заказ и точку.
2. Проверьте роль получателя и is_receive_bot_alerts.
3. Проверьте Telegram/MAX-привязку и, для Telegram, ID темы.
4. Посмотрите время последней попытки и безопасный код ошибки.
5. Убедитесь, что отзыв виден в dashboard, даже если внешний канал недоступен.

Call center

Call center имеет отдельные frontend/backend и теперь учитывает настройки выбранной точки, включая оплаты, время, баллы и минимальную сумму. Подробный чек-лист находится на странице Call center.