Перейти к содержанию
На сайт → База знаний Блог

POS-интеграция: чеки, заказы и статус столов

Интеграция «POS-чеки» забирает данные из внешней кассы в Meetto: закрытые чеки, заказы и текущий статус столов. Данные используются в CRM — спенд гостя, визиты, любимые блюда — и в оперативном экране заведения.

Это отдельный сценарий от передачи броней: брони по-прежнему отправляются в кассу существующей интеграцией (например, Quick Resto — раздел про бронирования). POS-чеки работают в обратную сторону — касса является источником данных для Meetto.

Что синхронизируется

  • Чеки — закрытые чеки, сумма, стол, позиции, возвраты, тип оплаты.
  • Заказы — открытые и закрытые заказы, номер, стол, сумма, количество позиций, статус.
  • Статус столов — занят/свободен, время прибытия гостя, текущий заказ.
  • Сопоставление с гостем — по телефону (если касса его отдаёт) или по столу и времени; вручную; либо игнор.
  • CRM-метрики — POS-спенд, визиты, любимые блюда; возвраты уменьшают спенд и не считаются визитами.

Для Quick Resto используются модули Back Office API:

Данные Модуль Quick Resto
Чеки front.orders
Заказы front.tableorders
Статус столов front.tablemanagement

Что нужно подготовить

  1. Доступ в бэк-офис Quick Resto вашего заведения.
  2. Логин и пароль для API из раздела «Предприятие» → «Настройки» → «Общие настройки». Это не логин и пароль кассового терминала.
  3. Адрес облака заведения, например https://myresto.quickresto.ru.
  4. Сопоставление столов Meetto и Quick Resto — без него сопоставление по столу работать не будет.

Для POS-интеграции не нужен Bearer-токен API бронирований. Это разные подключения: бронирования используют токен, а POS-чеки — API-логин и API-пароль Back Office.

Пошаговая настройка

1. Создание подключения

  1. Откройте Интеграции → POS-чеки.
  2. Нажмите «Добавить подключение».
  3. Выберите заведение.
  4. Заполните:
  5. Название — произвольное имя подключения;
  6. Cloud URL — адрес облака Quick Resto;
  7. API-логин и API-пароль — доступы Back Office API;
  8. Активно — включить синхронизацию.
  9. Нажмите «Сохранить».

2. Проверка и первый синк

  1. Нажмите «Проверить» — выполняется проверка доступности API.
  2. Нажмите «Синк» — забираются новые данные с текущего курсора.
  3. Для первичной загрузки истории нажмите «Initial» — синхронизация игнорирует сохранённый курсор и перечитывает доступный период.

Синхронизация также выполняется автоматически каждые 5 минут. Повторный синк не создаёт дублей: чеки и заказы обновляются по внешнему идентификатору.

3. Сопоставление столов

  1. В блоке «Сопоставление столов» выберите стол Quick Resto.
  2. Выберите соответствующий стол Meetto.
  3. Нажмите «Сопоставить».

Сопоставление нужно для сопоставления чеков по столу и времени и для отображения названий столов в разделах заказов и статуса.

Разделы страницы

Чеки

Показывает закрытые чеки выбранного заведения:

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

Кнопки «Сопоставить» и «Игнор» позволяют исправить автоматическое сопоставление. Ручное сопоставление сохраняется и не перезаписывается следующими синками.

Заказы

Показывает заказы из кассы: дата открытия, номер, стол, сумма, количество позиций и статус. Если заказ связан с чеком, связь сохраняется в чеке как источник заказа.

Статус столов

Карточки столов показывают:

  • занят или свободен;
  • время прибытия гостя;
  • текущий заказ.

Данные обновляются при каждой синхронизации.

Ошибки синхронизации

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

  • Pending — ожидает повторной попытки;
  • Dead — после нескольких неудачных попыток автоматические повторы прекращены;
  • Retry — вернуть чек в очередь;
  • Удалить — убрать запись об ошибке.

При повторной успешной синхронизации ошибка снимается автоматически.

Как работает сопоставление гостя

  1. Если касса передаёт телефон, Meetto ищет гостя по номеру.
  2. Если телефона нет, используется сопоставленный стол и ближайшая бронь в окне вокруг времени чека.
  3. Если совпадения нет, чек остаётся не сопоставленным — его можно привязать вручную.
  4. Ручное сопоставление имеет приоритет: последующие синки не меняют выбранного гостя.
  5. Игнорирование исключает чек из сопоставления и CRM-метрик.

Для Quick Resto телефон в front.orders не документирован, поэтому основной путь — стол + время и ручное сопоставление.

Ограничения

  • Заказы выгружаются полным списком на каждом синке; фильтра по дате для front.tableorders пока нет.
  • Имена полей front.tableorders и front.tablemanagement требуют проверки на живом облаке Quick Resto. Парсер устойчив к алиасам, но окончательная сверка сумм и статусов выполняется на тестовом заведении.
  • Если в кассе нет телефона гостя, сопоставление по телефону не сработает — используйте сопоставление столов и ручную привязку.
  • Заказы и статус столов зависят от возможностей подключения; для Quick Resto они включены по умолчанию.

Что проверить после настройки

  1. Нажмите «Проверить» — подключение должно быть доступно.
  2. Запустите «Синк» и убедитесь, что появились чеки за период.
  3. Сопоставьте столы и проверьте, что чеки без телефона привязываются к гостям по брони.
  4. Откройте карточку гостя в CRM — POS-спенд и визиты должны обновиться.
  5. Проверьте возврат: сумма POS-спенда должна уменьшиться, а визит не должен добавиться.
  6. Проверьте ошибки синхронизации: проблемный чек должен попасть в список, а не остановить остальные.

Частые вопросы

Почему чек не привязался к гостю? В Quick Resto нет телефона в чеке, либо стол не сопоставлен. Сопоставьте стол или привяжите гостя вручную.

Чем это отличается от интеграции Quick Resto для броней? Бронирования — push из Meetto в кассу. POS-чеки — pull из кассы в Meetto: чеки, заказы, статус столов.

Можно ли подключить несколько заведений? Да, подключение создаётся отдельно для каждого заведения.

Что делать, если заказы не появились? Проверьте last_error подключения, доступность модуля front.tableorders и права API-пользователя. Ошибки заказов не блокируют приём чеков.