UrbanPiper 在线食品配送集成指南 | Odoo 配置与使用

作者： /

在线食品配送

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

支持的提供商：

配置

前置条件

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

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

    :::: note
    ::: title
    注意
    :::
    如有关于 UrbanPiper 订阅的疑问，请联系绑定至您 Odoo 数据库的客户经理。
    ::::

  • Odoo 要求：

    • Odoo 订阅：需要有效的 Odoo Enterprise 订阅，Community 版不支持此集成。
    • Odoo 版本：Enterprise 版本 18.0 或以上。
    • Odoo 平台：支持所有 Odoo 平台，包括 Odoo Online、Odoo.sh 与本地部署。

  • 配送平台经销商账户：每个要集成的配送平台（如 Uber Eats、DoorDash、Careem、Deliveroo、Zomato）都需拥有已注册的经销商账户。

UrbanPiper 凭证 {#online_food_delivery/credentials}

  1. 获取 Atlas 凭证：
    1. 前往 POS 设置 <configuration/settings>。
    2. 滚动至 食品配送连接器 区段。
    3. 点击 填写此表单以获取用户名 & API 密钥 并完成调查。
  2. 前往您的 Atlas 账户，在 设置 → API 访问 中获取 API 密钥和用户名。

销售点 (POS)

  1. 启用 Urban Piper 设置：
    1. 前往 POS 设置 <configuration/settings>。
    2. 滚动至 食品配送连接器 区段。
    3. 勾选 Urban Piper。
  2. 配置 UrbanPiper：
    1. 在 用户名 与 API 密钥 字段填入您在 UrbanPiper 凭证 中获取的内容。
    2. 在 Urban Piper 位置 区段的 食品配送平台 字段选择需要的配送提供商（如 Zomato、Uber Eats）。
  3. 保存设置。
  4. 点击 + 创建店铺 按钮。此操作将在 UrbanPiper Atlas 平台上创建一个新位置。

:::: note
::: title
注意
:::

  • 保存后会自动选中 价目表 与 财务位置 字段。
  • 成功创建店铺会弹出通知。
  • 店铺创建过程可能需要 2–3 分钟才能在 Atlas 平台上反映。
  • 店铺名称会自动使用您的 POS 名称。
    ::::

店铺营业时间

配置店铺营业时间以确定配送服务的可用时段：

  1. 进入 销售点 → 配置 → 店铺营业时间。
  2. 点击 新建 添加新记录，或编辑已有记录。
  3. 填写 星期几、开始时间、结束时间 与 关联的销售点 列。

产品

单个产品上线

  1. 前往 销售点 → 产品 → 产品。
  2. 选中任意产品打开其表单。
  3. 切换到 销售点 选项卡。
  4. 完成 Urban Piper 部分：
    • 在 在食品配送上可用 中填写目标 POS。
    • 可选地设置 餐食类型，并启用 推荐 与 含酒精 按钮。

批量产品上线

  1. 前往 销售点 → 产品 → 产品。
  2. 点击列表图标 (oi-view-list) 切换至列表视图。
  3. 勾选需要的产品。
  4. 在 在食品配送上可用 列填写目标 POS。

:::: note
::: title
注意
:::

  • 目前 UrbanPiper 不支持组合产品。
  • 变通做法是创建单品并将组合选项定义为 属性 & 变体 <../sales/products_prices/products/variants>。
    ::::

同步

将产品同步至各食品配送平台：

  1. 前往 POS 设置 <configuration/settings>。
  2. 滚动至 食品配送连接器 区段。
  3. 点击 同步菜单 按钮。
    • 上次同步时间 会显示在 创建店铺 与 同步菜单 按钮下方。

:::: note
::: title
注意
:::

  • 同步成功会弹出通知。
  • 同步过程可能需要 2–3 分钟才能在 Atlas 平台上生效。
    ::::

正式上线

  1. 前往 Atlas 账户的 Locations（位置）页面。

  2. 选中要激活的地点，点击 请求上线。

  3. 在弹窗中：

    1. 选择要激活的平台并点击 下一步。
    2. 在对应字段填写 平台 ID 与 平台 URL，以建立平台与 UrbanPiper 的连接。
    3. 点击 请求上线 按钮。

    :::: note
    ::: title
    注意
    :::
    查找地点的 平台 ID 与 平台 URL 方法：

    1. 点击地点打开其设置表单。
    2. 在 HUB 选项卡中即可看到对应参数。
      :::

  4. 验证地点是否已上线：

    1. 再次进入 Atlas 的 Locations 页面。
    2. 在 关联平台 列中选择任意提供商，查看该平台的状态。

订单流程

通过已配置的配送平台下单后会触发通知。要管理这些订单，请：

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

  2. 点击在线订单的购物袋图标或 新建。

    :::: note
    ::: title
    注意
    :::

    • 图标下方会显示各阶段订单数量：新建、进行中、已完成。
    • 新建 表示刚下单的订单，进行中 为已接受的订单，已完成 为已准备好交付的订单。
      :::

随后：

  1. 选中目标订单。
  2. 点击 接受 按钮。
  3. 订单状态会从 已下单 变为 已确认，并自动显示在备餐显示屏上。

当订单准备完毕：

  1. 打开订单列表视图。
  2. 选中该订单。
  3. 点击 标记为已准备 按钮。
    • 订单状态从 已确认 变为 食物已准备好，
    • 状态列从 进行中 变为 已付款。

订单拒单

若店铺需 拒单，操作如下：

  1. 打开订单列表视图。
  2. 选中目标订单。
  3. 点击 拒单 按钮。
  4. 在弹窗中选择拒单原因。

:::: important
::: title
重要
:::
Swiggy 订单无法直接拒单，尝试拒单会促使 Swiggy 客服联系餐厅。Deliveroo、JustEat、HungerStation 亦不允许拒单。请务必遵循各平台的处理规范。
::::

滚动至顶部