文档中心 > API类目 > 汽车票API

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

提供给汽车票线下自助机的创建订单使用

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_t_v_m_create_order_r_q TvmCreateOrderRq 必须 创建订单对象
  • └ agent_order_id
  • String
  • 必须
  • 12345
  • 代理商订单ID
  • └ machine_number
  • String
  • 必须
  • 001
  • 终端机编号
  • passengers
  • TvmPassengerVo []
  • 必须
  • 乘客
  • └ full_price
  • Number
  • 必须
  • 9000
  • 全票价(单位分)
  • └ has_children
  • Boolean
  • 可选
  • false
  • 是否带儿童
  • └ rider_cert_number
  • String
  • 可选
  • 1111
  • 证件号码
  • └ rider_cert_type
  • String
  • 可选
  • 01
  • 证件类型:01:身份证,目前暂时只支持身份证
  • └ rider_name
  • String
  • 可选
  • 张三
  • 姓名
  • └ seat_number
  • String
  • 可选
  • 46
  • 座位号
  • └ service_charge
  • Number
  • 可选
  • 0
  • 默认值:0
  • 服务费 (单位分)
  • └ ticket_price
  • Number
  • 必须
  • 9000
  • 该张票价 (单位分)
  • └ agent_eticket
  • String
  • 可选
  • 12308
  • 电子票号
  • └ agent_ticket_id
  • String
  • 可选
  • ASSS1
  • 商家票号
  • └ insure_price
  • Number
  • 可选
  • 0
  • 保险费 (单位分)
  • └ ticket_count
  • Number
  • 必须
  • 2
  • 票总数量
  • └ total_price
  • Number
  • 必须
  • 18000
  • 订单总价格,含服务费 (单位分)
  • tvm_bus_line_info
  • TvmBusLineInfo
  • 必须
  • 班次信息
  • └ dep_time
  • String
  • 必须
  • 2017-03-10 21:11:01
  • 出发时间 yyyy-mm-dd HH:mm:ss
  • └ distance
  • Number
  • 可选
  • 1000
  • 距离 km
  • └ last_place_name
  • String
  • 必须
  • 上海
  • 到达目的地
  • └ start_city_name
  • String
  • 必须
  • 杭州
  • 出发城市
  • └ start_province_name
  • String
  • 可选
  • 上海
  • 出发省份
  • └ start_station_id
  • String
  • 可选
  • 1111
  • 出发车站ID
  • └ start_station_name
  • String
  • 必须
  • 上海虹桥车站
  • 出发车站名称
  • └ to_station_city_name
  • String
  • 可选
  • 杭州
  • 到达车站城市名称
  • └ to_station_id
  • String
  • 可选
  • 111
  • 到达车站ID
  • └ to_station_name
  • String
  • 可选
  • 杭州总站
  • 到达车站名称
  • └ to_station_province_name
  • String
  • 可选
  • 浙江
  • 到达车站省份
  • └ terminal
  • String
  • 可选
  • 宁波
  • 终点站名称
  • └ bus_number
  • String
  • 可选
  • PT222
  • 车次编号
  • └ start_station_address
  • String
  • 可选
  • xxx
  • 车站地址
  • └ bus_type
  • String
  • 可选
  • 豪华,空调等
  • 车型
  • └ runtime
  • Number
  • 可选
  • 10
  • 运行时长(分)
  • └ real_name
  • Boolean
  • 必须
  • true
  • true实名(必须传身份证),fasle非实名(非实名可以不传身份证信息)
  • account_in_details
  • AccountInDetail []
  • 可选
  • 分润账户明细列表,是个数组,有几个分账,写几个。 注意 只有需要分润到多账号才需要填,否则为空。分账总和等于订单总价。
  • └ alipay_account
  • String
  • 可选
  • alipay@xx.com
  • 支付宝账号
  • └ amount
  • Number
  • 可选
  • 100
  • 单位分
  • └ alipay_account_id
  • String
  • 可选
  • 211000090098
  • 对应该支付宝的支付宝账号ID,注意和支付宝账号保持一致
  • └ service_provider_id
  • String
  • 可选
  • 2088501624816263
  • 渠道商支付宝ID
  • └ trade_source
  • String
  • 可选
  • self
  • 交易场景来源 window(窗口) self(自助机)

响应参数

名称 类型 示例值 描述
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();
TvmCreateOrderRq obj1 = new TvmCreateOrderRq();
obj1.setAgentOrderId("12345");
obj1.setMachineNumber("001");
List<TvmPassengerVo> list3 = new ArrayList<TvmPassengerVo>();
TvmPassengerVo obj4 = new TvmPassengerVo();
list3.add(obj4);
obj4.setFullPrice(9000L);
obj4.setHasChildren(false);
obj4.setRiderCertNumber("1111");
obj4.setRiderCertType("01");
obj4.setRiderName("张三");
obj4.setSeatNumber("46");
obj4.setServiceCharge(0L);
obj4.setTicketPrice(9000L);
obj4.setAgentEticket("12308");
obj4.setAgentTicketId("ASSS1");
obj4.setInsurePrice(0L);
obj1.setPassengers(list3);
obj1.setTicketCount(2L);
obj1.setTotalPrice(18000L);
TvmBusLineInfo obj5 = new TvmBusLineInfo();
obj5.setDepTime("2017-03-10 21:11:01");
obj5.setDistance(1000L);
obj5.setLastPlaceName("上海");
obj5.setStartCityName("杭州");
obj5.setStartProvinceName("上海");
obj5.setStartStationId("1111");
obj5.setStartStationName("上海虹桥车站");
obj5.setToStationCityName("杭州");
obj5.setToStationId("111");
obj5.setToStationName("杭州总站");
obj5.setToStationProvinceName("浙江");
obj5.setTerminal("宁波");
obj5.setBusNumber("PT222");
obj5.setStartStationAddress("xxx");
obj5.setBusType("豪华,空调等");
obj5.setRuntime(10L);
obj1.setTvmBusLineInfo(obj5);
obj1.setRealName(true);
List<AccountInDetail> list7 = new ArrayList<AccountInDetail>();
AccountInDetail obj8 = new AccountInDetail();
list7.add(obj8);
obj8.setAlipayAccount("alipay@xx.com");
obj8.setAmount(100L);
obj8.setAlipayAccountId("211000090098");
obj1.setAccountInDetails(list7);
obj1.setServiceProviderId("2088501624816263");
obj1.setTradeSource("self");
req.setParamTVMCreateOrderRQ(obj1);
BusTvmcreateorderSetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • 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>

异常示例

  • 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>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部