文档中心 > API类目 > 欢行开发平台API

alibaba.happytrip.order.train.list (火车票订单同步)

火车票订单同步

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
param_order_get_request OrderGetRequest 必须 订单获取请求
  • └ create_begin_time
  • String
  • 可选
  • 2023-09-10 09:12:00
  • 订单创建时间-开始时间
  • └ create_end_time
  • String
  • 可选
  • 2023-09-10 09:12:00
  • 订单创建时间-结束时间
  • └ modified_begin_time
  • String
  • 可选
  • 2023-09-10 09:12:00
  • 订单修改时间-开始时间
  • └ modified_end_time
  • String
  • 可选
  • 2023-09-10 09:12:00
  • 订单修改时间-结束时间
  • └ order_id
  • String
  • 可选
  • 010000000100000000000001xxxx4926
  • 订单号
  • └ page_number
  • Number
  • 必须
  • 1
  • 分页页码,从0开始
  • └ page_size
  • Number
  • 必须
  • 20
  • 分页大小,默认每次20,最大不得超过100
  • └ user_work_no
  • String
  • 可选
  • 000001
  • 待查询用户工号
  • └ source_ta_head_id
  • String
  • 可选
  • 100001
  • 差旅单号
  • └ corp_id
  • String
  • 可选
  • -1
  • 租户ID,一个应用使用多租户模式下启用,需要欢行提供

响应参数

