Перейти к содержанию

Интеграции ​

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

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. Это отдельное подключение, отличающееся от получения заказа с площадки Яндекс.Еда.

Подключение точки ​

Перед включением проверьте:

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

Курьер вызывается после онлайн-оплаты или упаковки. Предзаказ всегда ждёт полного приготовления и полной онлайн-оплаты. Можно выбирать самое дешёвое или самое быстрое доступное предложение; число автоматических повторных заявок — от 0 до 3. Отложенное прибытие на 30–240 минут доступно только для тарифа «Экспресс» с вызовом после оплаты.

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

При включении доставки этой службой клиенту для доставки доступны только разрешённые онлайн-способы оплаты. Наличные, терминал при получении, 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. Убедитесь, что отзыв доступен в кабинете.

Кол-центр ​

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

Внутренняя и клиентская документация Beex/Dostavix.