订单网络异常处理流程

背景#

华住分销平台与分销商服务端采用互联网通信,传输中无法避免超时等网络异常因素,下述内容主要针对此类问题进行描述及应对方法说明。

网络异常定义#

  1. Connection timeout
  2. Connection read timeout
  3. Connection reset
  4. 其他网络引起的异常(Http状态码非200且非4XX)

用户故事#

在分销商系统发出请求后,由于网络异常,分销商系统无法收到华住系统真实的响应,此时,订单可能已产生,针对此类订单,双方务必遵守此文档给出的方案进行处理,未处理将需承担相应的酒店损失。通常,网络异常情况有如下两种:

1. 请求未到华住分销系统
2. 请求到达华住分销系统,传输或响应超时

处理方案#

预订结果补偿确认#

调用预订接口时,未收到华住分销系统的任何响应或收到Http状态码非200且非4XX的响应,需在8分钟内多次调用补偿查询预订结果接口进行预订结果确认(频率建议:8分钟内不超过16次/每单)。
8分钟内补偿查询到预订结果,则此笔订单记为分销商系统产生有效预订订单(有效预订订单需结算给门店。如分销商系统该订单无效,则建议调用取消接口进行取消);超过8分钟未补偿查询到预订结果,则此笔订单记为失败。

补偿查询中若出现网络异常时,此类订单需在24小时内人工介入通知华住一同确认订单状态。
补偿查询会返回华住订单号和订单状态,当收到订单状态为HOTEL_FAILED可认定为失败,无需继续进行补偿查询。

附:网络异常预订处理流程#

网络异常预订流程#

  1. 图中网络异常,分销商未收到来自华住系统的响应(Http状态码为200的响应),务必在八分钟内通过补偿查询预订结果接口进行预订结果确认。

networkerror1