POS-интеграция: чеки, заказы и статус столов
Интеграция «POS-чеки» забирает данные из внешней кассы в Meetto: закрытые чеки, заказы и текущий статус столов. Данные используются в CRM — спенд гостя, визиты, любимые блюда — и в оперативном экране заведения.
Это отдельный сценарий от передачи броней: брони по-прежнему отправляются в кассу существующей интеграцией (например, Quick Resto — раздел про бронирования). POS-чеки работают в обратную сторону — касса является источником данных для Meetto.
Что синхронизируется
- Чеки — закрытые чеки, сумма, стол, позиции, возвраты, тип оплаты.
- Заказы — открытые и закрытые заказы, номер, стол, сумма, количество позиций, статус.
- Статус столов — занят/свободен, время прибытия гостя, текущий заказ.
- Сопоставление с гостем — по телефону (если касса его отдаёт) или по столу и времени; вручную; либо игнор.
- CRM-метрики — POS-спенд, визиты, любимые блюда; возвраты уменьшают спенд и не считаются визитами.
Для Quick Resto используются модули Back Office API:
| Данные | Модуль Quick Resto |
|---|---|
| Чеки | front.orders |
| Заказы | front.tableorders |
| Статус столов | front.tablemanagement |
Что нужно подготовить
- Доступ в бэк-офис Quick Resto вашего заведения.
- Логин и пароль для API из раздела «Предприятие» → «Настройки» → «Общие настройки». Это не логин и пароль кассового терминала.
- Адрес облака заведения, например
https://myresto.quickresto.ru. - Сопоставление столов Meetto и Quick Resto — без него сопоставление по столу работать не будет.
Для POS-интеграции не нужен Bearer-токен API бронирований. Это разные подключения: бронирования используют токен, а POS-чеки — API-логин и API-пароль Back Office.
Пошаговая настройка
1. Создание подключения
- Откройте Интеграции → POS-чеки.
- Нажмите «Добавить подключение».
- Выберите заведение.
- Заполните:
- Название — произвольное имя подключения;
- Cloud URL — адрес облака Quick Resto;
- API-логин и API-пароль — доступы Back Office API;
- Активно — включить синхронизацию.
- Нажмите «Сохранить».
2. Проверка и первый синк
- Нажмите «Проверить» — выполняется проверка доступности API.
- Нажмите «Синк» — забираются новые данные с текущего курсора.
- Для первичной загрузки истории нажмите «Initial» — синхронизация игнорирует сохранённый курсор и перечитывает доступный период.
Синхронизация также выполняется автоматически каждые 5 минут. Повторный синк не создаёт дублей: чеки и заказы обновляются по внешнему идентификатору.
3. Сопоставление столов
- В блоке «Сопоставление столов» выберите стол Quick Resto.
- Выберите соответствующий стол Meetto.
- Нажмите «Сопоставить».
Сопоставление нужно для сопоставления чеков по столу и времени и для отображения названий столов в разделах заказов и статуса.
Разделы страницы
Чеки
Показывает закрытые чеки выбранного заведения:
- дата закрытия, номер чека, стол, сумма;
- отметка возврата;
- статус сопоставления — сопоставлен, не сопоставлен, игнорирован;
- источник сопоставления — автоматический или ручной;
- гость, если чек уже привязан.
Кнопки «Сопоставить» и «Игнор» позволяют исправить автоматическое сопоставление. Ручное сопоставление сохраняется и не перезаписывается следующими синками.
Заказы
Показывает заказы из кассы: дата открытия, номер, стол, сумма, количество позиций и статус. Если заказ связан с чеком, связь сохраняется в чеке как источник заказа.
Статус столов
Карточки столов показывают:
- занят или свободен;
- время прибытия гостя;
- текущий заказ.
Данные обновляются при каждой синхронизации.
Ошибки синхронизации
Проблемные чеки не блокируют остальные: ошибка попадает в список ошибок, а чек повторяется автоматически.
- Pending — ожидает повторной попытки;
- Dead — после нескольких неудачных попыток автоматические повторы прекращены;
- Retry — вернуть чек в очередь;
- Удалить — убрать запись об ошибке.
При повторной успешной синхронизации ошибка снимается автоматически.
Как работает сопоставление гостя
- Если касса передаёт телефон, Meetto ищет гостя по номеру.
- Если телефона нет, используется сопоставленный стол и ближайшая бронь в окне вокруг времени чека.
- Если совпадения нет, чек остаётся не сопоставленным — его можно привязать вручную.
- Ручное сопоставление имеет приоритет: последующие синки не меняют выбранного гостя.
- Игнорирование исключает чек из сопоставления и CRM-метрик.
Для Quick Resto телефон в front.orders не документирован, поэтому основной путь — стол + время и ручное сопоставление.
Ограничения
- Заказы выгружаются полным списком на каждом синке; фильтра по дате для
front.tableordersпока нет. - Имена полей
front.tableordersиfront.tablemanagementтребуют проверки на живом облаке Quick Resto. Парсер устойчив к алиасам, но окончательная сверка сумм и статусов выполняется на тестовом заведении. - Если в кассе нет телефона гостя, сопоставление по телефону не сработает — используйте сопоставление столов и ручную привязку.
- Заказы и статус столов зависят от возможностей подключения; для Quick Resto они включены по умолчанию.
Что проверить после настройки
- Нажмите «Проверить» — подключение должно быть доступно.
- Запустите «Синк» и убедитесь, что появились чеки за период.
- Сопоставьте столы и проверьте, что чеки без телефона привязываются к гостям по брони.
- Откройте карточку гостя в CRM — POS-спенд и визиты должны обновиться.
- Проверьте возврат: сумма POS-спенда должна уменьшиться, а визит не должен добавиться.
- Проверьте ошибки синхронизации: проблемный чек должен попасть в список, а не остановить остальные.
Частые вопросы
Почему чек не привязался к гостю? В Quick Resto нет телефона в чеке, либо стол не сопоставлен. Сопоставьте стол или привяжите гостя вручную.
Чем это отличается от интеграции Quick Resto для броней? Бронирования — push из Meetto в кассу. POS-чеки — pull из кассы в Meetto: чеки, заказы, статус столов.
Можно ли подключить несколько заведений? Да, подключение создаётся отдельно для каждого заведения.
Что делать, если заказы не появились? Проверьте last_error подключения, доступность модуля front.tableorders и права API-пользователя. Ошибки заказов не блокируют приём чеков.