创建订单请求详解

更新时间：2024/06/03 访问次数：71950

场景

预订页面，客人完成信息录入，提交订单

要求

根据去啊订单号做幂等处理，即同一订单，多次调用返回相同结果，且在CRS不重复预订
不要求立即返回预订结果，反馈接收成功，然后异步处理
处理能力要有合理评估并告知，去啊会根据性能要求投放流量

第三方系统根据此接口定义实现预定订单方法，并暴露成服务。去啊系统在用户下单时调用第三方的预定订单服务来创建订单。

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

下单基本业务流程图：

请求参数

名称	类型	是否必须	最大长度/取值范围	描述	示例值
Username	String	是	100	第三方系统接口调用需要校验时的用户名。	taobao
Password	String	是	100	第三方系统接口调用需要校验时的密码	taobao
CreateToken	String	是	255	单次请求token	taobao1387784033263-1387784033266
TaoBaoOrderId	long	是		淘宝订单id，第三方需根据此id判断订单是否已经存在，以实现幂等和避免重复下单。	1387784033263
TaoBaoHotelId	long	是		淘宝酒店id	123456789
HotelId	String	是	64	OTA酒店id，即第三方系统中的酒店id	80
TaoBaoRoomTypeId	long	是		淘宝房型id	123456978
RoomTypeId	String	是	64	OTA房型id，即第三方系统中的房型id	1205
TaoBaoRatePlanId	long	是		淘宝价格计划id	123000123
RatePlanCode	String	是	64	OTA价格计划id，即第三方系统中的价格计划id	VIP
Channel	String	否	64	酒店投放渠道阿里员工协议价 : A 飞猪商旅用户价 : O 公开价: H	A
TaoBaoGid	long	是		淘宝酒店商品id	1234567890
CheckIn	Timestamp	是	yyyy-MM-dd HH:mm:ss	入住时间	2013-12-24
CheckOut	Timestamp	是	yyyy-MM-dd HH:mm:ss	离店时间	2013-12-26
HourRent	String	否	5	小时房字段，客人实际入住时长	3.5
EarliestArriveTime	Timestamp	是	yyyy-MM-dd HH:mm:ss	最早到店时间	2013-12-24 20:00:00
LatestArriveTime	Timestamp	是	yyyy-MM-dd HH:mm:ss	最晚到店时间	2013-12-24 22:00:00
RoomNum	int	是	取值：1-9	房间数量（最大为9）	1
Occupancy	int	是	取值：1-15	入住人数，目前支持一笔订单最多入住人数15。例如别墅订单存在多人的情况。	2
PriceType	int	否	取值：0,1	下单使用的价格类型：0默认值；1变价订单价格标记说明：如果是变价订单，则表示不需要做价格校验	0
IsMorningBuy	int	否	取值：0,1	是否为凌晨房，0不是，1是，默认0	0
InventoryType	int	否	取值：0,1,2,3,4	下单使用的库存类型： 0.未知；1限售库存；2保留房库存；3物理库存；4超预定库存	0
TotalPrice	long	是		订单总价（分）	63850
OtherFee	long	否		授权杂费金额（分）	50000
PaidPrice	long	否		已付金额(预付和在线预约场景下启用)	63850
TotalSellerPromotion	long	否		卖家优惠总金额	2000
GTPrice	long	否		订单担保金额(担保订单场景下启用)	63850
GTStartTime	Timestamp	否	HH:mm	担保生效时间(峰时担保场景下启用)	18:00
GTType	int	否	0,1,2	担保类型(0无担保、1首晚(峰时/全天)、2全额)	0
Currency	String	是	长度：30 取值： CNY	货币类型（现在只支持一种）	CNY
PaymentType	int	是	取值：1、5	订单实际支付方式1预付、5面付、6信用住（现在只有1、5、6）	5
ContactName	String	是	32	联系人姓名	公泰
ContactTel	String	是	32	联系人电话	138000000
ContactEmail	String	可选	255	联系人邮箱	123@taobao.com
DailyInfos	DailyInfos	是		每日价格
OriDailyInfos	List<DailyInfo>	否		每日原始价格	当存在卖家优惠的时候启用
DisDailyInfos	List<DailyInfo>	否		每日折扣价格	当存在卖家优惠的时候启动
Day	Date	是	yyyy-MM-dd	日期	2013-12-24
Price	long	是		价格（分）	12354
BreakFast	int	是		早餐数量	1
OrderType	int	否	取值0,1	订单类型0普通客户订单 1飞猪集团订单 2 代订订单	0
Company	String	否		公司名称	阿里巴巴集团
OrderGuests	OrderGuests	是		入住人信息
Name	String	是	32	姓名	张三
IdType	int	否	取值：0-99	入住人证件号码类型 0:身份证 1:护照 2:学生证 3:军官证 4:回乡证 5:台胞证 6:港澳通行证 7:国际海员 8:外国人永久居留（身份）证 9:其他证件 10: 警官证 11:士兵证 12:台湾通行证 13:入台证 14:户口簿 15:出生证明 16:中国驾照 17:港澳居民居住证 18:台湾居民居住证	0
IdCode	String	否	128	入住人证件号码,证件号码类型根据idType决定	123456789
RoomPos	int	是	取值：1-9	房间序号	1
PersonType	int	是	取值：1,2	1成人类型；2儿童类型
Age	int	否		年龄儿童必填，成人不需要关注年龄信息
Comment	String	否	255	备注、特殊需求	要安静的房间
CardCode	String	否	32	信用卡类型：AX美国运通卡，MC(MASTERCARD)，DC大莱，JC（JCB），VA（VISA）	AX，MC，DC，JC，VA
CardHolderName	String	否	256	持卡人姓名	张三
ExpirationDate	String	否	10	客人选择的有效期	格式: 月/年，例如：07/19
CardNumber	String	否	256	信用卡卡号	543546464545
CvvCode	String	否	64	信用卡ccv号	768
NeedInvoice	int	否	取值：0,1	是否要开发票	0不需要，1需要
EarllyPrepare	int	否	取值：0,1	是否要提前开发票	0不需要，1需要
SubmitTime	String	否	20	提交开发票请求时间	(格式yyyy-MM-dd HH:mm:ss)
WantTime	String	否	20	需要发票时间	(格式yyyy-MM-dd HH:mm:ss)
PostType	int	否	取值：0,1,2,3,4	发票领取方式	0：前台自取 1：邮寄 2：电子发票 3: 送至房间
InvoiceType	int	否	取值：1,2	发票类型	1:增值税普通发票；2:增值税专用发票
Comment	String	否	一段文本	开票项目	一段文本（例如：代订房费、住宿费、会议费、旅游费等）
InvoiceTitle	String	否		发票抬头
CompanyTel	String	否		公司电话
CompanyTax	String	否		公司税号
RegisterAddress	String	否		公司注册地址
Bank	String	否		开户行
BankAccount	String	否		银行账号
ReceiverAddress	String	否		邮寄地址
ReceiverName	String	否		收件人姓名
ReceiverMobile	String	否		收件人手机号
MemberName	String	否		会员姓名	李雷
MemberFliggyNum	String	否		飞猪会员编号	123456
MemberOutNum	String	否		OTA会员编号	222222
MemberIdCard	String	否		会员证件号码	33100419670324121X
MemberPhone	String	否		会员电话	12548604178
MemberEmail	String	否		会员邮箱	taobao@test.com
MemberFliggyLevel	String	否		飞猪会员等级	F1
MemberOutLevel	String	否		OTA会员等级	V1
BookMemberName	String	否		预订人会员名称	小李
BookMemberFliggyNum	String	否		预订人飞猪会员号	1122
BookMemberOutNum	String	否		预订人商家会员号	A123
BookMemberPhone	String	否		预订人会员电话	13434567856
BookMemberEmail	String	否		预订人会员邮箱	test@taobao.coom
BookMemberFliggyLevel	String	否		预订人飞猪会员等级	F1
BookMemberOutLevel	String	否		预订人飞猪商家等级	V1
GuaranteeType	String	否		担保类型	0 无担保 1 峰时首晚担保 2峰时全额担保 3全天首晚担保 4全天全额担保
AlipayTradeNo	String	否	64	支付宝交易号	支付宝交易号，只有预付的先付款后下单会有这个
VoucherInfos	VoucherInfos	否		订单优惠节点	当订单中含有优惠(房券/代金券/立减等)
VoucherPomotionAmt	String	否		卖家优惠金额	2000 单位：分
VoucherPomotionDesc	String	否		活动描述	双十一首晚优惠
VoucherRuleDesc	String	否		优惠规则描述	订单金额200以上
VoucherOutCode	String	否		商家活动编码	12345
VoucherTid	String	否	64	购买房券/代金券的订单id	123456789
VoucherId	String	否	64	房券/代金券ID	12345
VoucherNum	int	否		核销次数，房券时有效，默认0	1
PaidFee	long	否		用户购买一张在线预约房券/代金券真实付费金额(分)，默认0	9000
PackageInfo		否		订单关联包对象
Desp	String	否		订单维度所有关联包描述，分号分隔	每间3张北京植物园门票;每晚2份酒店SPA
DimensionType	String	否		使用维度：每间每晚每入住人	每晚
Quantity	int	否		数量	1
Unit	String	否		单位	张
Name	String	否		产品名称	北京植物园
SubDesp	String	否		单个礼包描述	每间3张北京植物园门票
Code	String	否		酒+X的外部code	test001
Extensions	String	否		扩展字段json，用于处理特殊OTA个性需求添加的扩展字段	{"key":"value"} 一些优惠信息等在扩展字段中传递，也可根据商家需求做增添。如： key: appoint_id 代表此订单中在线预约产品的订单号，具体值在对应的value中传输
TravelInfo	TravelInfo	否		商旅订单信息节点	子节点OrderType不为0，表示企业统一支付订单
OriginPaymentType	int	否		商品原始支付类型,1:预付,5: 面付,7: 预付在线预约	1
HourRoomArriveTime	Timestamp	否	yyyy-MM-dd HH:mm:ss	小时房字段，客人实际选择到店时间	2020-05-18 14:00:00
HourRoomLeaveTime	Timestamp	否	yyyy-MM-dd HH:mm:ss	小时房字段，客人实际选择离店时间	2020-05-18 18:00:00
OnlineBookingItemSellerPromotion	Long	否		在线预约宝贝(第一单)卖家优惠金额，单位分，可空	1000

