履单时间和费用

本教程介绍了以下内容：

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

如需查看展示履单时间和费用使用情况的完整 Feed 示例，请参阅订购重定向 EPA 示例。

费用和履单时间用例

费用用例

我们提供了多种不同的费用指定方式。下面几点介绍了所支持的不同用例，以及一些类似于用户在前端看到的语言的示例语言。

  • 固定费用：“运费 $5”或“服务费 $5”
  • 按百分比收取运费：“运费 5%”或“服务费为 5%”
  • 费用范围：“运费：2-10 美元”或“服务费：3%-6%”
  • 开放式范围：“运费低至 5%”或“服务费最高为 20 美元”

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

不支持需要全天更新费用或根据用户信息进行更改的用例。

履单时间应用场景

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

  • 固定时间：“30 分钟后送达”或“15 分钟后送达”
  • 时间范围：“30 分钟 - 1 小时内送达”或“15-20 分钟后送达”
  • 开放式时间范围：“10 分钟内送达”或“1 小时内送达”

可以使用通用格式（如下所述）为自提和送货指定履单时间。如上例所示，向用户显示的文本将反映操作链接中指定的履单类型。

不支持需要全天更新时间或根据用户信息进行更改的用例。

通过 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
    }
  }
}

通过 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"
      }
    }
  }
]

费用和履单时间准确性

费用准确性

当您向商家提供费用数据时，我们希望您准确说明费用。您应包括订单适用的所有运费和服务费。

我们知道，费用可能会因时间和用户而异。因此，我们提供了以范围（包括开放式范围）的形式指定费用的功能。如果费用差异很大，请确保提供的范围包含用户在交易过程中可能会看到的费用。

如果您不确定自己的具体需要满足什么要求，请与您的 Actions Center 联系人联系。

履单时间准确性

我们理解，履单时间的具体细节取决于多种因素。这些因素包括：

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

上述任一因素都可能会导致以下情况：最初向用户显示的订单履单时间并不是他们在结账时会看到的确切履单时间。执行时间实现的目标不是完全消除这些类型，而是尽可能多地向用户提供清晰的信息。

合作伙伴应尽最大努力提供尽可能频繁地向用户显示准确的执行时间的实现。如果由于这些因素导致时间明显差异，我们建议您提供一个涵盖该变化的时间范围。 此外，如果履单时间确实因订单详情而发生变化，则应在商品送达时向用户明确显示这一点。

如果您不确定自己的具体需要满足什么要求，请与您的 Actions Center 联系人联系。