Robotics Open Serving

Sitora Robotics Open Serving позволяет владельцам ресторанов подавать еду роботами — своим оборудованием или парком подрядчика — через публичный версионированный API. Этот раздел — контракт для поставщиков; его машиночитаемая половина — документ OpenAPI, отдаваемый живьём по адресу GET /api/robotics/v1/openapi.json (без аутентификации) и отрисованный в разделе API reference этого сайта.

Модель: Sitora описывает работу, а не движение

Sitora — авторитет по процессам, а не менеджер парка. Когда оплаченный заказ доходит до физической передачи, Sitora предлагает задачу подачи активированному парку филиала. Ваш контроллер принимает её (побеждает первая заявка), ведёт робота и сообщает ограниченный прогресс. Примитивов движения нет — навигация, объезд препятствий и физическая безопасность целиком ваши, в рамках сертификационного контракта.

Существуют два этапа:

Этап	Триггер	Завершается в
dine_in_tray	заказ становится ready (стол подтверждён)	served
delivery_courier	заказ становится out_for_delivery	delivered

У самовывоза этапа для робота нет: принимающая сторона — гость, а не подтверждающий сотрудник.

Завершение предлагает переход заказа, но никогда не выполняет его напрямую. Решает политика подтверждения филиала: human_confirmed (по умолчанию — сотрудник подтверждает подачу) или auto_confirm (бэкенд применяет переход после вашего отчёта completed, который должен прийти не раньше настроенной задержки после arrived).

Сбой всегда безопасен

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

Допуск: три слоя, все обязательны

Филиал получает предложения, только когда выполняется всё перечисленное:

1. Поставщик сертифицирован — ваш парк прошёл набор проверок соответствия, и Sitora выдала сертификацию.
2. Право по тарифу — тарифный план ресторана включает функцию робототехники.
3. Активация активна — активация робототехники филиала запрошена владельцем, одобрена в Sitora Console и не приостановлена.

Дополнительно предложения прекращаются при включённой заморозке платформы или при устаревшем heartbeat парка. Текущее состояние каждого слоя видно в blocked_reasons снимка парка.

Какие данные вы увидите, а какие — нет

Манифест задачи содержит отображаемый номер заказа, названия и количества позиций, а также назначение (метку/номер стола или адрес доставки для курьерских этапов). Вы никогда не получите личность гостя, контактные номера или платёжные данные. Не запрашивайте их.