Что синхронизировать с Avtomatizaciya-Restorana

• Товары (Menu Items): синхронизация с сайтами доставки и CRM. Используется метод GET /v1/menu/items для выгрузки состава блюд и POST /v1/menu/update для изменения цен и стоп-листов.
• Заказы (Orders): передача заказов в агрегаторы (Яндекс.Еда, Delivery Club). Метод POST /v1/orders/create создает заказ в POS, а GET /v1/orders/{id}/status возвращает текущий статус приготовления.
• Остатки (Stock): синхронизация с учетными системами (iiko, r-keeper). Метод GET /v1/warehouse/stocks возвращает актуальные остатки по ингредиентам для предотвращения перепродажи.
• Клиентская база (CRM Customers): передача данных о гостях для программы лояльности. Используется метод PUT /v1/customers/sync для обновления профиля гостя по номеру телефона.
• Транзакции (Payments): передача фискальных данных в системы эквайринга. Метод POST /v1/payments/register фиксирует оплату и возвращает ID транзакции для закрытия чека.
• Модификаторы (Modifiers): синхронизация состава добавок к блюдам. Используется метод GET /v1/menu/modifiers для загрузки групп модификаторов и их привязки к конкретным товарам.

Технические особенности API Avtomatizaciya-Restorana

• Аутентификация: используется протокол Bearer Token, который передается в заголовке Authorization: Bearer . Токен генерируется в панели управления ресторатора.
• Формат данных: всё взаимодействие происходит исключительно через JSON. Заголовки запроса должны содержать Content-Type: application/json.
• Rate Limits: API ограничивает нагрузку до 100 запросов в минуту на один API-ключ. При превышении сервер возвращает ошибку 429 Too Many Requests с заголовком Retry-After.
• Обработка ошибок: API использует стандартные коды HTTP: 401 (ошибка авторизации), 403 (нет прав на ресурс), 422 (ошибка валидации полей JSON), 500 (внутренняя ошибка сервера).
• Вебхуки (Webhooks): реализована событийная модель (создание заказа, смена статуса). Сервер отправляет POST-запрос на указанный callback_url с нагрузкой в теле JSON.
• Версионирование: API использует префикс в URL (например, /v1/). Все критические изменения выносятся в новые версии, поддержка старых версий гарантируется в течение 12 месяцев.
• Песочница (Sandbox): доступен тестовый сервер api-sandbox.avtomatizaciya.ru, полностью дублирующий логику продуктового API для безопасной отладки интеграций.

Часто задаваемые вопросы о Avtomatizaciya-Restorana

Как получить API-ключ? Ключ генерируется в разделе «Настройки интеграции» личного кабинета администратора. Необходимо создать нового пользователя с ролью «Интегратор» и скопировать сгенерированный токен.

Есть ли ограничения по количеству запросов? Да, лимит составляет 100 запросов в минуту. При необходимости массовой выгрузки данных рекомендуется использовать методы пакетной обработки (batch requests).

Поддерживает ли API вебхуки для всех событий? Да, можно подписаться на события создания, отмены заказа и изменения статуса оплаты. Настройка происходит через метод POST /v1/webhooks/subscribe.

Как проверить интеграцию без риска для реальных продаж? Используйте среду Sandbox, где создаются тестовые заказы, которые не попадают на кухонный монитор и не влияют на фискальную отчетность. Доступ к песочнице выдается по запросу в техподдержку.

Совместимы ли версии API при обновлении системы? Система придерживается семантического версионирования, поэтому при переходе внутри мажорной версии (например, с 1.1 на 1.2) обратная совместимость сохраняется. Изменения в API-контрактах всегда анонсируются за 30 дней.

Где найти полную спецификацию методов? Актуальная Swagger-документация доступна по адресу docs.avtomatizaciya.ru/api. Там же можно протестировать каждый метод через кнопку «Try it out» прямо в браузере. Настроить интеграцию Avtomatizaciya-Restorana под ключ — flowframe.ru, от 40 000 ₽, срок 7-21 день.