Настройте доступ
В Hallify выберите заведение → Настройки → Обслуживание → настройки ресурсов → Интеграции. Администратор с правом preorders.external.manage создаёт ключ, выбирает каналы продаж и разрешения. В публичном канале настройте активный канал и служебного пользователя. Одноразово скопируйте ключ на свой сервер.
Маршрут кабинета: /venues/:venueId/settings/fulfillment. Для четырёх методов выдайте catalog:read, quotes:write, orders:write и orders:read; webhooks:manage назначается отдельно. Замените :venueId идентификатором выбранного заведения.
Первый успешный сценарий
Выполните шаги по порядку. Откройте каждый метод для точного тела, обязательных заголовков и схемы ответа.
- Выполните GET catalog с разрешённым salesChannelId; сохраните идентификатор меню и токен его графа.
- Выполните POST quotes с этим каталогом, выбранными товарами, способом исполнения и допустимым будущим временем. Сохраните quoteId, quoteToken и expiresAt.
- Выполните POST orders с принятым расчётом, совпадающими входными данными и новым Idempotency-Key. Сохраните orderId, fulfillmentId и ревизию.
- Используйте GET orders/{orderId} или настроенные webhooks для получения состояния в пределах доступа партнёра.
Состояния, повторы и восстановление
Расчёт ограничен по времени и используется один раз. При истечении срока или существенных изменениях получите новый. Начальное исполнение — HELD или CONFIRMED по политике; успешное создание не означает оплату или завершение. В этих четырёх партнёрских методах нет общего списка, отмены или изменения заказа.