文档中心 > 酒店客栈

酒店取消订单请求

更新时间:2016/11/04 访问次数:11585
  • 场景
  1. 在符合退改规则的条件下,用户发起对订单进行取消
  2. 在不符合退改规则的条件下,用户与商家协商,商家发起取消
  3. 下单接口出现异常情况,长时间未拿到结果,给用户关闭后,发起取消补偿
  • 要求
  1. 根据去啊订单号做幂等处理,即同一订单,多次调用返回相同结果
  2. 不要求立即返回取消结果,可反馈接收成功,然后异步处理

第三方系统根据此接口定义实现取消订单方法,并暴露成服务。去啊系统实时调用第三方的取消订单服务来取消订单。

接收阿里旅行调用接口方式
1. 由第三方提供一个接收阿里请求的服务地址(注意:所有的接口请求均用这个相同的地址),以及用于验证的用户名和密码。
2. 第三方根据请求参数中的xml父节点区分业务请求类型,根据文档要求开发接收请求数据和返回相应的数据

请求参数

名称

类型

是否必须

最大长度/取值范围

描述

示例值

Username

String

100

第三方系统接口调用需要校验时的用户名。

taobao

Password

String

100

第三方系统接口调用需要校验时的密码

taobao

CreateToken

String

255

单次请求token

taobao1387784033263-1387784033266

TaoBaoOrderId

Long

20

淘宝订单号

123455

OrderId

String

100

外部订单号(如果已获取)

OTA21544874

HotelId

String

64

OTA酒店code,即第三方系统中的酒店code

HZJT01

Reason

String

300

取消订单原因

行程修改

HardCancel

String

 

是否强制取消订单
默认false

true/false

XML示例:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<CancelRQ>

       <AuthenticationToken>

              <Username>taobao</Username>

              <Password>taobao</Password>

              <CreateToken>taobao125484778-1387789907859</CreateToken>

       </AuthenticationToken>

       <TaoBaoOrderId>21544874</TaoBaoOrderId>

       <OrderId>21544874</OrderId>

       <HotelId>HZJT01</HotelId>

       <Reason>reason</Reason>

<HardCancel>true</HardCancel>

</CancelRQ>

返回结果(成功)

名称

类型

是否必须

限制范围

描述

示例值

Message

String

100

处理结果

处理成功

ResultCode

String

0 参见ResultCode描述表

处理结果,0表示成功

0

OrderId

String

100

OTA订单id,即第三方系统中的订单id

21544874

XML示例:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<Result>

       <Message>成功</Message>

       <ResultCode>0</ResultCode>

     <OrderId >21544874</OrderId >

</Result>

返回结果(失败)

名称

类型

是否必须

限制范围

描述

示例值

Message

String

300

 

错误原因

取消失败

ResultCode

String

参见ResultCode描述表

错误码

-200

XML示例:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>

<Result>

       <Message>取消失败</Message>

       <ResultCode>-200</ResultCode>

</Result>

返回结果定义表

以下是第三方接到取消订单请求后,处理成功或失败时应该返回的结果。此表已定义结果类型不会修改,但可能会根据业务情况进行增补。

ResultCode

Message

备注

0

取消成功

 取消成功返回值

-200

取消失败

 所有其它失败返回此值。并在Message中写明原因,已经第三方的错误码

-204

不存此订单

 订单不存在时候返回此值

-205

订单已取消

 订单已经取消返回此值

-206

退订政策不允许取消

当与退订政策不符合时候返回此值。并在Messsage中写明当前酒店退订政策。

-100

异步取消

当卖家系统实现为异步取消时候返回此值,阿里平台会进行查询取消结果

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部