V1/order/submit
功能说明
生成订单，下单用
URL
http://[域名]//v1/order/submit
返回格式
支持json,xml.通过format参数来控制
HTTP请求方式
POST.可以post的数据为xml或json.
输入参数说明
| 参数名称 | 是否必须 | 类型 | 描述 |
|---|---|---|---|
| uid |
是 | int | 用户id |
| tid | 是 | int | 票种id |
| num | 是 | int | 数量 |
| appname | 否 | string | APP名字 |
| referer | 否 | int | 订单来源 |
| address_id | 否 | int | 地址id |
| receiver |
否 | string | 收货人姓名(酒店以json数组形式将多个入住人回传) |
| mobile | 否 | int | 收货人手机 |
| province | 否 | string | 省 |
| city | 否 | string | 市 |
| area |
否 |
int |
区（3.1格瓦拉快递票需要此参数） |
| address | 否 | string | 地址 |
| coupon_sn | 否 | string | 优惠券号 |
| inv_type | 否 | string | 发票(0:不用1:个人;2:企业) |
| inv_content | 否 | string | 发票抬头 |
| postscript |
否 | string | 订单附言 |
| package_night_num |
否(酒店订单必须填写) | int | 住店晚数 |
| bed_require |
是 | string | 酒店床型需求(回传 "bed_type_list": [
{
"type": "big",
"bed_require": "尽量安排大床"
},
{
"type": "double",
"bed_require": "尽量安排双床"
},
{
"type": "single",
"bed_require": "尽量安排单床"
}
] 中的bed_require值)
|
| special |
否 | int | 无烟需求(1尽量无烟) |
| date | 否 | string | 日期(2014-06-06 10:00:00这样格式 景点票必须传),酒店直接传日期格式，不需要时分秒 |
| extend_field | 否 | json | 附加表单 |
| cert_info |
否 |
json |
证件信息 |
| play_time |
是 |
string |
酒加景套餐的景点票游玩时间 |
| receiver_email |
否 |
int |
线路游用户接收合同邮箱 |
| shipping_method |
是 |
int |
运送方式：1快递，2ems。（2.5版本增加此参数） |
| cps_name |
是 |
string |
订单来源的页面跟踪（2.5版本新增，运营统计需要） |
| third_type |
否 |
string |
第三方类型：“gewala_seat”(3.1格瓦拉选座加入:必需传) |
| disid |
否 |
int |
价格票套票id |
| seat_info |
否 |
json |
座位信息，格式如：["14:2","14:1","15:1","15:2"]（3.1格瓦拉选座加入，选座下单必须传） |
| ticket_ids |
否 |
json |
座位信息对应的票种id,格式如：["9525","9525","9523","9523"]（3.1格瓦拉选座加入，选座下单必须传） |
| ticket_num |
否 |
json |
票种id对应的数量，格式如：[1,1,1,1]（3.1格瓦拉选座加入，选座下单必须传）注意：seat_info与ticket_ids和ticket_num数据需要对应 |
| is_partner |
否 |
int |
是否结伴（1是，0否），酒店产品必须传（app3.10新增），演出和通用的结伴产品必须传 |
| user_city_id |
是 |
int |
用户所属分站（3.50版本新增） |
| share_id |
否 |
int |
分享id,分享产品被购买必传（v3.72新增，分享指fmb_share_choice） |
| tid_create |
是 |
int |
结伴参团-团长购买的票种ID[v3.8新增，参团必传] |
| pid |
是 |
int |
结伴参团-团号[v3.8新增，参团必传] |
| partner_source |
是 |
string |
结伴参团-来源"join"[v3.8新增，参团必传] |
| hotel_scenery_time |
否 |
json |
酒+X，如果含景点票，需要回传景点票的票种id和出行日期。格式如：[{"ticket_id":"20259","play_time":"2018-07-27"},{"ticket_id":"20265","play_time":"2018-07-27"},{"ticket_id":"21853","play_time":"2018-07-27"}]【客户端v3.90及以上版本试用，以下版本继续试用play_time字段】 |
{"extend_field":[{"name":"IDcard","value":"123123123123123"},...]}//附加表单回传
{"cert_info":[{"name":"张三","cert_no":"130852369852141425"},...]}//证件信息返回格式
请求示例
正式环境 http://api.fumubang.com/v1/order/submit 测试环境 http://api.fumubang.net/v1/order/submit 本地环境 http://dev-api.fumubang.net/v1/order/submit
返回参数说明
| 参数 | 说明 |
|---|---|
| status | 发送状态 1表示成功 |
| msg | 返回信息 |
| order_sn | 生成的订单号 |
| money | 订单金额 |
| shipping_fee | 订单邮费(酒店不返回此参数) |
| all_money | 订单金额合计(酒店不返回此参数) |
正确返回示例
普通订单回传
<syntaxhighlight lang="php"> <status>1</status> <msg>提交订单信息成功</msg> <order_sn>20140429164801820259</order_sn> <money>0.01</money> <shipping_fee>0.00</shipping_fee> <all_money>0.01</all_money> </syntaxhighlight>
酒店订单回传信息
<syntaxhighlight lang="php"> <status>1</status> <msg>提交订单信息成功</msg> <order_sn>20140429164801820259</order_sn> <money>0.01</money> </syntaxhighlight>
错误返回示例
1 <source lang="php"> <error_code>200111</error_code> <error_msg>没有该票种信息</error_msg> </source> 2 <source lang="php"> <error_code>200112</error_code> <error_msg>票种日期有误</error_msg> </source> 3 <source lang="php"> <error_code>200113</error_code> <error_msg>提交订单信息失败</error_msg> </source>
