第三方系统根据此接口定义实现取消订单方法,并暴露成服务。去啊系统实时调用第三方的取消订单服务来取消订单。
接收阿里旅行调用接口方式
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 |
否 |
|
是否强制取消订单 |
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 |
异步取消 |
当卖家系统实现为异步取消时候返回此值,阿里平台会进行查询取消结果 |