V1 6/order/get order hotel info
功能说明
根据用户id和订单号获取酒店订单详情
URL
http://[域名]/v1/order/get_order_hotel_info
返回格式
支持json,xml.通过format参数来控制
HTTP请求方式
POST.可以post的数据为xml或json.
输入参数说明
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
uid | 是 | int | 用户id |
order_id | 是 | int | 订单号 |
请求示例
正式环境 http://api.fumubang.com/v1_6/order/get_order_hotel_info 测试环境 http://api.fumubang.net/v1_6/order/get_order_hotel_info
本地环境 http://dev-api.fumubang.net/v1_6/order/get_order_hotel_info
返回参数说明
见xml标红处
正确返回示例
//酒店订单返回
{
"order_id": "30001", //订单id
"change_to_order": null, //改签后的订单号
"order_name": "sam 酒店新数据", //订单名称
"pay_sn": "201501271656121376632", //交易订单号
"my_pay_sn": "1501271656041428077527",
"third_sn": null,
"buyer_email": "",//买家邮箱
"uid": "33093",
"order_status": "5",//订单状态
"shipping_status": "1",
"trace_status": "0",
"pay_status": "2",
"confirm_status": "0",
"confirm_recheck_status": "-1",
"pay_clear": "0",
"aid": "100665",
"order_city_id": "1",
"shop_user_id": "59",
"goods_group_id": "863",
"goods_type": "4",
"activity_type": "1",
"shape_type": "1",
"receiver": "吉宇学,jyx",
"country": "1",
"province": "0",
"city": "0",
"area": "0",
"street": "0",
"address": "",
"zipcode": "",
"tel": "",
"mobile": "14000000001",
"email": "",
"receiver_email":"",//线路游用户接收合同邮箱
"postscript": "无要求",
"ext_info": [],
"inv_type": "0",
"inv_payee": "",
"inv_content": "",
"money": "¥1200.00",
"shipping_fee": "¥0.00",
"pay_source": "银联支付",
"pay_note": "",
"editor_note": "",
"referer": "web",
"appname": "",
"create_time": "2015-01-27 16:56:04",
"confirm_time": "0000-00-00 00:00:00",
"pay_time": "2015-01-27 16:56:33",
"confirm_update_time": "0000-00-00 00:00:00",
"shipping_time": "2015-01-27 16:56:33",
"play_time": "2015-02-12 00:00:00",
"use_coupon": "1",
"coupon_money": "30",
"app_sub_money": "0",
"coupon_share_money": "0.00",
"realpay_money": "1170.00",
"is_comment": "0",
"cps_name": "",
"cps_cookie": null,
"order_status_name": "交易成功",
"order_status_tishi":"",//订单交易状态提示文字,没有返回“”,2.6版本新增
"order_status_pay":true,//是否可以继续支付,ture是,false否(PS:当order_status=7并且order_status_pay=false,不能支付)
"exchange_code": "790679671437(已过期),499413859581(已过期),591420788616(已过期),157791184234(已过期),898181971331(已过期),069078930313(已过期),806549786801(已过期),775364796931(已过期)",
"pay_time_limit":"7200",//自动取消订单间隔时间,单位s
"pay_time_remain":"7015",//订单支付剩余时间,单位s
"third_part_exist": 0,
"status": 1,
"coupon_sn": "rWcW26KKueNX",
"sum_money": "¥1170.00",
"is_invoice": 0,
"inv_type_name": "不需要发票",
"is_return": "0",
"rec_id": "34533",
"goods_id": "2611",
"goods_number": "2", //房间数量
"market_price": "200.00",
"goods_price": "150.00",
"ctime": "2015-01-27 16:56:04",
"occupancy_date": "2015-02-12 星期四", //入店日期
"leave_date": "2015-02-20 星期五", //离店日期
"bed_require": "大床房", //床型要求
"smoke_require": "尽量无烟", //无烟要求
"activity_title": "sam 酒店新数据", //活动名称
"houses_type": "豪华2日套餐(豪华房)", //房型
"breakfast_type_name": "早餐/晚餐", //用餐
"product_detail": "套餐类型:豪华2日套餐(豪华房)
入住日期:2015-02-12
离店日期:2015-02-20",
"goods_total_price": 1200,
"sub_title": "新数据,新数据新数据新数据,新数据,新数据新数据,新数据,新数据新数据新数据新数据新数据。",
"banner": "<a href="http://img3.fumubang.net/huodong/banner/X20150123150001350.jpg">http://img3.fumubang.net/huodong/banner/X20150123150001350.jpg</a>",
"app_activity": "1",
"ticket_type": "4",//酒+景:15,普通酒店:4
"activity": [ //景点票活动列表
{
"aid": "101031",//活动id
"title": "sam 景点通用票 图文详情",//活动标题
"sub_title": "新活动,只有图文详情",//活动副标题
"tname": "景点门票",//票种名称
"goods_id": "3441",//票种id
"goods_type": "2",//票种类型
"goods_number": "4",//购买数量
"play_time": "2015-08-18 00:00:00"//游玩时间
},...
],
"order_ctime": "2015-01-27 16:56",
"is_partner_order":"1"//是否结伴游订单并且跳转
"origin_partner_order":"1",//不考虑支付状态,本身是否是结伴订单,1是,0否
"partner_discount_price": 0,//折扣金额
"money_type": 3, //3.37新增 优惠类型 1-减少 2-不变 3-增加
"discount_des": "增加20元且结伴可升级为豪华房", //3.37新增 优惠描述
"show_map_coordinate": "117.503924,38.85532",//商户的经纬度(3.2新增)
"show_map_address": "天津市滨海新区人民法院西侧",//商户地址(3.2新增)
"shop_contact": "022-12344666",//商户电话(3.2新增)
}
注:
在order_status=7,待付尾款情况下,已付金额=money(支付金额)-coupon_money(优惠券金额)-app_sub_money(下单立减金额)-realpay_money(实际支付金额)
order_stauts=8 时订单状态为处理中
order_status = 0时存在的按钮有:支付,取消
order_status = 6时存在的按钮 :重新购买
order_status = 2&&shape_type=2时存在的按钮有:确认收货(注:只适用于与实体票,酒店都是电子票,没有此操作)
status = 0&&shape_type = 1时存在的按钮 :重新发送 shape_type是1时才会有status字段
codes_show = 1时,电子验证码处显示 已发送到您的手机(注:酒店没有电子码,不需要此处逻辑)
//2016-10-26返回json结果示例(3.30版本)
{
"order_id": "67657",
"order_sn": "20161026144203540833",
"change_to_order": null,
"order_name": "自贡市 sam 酒店带附加表单",
"pay_sn": "",
"my_pay_sn": "1610261442034187000658",
"third_sn": null,
"buyer_email": "",
"receiver_email": "",
"uid": "34059",
"order_status": "7",
"shipping_status": "0",
"trace_status": "0",
"pay_status": "0",
"confirm_status": "0",
"confirm_recheck_status": "-1",
"occupy_status": "0",
"pay_clear": "0",
"aid": "100757",
"order_city_id": "1",
"shop_user_id": "59",
"shop_warehouse_id": "0",
"goods_group_id": "955",
"goods_type": "4",
"activity_type": "1",
"shape_type": "1",
"receiver": "手机号",
"country": "1",
"province": "0",
"city": "0",
"area": "0",
"street": "0",
"address": "",
"zipcode": "",
"tel": "",
"mobile": "13811117893",
"email": "",
"weixin": "",
"postscript": "",
"cert_info": [
{
"name": "搞活经济",
"cert_no": "110101199707016611"
}
],
"inv_type": "0",
"inv_payee": "",
"inv_content": "",
"adult_num": "0",
"child_num": "0",
"money": "¥1388",
"shipping_fee": "¥0",
"shipping_method": "0",
"pay_source": "手机银联支付",
"pay_note": "",
"editor_note": null,
"referer": "apple",
"order_referer": "1",
"appname": "",
"create_time": "2016-10-26 14:40:22",
"confirm_time": "0000-00-00 00:00:00",
"pay_time": "2016-10-26 14:40:39",
"confirm_update_time": "0000-00-00 00:00:00",
"shipping_time": "2016-10-26 14:40:39",
"play_time": "2016-11-09 00:00:00",
"use_coupon": "0",
"coupon_money": "0",
"app_sub_money": "0",
"realpay_money": "1300.00",
"cps_name": "app.sea_res",
"cps_cookie": null,
"version": "3.30",
"order_status_name": "待付尾款",
"pay_time_limit": "1200",
"pay_time_remain": 0,
"order_status_tishi": "该订单由其他订单改签生成,请支付尾款。",
"exchange_code": "",
"third_part_exist": 0,
"status": 1,
"relpad_total_money": 88,
"sum_money": "¥1300",
"is_invoice": 0,
"inv_type_name": "不需要发票",
"is_return": "1",
"activity_title": "自贡市 sam 酒店带附加表单",
"packages": [
{
"pack_product_id": "0",
"product_id": "0",
"supplier_id": "0",
"sell_id": "0",
"type_name": "",
"plane_trip_status": "0",
"activity_type": "1",
"goods_type": "4",
"goods_id": "6091",
"goods_number": "1",
"market_price": "100",
"goods_price": "88",
"settle_price": "60",
"play_time": "2016-11-09 00:00:00",
"leave_time": "2016-11-10 00:00:00",
"ctime": "2016-10-26 14:42:03",
"bed_require": "大床房",
"ext_info": [],
"row_index": "0",
"tax_money": "0.00",
"settle_tax_money": "0.00",
"tuan_status": "0",
"extend_info": "",
"good_ext": "",
"count": "1",
"rec_ids": "89711",
"goods_number_total": "1",
"occupancy_date": "2016-11-09",
"leave_date": "2016-11-10",
"smoke_require": "",
"houses_type": "双12套餐(豪华房)",
"breakfast_type_name": "早餐",
"goods_total_price": 88,
"display_return": "",
"display_return_status":0//显示退款,0不显示,大于0展示display_return内容
"goods_detail": [ //商品明细
{
"rec_id": "89711",
"order_sn": "20161026144203540833",
"uid": "34059",
"goods_number": "1",
"goods_price": "88.00",
"play_time": "2016-11-09 00:00:00",
"leave_time": "2016-11-10 00:00:00",
"bed_require": "大床房",
"snapshot_status": true,//是否有交易快照:true有,false没有
"snapshot_url": "http://dev-m.fumubang.net/hd_my/order_trade_snapshot?order_id=20161026144203540833&rec_id=89711&uid=34059&from=app"//交易快照地址
}
]
},
...
],
"sub_title": "副标题有点长,副标题有点长副标题有点长副标题有点长,副标题有点长副标题有点长",
"banner": "http://img3.fumubang.net/huodong/banner/X20160129114502451.jpg!thumb_640",
"app_activity": "1",
"ticket_type": "4",
"package_detail": { //酒加景特殊明细处理
"package_num": "2",//套餐份数
"package_price": "2400.01"//套餐单价
},
"order_ctime": "2016-10-26 14:40",
"order_change_status": [
{
"status": "on",
"words": "订单提交"
},
{
"status": "off",
"words": "待付尾款"
},
{
"status": "off",
"words": "等待确认"
}
],
"is_partner_order": 0,
"origin_partner_order": 0,
"partner_discount_price": 0,
"show_map_coordinate": "117.503924,38.85532",
"show_map_address": "天津市滨海新区人民法院西侧",
"shop_contact": "022-12344666",
"split_order": { //此订单是否是拆分订单(3.63以上版本返回此参数)
"status": true, //true:是拆分订单,false不是
"money": "1.02",//待付金额
"last_status": false,
"split_money": 0.03,//可拆分订单金额限制
"min_money": 0.02//最小拆分金额(拆分金额需大于等于最小金额)
}
}
//酒加X订单返回结果,活动节点差异如下:
"activity": [{
"aid": "104395",
"ticket_type": "3",
"ticket_group_id": "3771",//票务di
"title": "sam's预约通用票活动",
"sub_title": "预约预约。。。。。。。。。。",
"third_part_exist":0,//是否是第三方发码:1是0否;第三方发码不显示发送电子码按钮
"tickets": [{
"tname": "成人票",
"goods_id": "23633",
"goods_type": "3",//2景点3通用
"goods_number": 2,//购买数量
"play_time":"2018-07-29",//游玩时间
"exchange_code": [ //二次确认返回此电子码
"55555568",
"81579716"
],
"snapshot_status": false,
"snapshot_url": "http://dev-m.fumubang.net/mobile/hd_my/order_trade_snapshot?order_id=20180724104008718103&rec_id=120945&uid=33893&from=app",
"attr": [{ //通用票属性
"key": "票种",
"value": "成人票"
},
{
"key": "有效期",
"value": "2018.06.04至2019.06.04"
}
]
}]
},
{
"aid": "104341",
"ticket_type": "2",
"ticket_group_id": "3725",
"title": "景点票测试123",
"sub_title": "456",
"tickets": [{
"tname": "景点通票",
"goods_id": "21853",
"goods_type": "2",
"goods_number": 2,
"exchange_code": [
"17328912",
"63438053"
],
"snapshot_status": false,
"snapshot_url": "http://dev-m.fumubang.net/mobile/hd_my/order_trade_snapshot?order_id=20180724104008718103&rec_id=120947&uid=33893&from=app",
"attr": []
}]
},
...
],
错误返回示例
<?xml version="1.0" encoding="utf-8"?>
<error_code>300000</error_code> <error_msg>参数不全</error_msg>
<?xml version="1.0" encoding="utf-8"?>
<error_code>300001</error_code> <error_msg>订单信息不存在</error_msg>