注：1.DailyInfos和OrderGuests是两个复合类型，详见下面XML示例

2.Extensions 字段用于支持特殊OTA个性需求，普通的OTA不用关注

XML示例：

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

<Username>taobao</Username>

<Password>taobao</Password>

<CreateToken>taobao1387784033263-1387784033266</CreateToken>

</AuthenticationToken>

</GTInfo>

<ContactName>测试联系人</ContactName>

<ContactEmail >hello@taobao.com</ContactEmail >

</DailyInfo>

</DailyInfo>

</DailyInfos>

</DailyInfo>

</DailyInfo>

</OriDailyInfos>

</DailyInfo>

</DailyInfo>

</DisDailyInfos>

<Company>阿里巴巴去啊</Company>

</TravelInfo>

<PersonType>1</PersonType> //表示成人

</OrderGuest>

<PersonType>2</PersonType> //表示儿童

</OrderGuest>

</OrderGuests>

<MemberEmail>taobao@test.com</MemberEmail>

<BookMemberEmail>taobao@test.com</BookMemberEmail>

</MemberInfo>

<VoucherPomotionDesc>双十一首晚优惠</VoucherPomotionDesc>

</VoucherInfo>

</VoucherInfos>

<CardHolderName>zhuran</CardHolderName>

</CreditCardInfo>

