外卖平台 API 连接:运作方式
连接外卖平台的合作伙伴 API:平台订单通过 webhook 直接进入厨房显示屏,并带有平台订单号;订单状态、菜单、售罄商品和门店营业 / 打烊状态会回传给平台。佣金和结算仍在 Delivery platforms 页面处理。
第 3 课,共 12 课 · 运作方式
运作方式
在 «Add a connection» 下添加连接:Deliveroo、Talabat / foodpanda(Delivery Hero POS)和 Uber Eats 提供合作伙伴 API;Careem、Noon Food 和 Zomato 没有公开 API,因此只能以模拟方式运行——对它们请通过中间件使用 «Generic webhook contract»,或使用 CSV / 电子邮件导入。
保存平台提供给您的凭证,并在平台上登记 webhook 地址。每条消息都会验证签名;没有签名或被篡改的消息会被拒绝。
在 «Menu» 标签页添加商品并填写其平台商品 ID;«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 Eats 提供合作伙伴 API;Careem、Noon…
- 保存平台提供给您的凭证,并在平台上登记 webhook 地址。每条消息都会验证签名;没有签名或被篡改的消息会被拒绝。
- 在 Menu 标签页添加商品并填写其平台商品 ID;Push menu 会按平台价格推送;厨房切换的售罄状态会自动同步出去。
- 订单会变成一张普通的平台订单:扣减库存和配方,厨房小票上显示平台名称和单号,订单上计提佣金,等待平台结算。同一张平台订单绝不会被重复接收。
提示和常见错误
- 使用真实凭证前,请先在 «Simulator» 标签页发送测试订单——它们会走完整个流程,包括签名校验。
- 如果平台因为您没有及时接单而取消订单,请打开 «Accept orders automatically»。
- Uber Eats 没有出餐 / 已取餐接口:这两种状态只在这里记录。