通过该接口,允许用户可以向酒店发起催确认/催离店/催结账等多种催促动作,满足用户对于订单流转信息的快速获取,提升体验。
第三方系统根据此接口定义实现催促订单方法,并暴露成服务。去啊系统实时调用第三方的查询订单服务来获取订单详细信息。
接收阿里旅行调用接口方式
1. 由第三方提供一个接收阿里请求的服务地址(注意:所有的接口请求均用这个相同的地址),以及用于验证的用户名和密码。
2. 第三方根据请求参数中的xml父节点区分业务请求类型,根据文档要求开发接收请求数据和返回相应的数据
请求参数
名称 |
类型 |
是否必须 |
最大长度/取值范围 |
描述 |
示例值 |
Username |
String |
是 |
100 |
第三方系统接口调用需要校验时的用户名 |
taobao |
Password |
String |
是 |
100 |
第三方系统接口调用需要校验时的密码 |
taobao |
CreateToken |
String |
是 |
255 |
单次请求token |
taobao1387784033263-1387784033266 |
TaoBaoOrderId |
long |
是 |
|
taobao订单id |
524148745 |
CheckIn |
Timestamp |
是 |
yyyy-MM-dd |
入住时间 |
2016-09-20 |
CheckOut |
Timestamp |
是 |
yyyy-MM-dd |
离店时间 |
2016-09-21 |
Remark |
String |
是 |
1000 |
用户备注 |
请求快速确认订单 |
UrgeType |
int |
是 |
10 |
催促请求类型 1 催确认;2催取消;3崔结账 |
1 |
XML示例:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <UrgeRQ> <AuthenticationToken> <Username>taobao</Username> <Password>taobao</Password> <CreateToken>taobao1230123213-1387792484913</CreateToken> </AuthenticationToken> <TaoBaoOrderId>1230123213</TaoBaoOrderId> <CheckIn>2015-08-10</CheckIn> <CheckOut>2015-08-12</CheckOut> <Remark>请求快速确认订单</Remark> <UrgeType>1</UrgeType> </UrgeRQ> |
返回结果(成功)
名称 |
类型 |
是否必须 |
限制 范围 |
描述 |
示例值 |
Message |
String |
是 |
100 |
处理结果 |
成功 |
ResultCode |
String |
是 |
取值: 0 |
处理结果,0表示成功 |
0 |
XML示例:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Result> <Message>成功</Message> <ResultCode>0</ResultCode> </Result> |
返回结果(失败)
名称 |
类型 |
是否必须 |
限制范围 |
描述 |
示例值 |
Message |
String |
是 |
300 |
错误原因 |
处理失败 |
ResultCode |
String |
是 |
取值: -1 |
错误码 |
-1 |
SubMessage |
String |
是 |
300 |
具体失败原因(-101:等待处理;-102:处理失败) |
处理等待 |
SubCode |
String |
是 |
取值: -101,-102 |
具体失败原因(-101:等待处理;-102:处理失败) | -101 |
XML示例:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Result> <Message>失败</Message> <ResultCode>-1</ResultCode> <SubMessage>等待处理</SubMessage> <SubCode>-101</SubCode> </Result> |