履单时间和费用（仅限旧版）

<ph type="x-smartling-placeholder">。 <ph type="x-smartling-placeholder">

本教程将逐步介绍以下内容：

  1. 费用和支持履单时间用例
  2. 关于如何为 指定履单时间和费用的具体说明 action_link 在您的 Feed 中
  3. 对准确性的期望

有关展示履单时间和费用使用情况的完整 Feed 示例，请参阅 订单重定向 EPA 示例。

费用和履单时间用例

费用用例

我们提供了多种不同的费用指定方式。以下几点介绍了 支持的情况，并提供一些类似于用户在 前端。

  • 固定费用：“运费 5 元”或“5 美元服务费”
  • 百分比：“配送费 5%”或“服务费 5%”
  • 费用范围：“运费 2-10 美元”或“服务费：3%-6%”
  • 开放式范围：“运费最低为 5%”或“不超过 20 美元的服务费”

如上面的示例所示，费用可以指定为运费或服务费。 您还可以指定多项费用（例如“服务费为 5%-10%，配送费为 5 美元”）。

不支持需要全天更新费用或更改费用的用例 生成自定义代码。

“Fulfillment Time”用例

我们支持使用多种不同的格式来指定空闲时间，这样可确保您 提供准确的数据。以下几点介绍了支持的不同用例，以及 并提供一些类似于用户在前端看到的示例语言

  • 固定时间：“30 分钟后送达”或“15 分钟后抵达”
  • 时间范围：“30 分钟 - 1 小时内送达”或“15-20 分钟后抵达”
  • 打开结束时间范围：“超过 10 分钟后送达”或“1 小时内到账”

可以使用通用格式为自提和送货指定履单时间 （如下所述）。如上面的示例所示，向用户显示的文字将 反映订单的 type。

不支持需要一天中更新时间或需要更改时间的用例 生成自定义代码。

通过 Feed 指定订单履行时间

商家 Feed 中包含操作链接的订单履单时间 action_link 作为 food_ordering_metadata 字段。对于每个 action_link 与商家关联的商品时，需要提供履单信息 使用其中一个消息路径。

固定履单时间

  • Merchant.action_link.food_ordering_metadata.fulfillment_lead_time_duration

此消息应采用以下格式：

{
  "fulfillment_lead_time_duration": {
    "seconds" : 1800
  }
}

范围履单时间

  • Merchant.action_link.food_order_metadata.fulfillment_lead_time_duration_range

此消息应采用以下格式：

{
  "fulfillment_lead_time_duration_range": {
    "min_duration": {
       "seconds" : 1800
     },
    "max_duration": {
     "seconds" : 2400
    }
  }
}
<ph type="x-smartling-placeholder">。 <ph type="x-smartling-placeholder">。 <ph type="x-smartling-placeholder">。 <ph type="x-smartling-placeholder">

通过 Feed 指定费用

与履单时间类似，费用也可包含在 food_ordering_metadata 下方有 action_link 消息 字段。对于与商家关联的每个action_link，您可以 使用以下消息路径提供费用信息：

merchant.action_link.food_ordering_metadata.fee_details

以下是不同用例的几个示例。
  • 1.99 美元的固定运费： 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "1",
        "nanos": "990000000"
      }
    }
  }
]
  • 配送费百分比为 5.6%。 
    [
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "5.6"
      }
    }
  }
]
  • 服务费在 1.99 美元到 9.99 美元之间 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount_range": {
        "min_amount": {
          "currency_code": "USD",
          "units": "1",
          "nanos": "990000000"
        },
        "max_amount": {
          "currency_code": "USD",
          "units": "9",
          "nanos": "990000000"
        }
      }
    }
  }
]
  • 服务费百分比介于 1.2% 到 2.7% 之间 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "cart_percentage": {
        "value_range": {
          "min_value": "1.2",
          "max_value": "2.7"
        }
      }
    }
  }
]
  • 两笔费用、5 美元服务费和 1.2% 的配送费。 
    [
  {
    "type": "SERVICE",
    "fee_amount": {
      "amount": {
        "currency_code": "USD",
        "units": "5",
        "nanos": "0"
      }
    }
  },
  {
    "type": "DELIVERY",
    "fee_amount": {
      "cart_percentage": {
        "value": "1.2"
      }
    }
  }
]
。 <ph type="x-smartling-placeholder">

费用和履单时间准确性

费用准确性

在为商家提供费用数据时，我们希望您能准确陈述 费用。您应将可能适用于某个订单的所有送货和服务费都包含在内。

我们理解，费用可能因用户而异，并可能因用户而异。因此，我们提供了 能够以范围（包括开放式范围）指定费用。在费用可能会有所不同的情况下 显著确保所提供的范围包含用户在观看 进行交易

如果您不确定具体需要满足哪些要求，请与您的 Actions Center 联系人。

订单履行时间准确性

我们知道 会随着时间的变化而变化这些因素包括：

  • 根据订单大小更改订单履行时间
  • 根据完成订购和 结账
  • 通过 Feed 更新履单时间变更之间的延迟时间
  • 用户的送货地址。

这些因素中的任何一个都可能导致履单 最初向用户显示的时间并非他们的确切履单时间 结账时会看到的标签。实现履单时间的目标不是 但要像以前一样 。

合作伙伴提供的实现方式应能确保 尽最大努力尽可能频繁地向用户显示履单时间 基础。如果由于这些因素而导致时间出现显著变化，我们建议您 您需要提供一个包含该变化的时间范围 此外，如果履单时间因订单详情而发生变化， 当商品送达您的订餐流程中时，应向用户清楚显示此信息。

如果您不确定具体是什么 请与您的操作中心联系人联系。