<InvoiceTitle>淘宝(中国)软件有限公司</InvoiceTitle>

<RegisterAddress>浙江省杭州市余杭区文一西路001号</RegisterAddress>

<Bank>中国工商银行</Bank>

<ReceiverAddress>浙江省杭州市余杭区文一西路002号</ReceiverAddress>

</InvoiceInfo>

<Desp>每间3张北京植物园门票;每晚2份酒店SPA</Desp>

<Name>北京植物园</Name>

<SubDesp>每间3张北京植物园门票</SubDesp>

</PackageInfo>

<SubDesp>每晚2份酒店SPA</SubDesp>

</PackageInfo>

</PackageInfos>

</BookRQ>

返回结果（成功/失败）

名称	类型	是否必须	限制范围	描述	示例值
Message	String	是	100	处理结果	处理成功
ResultCode	String	是	0 参见ResultCode描述表	参见ResultCode描述表	0
OrderId	String	是	100	OTA订单id，即第三方系统中的订单id	21544874
PmsResID	String	否	100	PMS的确认单号	F15F190223
Comment	String	否	100	外部订单说明	渠道来源/其他标识信息
syncToHotel	String	否	2	是否把代理直签的订单同步到酒店，Y为同步，N不同步	Y

XML示例：

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

<Message>创建订单成功</Message>