名称 类型 示例值 描述
result ResultDTO 返回结果
  • content
  • Page
  • 业务处理返回结果
  • cotents
  • TrainOrderDTO []
  • 订单列表
  • expense_list
  • OrderExpenseDetailDTO []
  • 订单费用信息
  • └ amount
  • String
  • 100.000000000
  • 金额:不可空
  • └ currency_code
  • String
  • CNY
  • 币种:不可空
  • └ expense_detail
  • String
  • 火车票价
  • 费用类型描述:不可空
  • └ expense_type
  • String
  • TRAIN_TICKET_PRICE
  • 费项类型:火车票价 TRAIN_TICKET_PRICE、改签手续费 TRAIN_TICKET_CHANGE_FEE、退票手续费 TRAIN_TICKET_REFUND_FEE:不可空
  • └ order_id
  • String
  • 010000000100000000000001xxxx4926
  • 欢行订单号:不可空
  • └ ticket_id
  • String
  • 1000000001
  • 费用关联的火车票ID:不可空
  • └ expense_time
  • String
  • 2023-09-10 09:12:00
  • 费用产生时间:不可空
  • └ apply_type
  • String
  • BOOK
  • 预定类型:预定 BOOK,改签 CHANGE,退票 REFUND:不可空
  • └ resource_id
  • String
  • 111
  • 资源ID,资源唯一标识:不可空
  • └ trade_action
  • Number
  • 1
  • 支付方向:1支付 2退款:不可空
  • └ pay_type
  • Number
  • 1
  • 支付类型:1企业支付,2个人支付:不可空
  • └ origin_ticket_id
  • String
  • 1000000002
  • 改签票关联的原票ID:不可空
  • └ name
  • String
  • 张三
  • 出行人姓名:不可空
  • └ work_no
  • String
  • 000001
  • 出行人工号:可空
  • └ expense_ticket_id
  • String
  • 1000000002
  • 费用归属的票的id:不可空
  • └ expense_resource_id
  • String
  • 111
  • 费用归属的资源ID,资源唯一标识:不可空
  • └ idempotent
  • String
  • RESERVE_1000000002
  • 幂等号:不可空
  • order_base_info
  • OrderBaseDTO
  • 订单基础信息:不可空
  • └ book_time
  • String
  • 2023-09-10 09:12:00
  • 订单下单时间:不可空
  • └ buyer_user_name
  • String
  • 张三
  • 预订人名称:不可空
  • └ buyer_user_work_no
  • String
  • 000001
  • 预订人工号:不可空
  • └ order_class_id
  • Number
  • 火车
  • 订单主类型:4是机票、5是酒店、6是打车、7是火车:不可空
  • └ order_class_id_desc
  • String
  • 7
  • 机酒火大类,是订单主类型的描述信息:不可空
  • └ order_class_second_id
  • Number
  • 71
  • 订单子类型:不可空
  • └ order_class_second_id_desc
  • String
  • 飞猪国内火车票
  • 国内国际等:不可空
  • └ order_id
  • String
  • 010000000100000000000001xxxx4926
  • 欢行订单号:不可空
  • └ order_status
  • Number
  • 0
  • 订单状态:2-已取消,6-已完成,20-待支付,23-有改签单,24-有退票单,25-出票完成,26-退票申请中,27-改签申请中,28-已出票,29-出票失败,30-改签失败,31-退票失败:不可空
  • └ order_status_desc
  • String
  • 已出票
  • 订单状态描述,订单状态的描述:不可空
  • └ submit_user_name
  • String
  • 张三
  • 差旅单提交人名称:不可空
  • └ submit_user_work_no
  • String
  • 000001
  • 差旅单提交人工号:不可空
  • └ supplier_order_id
  • String
  • 100001
  • 供应商订单号:不可空
  • └ source_id
  • String
  • 100001
  • 差旅单号:不可空
  • └ source_ta_line_id
  • String
  • 1100001
  • 来源系统差旅单行程ID,作为行程标识:不可空
  • └ total_amount
  • String
  • 100.000000000
  • 订单总金额:不可空
  • └ total_amount_currency_code
  • String
  • CNY
  • 币种代码:不可空
  • └ company_code
  • String
  • A50
  • 单据归属公司编码:不可空
  • └ company_pay_amount
  • String
  • 100.000000000
  • 订单企业支付实付金额,等于订单费用中公付费用的金额总和;可空
  • └ pay_mode
  • Number
  • 1
  • 订单支付类型:1企业支付,2个人支付,3混合支付(企业支付+个人支付);不可空
  • └ person_pay_amount
  • String
  • 100.000000000
  • 订单个付实付金额,等于订单费用中个付费用的金额总和:可空
  • resource_list
  • TrainResourceDTO []
  • 订单资源信息,每张车票为一个resource
  • └ apply_time
  • String
  • 2023-09-10 09:12:00
  • 申请时间:不可空
  • └ arrive_city_name
  • String
  • 无锡
  • 到达城市名称:不可空
  • └ arrive_date
  • String
  • 2022/12/20
  • 到达日期:不可空
  • └ arrive_station_name
  • String
  • 无锡东
  • 到达车站名称:可空
  • └ arrive_time
  • String
  • 19:50
  • 到达时间点:不可空
  • └ boarding_gates
  • String
  • 17A
  • 检票口:不可空
  • change_list
  • TrainChangeDTO []
  • 改签单相关内容:可空
  • └ apply_time
  • String
  • 2023-09-10 09:12:00
  • 改签申请时间:不可空
  • └ change_apply_id
  • String
  • 1
  • 改签申请单号:不可空
  • └ change_cost
  • String
  • 120
  • 改签手续费:不可空
  • └ change_id
  • String
  • 010000000100000000000001xxxx4926
  • 改签单号:不可空
  • └ change_order_id
  • String
  • 010000000100000000000001xxxx4926
  • 改签订单号:不可空
  • └ change_rate
  • String
  • 3
  • 改签费率:不可空
  • └ change_reason
  • String
  • 1
  • 改签原因:1-因工作变动需要改签,费用无需差旅人承担;2-因火车取消或延误导致的改签,费用无需差旅人承担;3-因为生病,司机晚到或堵车导致的改签,费用无需差旅人承担;4-因忘带证件、处理私事等主观原因需要改签,费用需自理:可空
  • └ change_reason_type
  • Number
  • 因工作变动需要改签,费用无需差旅人承担
  • 改签原因类型:1、2、3、4,含义参考改签原因:可空
  • └ change_status
  • Number
  • 10
  • 改签状态:0、1、2、3、4、5、6、-1,含义参考改签状态描述:不可空
  • └ change_status_desc
  • String
  • 出票失败
  • 外部改签状态描述:0 初始化、1 待支付、2 处理中、3 改签成功、4 改签失败、5 改签待确认、6 改签占座中、-1 未知:不可空
  • └ change_ticket_no
  • String
  • 010000000100000000000001xxxx4926
  • 改签新票号:不可空
  • └ change_total
  • String
  • 132
  • 改签整体费用:不可空
  • └ diff_price
  • String
  • 12
  • 改签差价:不可空
  • └ original_ticket_no
  • String
  • 306712A08609239961xxx
  • 改签原票:不可空
  • └ sequence_no
  • Number
  • 1
  • 序号:不可空
  • └ check_in_place
  • String
  • 17A
  • 检票口:可空
  • └ contract_name
  • String
  • 张三
  • 联系人:不可空
  • └ cost
  • String
  • 120
  • 花费:不可空
  • └ depart_city_name
  • String
  • 杭州
  • 出发城市名称:可空
  • └ depart_date
  • String
  • 2022/12/20
  • 出发日期:不可空
  • └ depart_station_name
  • String
  • 杭州东
  • 出发车站名称:可空
  • └ depart_time
  • String
  • 19:50
  • 出发时间点:不可空
  • └ distance
  • String
  • 1
  • 运行公里数:可空
  • └ entrance_no
  • String
  • 17A
  • 进站口:可空
  • └ has_change_ticket
  • Number
  • 1
  • 是否有改签:1改签 0无:可空
  • └ has_refund_ticket
  • Number
  • 1
  • 是否有退票:1退票 0无:可空
  • └ order_id
  • String
  • 010000000100000000000001xxxx4926
  • 欢行订单id:不可空
  • refund_list
  • TrainRefundDTO []
  • 退票单相关内容:可空
  • └ sequence_no
  • Number
  • 1
  • 序号:不可空
  • └ refund_no
  • String
  • 1
  • 退款id:不可空
  • └ apply_reason
  • String
  • 测试示例
  • 退款原因:可空
  • └ apply_answer
  • String
  • 测试示例
  • 退款申请回复:可空
  • └ ticket_no
  • String
  • 306712A08609229936241
  • 退票票号:不可空
  • └ create_time
  • String
  • 2023-09-10 09:12:00
  • 申请时间:不可空
  • └ refuse_time
  • String
  • 2023-09-10 09:12:00
  • 拒绝时间:不可空
  • └ refund_fee
  • String
  • 1023
  • 退款金额:不可空
  • └ refund_cost
  • String
  • 54
  • 退款手续费:不可空
  • └ refund_status
  • String
  • 40
  • 退票状态:10 处理中、20 已拒绝、30 已同意、40 已退款、50 待确认:不可空
  • └ trade_action
  • Number
  • 2
  • 支付方向:1支付 2退款:不可空
  • └ refund_rate
  • String
  • 2
  • 费率:不可空
  • └ refund_reason
  • String
  • 因工作变动需要退票,费用无需差旅人承担
  • 退款原因描述:因工作变动需要退票,费用无需差旅人承担;因火车取消或延误导致的退票,费用无需差旅人承担;因火车车次取消或延误,本人或直系亲属生病而不适宜乘车导致的退票,费用无需差旅人承担;因为生病,司机晚到或堵车导致的退票,费用无需差旅人承担;因忘带证件、处理私事等主观原因需要退票,费用需自理:可空
  • └ resource_type
  • Number
  • 1
  • 火车资源类型:1买 2改:不可空
  • └ resource_type_desc
  • String
  • 火车资源描述:不可空
  • └ run_time
  • String
  • 120
  • 运行时间:可空
  • └ sequence_no
  • Number
  • 1
  • 序号:可空
  • └ sub_order_id
  • String
  • 010000000100000000000001xxxx4926
  • 子订单id:不可空
  • ticket_list
  • TrainTicketDTO []
  • 票据:不可空
  • └ sequence_no
  • Number
  • 1
  • 序号
  • └ ticket_type
  • String
  • 正向票
  • 票类型(正向票,改签票):不可空
  • └ ticket_status
  • Number
  • 3
  • 车票状态:0-待支付,1-已支付,2-出票成功,3-已退票,4-改签中,5-改签待支付,6-已改签,7-改签票,8-已关闭,9-已入账,10-退票处理中,11-退票失败,15-已校验:不可空
  • └ ticket_price
  • String
  • 120
  • 票价:不可空
  • └ coach_no
  • String
  • 2
  • 车厢号:可空
  • └ coach_name
  • String
  • 2
  • 车厢名称:可空
  • └ seat_no
  • String
  • 006D
  • 座位号:可空
  • └ seat_name
  • String
  • 二等座
  • 座位名称:可空
  • └ seat_type
  • String
  • O
  • 座位类型:可空
  • └ original_ticket_no
  • String
  • 306712A0861212909xxxx
  • 改签退票原始票:可空
  • └ check_in_place
  • String
  • 14A
  • 检票口:可空
  • └ abnormal_type
  • Number
  • 1
  • 异常状态类型:1:退 2:改:不可空
  • └ abnormal_type_desc
  • String
  • 火车票退票
  • 异常状态描述:可空
  • └ abnormal_cost
  • String
  • 0
  • 异常操作手续费:不可空
  • └ abnormal_fee
  • String
  • 0
  • 异常操作花费:不可空
  • └ diff_price
  • String
  • 120
  • 差价:不可空
  • └ ticket_no
  • String
  • 306712A0861212909xxxx
  • 车票号:不可空
  • └ total_amount
  • String
  • 0
  • 票的总花费金额:不可空
  • └ depart_date_time
  • String
  • 2023-09-10 09:12:00
  • 出发时间:不可空
  • └ name
  • String
  • 张三
  • 名字:不可空
  • └ work_no
  • String
  • 000001
  • 工号:可空
  • └ ticket_status_desc
  • String
  • 待支付
  • 车票状态描述,配合车票状态使用:0-待支付,1-已支付,2-出票成功,3-已退票,4-改签中,5-改签待支付,6-已改签,7-改签票,8-已关闭,9-已入账,10-退票处理中,11-退票失败,15-已校验:不可空
  • └ ticket_id
  • String
  • 1000000001
  • 火车票ID:不可空
  • └ ticket_price
  • String
  • 120
  • 车票价格:不可空
  • └ trade_action
  • Number
  • 1
  • 支付方向:1正向 2逆向:不可空
  • └ train_no
  • String
  • G530
  • 列车编号:不可空
  • └ train_type
  • String
  • 高铁
  • 列车类型:不可空
  • └ train_type_name
  • String
  • 高铁
  • 列车类型名称:可空
  • └ waiting_room
  • String
  • 大厅
  • 候车大厅:可空
  • └ resource_id
  • String
  • 111
  • 资源ID,资源唯一标识:不可空
  • pagination
  • Pagination
  • 页码参数
  • └ page_number
  • String
  • 1
  • 分页页码
  • └ page_size
  • String
  • 20
  • 分页大小
  • └ total_count
  • String
  • 20
  • 返回总数
  • └ error_code
  • String
  • 100000
  • 错误码
  • └ error_msg
  • String
  • 内部服务处理异常
  • 错误信息
  • └ stack_trace
  • String
  • TaeBussinessException
  • 错误异常栈
  • └ success
  • String
  • true
  • 请求是否处理成功

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaHappytripOrderTrainListRequest req = new AlibabaHappytripOrderTrainListRequest();
AlibabaHappytripOrderTrainListRequest.OrderGetRequest obj1 = new AlibabaHappytripOrderTrainListRequest.OrderGetRequest();
obj1.setCreateBeginTime("2023-09-10 09:12:00");
obj1.setCreateEndTime("2023-09-10 09:12:00");
obj1.setModifiedBeginTime("2023-09-10 09:12:00");
obj1.setModifiedEndTime("2023-09-10 09:12:00");
obj1.setOrderId("010000000100000000000001xxxx4926");
obj1.setPageNumber(1L);
obj1.setPageSize(20L);
obj1.setUserWorkNo("000001");
obj1.setSourceTaHeadId("100001");
obj1.setCorpId("-1");
req.setParamOrderGetRequest(obj1);
AlibabaHappytripOrderTrainListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_happytrip_order_train_list_response>
    <result>
        <content>
            <cotents>
                <train_order_d_t_o>
                    <expense_list>
                        <order_expense_detail_d_t_o>
                            <amount>100.000000000</amount>
                            <currency_code>CNY</currency_code>
                            <expense_detail>火车票价</expense_detail>
                            <expense_type>TRAIN_TICKET_PRICE</expense_type>
                            <order_id>010000000100000000000001xxxx4926</order_id>
                            <ticket_id>1000000001</ticket_id>
                            <expense_time>2023-09-10 09:12:00</expense_time>
                            <apply_type>BOOK</apply_type>
                            <resource_id>111</resource_id>
                            <trade_action>1</trade_action>
                            <pay_type>1</pay_type>
                            <origin_ticket_id>1000000002</origin_ticket_id>
                            <name>张三</name>
                            <work_no>000001</work_no>
                            <expense_ticket_id>1000000002</expense_ticket_id>
                            <expense_resource_id>111</expense_resource_id>
                            <idempotent>RESERVE_1000000002</idempotent>
                        </order_expense_detail_d_t_o>
                    </expense_list>
                    <order_base_info>
                        <book_time>2023-09-10 09:12:00</book_time>
                        <buyer_user_name>张三</buyer_user_name>
                        <buyer_user_work_no>000001</buyer_user_work_no>
                        <order_class_id>火车</order_class_id>
                        <order_class_id_desc>7</order_class_id_desc>
                        <order_class_second_id>71</order_class_second_id>
                        <order_class_second_id_desc>飞猪国内火车票</order_class_second_id_desc>
                        <order_id>010000000100000000000001xxxx4926</order_id>
                        <order_status>0</order_status>
                        <order_status_desc>已出票</order_status_desc>
                        <submit_user_name>张三</submit_user_name>
                        <submit_user_work_no>000001</submit_user_work_no>
                        <supplier_order_id>100001</supplier_order_id>
                        <source_id>100001</source_id>
                        <source_ta_line_id>1100001</source_ta_line_id>
                        <total_amount>100.000000000</total_amount>
                        <total_amount_currency_code>CNY</total_amount_currency_code>
                        <company_code>A50</company_code>
                        <company_pay_amount>100.000000000</company_pay_amount>
                        <pay_mode>1</pay_mode>
                        <person_pay_amount>100.000000000</person_pay_amount>
                    </order_base_info>
                    <resource_list>
                        <train_resource_d_t_o>
                            <apply_time>2023-09-10 09:12:00</apply_time>
                            <arrive_city_name>无锡</arrive_city_name>
                            <arrive_date>2022/12/20</arrive_date>
                            <arrive_station_name>无锡东</arrive_station_name>
                            <arrive_time>19:50</arrive_time>
                            <boarding_gates>17A</boarding_gates>
                            <change_list>
                                <train_change_d_t_o>
                                    <apply_time>2023-09-10 09:12:00</apply_time>
                                    <change_apply_id>1</change_apply_id>
                                    <change_cost>120</change_cost>
                                    <change_id>010000000100000000000001xxxx4926</change_id>
                                    <change_order_id>010000000100000000000001xxxx4926</change_order_id>
                                    <change_rate>3</change_rate>
                                    <change_reason>1</change_reason>
                                    <change_reason_type>因工作变动需要改签,费用无需差旅人承担</change_reason_type>
                                    <change_status>10</change_status>
                                    <change_status_desc>出票失败</change_status_desc>
                                    <change_ticket_no>010000000100000000000001xxxx4926</change_ticket_no>
                                    <change_total>132</change_total>
                                    <diff_price>12</diff_price>
                                    <original_ticket_no>306712A08609239961xxx</original_ticket_no>
                                    <sequence_no>1</sequence_no>
                                </train_change_d_t_o>
                            </change_list>
                            <check_in_place>17A</check_in_place>
                            <contract_name>张三</contract_name>
                            <cost>120</cost>
                            <depart_city_name>杭州</depart_city_name>
                            <depart_date>2022/12/20</depart_date>
                            <depart_station_name>杭州东</depart_station_name>
                            <depart_time>19:50</depart_time>
                            <distance>1</distance>
                            <entrance_no>17A</entrance_no>
                            <has_change_ticket>1</has_change_ticket>
                            <has_refund_ticket>1</has_refund_ticket>
                            <order_id>010000000100000000000001xxxx4926</order_id>
                            <refund_list>
                                <train_refund_d_t_o>
                                    <sequence_no>1</sequence_no>
                                    <refund_no>1</refund_no>
                                    <apply_reason>测试示例</apply_reason>
                                    <apply_answer>测试示例</apply_answer>
                                    <ticket_no>306712A08609229936241</ticket_no>
                                    <create_time>2023-09-10 09:12:00</create_time>
                                    <refuse_time>2023-09-10 09:12:00</refuse_time>
                                    <refund_fee>1023</refund_fee>
                                    <refund_cost>54</refund_cost>
                                    <refund_status>40</refund_status>
                                    <trade_action>2</trade_action>
                                    <refund_rate>2</refund_rate>
                                    <refund_reason>因工作变动需要退票,费用无需差旅人承担</refund_reason>
                                </train_refund_d_t_o>
                            </refund_list>
                            <resource_type>1</resource_type>
                            <resource_type_desc>买</resource_type_desc>
                            <run_time>120</run_time>
                            <sequence_no>1</sequence_no>
                            <sub_order_id>010000000100000000000001xxxx4926</sub_order_id>
                            <ticket_list>
                                <train_ticket_d_t_o>
                                    <sequence_no>1</sequence_no>
                                    <ticket_type>正向票</ticket_type>
                                    <ticket_status>3</ticket_status>
                                    <ticket_price>120</ticket_price>
                                    <coach_no>2</coach_no>
                                    <coach_name>2</coach_name>
                                    <seat_no>006D</seat_no>
                                    <seat_name>二等座</seat_name>
                                    <seat_type>O</seat_type>
                                    <original_ticket_no>306712A0861212909xxxx</original_ticket_no>
                                    <check_in_place>14A</check_in_place>
                                    <abnormal_type>1</abnormal_type>
                                    <abnormal_type_desc>火车票退票</abnormal_type_desc>
                                    <abnormal_cost>0</abnormal_cost>
                                    <abnormal_fee>0</abnormal_fee>
                                    <diff_price>120</diff_price>
                                    <ticket_no>306712A0861212909xxxx</ticket_no>
                                    <total_amount>0</total_amount>
                                    <depart_date_time>2023-09-10 09:12:00</depart_date_time>
                                    <name>张三</name>
                                    <work_no>000001</work_no>
                                    <ticket_status_desc>待支付</ticket_status_desc>
                                    <ticket_id>1000000001</ticket_id>
                                </train_ticket_d_t_o>
                            </ticket_list>
                            <ticket_price>120</ticket_price>
                            <trade_action>1</trade_action>
                            <train_no>G530</train_no>
                            <train_type>高铁</train_type>
                            <train_type_name>高铁</train_type_name>
                            <waiting_room>大厅</waiting_room>
                            <resource_id>111</resource_id>
                        </train_resource_d_t_o>
                    </resource_list>
                </train_order_d_t_o>
            </cotents>
            <pagination>
                <page_number>1</page_number>
                <page_size>20</page_size>
            </pagination>
            <total_count>20</total_count>
        </content>
        <error_code>100000</error_code>
        <error_msg>内部服务处理异常</error_msg>
        <stack_trace>TaeBussinessException</stack_trace>
        <success>true</success>
    </result>
</alibaba_happytrip_order_train_list_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

返回
顶部