UrbanPiper

UrbanPiper 是一个订单管理系统，可以与多个食品配送平台集成。它将所有连接平台的订单整合到一个界面中，简化了配送流程。

支持的供应商和地区：

Global and multi-region providersRegional and national providers: AmericasRegional and national providers: Middle East and North AfricaRegional and national providers: Asia and Oceania

服务商	地点
Deliveroo	比利时、法国、爱尔兰、意大利、科威特、阿联酋、英国
DoorDash	澳大利亚、加拿大、美国
Glovo	亚美尼亚、波斯尼亚和黑塞哥维那、保加利亚、克罗地亚、科特迪瓦、格鲁吉亚、意大利、哈萨克斯坦、肯尼亚、吉尔吉斯斯坦、摩尔多瓦、黑山、摩洛哥、尼日利亚、波兰、葡萄牙、罗马尼亚、塞尔维亚、西班牙、突尼斯、乌干达、乌克兰
HungryPanda	澳大利亚、加拿大、法国、意大利、日本、新西兰、新加坡、韩国、英国、美国
Just Eat	奥地利、比利时、保加利亚、加拿大、丹麦、德国、爱尔兰、以色列、意大利、卢森堡、波兰、斯洛伐克、西班牙、瑞士、荷兰、英国
Keeta	巴林、巴西、中国香港、科威特、卡塔尔、沙特阿拉伯、阿联酋
UberEats	阿根廷、澳大利亚、比利时、加拿大、智利、哥斯达黎加、丹麦、多米尼加共和国、厄瓜多尔、萨尔瓦多、芬兰、法国、德国、危地马拉、爱尔兰、意大利、日本、肯尼亚、卢森堡、墨西哥、荷兰、新西兰、挪威、巴拿马、波兰、葡萄牙、南非、西班牙、斯里兰卡、瑞典、瑞士、中国台湾、英国、美国
Wolt	阿尔巴尼亚、奥地利、阿塞拜疆、保加利亚、克罗地亚、塞浦路斯、捷克、丹麦、爱沙尼亚、芬兰、格鲁吉亚、德国、希腊、匈牙利、冰岛、以色列、日本、哈萨克斯坦、科索沃、拉脱维亚、立陶宛、卢森堡、马耳他、北马其顿、挪威、波兰、罗马尼亚、塞尔维亚、斯洛伐克、斯洛文尼亚、瑞典、乌兹别克斯坦

配置

先决条件

要在实际生产环境中使用 UrbanPiper 集成，请确保满足以下要求：

• UrbanPiper 订阅： 必须有有效的 UrbanPiper 订阅。

  注解

  如有关于您 UrbanPiper 订阅的任何疑问或问题，请联系与您的 Odoo 数据库关联的客户经理。

• Odoo 要求：

  • Odoo 订阅： 需要有效的 Odoo 企业订阅。Odoo 社区版不支持此整合。

  • Odoo 版本： Odoo 企业版 18.0 或以上版本。

  • Odoo 平台： 支持所有 Odoo 平台，包括 Odoo 在线、Odoo.sh 和内部安装。

• 外卖平台经销商账户： 每个要整合的外卖平台（如 Uber Eats、DoorDash、Careem、Deliveroo、Zomato）都需要一个注册经销商账户。

UrbanPiper 凭据

1. 获取您的 Atlas 凭据：

   1. 导航至 销售点（POS）设置。

   2. 向下滚动到 食品配送连接器 部分。

   3. 点击 填写此表单以获取用户名和 API 密钥 并填写调查问卷。

2. 前往您的 Atlas 账户，并通过导航到 设置 ‣ API 访问 来获取您的 API 密钥和用户名。

门店收银

1. 启用 Urban Piper 设置：

   1. 导航至 销售点（POS）设置。

   2. 向下滚动到 食品配送连接器 部分。

   3. 检查 Urban Piper 设置。

2. 设置 UrbanPiper：

   1. 在使用者名稱和Api 金鑰欄位中填寫您的UrbanPiper 憑證。

   2. 在 Urban Piper 位置 部分的 食品配送平台 字段中选择所需的配送提供商（例如，Zomato、Uber Eats）。

3. 保存设置。

