API-подключения сервисов доставки: как это работает
Подключает партнёрский API платформы доставки: её заказы через webhook попадают прямо на кухонный экран с номером платформы, а статус заказа, меню, закончившиеся позиции и открытие / закрытие заведения возвращаются на платформу. Комиссия и выплаты остаются на странице Delivery platforms.
Урок 3 из 12 · Как это работает
Как это работает
Добавьте подключение через «Add a connection»: у Deliveroo, Talabat / foodpanda (Delivery Hero POS) и Uber Eats есть партнёрские API; Careem, Noon Food и Zomato их не публикуют, поэтому работают только в режиме симуляции — для них используйте «Generic webhook contract» через промежуточный сервис или приём заказов через CSV / электронную почту.
Сохраните учётные данные, выданные платформой, и зарегистрируйте адрес webhook на платформе. Подпись каждого сообщения проверяется; неподписанные или изменённые сообщения отклоняются.
Добавьте позиции на вкладку «Menu» с их идентификатором на платформе; «Push menu» отправляет их с ценой платформы, а отметки «закончилось» с кухни уходят сами.
Заказ становится обычным заказом платформы: списание запасов по рецептам, кухонный чек с названием и номером платформы, комиссия по заказу, ожидание выплаты. Один и тот же заказ платформы никогда не принимается дважды.
Принять, отклонить, готово и забран — на вкладке «Orders» (или автоматически с «Accept orders automatically»); «Ready» также отправляется, когда кухня закрывает последний чек.
Заказ с позицией, которой нет в здешнем меню, удерживается и открывает задачу — на кухню он никогда не попадает по догадке. Отмена со стороны платформы останавливает кухонные чеки и открывает задачу.
Где это найти
- Point of sale → Tables → Delivery API connections
/admin/pos/platforms/connections - Generic webhook contract
/admin/pos/platforms/connections?tab=generic
Настройки, которые на это влияют
- Platforms & prices
/admin/pos/platforms?tab=platforms
Чек-лист
Прежде чем идти дальше, проверьте, что вы умеете:
- Открыть Point of sale → Tables → Delivery API connections
- Добавьте подключение через Add a connection: у Deliveroo, Talabat / foodpanda (Delivery Hero POS) и Uber…
- Сохраните учётные данные, выданные платформой, и зарегистрируйте адрес webhook на платформе.
- Добавьте позиции на вкладку Menu с их идентификатором на платформе; Push menu отправляет их с ценой…
- Заказ становится обычным заказом платформы: списание запасов по рецептам, кухонный чек с названием и номером…
Советы и частые ошибки
- Перед использованием реальных учётных данных отправьте тестовые заказы с вкладки «Simulator» — они проходят весь путь, включая проверку подписи.
- Если платформа отменяет заказы, которые вы не успели принять, включите «Accept orders automatically».
- У Uber Eats нет вызова «готово / забран»: эти статусы записываются только здесь.