设置取消期限

如何添加取消窗口

取消期限用于定义“取消”和“修改”按钮的有效时间。这意味着，取消和修改功能将无法在用户确认电子邮件中使用，并且将从所有其他界面（包括确认模态）中消失。

取消期限可通过两种方式启用：服务级和时段级。下文介绍了在这些级别指定窗口的流程。

如果同时设置了服务级取消期限和空档级取消期限，则空档级取消期限将生效。如果二者均未设置，则取消时段默认为时段开始时间（即用户可以在最后一刻取消）。

服务等级定义

您可以在 Service Feed 中指定 rules.min_advance_online_canceling 以启用服务级取消期限。此字段应设置为预订开始时间之前需要预订的秒数。例如，如果预订只能在开始时间前 24 小时取消，则此字段将设置为 86400（因此，如果预订时间为下午 3 点，则只能在前一天下午 3 点之前取消）。 这将应用于该服务的所有空档（除非被空档级别定义替换）。

JSON

{
  "service": [
    {
      "rules": {
        "min_advance_online_canceling": 86400
      }
    }
  ]
}

槽级定义

在可用性空档级别，该字段称为 scheduling_rule_overrides.last_online_cancellable_sec。此字段是可取消特定空档的最后时间（公元纪年时间戳）。这将应用于指定此属性的每个单独槽位。

JSON

"service_availability": [
  {
    "availability": {
      "scheduling_rule_overrides": {
        "last_online_cancellable_sec": 1468081800
        }
    }
  }
]

警告：在 Feed 中实现取消期限并不会使您无需实现和处理 BookingFailure OUTSIDE_CANCELLATION_WINDOW。在某些极端情况下（例如浏览器标签页卡顿），系统可能会在指定的取消期限之外发送 UpdateBooking。收到 UpdateBooking 后，您的系统必须确认更改是否在指定的取消期限内发生；如果没有，则应使用 UpdateBookingResponse.booking_failure = OUTSIDE_CANCELLATION_WINDOW 进行响应。