4. 点击 + 创建店铺 按钮。这样做会在 UrbanPiper Atlas 平台上创建一个新的位置。

注解

• 价格表 和 税务规则 字段在保存后会自动选择。

• 成功创建店铺后，会触发一个通知。

• 店铺创建过程可能需要2-3分钟才能在 UrbanPiper Atlas 平台上反映更改。

• 店铺会自动以您的销售点名称命名.

门店营业时间

配置门店营业时间以定义配送服务何时可用：

1. 导航至 销售点 ‣ 配置 ‣ 门店营业时间 。

2. 点击 新建 添加一行，以新增一条时间记录，或编辑现有行。

3. 填写 星期 、开始时间 、结束时间 和 关联此时间的销售点 列。

产品

要使产品单独可用，

1. 转到 销售点 ‣ 产品 ‣ 产品 。

2. 选择任何产品以打开其产品表单。

3. 转到 销售点 选项卡。

4. 完成 Urban Piper 部分：

   • 在 可用的食品配送 中填写所需的销售点。

   • 可选地，设置 餐类型 字段，并启用 推荐 和 含酒精 按钮。

一次性使多个产品可用于食品配送

1. 转到 销售点 ‣ 产品 ‣ 产品 。

2. 点击列表图标 () 切换到列表视图。

3. 选择产品。

4. 在 可用于食品配送 列中输入所需的 POS。

注解

• 目前，UrbanPiper 不支持组合产品。

• 作为替代方案，可创建一个产品并将组合选项定义为属性与变体。

同步

要使产品在食品配送平台上可用，请与您的 UrbanPiper 账户同步：

1. 导航至 销售点（POS）设置。

2. 向下滚动到 食品配送连接器 部分。

3. 点击 同步菜单 按钮。

   • 创建店铺 和 同步菜单 按钮下方的 上次同步于 时间戳会更新。

注解

• 成功的同步会触发一个通知。

• 同步过程可能需要2-3分钟才能在UrbanPiper Atlas平台上反映更改。

上线

1. 转到您 Atlas 账户的“位置”选项卡。

2. 选择要激活的位置，然后点击 申请上线 。

   

3. 在弹出窗口中：

   1. 选择要激活的平台，并点击 下一步 。

   2. 在相应的字段中输入 平台 ID 和 平台 URL ，以建立该平台与 UrbanPiper 之间的连接。

   3. 点击 申请上线 按钮。

   

   注解

   如需查找门店的 平台 ID 和 平台 URL ，

   1. 点击该门店以打开其设置表单。

   2. 门店的相关参数可在 HUB 选项卡中查看。

4. 确认您的门店已上线：

   1. 转到您 Atlas 账户的“位置”选项卡。

   2. 在 关联平台 列中选择任意服务商，以查看该服务商平台在此门店的状态。

订单流程

通过已配置的配送平台下单会触发通知。要管理这些订单，请通过以下方式打开订单列表视图：

1. 在通知弹窗上点击 查看订单 。

2. 点击在线订单的袋形图标和 新建 。

   

   注解

   • 点击此图标会显示每个阶段的订单数量： 新建 、 进行中 和 已完成 。

   • 新建 按钮表示刚下单的订单， 进行中 表示已接受的订单， 已完成 表示可供配送的订单。

然后，

1. 选择目标订单。

2. 点击 接受 按钮。

3. 订单被接受后，其 订单状态 会从 已下单 切换为 已确认 ，并自动显示在备餐显示屏上。

当订单备好后，

1. 打开订单列表视图。

2. 选择该订单。

3. 点击 标记为已备好 按钮。其 订单状态 从 已确认 切换为 餐食就绪 ，其 状态 从 进行中 切换为 已支付 。

拒绝订单

有时，商店或餐厅可能需要 拒绝 某个订单。此时，打开订单列表视图，

1. 选择目标订单。

2. 点击 拒绝 按钮。

3. 在弹出窗口中选择一个原因。

重要

Swiggy 订单无法直接拒绝。尝试拒绝此类订单会促使 Swiggy 客服联系餐厅。类似地，Deliveroo、JustEat 和 HungerStation 也不允许拒绝订单。处理此类情况时，务必遵循各服务商的指引。