> ## Documentation Index
> Fetch the complete documentation index at: https://docs.maple.inc/llms.txt
> Use this file to discover all available pages before exploring further.

# 配送配置

> 为您的餐厅设置配送范围、费用和配送服务商

Maple 支持配送订单，可灵活配置配送范围、费用和骑手管理。您可以使用第三方配送服务商（DSP）网络、您自己的骑手团队（BYOF），或两者结合。

## 配送模式

<Tabs>
  <Tab title="Maple Fleet (DSP)" icon="truck">
    Maple Fleet 将您的餐厅连接到由配送服务商（DSP）组成的网络，包括 DoorDash Drive 和 Uber Direct。Maple 会自动处理骑手分配、跟踪和状态更新。

    **工作方式：**

    * 顾客通过 Maple 下配送订单
    * Maple 向 DSP 网络请求配送报价
    * 分配骑手并派往您的餐厅
    * 顾客通过短信收到实时状态更新
    * 配送费和小费通过 Maple 处理

    **适合：** 没有自己的配送骑手的餐厅，或在高峰时段作为补充运力。
  </Tab>

  <Tab title="Bring Your Own Fleet (BYOF)" icon="user-group">
    使用您自己的配送骑手。Maple 负责接单，并将配送详情发送给您的团队。

    **工作方式：**

    * 顾客通过 Maple 下配送订单
    * 订单连同配送详情发送到您的 POS 系统
    * 由您的团队负责分配骑手和派单
    * 您自行定义配送范围和费用

    **配置选项：**

    * 为所有 BYOF 订单设置默认配送费
    * 定义配送范围，控制覆盖区域
    * 可选择是否在配送订单中接受小费

    **适合：** 已有配送人员、希望继续使用自己骑手的餐厅。
  </Tab>

  <Tab title="Hybrid" icon="arrows-split-up-and-left">
    近距离配送使用 BYOF，较远距离的订单或补充运力则使用 DSP 网络。

    **工作方式：**

    * 为您的骑手能覆盖的区域定义 BYOF 范围
    * BYOF 范围之外的订单会自动转给 DSP 网络
    * 您的车队无法接单时可无缝切换

    **适合：** 希望自己负责近距离配送，同时扩大配送半径的餐厅。
  </Tab>
</Tabs>

## 设置配送

<Steps>
  <Step title="启用配送">
    在 Maple 控制台中进入配送设置，并选择您的配送模式（Maple Fleet 或 BYOF）。
  </Step>

  <Step title="配置配送范围">
    定义您提供配送的地理区域。您可以创建多边形范围（自定义形状）或圆形范围（基于半径）。
  </Step>

  <Step title="设置费用和起送额">
    为每个范围配置配送费、最低订单金额和预计送达时间。
  </Step>

  <Step title="测试配送">
    下一笔测试配送订单，以验证范围覆盖、费用计算和订单路由。
  </Step>
</Steps>

## 配送范围

配送范围定义了您的餐厅可以配送的区域。每个范围都有各自的费用、最低订单金额和预计送达时间。

### 范围类型

| 范围类型 | 说明 | 适合 |
| - | - | - |
| **多边形** | 在地图上自定义绘制的形状 | 精确的覆盖区域、城市边界 |
| **圆形** | 以您的门店为中心、基于半径的范围 | 简单的设置，各个方向覆盖均匀 |

**多边形范围**可让您在地图上自由绘制边界。当您的配送区域沿街道、公路或其他不规则边界时，请使用这种方式。

**圆形范围**以您门店所在位置为中心，按半径（单位为英里）定义。系统会自动生成边界——您只需设置距离。当您希望各个方向覆盖均匀时，圆形范围很有用。

<Info>
  两种范围类型在下单时的工作方式相同。当顾客提供配送地址时，Maple 会检查该地址是否位于范围边界内。对于圆形范围，边界是您所设半径的近似值。
</Info>

### 范围设置

为每个配送范围配置以下内容：

| 设置 | 说明 |
| - | - |
| **Delivery fee**（配送费） | 向顾客收取的固定配送费 |
| **Minimum order**（最低订单金额） | 低于此金额的订单无法下单配送 |
| **Estimated time**（预计时间） | 下单时向顾客显示的预计送达时间 |
| **Zone priority**（范围优先级） | 范围重叠时，优先级较高的范围优先生效 |

<Info>
  您可以创建多个费用和起送额各不相同的范围。例如，近处区域收取较低的费用，较远的区域收取较高的费用。
</Info>

## 取餐说明

