此页面由 Cloud Translation API 翻译。

履单时间和费用

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

费用和支持履单时间用例
关于如何为指定履单时间和费用的具体说明服务 Feed。
对准确性的期望

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

费用

我们提供了多种不同的费用指定方式，例如：

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

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

不支持根据信息收费的用例用户的信息

费用示例

配送和自提费用

应用支持“DELIVERY”和“SERVICE”费用类型。

送餐

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

服务

{
  "fee": {
    "fee_id": "12345/service_fee",
    "fee_type": "SERVICE",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

不同的费用类型

下文简要介绍了指定所选费用的一些简单示例。类型。

固定

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "fixed_amount": {
      "currency_code": "USD",
      "units": 10,
      "nanos": 0
    },
    "service_ids": ["service/entity002"]
  }
}

购物车百分比

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "cart_percentage": {
      "base_value": {
        "currency_code": "USD",
        "units": 3,
        "nanos": 500000000
      },
      "percentage_of_cart_value": 10
    },
    "service_ids": [
      "service/entity002"
    ]
  }
}

Range

{
  "fee": {
    "fee_id": "12345/delivery_fee",
    "fee_type": "DELIVERY",
    "range_amount": {
      "min_amount": {
        "currency_code": "USD",
        "units": 3,
        "nanos": 500000000
      },
      "max_amount": {
        "currency_code": "USD",
        "units": 5,
        "nanos": 600000000
      }
    },
    "service_ids": [
      "service/entity002"
    ]
  }
}

履单时间

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

固定时间：“30 分钟后送达”或“15 分钟后抵达”
时间范围：“在 30 分钟 - 1 小时内送达”或“15-20 分钟后抵达”

可以使用通用格式为自提和送货指定履单时间（如下所述）。

不支持需要根据用户信息更改加大型文字广告的用例。

履单时间示例

服务 Feed 中包含操作链接的订单履行时间 ETA 作为 FoodOrderingService 字段。

固定

{
    "service": {
        "service_id": "service-id",
        "service_type": "TAKEOUT",
        "parent_entity_id": "entity-id",
        "lead_time": {
            "min_lead_time_duration": "900s"
        },
        "action_link_id": "action-link-id"
    }
},

时间范围

{
    "service": {
        "service_id": "service-id",
        "service_type": "TAKEOUT",
        "parent_entity_id": "entity-id",
        "lead_time": {
            "min_lead_time_duration": "900s"
            "max_lead_time_duration": "1200s"

        },
        "action_link_id": "action-link-id"
    }
},

履单时间范围

使用 ServiceHours，可以为特定时间范围设置履单时间。默认 lead_time在已使用 FoodOrderingService 。

在此示例中，lead_time 的 2400s 将在上午 11:00 到下午 1:30 期间显示。
1200s的lead_time将在前上午 11:00 和下午 1:30 后。

{
  "data": [
    {
      "service": {
        "service_id": "merchant-1-service-delivery",
        "service_type": "DELIVERY",
        "parent_entity_id": "merchant-1",
        "lead_time": {
          "min_lead_time_duration": "1200s"
        },
        "action_link_id": "merchant-1-takeout-delivery-action"
      }
    },
    {
      "service_hours": {
        "hours_id": "merchant-1-advance-hours-delivery",
        "service_ids": ["merchant-1-service-delivery"],
        "asap_hours": [
          {
            "time_windows": {
              "time_windows": {
                "open_time": {
                  "hours": 11
                },
                "close_time": {
                  "hours": 13,
                  "minutes": 30
                }
              }
            },
            "lead_time": {
              "min_lead_time_duration": "2400s"
            }
          }
        ]
      }
    }
  ]
}

费用和履单时间准确性

费用准确性

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

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

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

订单履行时间准确性

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

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

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

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

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

及时更新费用和预计到达时间

通过普通 Feed 上传进行更改可能需要至少 2 个小时处理。如果您计划更改加大型文字广告，请务必注意这一点。

强烈建议合作伙伴实现实时更新，这样一来，API 调用便可在 5 分钟内更改服务 Feed（包括费用和预计到达时间）。

服务 Feed

Feed proto 软件包