<Comment> 渠道A订单</Comment>

</Result>

返回结果（异步）

名称	类型	是否必须	限制范围	描述	示例值
Message	String	是	100	第三方系统异步创建订单	接收到去啊订单
ResultCode	String	是	取值：0	处理结果，resultCode为0并且Message和OrderId为空表示为异步下单，已经接受到阿里旅行下单请求，需要在后续的查询消息中返回第三方订单号. （如果查询多次没有第三方订单号订单会自动失败）	0
OrderId	String	是	100	OTA订单id，即第三方系统中的订单id	21544874
syncToHotel	String	否	2	是否把代理直签的订单同步到酒店，Y为同步，N不同步	Y

XML示例：

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

</Result>

返回结果（失败）

名称	类型	是否必须	限制范围	描述	示例值
Message	String	是	300	错误原因	生成订单错误
ResultCode	String	是	取值：-100,-101,-102,-103,-104,-105	错误码，参见ResultCode描述表	-100

XML示例：

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

</Result>

返回结果定义表

以下是第三方接到创建订单请求后，处理成功或失败时应该返回的结果。此表已定义结果类型不会修改，但可能会根据业务情况进行增补。返回的错误码为-100，-102，去啊系统将会将下单对应的item下架。

特别说明：返回码为0并且Message和OrderId为空，表示第三系统收到去啊订单，第三方系统将会异步执行创建订单。

ResultCode	Message	备注
0	第三方订单id	resultCode为0并且Message和OrderId为空表示为异步下单
-100	生成订单失败:{具体原因}	请尽量用其他的更详细的失败错误码
-101	{ "reason": "满房", "dailyInventory": [{"date":"2015-04-03","inventory":0},{"date":"2015-04-04","inventory":0},{"date":"2015-04-05","inventory":1}] }	Json格式。预定的房型在用户选择的入离店日期内已经满房或者不接受预定。 dailyInventory是客户下单日期间的库存，date是格式yyyy-MM-dd的日期，inventory表示库存，0表示无库存。示例表示4月3日、4月4日无房，4月5日有1间房。去啊旅行将根据返回的库存信息将去啊系统里的库存更新。
-102	自定义原因	message填入详细信息。请尽量使用其他的更详细的错误码。
-103	{ "reason": "价格校验失败", "precisDailyPrice": [{"date":"2015-04-03","price":"18000"},{"date":"2015-04-04","price":"19000"}] }	淘宝酒店下单请求里的每日价格、总价与第三方系统的每日价格、总价不匹配。precisDailyPrice表示正确的第三方价格。去啊旅行将根据precisDailyPrice更新去啊系统里的价格。
-104	第三方系统异常	第三方系统接到请求后，系统异常不能创建订单，请返回此错误码。第三方系统返回此错误码，去啊系统将自动将卖家从搜索中屏蔽。
-105	不符合预订政策:{具体不符合的政策}	订单不符合第三方的预订政策。例如，预订政策要求提前3天预订，但订单预订的是第二天的房间，不符合预订政策。 “不符合预订政策”为必须的，具体原因可选。示例1：不符合预订政策:{需提前三天预订} 示例2：不符合预订政策:{}
-106	重复预定	重复预定
-107	预定房间数超过限制	预定房间数超过限制
-108	最早到店时间不合法:{具体不合法原因说明}	最早到店时间不合法:{具体不合法原因说明}
-109	最晚到店时间不合法:{具体不合法原因说明}	最晚到店时间不合法:{具体不合法原因说明}
-110	联系人姓名不合法:{具体不合法原因说明}	联系人姓名不合法:{具体不合法原因说明}
-111	联系电话不合法:{具体不合法原因说明}	联系电话不合法:{具体不合法原因说明}
-112	超过入住人数限制	超过入住人数限制
-113	酒店id不存在	酒店id不存在。去啊将把此酒店关闭，设置为不可卖。
-114	房型不存在	房型不存在。去啊将把此房型关闭，设置为不可卖。
-115	价格政策不存在	价格政策不存在。去啊将把此rp关闭，设置为不可卖。
-116	参数错误:{具体参数不合法说明}	参数错误:{具体参数不合法说明}

注：此文档会根据业务需要进行适当增删除。

FAQ

关于此文档暂时还没有FAQ

有用(2) 我要提问

开放平台

酒店客栈

创建订单请求详解

返回结果（异步）

返回结果（失败）

返回结果定义表

FAQ