Интеграции

Здесь собраны проверки подключённых сервисов. Настройки изменяют поддержка и технические сотрудники. Перед диагностикой зафиксируйте бренд, точку, время и номер заказа; ключи доступа передавайте отдельно от обращения.

CloudPayments

CloudPayments используется для онлайн-оплаты. В административной панели найдите подключение сервиса и проверьте:

• Открытый идентификатор магазина;
• наличие Секретного ключа;
• Бренд и привязку к Точке или Городу;
• настроенные уведомления об оплате на стороне CloudPayments;
• итог тестовой операции у платёжного сервиса и получение подтверждения в Beex.

Приоритет имеет подключение точки. Если его нет, используется подключение города того же бренда. Несколько подходящих записей — ошибка настройки, которую нужно передать поддержке; система не должна выбирать произвольную запись.

Не повторяйте оплату только потому, что Beex ещё не показал результат. Сначала сравните состояние операции у платёжного сервиса и историю заказа.

iiko

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

Полная последовательность: Подключение точки к iiko.

Для подключения проверьте:

• активность и принадлежность бренду;
• успешное обновление организаций и городов;
• соответствие внешнего города городу Beex.

Для точки проверьте:

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

QR-код и банковский перевод передаются через наличный тип iiko. Терминал использует карточный тип. Онлайн-оплата также использует карточный тип, с отметкой об оплате вне iiko; поэтому карточная настройка нужна и для онлайн-заказов.

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

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

1. Откройте журнал синхронизаций и найдите нужную точку.
2. Сравните последний успешный запуск и последнюю ошибку.
3. Проверьте доступ к организации, выбор меню, цен и оплат.
4. Для устаревшего меню после проверки причины запустите обновление из административной панели.
5. Для ошибки заказа сравните состав, оплату, организацию и результат передачи.
6. Если заказ принят iiko, а статусы не возвращаются, отдельно проверьте регистрацию обмена и служебную учётную запись.

Не включайте Округление стоимости позиций заказа для точки с активной интеграцией iiko.

Яндекс.Еда

Яндекс.Еда получает меню и передаёт заказы через подключение конкретной точки. В её настройках проверьте наличие Учётной записи Яндекс.Еды, Ключей подключения и Служебного пользователя.

Затем проверьте доступность ресторана, меню и отдельных позиций, создание заказа, итоговую сумму, отмену и передачу статусов.

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

Если добавка отсутствует:

1. Проверьте активность группы, варианта и связи с конкретным блюдом.
2. Сравните добавку у блюда в Beex и в опубликованном меню Яндекс.Еды.
3. Проверьте, была ли она передана площадкой в исходном заказе.
4. Сравните состав заказа в административной панели и у агрегатора.

Для этой интеграции округление стоимости позиций тоже должно быть выключено.

Яндекс Доставка

Яндекс Доставка привлекает внешнего курьера к заказу Beex. Это отдельное подключение, отличающееся от получения заказа с площадки Яндекс.Еда.

При включении доставки этой службой клиенту для доставки доступны только разрешённые онлайн-способы оплаты. Наличные, терминал при получении, QR-код и банковский перевод для этого варианта скрываются. Настройки самовывоза проверяются отдельно.

В заказе оператора проверьте блок «Яндекс Доставка»:

• Статус доставки;
• Стоимость;
• назначенного курьера и доступное отслеживание;
• результат передачи изменённых данных получателя;
• доступные действия: согласование стоимости, повтор попытки, проверка или подтверждение отмены.

Доступность действия зависит от текущего состояния доставки. Если стоимость не определена, это не нулевая стоимость. После ошибки или долгого ожидания сначала обновите сведения и проверьте результат предыдущего действия.

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

MAX-бот

Бот MAX связывает аккаунт управляющего с получением уведомлений. Проверьте в административной панели:

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

Клиентский вход через MAX описан отдельно на странице Вход клиентов.

Уже настроенная привязка не требует повторного подключения после обновления способа отправки. При временной ошибке предусмотрен повтор. Если Telegram-уведомление пришло, а MAX — нет, проверьте активность привязки, время и результат последней попытки до переподключения аккаунта.

Темы Telegram

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

Поддерживаются уведомления о новом заказе, отмене, подозрительной активности и низкой оценке.

Порядок настройки:

1. Создайте тему в супергруппе и добавьте бота уведомлений.
2. Проверьте право бота публиковать сообщения в теме.
3. Откройте пользователя в административной панели и найдите его привязку Telegram.
4. Укажите Номер группового чата. Для группы он отрицательный.
5. Укажите Номер темы Telegram. Он должен быть положительным и соответствовать существующей теме.
6. Сохраните и проверьте согласованное тестовое уведомление без персональных данных.

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

В карточке привязки проверяйте «Последняя попытка отправки» и «Ошибка последней отправки». Для возврата в основной чат очистите номер темы. Для полного прекращения сообщений удалите привязку по регламенту: очистка темы сама по себе отправку не прекращает.

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

Оценка заказа от 1 до 3 создаёт уведомление в кабинете и отдельные отправки в доступные Telegram и MAX. Временная ошибка одного канала не должна скрывать отзыв в кабинете.

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

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

Кол-центр

Кол-центр работает в отдельном кабинете и учитывает настройки выбранной точки: оплаты, время, баллы и минимальную сумму. Проверки собраны на странице Кол-центр.