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

taobao.bus.tvmbookorder.set (线下自助机通知出票接口)

出票,当成功的时候告知出票;当失败的时候告知出票失败,飞猪退款给用户。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
alitrip_order_id String 必须 10000241 飞猪订单号
book_time String 必须 2017-03-03 11:22:33 出票时间 2017-03-03 11:22:33
fetch_phone String 可选 17701011234 取票人手机号
passengers TvmPassengerVo [] 可选
  • 最大列表长度:20
  • 乘客票面信息
    • └ agent_eticket
    • String
    • 可选
    • ""
    • 电子票内容
    • └ agent_ticket_id
    • String
    • 可选
    • 00001002
    • 票号ID
    • └ full_price
    • Number
    • 可选
    • 1100
    • 标准票价
    • └ has_children
    • Boolean
    • 可选
    • false
    • 是否带有儿童
    • └ rider_cert_number
    • String
    • 可选
    • 111213199010105678
    • 身份证号
    • └ rider_cert_type
    • String
    • 可选
    • 1
    • 证件类型
    • └ rider_name
    • String
    • 可选
    • 张三
    • 姓名
    • └ seat_number
    • String
    • 可选
    • 20
    • 座位号
    • └ service_charge
    • Number
    • 可选
    • 0
    • 服务费
    • └ ticket_price
    • Number
    • 可选
    • 1000
    • 实际票价
    pay_mode String 必须 ALIPAY 取值范围 ALIPAY (飞猪渠道); WECHAT(微信); BANKCARD(银行卡);CASH(现金); OWN_ALIPAY(自身支付宝渠道,非飞猪渠道)
    success Boolean 必须 true true代表出票成功;false代表出票失败
    support_eticket Boolean 可选 false
  • 默认值:false
  • 是否支持电子票
    ticket_gate String 可选 12F 检票口

    响应参数

    名称 类型 示例值 描述
    result_code String 11 errorCode
    result_msg String 22 errorMsg
    is_success Boolean true success

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    BusTvmbookorderSetRequest req = new BusTvmbookorderSetRequest();
    req.setAlitripOrderId("10000241");
    req.setBookTime("2017-03-03 11:22:33");
    req.setFetchPhone("17701011234");
    List<BusTvmbookorderSetRequest.TvmPassengerVo> list2 = new ArrayList<BusTvmbookorderSetRequest.TvmPassengerVo>();
    BusTvmbookorderSetRequest.TvmPassengerVo obj3 = new BusTvmbookorderSetRequest.TvmPassengerVo();
    list2.add(obj3);
    obj3.setAgentEticket("\"\"");
    obj3.setAgentTicketId("00001002");
    obj3.setFullPrice(1100L);
    obj3.setHasChildren(false);
    obj3.setRiderCertNumber("111213199010105678");
    obj3.setRiderCertType("1");
    obj3.setRiderName("张三");
    obj3.setSeatNumber("20");
    obj3.setServiceCharge(0L);
    obj3.setTicketPrice(1000L);
    req.setPassengers(list2);
    req.setPayMode("ALIPAY");
    req.setSuccess(true);
    req.setSupportEticket(false);
    req.setTicketGate("12F");
    BusTvmbookorderSetResponse rsp = client.execute(req, sessionKey);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <bus_tvmbookorder_set_response>
        <result_code>11</result_code>
        <result_msg>22</result_msg>
        <is_success>true</is_success>
    </bus_tvmbookorder_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

    返回
    顶部