飞猪 - 开放平台

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

名称	类型	是否必须	示例值	更多限制	描述
param_t_v_m_create_order_r_q	TvmCreateOrderRq	必须			创建订单对象
account_in_details AccountInDetail [] 可选分润账户明细列表，是个数组，有几个分账，写几个。注意只有需要分润到多账号才需要填，否则为空。分账总和等于订单总价。 └ alipay_account String 可选 alipay@xx.com 支付宝账号 └ alipay_account_id String 可选 211000090098 对应该支付宝的支付宝账号ID，注意和支付宝账号保持一致 └ amount Number 可选 100 单位分 └ agent_order_id String 必须 12345 代理商订单ID └ machine_number String 必须 001 终端机编号，每个商家终端编号要进行唯一标识 passengers TvmPassengerVo [] 必须乘客 └ agent_eticket String 可选 12308 电子票号 └ agent_ticket_id String 可选 ASSS1 商家票号 └ full_price Number 必须 9000 全票价(单位分) └ has_children Boolean 可选 false 是否带儿童 └ insure_price Number 可选 0 保险费 (单位分) └ rider_cert_number String 可选 1111 (必须填写，后续程序强制校验)，证件号码 └ rider_cert_type String 可选 01 (必须填写，后续程序强制校验)证件类型：01：身份证，02：护照，03：港澳通行证，04：台湾通行证，05：港澳往返内地通行证，06：台湾往返内地通行证，07：港澳居民居住证 └ rider_name String 可选张三 (必须填写，后续程序强制校验)姓名 └ seat_number String 可选 46 座位号 └ service_charge Number 可选 0 服务费 (单位分) └ ticket_price Number 必须 9000 该张票价 (单位分) tvm_insurance_infos TvmInsuranceInfo [] 可选保险信息 └ insure_price Number 可选 1000 保险商品单价(单位分) └ insure_name String 可选意外险保险名称 └ product_no String 可选 1111abc 保险唯一id └ ticket_type Number 可选 0 乘客类型：0：成人，1：儿童，2：携童 └ discount_type Number 可选 1 折扣类型：1：特殊证件，2：特殊线路，3其他。如果是折扣票必须填写 └ real_name Boolean 必须 true true实名（传身份证）,必须传true后续进行程序强制校验 └ ticket_count Number 必须 2 票总数量 └ total_price Number 必须 18000 订单总价格，含服务费 (单位分) tvm_bus_line_info TvmBusLineInfo 必须班次信息 └ bus_number String 可选 PT222 车次编号 └ bus_type String 可选豪华，空调等车型 └ dep_time String 必须 2017-03-10 21:11:01 出发时间 yyyy-mm-dd HH:mm:ss └ distance Number 可选 1000 距离 km └ last_place_name String 必须上海到达目的地 └ runtime Number 可选 10 运行时长（分） └ start_city_name String 必须杭州出发城市(必须填写，后续程序中会进行校验) └ start_province_name String 可选上海出发省份(必须填写，后续程序中会进行强制校验，参考标准区域码表) └ start_station_address String 可选 xxx 车站地址(必须填写，后续程序中会进行强制校验，参考标准区域码表) └ start_station_id String 可选 1111 出发车站ID(必须填写，且与线上车站id能进行数据互通) └ start_station_name String 必须上海虹桥车站出发车站名称(必须填写，与线上售卖车站名称保持一致) └ terminal String 可选宁波终点站名称 └ to_station_city_name String 可选杭州到达车站城市名称 └ to_station_id String 可选 111 到达车站ID └ to_station_name String 可选杭州总站到达车站名称 └ to_station_province_name String 可选浙江到达车站省份 └ start_province_code String 可选 1111 出发省份， └ start_city_code String 可选 1111 出发城市码 └ to_station_province_code String 可选 11111 到达省份码 └ to_station_city_code String 可选 11111 到达城市码 └ service_provider_id String 可选 2088501624816263 渠道商支付宝ID └ trade_source String 可选 self 交易场景来源 window(窗口) self(自助机） └ pay_timeout Number 可选 10 支付超时时间(创建订单成功后开始计算) 单位:秒,到达指定时间后，平台进行关闭订单操作(自助机小程序订单使用) └ tvm_online Boolean 可选 true true:切换为自助机小程序订单;false:普通自助机订单 └ issue_timeout Number 可选 5 出票超时时间(支付成功后开始计算) 单位:秒，如果商家不设置，平台默认超时时间为60天(自助机小程序订单使用) └ create_deadline String 可选 2021-03-10 21:11:01 创建订单截止时间，不传值默认使用出发时间字段 yyyy-mm-dd HH:mm:ss └ pay_mode String 可选 ALIPAY 取值范围 ALIPAY （飞猪渠道）; WECHAT（微信）; BANKCARD（银行卡）;CASH（现金）; OWN_ALIPAY（自身支付宝渠道，非飞猪渠道）；UNION（多码合一） contact_info TvmContactInfo 可选下单人联系信息 └ mobile_number String 可选 18611223050 下单人手机号，非特殊业务必填，影响商务结算 └ contact_name String 可选张三丰下单人姓名

名称	类型	示例值	描述
alitrip_order_id	String	123456789	alitripOrderId
result_code	String	PARAM_ERROE	errorCode
result_msg	String	TOP参数错误	errorMsg
is_success	Boolean	false	success

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
BusTvmcreateorderSetRequest req = new BusTvmcreateorderSetRequest();
BusTvmcreateorderSetRequest.TvmCreateOrderRq obj1 = new BusTvmcreateorderSetRequest.TvmCreateOrderRq();
List<BusTvmcreateorderSetRequest.AccountInDetail> list3 = new ArrayList<BusTvmcreateorderSetRequest.AccountInDetail>();
BusTvmcreateorderSetRequest.AccountInDetail obj4 = new BusTvmcreateorderSetRequest.AccountInDetail();
list3.add(obj4);
obj4.setAlipayAccount("alipay@xx.com");
obj4.setAlipayAccountId("211000090098");
obj4.setAmount(100L);
obj1.setAccountInDetails(list3);
obj1.setAgentOrderId("12345");
obj1.setMachineNumber("001");
List<BusTvmcreateorderSetRequest.TvmPassengerVo> list6 = new ArrayList<BusTvmcreateorderSetRequest.TvmPassengerVo>();
BusTvmcreateorderSetRequest.TvmPassengerVo obj7 = new BusTvmcreateorderSetRequest.TvmPassengerVo();
list6.add(obj7);
obj7.setAgentEticket("12308");
obj7.setAgentTicketId("ASSS1");
obj7.setFullPrice(9000L);
obj7.setHasChildren(false);
obj7.setInsurePrice(0L);
obj7.setRiderCertNumber("1111");
obj7.setRiderCertType("01");
obj7.setRiderName("张三");
obj7.setSeatNumber("46");
obj7.setServiceCharge(0L);
obj7.setTicketPrice(9000L);
List<BusTvmcreateorderSetRequest.TvmInsuranceInfo> list10 = new ArrayList<BusTvmcreateorderSetRequest.TvmInsuranceInfo>();
BusTvmcreateorderSetRequest.TvmInsuranceInfo obj11 = new BusTvmcreateorderSetRequest.TvmInsuranceInfo();
list10.add(obj11);
obj11.setInsurePrice(1000L);
obj11.setInsureName("意外险");
obj11.setProductNo("1111abc");
list8.setTvmInsuranceInfos(list10);
obj7.setTicketType(0L);
obj7.setDiscountType(1L);
obj1.setPassengers(list6);
obj1.setRealName(true);
obj1.setTicketCount(2L);
obj1.setTotalPrice(18000L);
BusTvmcreateorderSetRequest.TvmBusLineInfo obj12 = new BusTvmcreateorderSetRequest.TvmBusLineInfo();
obj12.setBusNumber("PT222");
obj12.setBusType("豪华，空调等");
obj12.setDepTime("2017-03-10 21:11:01");
obj12.setDistance(1000L);
obj12.setLastPlaceName("上海");
obj12.setRuntime(10L);
obj12.setStartCityName("杭州");
obj12.setStartProvinceName("上海");
obj12.setStartStationAddress("xxx");
obj12.setStartStationId("1111");
obj12.setStartStationName("上海虹桥车站");
obj12.setTerminal("宁波");
obj12.setToStationCityName("杭州");
obj12.setToStationId("111");
obj12.setToStationName("杭州总站");
obj12.setToStationProvinceName("浙江");
obj12.setStartProvinceCode("1111");
obj12.setStartCityCode("1111");
obj12.setToStationProvinceCode("11111");
obj12.setToStationCityCode("11111");
obj1.setTvmBusLineInfo(obj12);
obj1.setServiceProviderId("2088501624816263");
obj1.setTradeSource("self");
obj1.setPayTimeout(10L);
obj1.setTvmOnline(true);
obj1.setIssueTimeout(5L);
obj1.setCreateDeadline("2021-03-10 21:11:01");
obj1.setPayMode("ALIPAY");
BusTvmcreateorderSetRequest.TvmContactInfo obj13 = new BusTvmcreateorderSetRequest.TvmContactInfo();
obj13.setMobileNumber("18611223050");
obj13.setContactName("张三丰");
obj1.setContactInfo(obj13);
req.setParamTVMCreateOrderRQ(obj1);
BusTvmcreateorderSetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
BusTvmcreateorderSetRequest req = new BusTvmcreateorderSetRequest();
BusTvmcreateorderSetRequest.TvmCreateOrderRqDomain obj1 = new BusTvmcreateorderSetRequest.TvmCreateOrderRqDomain();
List<BusTvmcreateorderSetRequest.AccountInDetailDomain> list3 = new List<BusTvmcreateorderSetRequest.AccountInDetailDomain>();
BusTvmcreateorderSetRequest.AccountInDetailDomain obj4 = new BusTvmcreateorderSetRequest.AccountInDetailDomain();
list3.Add(obj4);
obj4.AlipayAccount = "alipay@xx.com";
obj4.AlipayAccountId = "211000090098";
obj4.Amount = 100L;
obj1.AccountInDetails= list3;
obj1.AgentOrderId = "12345";
obj1.MachineNumber = "001";
List<BusTvmcreateorderSetRequest.TvmPassengerVoDomain> list6 = new List<BusTvmcreateorderSetRequest.TvmPassengerVoDomain>();
BusTvmcreateorderSetRequest.TvmPassengerVoDomain obj7 = new BusTvmcreateorderSetRequest.TvmPassengerVoDomain();
list6.Add(obj7);
obj7.AgentEticket = "12308";
obj7.AgentTicketId = "ASSS1";
obj7.FullPrice = 9000L;
obj7.HasChildren = false;
obj7.InsurePrice = 0L;
obj7.RiderCertNumber = "1111";
obj7.RiderCertType = "01";
obj7.RiderName = "张三";
obj7.SeatNumber = "46";
obj7.ServiceCharge = 0L;
obj7.TicketPrice = 9000L;
List<BusTvmcreateorderSetRequest.TvmInsuranceInfoDomain> list9 = new List<BusTvmcreateorderSetRequest.TvmInsuranceInfoDomain>();
BusTvmcreateorderSetRequest.TvmInsuranceInfoDomain obj10 = new BusTvmcreateorderSetRequest.TvmInsuranceInfoDomain();
list9.Add(obj10);
obj10.InsurePrice = 1000L;
obj10.InsureName = "意外险";
obj10.ProductNo = "1111abc";
obj7.TvmInsuranceInfos= list9;
obj7.TicketType = 0L;
obj7.DiscountType = 1L;
obj1.Passengers= list6;
obj1.RealName = true;
obj1.TicketCount = 2L;
obj1.TotalPrice = 18000L;
BusTvmcreateorderSetRequest.TvmBusLineInfoDomain obj11 = new BusTvmcreateorderSetRequest.TvmBusLineInfoDomain();
obj11.BusNumber = "PT222";
obj11.BusType = "豪华，空调等";
obj11.DepTime = "2017-03-10 21:11:01";
obj11.Distance = 1000L;
obj11.LastPlaceName = "上海";
obj11.Runtime = 10L;
obj11.StartCityName = "杭州";
obj11.StartProvinceName = "上海";
obj11.StartStationAddress = "xxx";
obj11.StartStationId = "1111";
obj11.StartStationName = "上海虹桥车站";
obj11.Terminal = "宁波";
obj11.ToStationCityName = "杭州";
obj11.ToStationId = "111";
obj11.ToStationName = "杭州总站";
obj11.ToStationProvinceName = "浙江";
obj11.StartProvinceCode = "1111";
obj11.StartCityCode = "1111";
obj11.ToStationProvinceCode = "11111";
obj11.ToStationCityCode = "11111";
obj1.TvmBusLineInfo= obj11;
obj1.ServiceProviderId = "2088501624816263";
obj1.TradeSource = "self";
obj1.PayTimeout = 10L;
obj1.TvmOnline = true;
obj1.IssueTimeout = 5L;
obj1.CreateDeadline = "2021-03-10 21:11:01";
obj1.PayMode = "ALIPAY";
BusTvmcreateorderSetRequest.TvmContactInfoDomain obj12 = new BusTvmcreateorderSetRequest.TvmContactInfoDomain();
obj12.MobileNumber = "18611223050";
obj12.ContactName = "张三丰";
obj1.ContactInfo= obj12;
req.ParamTVMCreateOrderRQ_ = obj1;
BusTvmcreateorderSetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new BusTvmcreateorderSetRequest;
$param_t_v_m_create_order_r_q = new TvmCreateOrderRq;
$account_in_details = new AccountInDetail;
$account_in_details->alipay_account="alipay@xx.com";
$account_in_details->alipay_account_id="211000090098";
$account_in_details->amount="100";
$param_t_v_m_create_order_r_q->account_in_details = $account_in_details;
$param_t_v_m_create_order_r_q->agent_order_id="12345";
$param_t_v_m_create_order_r_q->machine_number="001";
$passengers = new TvmPassengerVo;
$passengers->agent_eticket="12308";
$passengers->agent_ticket_id="ASSS1";
$passengers->full_price="9000";
$passengers->has_children="false";
$passengers->insure_price="0";
$passengers->rider_cert_number="1111";
$passengers->rider_cert_type="01";
$passengers->rider_name="张三";
$passengers->seat_number="46";
$passengers->service_charge="0";
$passengers->ticket_price="9000";
$tvm_insurance_infos = new TvmInsuranceInfo;
$tvm_insurance_infos->insure_price="1000";
$tvm_insurance_infos->insure_name="意外险";
$tvm_insurance_infos->product_no="1111abc";
$passengers->tvm_insurance_infos = $tvm_insurance_infos;
$passengers->ticket_type="0";
$passengers->discount_type="1";
$param_t_v_m_create_order_r_q->passengers = $passengers;
$param_t_v_m_create_order_r_q->real_name="true";
$param_t_v_m_create_order_r_q->ticket_count="2";
$param_t_v_m_create_order_r_q->total_price="18000";
$tvm_bus_line_info = new TvmBusLineInfo;
$tvm_bus_line_info->bus_number="PT222";
$tvm_bus_line_info->bus_type="豪华，空调等";
$tvm_bus_line_info->dep_time="2017-03-10 21:11:01";
$tvm_bus_line_info->distance="1000";
$tvm_bus_line_info->last_place_name="上海";
$tvm_bus_line_info->runtime="10";
$tvm_bus_line_info->start_city_name="杭州";
$tvm_bus_line_info->start_province_name="上海";
$tvm_bus_line_info->start_station_address="xxx";
$tvm_bus_line_info->start_station_id="1111";
$tvm_bus_line_info->start_station_name="上海虹桥车站";
$tvm_bus_line_info->terminal="宁波";
$tvm_bus_line_info->to_station_city_name="杭州";
$tvm_bus_line_info->to_station_id="111";
$tvm_bus_line_info->to_station_name="杭州总站";
$tvm_bus_line_info->to_station_province_name="浙江";
$tvm_bus_line_info->start_province_code="1111";
$tvm_bus_line_info->start_city_code="1111";
$tvm_bus_line_info->to_station_province_code="11111";
$tvm_bus_line_info->to_station_city_code="11111";
$param_t_v_m_create_order_r_q->tvm_bus_line_info = $tvm_bus_line_info;
$param_t_v_m_create_order_r_q->service_provider_id="2088501624816263";
$param_t_v_m_create_order_r_q->trade_source="self";
$param_t_v_m_create_order_r_q->pay_timeout="10";
$param_t_v_m_create_order_r_q->tvm_online="true";
$param_t_v_m_create_order_r_q->issue_timeout="5";
$param_t_v_m_create_order_r_q->create_deadline="2021-03-10 21:11:01";
$param_t_v_m_create_order_r_q->pay_mode="ALIPAY";
$contact_info = new TvmContactInfo;
$contact_info->mobile_number="18611223050";
$contact_info->contact_name="张三丰";
$param_t_v_m_create_order_r_q->contact_info = $contact_info;
$req->setParamTVMCreateOrderRQ(json_encode($param_t_v_m_create_order_r_q));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=taobao.bus.tvmcreateorder.set' \
-d 'partner_id=apidoc' \
-d 'session=77c91b0e-9d77-461d-b054-e6222c03508d' \
-d 'sign=53B482A06AE148A3B562E2B39430B93F' \
-d 'sign_method=hmac' \
-d 'timestamp=2024-04-19+07%3A02%3A19' \
-d 'v=2.0' \
-d 'param_t_v_m_create_order_r_q=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.BusTvmcreateorderSetRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.param_t_v_m_create_order_r_q=""
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"taobao.bus.tvmcreateorder.set");
add_param(pRequest,"param_t_v_m_create_order_r_q","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('taobao.bus.tvmcreateorder.set', {
	'param_t_v_m_create_order_r_q':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<bus_tvmcreateorder_set_response>
    <alitrip_order_id>123456789</alitrip_order_id>
    <result_code>PARAM_ERROE</result_code>
    <result_msg>TOP参数错误</result_msg>
    <is_success>false</is_success>
</bus_tvmcreateorder_set_response>

{
    "bus_tvmcreateorder_set_response":{
        "alitrip_order_id":"123456789",
        "result_code":"PARAM_ERROE",
        "result_msg":"TOP参数错误",
        "is_success":false
    }
}

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

汽车票API

taobao.bus.tvmcreateorder.set (线下自助机创建订单)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