ST POINTЭкспертный материал ST Point
Интеграция киоска с POS, CRM и ERP
Интеграция включает справочники, цены, доступность, заказ, оплату, статусы, повторы, мониторинг и ответственность систем — не только один API-вызов.
Практический подход
С чего начинать решение
До разработки важно определить систему-источник для каждого вида данных и договориться, что происходит при тайм-ауте, повторе запроса, частичном сбое и восстановлении связи.
Критерии выбора
Что необходимо определить до заказа
Справочники и контент
Номенклатура, услуги, модификаторы, цены, изображения, языки, ограничения и стоп-листы.
Клиент и лояльность
Идентификация, карты, штрихкоды, бонусы, купоны, персональные условия и согласия.
Заказ или операция
Создание, изменение, отмена, резервирование, номер, состав, налоги и маршрутизация.
Оплата
Инициация эквайринга, подтверждение, отмена, возврат, фискализация и защита от двойного списания.
Статусы
Киоск должен понимать, принят ли заказ, завершена ли операция, нужно ли повторить запрос и что показать пользователю.
Мониторинг
Состояние приложения, периферии, сети, очередей сообщений и версия конфигурации передаются в единый контур поддержки.
Рабочая матрица
Что фиксируется в проекте
| POS | Заказ, кассовая логика, цены, налоги, чек и статус выполнения. |
| CRM/лояльность | Клиент, бонусы, сегменты, купоны и история взаимодействия. |
| ERP | Номенклатура, остатки, заказы, учётные документы и мастер-данные. |
| KDS/WMS/YMS | Маршрутизация операции на кухню, склад, ворота или рабочее место. |
| Мониторинг | Доступность устройств, ошибки, журналы, версии ПО и удалённые действия. |
Риски
Типичные ошибки
Не выбрать источник истины
Одни и те же цены в трёх системах быстро начинают жить разными жизнями.
Не проектировать идемпотентность
Повтор запроса после тайм-аута не должен создавать второй заказ или второе списание.
Смешать ответственность
Нужно явно разделить устройство, ОС, приложение, API, эквайринг и поддержку.
Тестировать только happy path
Основные проблемы появляются при сбоях сети и частично завершённых операциях.
Чек-лист
Что проверить перед согласованием
Перед передачей запроса производителю убедитесь, что ключевые исходные данные собраны и согласованы.
- Есть актуальная OpenAPI/документация
- Назначены владельцы всех систем
- Определены источники данных
- Согласованы тайм-ауты и повторы
- Разработана защита от дублей
- Описан offline-режим
- Подготовлены тестовые стенды и сценарии отказов
- Настроен мониторинг и журналирование