V1 6/order/get order hotel info

来自技术开发小组内部wiki
跳转至: 导航搜索

功能说明

根据用户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>