如果您使用 Maple Fleet (DSP) 网络，可以为骑手提供取餐说明。这些说明会告诉骑手如何以及在哪里到您的餐厅取餐。

进入您门店的配送设置，在文本框中输入取餐说明。示例：

* "Enter through the side door on Oak Street"（从 Oak Street 的侧门进入）
* "Ask for the online order at the front counter"（在前台询问网上订单）
* "Ring the buzzer and say you're picking up a delivery order"（按门铃，并说明是来取配送订单）

## 配送订单的付款

<Warning>
  配送订单需要预先用银行卡付款；但由您自己的骑手配送时除外——此时顾客可以在送达时付款（需 POS 系统支持到店付款）。Maple Fleet 的配送始终要求预先用银行卡付款。
</Warning>

配送订单的付款通过您配置的支付服务商（Stripe、Gravity 或 Shift4）处理，之后订单才会发送到您的 POS 系统。配送费会根据顾客的配送地址和您的范围配置自动加入订单总额。

<Warning>
  **通过 StreamOrders 对接 Toast 的门店：送达时付款需要在 StreamOrders 中启用现金。** 如果您接受通过 StreamOrders 发送到 Toast 的送达时付款（到店付款）订单，则必须在 StreamOrders 中将**现金**启用为配送可接受的付款方式。否则 Toast 会拒绝该订单（`decision_failed` / "payment method declined"），订单也不会到达后厨。请参阅[StreamOrders: accepted payment methods](https://help.streamorders.com/en/articles/13441016)。
</Warning>

### 配送费结算

配送费如何结算取决于您的支付处理商：

* **Stripe 商户：** Maple 直接收取配送费。
* **非 Stripe 商户：** 配送费会作为一行明细加入订单，由您在结账时收取，随后 Maple 再向您开具账单收回。这是净额为零的代收代付——并非额外收费。

## 配送订单流程

<Steps>
  <Step title="顾客下单">
    顾客致电或发短信给 Maple 并要求配送。AI 会收集其配送地址。
  </Step>

  <Step title="地址验证">
    Maple 检查该地址是否在您的配送范围内，并计算配送费。
  </Step>

  <Step title="订单确认">
    AI 会与顾客确认订单、配送费和预计送达时间。
  </Step>

  <Step title="付款处理">顾客通过银行卡预先付款。配送费已包含在总额中。</Step>
  <Step title="订单发送到后厨">订单会提交到您的 POS 系统进行备餐。</Step>

  <Step title="派单">
    对于 Maple Fleet 订单，系统会自动分配并派出骑手。对于 BYOF，由您的团队负责派单。
  </Step>

  <Step title="状态更新">
    随着配送进展（已分配骑手、已取餐、配送中、已送达），顾客会收到短信更新。
  </Step>
</Steps>

## 故障排查

<AccordionGroup>
  <Accordion title="顾客的地址无法配送">
    顾客的地址可能在您配置的配送范围之外。请在控制台中检查您的范围边界，并在需要时扩大范围。AI 会告知顾客，并提供自取作为替代方案。
  </Accordion>

  <Accordion title="配送费显示不正确">
    请核对每个配送范围的费用设置。如果范围重叠，则使用优先级较高的范围的费用。
  </Accordion>

  <Accordion title="Maple Fleet 订单没有被分配骑手">
    请确保您的 Maple Fleet 设置已完成，并且已为您所在的地区配置配送区域。在需求高峰期，骑手的可用性可能有限。如果持续无法分配，请联系 Maple 支持。
  </Accordion>
</AccordionGroup>

## 抢先体验

对 Maple Fleet 配送感兴趣吗？我们正在与部分合作伙伴合作。

<Card title="申请 Maple Fleet 使用权限" icon="truck" href="mailto:aidan@maple.inc?subject=%5BCOMPANY%20NAME%5D%20-%20Maple%20Delivery%20Early%20Access">
  发送邮件给我们，开始使用 Maple Fleet 配送
</Card>

## 后续步骤

<CardGroup cols={2}>
  <Card title="配置支付" icon="credit-card" href="/zh/orders/config/payment-methods">
    设置支付处理
  </Card>

  <Card title="菜单管理" icon="utensils" href="/zh/orders/config/menu-management">
    管理您的菜单
  </Card>

  <Card title="Orders 概览" icon="cart-shopping" href="/zh/orders/overview">
    返回 Orders 概览
  </Card>

  <Card title="正式上线" icon="badge-check" href="/zh/going-live">
    启用您的 Maple AI
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.