Hotel confirm V1/order/hotel confirm

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

功能说明

酒店确认订单

URL

http://[域名]/v1_6/order/hotel_confirm

返回格式

支持json,xml.通过format参数来控制

HTTP请求方式

POST.可以post的数据为xml或json.

输入参数说明

各个参数请进行URL 编码,编码时请遵守 RFC 1738
(1)公共参数
发送请求时必须传入公共参数,详见公共参数说明。
(2)私有参数
参数名称 是否必须 类型 描述
ticket_id
必须 int 票种ID
target_date

string
出行时间,格式为‘2015-07-07’
version
string
版本号
is_partner

int
是否结伴:1是0否(3.10版本新增)
uid

int
用户id(3.10版本新增)
need_receiver

int
是否需要收货人:0否1是

请求示例

正式环境
http://api.fumubang.com/v1_6/order/hotel_confirm
测试环境
http://api.fumubang.net/v1_6/order/hotel_confirm
本地环境
http://dev-api.fumubang.net/v1_6/order/hotel_confirm

返回参数说明

参数 说明
title
活动名称
aid
活动ID
shop_address
商家地址
package_id
套餐ID
package_name
套餐名称
package_brief
套餐简介
package_desc
套餐内容
package_night_num
套餐晚数
ticket_id
票种ID
hotel_type_name
房型名称
bed_type_list
房型安排
image
房型图
limit_min
最小购买数
limit_max
最大购买数
mintime
日历最小日期
maxtime
日历最大日期
date_price
日历价格列表
summary
购买说明
extend_field
套餐里的附加表单
hotel_scenery
酒+景的景点票列表
package_id
套餐id
ticket_id
景点票种id
num
景点票种数量
tname
景点票种名称
people_num
身份证数量
scenery_time
景点票游玩时间,以‘,’分隔
bed_date_list
床型对应的5个酒店套餐晚数的列表
receiver
收货人列表(3.10新增)
mobile
收货人手机号(3.10新增)
date_goods_price
target_date不为空,且为结伴订单时,该值返回酒店target_date对应的现价,根据这个值和结伴价相减就是结伴优惠
discount_des
优惠描述(3.37新增)
money_type
优惠类型 1-减少 2-不变 3-增加  (3.37新增)

正确返回示例

{
    "title": "shuwen测试活动----l----酒店",
    "aid": "100611",
    "sell_limit_time": "129600",
    "shop_address": "北京市朝阳区朝阳北路常营公园",
    "package_id": "27",  

    "extend_field": [        
    {
                "extend_name": "身份证",
                "extend_value": "",
                "require": 1,
                "extend_validate": "^(\\d{15}$|^\\d{18}$|^\\d{17}(\\d|X|x))$"
    }],

    "package_name": "小套餐",
    "package_brief": "小套餐",
    "package_desc": "小套餐",
    "package_have": "array (\n  0 => \\'breackfast\\',\n)",
    "package_night_num": "1",
    "ticket_id": "2497",
    "hotel_type_name": "小房",
    "bed_type_list": [  //所选日期当天可选床型
        {
            "type": "double",
            "bed_require": "尽量安排双床"
        }
    ],
    "image": "http://img.fumubang.net/house_type/20150106/20150106144836935.jpg",
    "limit_min": "1",

    “people_num”:"1",

      "hotel_scenery": [   //v3.90版本返回如下,单独列出。
        {
            "package_id": "99",
            "ticket_id": "3441",
            "num": "2",
            "tname": "景点门票"
        },
        {
            "package_id": "99",
            "ticket_id": "3453",
            "num": "1",
            "tname": "saa"
        }
    ],

  "bed_date_list": [//续住时日期床型对照表
        {
            "date": "2015-09-12",//日期
            "bed_list": [//床型列表
                {
                    "type": "double",
                    "bed_require": "双床房"
                },
                {
                    "type": "single",
                    "bed_require": "单床房"
                }
            ]
        },
        {
            "date": "2015-09-16",
            "bed_list": [
                {
                    "type": "double",
                    "bed_require": "双床房"
                },
                {
                    "type": "single",
                    "bed_require": "单床房"
                }
            ]
        },...

    ]
    "goods_price": "0.02",
    "limit_max": "20",

    "scenery_time":"2015-09-22,2015-09-23",//景点票游玩时间
    "mintime": "2015-02-01",
    "maxtime": "2015-02-04",
    "date_price": "2015-02-01:0.02:50,2015-02-02:0.02:50,2015-02-03:0.02:50,2015-02-04:0.02:50", //日期:当日价格:当日库存

    "date_goods_price": "180.00",

     "discount_des": "如果结伴的话,表面上看价格是一样的,实际上优惠可大了,送好多东西,不管你信不信吧,反正我是不信,哈哈哈哈哈哈哈哈哈哈哈", //3.37新增 优惠描述
     "money_type": "2" //3.37新增 优惠类型 1-减少 2-不变 3-增加

}

v3.90酒店确认订单由酒加景衍生为酒加X,故结构做出以下调整:

    "hotel_scenery": [{
            "aid": "104085",
            "activity_name": "joanna_酒+景专用景点票 ddd",
            "ticket_group_id": "3517",
            "package_id": "321",
            "ticket_type": "2",
            "tickets": [{
                    "ticket_id": "20259",
                    "tname": "票种a",
                    "num": "1"
                },
                {
                    "ticket_id": "20265",
                    "tname": "酒加景专用b",
                    "num": "1"
                }
            ],
            "scenery_time": "2018-07-27,2018-07-28"
        },
        {
            "aid": "104395",
            "activity_name": "sam's预约通用票活动",
            "ticket_group_id": "3771",
            "package_id": "321",
            "ticket_type": "3",
            "tickets": [{
                "ticket_id": "23633",
                "tname": "成人票",
                "num": "2",
                "attr": [{
                        "key": "票种",
                        "value": "成人票"
                    },
                    {
                        "key": "有效期",
                        "value": "2018.06.04至2019.06.04"
                    }
                ]
            }]
        }

错误返回示例

<syntaxhighlight lang="php"> <error_code>100001</error_code> <error_msg>签名失败</error_msg> </syntaxhighlight>