酒店通用分销
方法名称
taobao.xhotel.order.distribution.create
使用说明
概述
下单接口，分销商基于验价结果与用户填写的信息请求下单，基于接口结果判断是否下单成功。
下单流程
注意事项
- 创建订单前，分销商需要先进行数据验证，并拿验价结果及createKey下单。createKey具有时效性，过期时间X分钟，过期后分销商需要重新进行数据验证。
- 创建订单接口基于out_order_id（分销商侧订单号，需要保证唯一）支持幂等，当发生超时、网络抖动等无法获得接口返回结果时，分销商可以用原out_order_id重试下单，或调用【飞猪酒店分销订单详请接口】查询订单状态。
- 当接口返回结果明确失败时，分销商需要重新生成新的out_order_id重新下单。
- 创建订单成功后，飞猪会发送【状态变更消息】通知分销商订单状态变为“待付款”，或分销商查询【订单详情】发现订单状态为“待付款”，此刻订单状态支持【确认支付】。
- 关于重复订单。飞猪侧基于out_order_id判断是否重复，与入住人，入离日期无关。
API入参
hotel_contact节点
字段 |
类型 |
可为空 |
示例值 |
描述 |
phone |
String |
N |
13000000000 |
联系人电话 |
name |
String |
N |
言五 |
联系人姓名 |
String |
Y |
yanwu@alibaba-inc.com |
邮箱 |
hotel_invoice_do节点
字段 |
类型 |
可为空 |
示例值 |
描述 |
invoice_content |
String |
Y |
发票内容 |
发票内容 |
receiver_do |
Object |
Y |
收件人信息 |
|
invoice_type |
Number |
Y |
0 |
发票类型：0:增值税普通发票(纸质),1:增值税专用发票(纸质),2:增值税普通发票(电子),21:增值税普通发票(电子/商家自主开票) |
sp_invoice_do |
Object |
Y |
专票信息 |
|
invoice_email |
String |
Y |
yanwu@alibaba-inc.com |
接收发票邮箱，电子发票场景，必填 |
invoice_category |
Number |
Y |
0 |
发票种类：0:公司 1：个人 |
invoice_title |
String |
Y |
飞猪 |
发票抬头 |
invoice_remark |
String |
Y |
发票备注 |
发票备注 |
receiver_do节点
字段 |
类型 |
可为空 |
示例值 |
描述 |
receiver_address |
String |
Y |
浙江省杭州市余杭区巨化大厦 |
收件人完整地址 |
receiver_tel |
String |
Y |
13000000000 |
收件人电话 |
province |
String |
Y |
浙江 |
省份 |
city |
String |
Y |
杭州 |
城市 |
receiver_name |
String |
Y |
言五 |
收件人姓名 |
postal_code |
String |
Y |
311000 |
邮编 |
district |
String |
Y |
行政区 |
|
express_payer_type |
Number |
Y |
1 |
0:未知,1:卖家承担,2:买家承担 |
sp_invoice_do节点
字段 |
类型 |
可为空 |
示例值 |
描述 |
account_no |
String |
Y |
测试银行账户 |
公司银行账户 |
register_addr |
String |
Y |
13000000000 |
公司注册地址 |
tel |
String |
Y |
0571-11111111 |
公司电话 |
tax_no |
String |
Y |
测试公司税号 |
公司税号 |
opening_bank |
String |
Y |
测试公司开户行 |
公司开户行 |
customers节点
Map， key=房间序号, 从1开始计数 value=List<Customer> , 每间房的入住人信息。其中customer对象的结构：
字段 |
类型 |
可为空 |
示例值 |
描述 |
name |
String |
N |
言五 |
最早到店时间 |
customerType |
Number |
N |
1 |
1：成人；2：儿童 |
hotel_order_validate_do节点
字段 |
类型 |
可为空 |
示例值 |
描述 |
promotion_total_price |
Number |
N |
0 |
验价返回的优惠总金额, 单位为分 |
hotel_arrival_time节点
字段 |
类型 |
可为空 |
示例值 |
描述 |
latest_arrival_time |
Date |
N |
2022-11-16 19:00:00 |
最早到店时间 |
earliest_arrival_time |
Date |
N |
2022-11-16 15:00:00 |
最晚到店时间 |
promotion_list节点
数组，其中对象结构同验价：
字段 |
类型 |
可为空 |
示例值 |
描述 |
promotion_name |
String |
Y |
百亿补贴 |
优惠名称 |
promotion_price |
Number |
Y |
1000 |
优惠金额 |
promotion_type |
Number |
Y |
1 |
优惠类型, 1=百亿补贴, 2=贵必赔 |
promotion_id |
String |
Y |
1 |
优惠唯一标识 |
API出参
字段 |
类型 |
可为空 |
示例值 |
描述 |
result |
Object |
Y |
结果体，范型对象 |
|
is_success |
Boolean |
N |
false |
请求是否成功 |
error_msg |
String |
Y |
系统异常，请稍后重试 |
错误信息 |
error_resp_code |
Number |
Y |
101 |
错误码 |
msg_for_dev |
String |
Y |
参数错误 |
开发查看的错误信息 |
result节点
字段 |
类型 |
可为空 |
示例值 |
描述 |
tid |
Number |
N |
3035909269095214604 |
飞猪订单号 |
out_order_id |
Number |
N |
4564645 |
外部订单号 |
错误码解释
错误码 |
解释 |
解决方案 |
101 |
请求参数有误 |
检查请求参数是否符合要求 |
102 |
未知错误 |
联系飞猪开发同学排查 |
202 |
buy2查询失败 |
联系飞猪开发同学排查 |
203 |
buy2创建订单失败 |
联系飞猪开发同学排查 |
206 |
酒店价格发生变化，请刷新页面，重新购买 |
该商品价格变高，需要重新验价并下单 |
207 |
商品已经失效，可能是ratePlan失效，或库存不足、满房 |
商家库存是实时更新的，报价结果与实时请求验价之间存在时间差，该问题不能完全被避免 |
208 |
优惠信息已发生变更，请刷新页面重新购买 |
优惠信息变了，需要重新验价并下单 |
