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

taobao.train.agent.bookticket.confirm (火车票代理商接口——确认出票是否成功)

火车票代理商接口——确认出票是否成功

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
sub_order_id String 可选 123434 错误的子订单号123434,123432
can_change Boolean 可选 false
  • 默认值:true
  • 是否支持在线退改签
    main_order_id Number 必须 123456 主订单id
    status Boolean 必须 true 是否成功
    agent_id Number 必须 123 代理商id
    tickets String [] 必须 453648717;59650;14;二等座_08_05D号;G1327;郭国新;0;5226254123213213125;0;0
  • 最大列表长度:10
  • 火车票子订单id;单价;坐席;座次号;车次;乘车人姓名;证件类型;证件号码;保单号;保单价格 (座次号格式:坐席_车厢号_座位号,eg1:硬卧_09_03号下铺 eg2:硬座_02_03c ,注意:票价、保险价格必须到分)
    ticket_num Number 必须 1 订单中包含的票数量
    dep_date String 必须 2013-08-08 11:11:11 出发时间
    ticket_12306_id String 必须 123456 12306成功出票id
    fail_msg String 必须 1 记录失败原因,传数字,1:票已售完,2:票价变动,3:乘车人已购相同车票,4:出票超时,5:乘车人证件未通过铁路局核验,6:发车时间变动,7:车次信息变更,8:12306故障,9:学生票信息有误,10:身份冒用,11:被限制高消费,12:坐票已售完,13:行程冲突,14:预售期变更,15:用户12306账号登录失败,16:12306账号存在未支付订单,17:用户常旅客已满,18:乘客信息有误,19:非法席别,20:车次停运,21:session登陆失败,22:账户已在其他地方登陆,23:帐号手机未核验,24:取消订单次数达到上限,25:帐号持有人身份未核验,26:邮寄地址无法保证及时送达,27:无法满足用户定制需求,28:您主动要求取消,0:未知原因
    alipay_trade_no String 可选 2013092511001001990049119607 支付宝交易流水号
    order_type Number 可选 0 订单类型 0 代购 1直购 3抢票
    alipay_account String 可选 abc@gmail.com 支付宝账号
    arrive_date String 可选 2013-08-08 11:11:11 到达时间
    from_station_name String 可选 北京南 出发站
    to_station_name String 可选 徐州东 到达站
    boarding_gates String 可选 13 检票口

    响应参数

    名称 类型 示例值 描述
    is_success Boolean false 是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
    TrainAgentBookticketConfirmRequest req = new TrainAgentBookticketConfirmRequest();
    req.setSubOrderId("123434");
    req.setCanChange(false);
    req.setMainOrderId(123456L);
    req.setStatus(true);
    req.setAgentId(123L);
    req.setTickets("453648717;59650;14;二等座_08_05D号;G1327;郭国新;0;5226254123213213125;0;0");
    req.setTicketNum(1L);
    req.setDepDate("2013-08-08 11:11:11");
    req.setTicket12306Id("123456");
    req.setFailMsg("1");
    req.setAlipayTradeNo("2013092511001001990049119607");
    req.setOrderType(0L);
    req.setAlipayAccount("abc@gmail.com");
    req.setArriveDate("2013-08-08 11:11:11");
    req.setFromStationName("北京南");
    req.setToStationName("徐州东");
    req.setBoardingGates("13");
    TrainAgentBookticketConfirmResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <train_agent_bookticket_confirm_response>
        <is_success>false</is_success>
    </train_agent_bookticket_confirm_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>

    错误码解释

    错误码 错误描述 解决方案
    isv.service-error 系统未知错误 请重试
    isv.invalid-parameter:orderid 主订单id不存在 请查找原因,输入正确订单号
    isv.invalid-check-parameter:params 出票成功时,校验参数失败,请检查参数重试 检查参数重新上传
    isv.trade-had-closed 订单关闭 不用重新调用
    isv.invalid-parameter:orderId is exists 已调用过出票确认订单 不需要重试,如果还没显示出票成功,请联系技术人员
    isv.SYSTEM_ERROR 系统异常 重试
    isv.invalid-check-parameter 参数校验出错 请检查入参
    isv.user-cancel-order 用户关单 关单处理

    API工具

    如何获得此API

    FAQ

    返回
    顶部