创建订单
请求方式:http,返回json格式。
订单30秒视为超时。
请求多天数的订单,每天取消规则不同时,以最严格的那天为准。
接口地址
名称 |
请求格式 |
测试地址 |
创建订单 |
POST |
http://58.250.56.5:8158/api/order/createOrder.json?reqData=xxx |
系统输入参数
名称 |
编码 |
类型 |
示例值 |
描述 |
客户编号 |
appKey |
String |
SZ28276 |
捷旅提供 |
房间数量 |
roomNum |
Integer |
2 |
几个RoomGroup就是对应几间房 |
时间戳 |
timestamp |
String |
1516816895000 |
Unix时间戳 |
数字签名 |
sign |
String |
063cae11a00896187f80eecbf922364a |
签名方法:md5(md5(secretKey+appKey)+timestamp)md5采用32位小写。 |
版本 |
version |
String |
3.0.1 |
版本信息,请参考版本说明 |
系统输出参数
名称 |
编码 |
类型 |
示例值 |
描述 |
结果代码 |
code |
Integer |
0 |
0表示请求成功;非0表示存在业务异常。 |
结果描述 |
errorMsg |
String |
|
错误描述 |
版本 |
version |
String |
|
3.0.1 |
结果对象 |
result |
String |
|
不同的请求是不同的对象,错误的请求一般返回为空 |
响应码 |
respId |
String |
|
单次响应的唯一编码,业务问题排查请提供编码 |
输入参数
名称 |
编码 |
类型 |
是否必填 |
示例值 |
描述 |
客户订单号 |
customerOrderCode |
String |
是 |
|
无 |
酒店编号 |
hotelId |
Integer |
是 |
|
无 |
产品编号 |
keyId |
String |
是 |
|
无 |
入住日期 |
checkInDate |
String |
是 |
|
yyyy-MM-dd |
离店日期 |
checkOutDate |
String |
是 |
|
yyyy-MM-dd |
每日价格 |
nightlyPrices |
String |
是 |
|
200.58|120.6|120.8 |
总金额 |
totalPrice |
Double |
是 |
|
|
房间信息 |
roomGroups |
RoomGroup[] |
是 |
无 |
常用设置为1个房间2个成人,几个RoomGroup就是对应几间房 |
给酒店备注 |
hotelRemark |
String |
否 |
|
|
属性
名称 |
编码 |
类型 |
是否必填 |
示例值 |
描述 |
入住人姓名 |
checkInPersions |
CheckInPersion[] |
是 |
|
|
成人数 |
adults |
Integer |
是 |
|
默认:入住人姓名对象size |
儿童数 |
children |
Integer |
否 |
|
|
儿童年龄 |
childAges |
String |
否 |
|
儿童年龄(多个时用逗号分割)。年龄的个数需要和儿童数保持一致 |
属性
名称 |
编码 |
类型 |
是否必填 |
示例值 |
描述 |
入住人的姓 |
lastName |
String |
是 |
张 |
不能包含特殊字符 |
入住人的名 |
firstName |
String |
是 |
三 |
不能包含特殊字符 |
国籍 |
nationality |
String |
否 |
CHN |
三位字母 参考http://doc.chacuo.net/iso-3166-1(字段非必传,但港澳及境外酒店不传可能存在导致客人因国籍问题导致无法入住的风险) |
输入示例
{"head":{"appKey":"SZ28276","timestamp":"1516816895000","sign":"063cae11a00896187f80eecbf922364a","version":"3.0.1"},"data":{"customerOrderCode":"R15644321358","hotelId":171870,"keyId":"SGS8GA#4A2SG#S2F262#S2F244#A||13#1318581569168081061#||EQW7PWEPEW","checkInDate":"2017-12-21","checkOutDate":"2017-12-23","nightlyPrices":"601|601","roomGroups":[{"adults":2,"checkInPersions":[{"lastName":"姓名","firstName":"test"}]}],"hotelRemark":"酒店备注","totalPrice":1202.0}}
返回参数
名称 |
编码 |
类型 |
示例值 |
描述 |
订单编号 |
orderCode |
String |
JLA20118010978888 |
|
订单状态 |
orderStatus |
Integer |
无 |
1:待确认、2:已确认、3:已拒单、4:已取消、5:已入住 |
返回示例
返回示例
{"code":0,"errorMsg":"","result":{"createOrder":{"orderCode":"JLA20118010955385","orderStatus":2}},"respId":"27c8689c-8fa1-4999-8e00-f6847df96ed1"}