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

alibaba.happytrip.order.flight.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
  • FlightOrderDTO []
  • 订单列表
  • expense_list
  • OrderExpenseDetailDTO []
  • 订单费用信息:不可空
  • └ amount
  • String
  • 100.000000000
  • 金额:不可空
  • └ currency_code
  • String
  • CNY
  • 币种:不可空
  • └ expense_detail
  • String
  • 机票票价
  • 费用类型描述:不可空
  • └ expense_type
  • String
  • AIR_TICKET_PRICE
  • 费项类型:机票票价 AIR_TICKET_PRICE、燃油 AIR_TICKET_FUEL、机建 AIR_TICKET_TAX、升舱差价 UPGRADE_DIFFERENCE、 改签手续费 AIR_TICKET_CHANGE_FEE、 退票手续费 AIR_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个人支付:不可空
  • └ expense_ticket_id
  • String
  • 1000000001
  • 费用关联的机票ID:不可空
  • └ expense_resource_id
  • String
  • 111
  • 资源ID,资源唯一标识:不可空
  • 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
  • 订单主类型:4是机票、5是酒店、6是打车、7是火车:不可空
  • └ order_class_id_desc
  • String
  • 机票
  • 机酒火大类:不可空
  • └ order_class_second_id
  • Number
  • 24
  • 订单子类型:不可空
  • └ order_class_second_id_desc
  • String
  • 飞猪国内机票
  • 国内国际等:不可空
  • └ order_id
  • String
  • 010000000100000000000001xxxx4926
  • 欢行订单号:不可空
  • └ order_status
  • Number
  • 6
  • 订单状态:1-创建中,2-已取消,6-已完成:不可空
  • └ order_status_desc
  • String
  • 已完成
  • 订单状态描述,配合order_status使用:不可空
  • └ submit_user_name
  • String
  • 张三
  • 差旅单提交人名称:不可空
  • └ submit_user_work_no
  • String
  • 000001
  • 差旅单提交人工号:不可空
  • └ supplier_order_id
  • String
  • 5714541906xxx
  • 供应商订单号:不可空
  • └ source_id
  • String
  • 100001
  • 差旅单号:不可空
  • └ source_ta_line_id
  • String
  • 1
  • 来源系统差旅单行程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
  • FlightResourceDTO []
  • 订单资源信息:不可空
  • └ airline_code
  • String
  • CA
  • 实际承运航司编码:不可空
  • └ airline_name
  • String
  • 中国国航
  • 实际承运航司名称:不可空
  • apply_list
  • FlightApplyDTO []
  • 改签/退票申请:可空
  • └ current_status
  • String
  • 2
  • 机票改升/退票状态:如果是改升:1-初始状态、2-接受(终结状态,对应改签优化后改签成功)、3-拒绝(终结状态)、4-未付款(已回填费用)、5-待回填票号(已付款/无需付款); 如果是退票:1-初始状态、2-费用完整、3-确认退款、4-失败、5-买家处理中(没有这个数据)、6-卖家处理中、7-等待小二回填金额(没有这个数据)、8-退款成功
  • └ online_flag
  • Number
  • 1
  • 线上线下标记:0线下 1线上:不可空
  • └ order_id
  • String
  • 010000000100000000000001xxxx4926
  • 欢行订单号:不可空
  • └ payment_mode
  • Number
  • 1
  • 支付类型:1-对公支付,2-个人支付:不可空
  • └ reason_code
  • String
  • RISE
  • 改升/退票编码:改升 RISE、退票 REFUND:可空
  • └ reason_describe
  • String
  • 因航班取消、延误,或因疫情防控政策、东航特殊客票政策,改签及票差费用无需差旅人承担
  • 改升/退原因描述(纯文案):可空
  • └ reason_type
  • String
  • 1
  • 改升/退原因类型:0 自愿退改、1 因航变等原因导致的非自愿退改:可空
  • └ sequence_no
  • Number
  • 1
  • 序号:可空
  • └ apply_type
  • String
  • CHANGE
  • 预定类型:预定 BOOK,改签 CHANGE,退票 REFUND:不可空
  • └ arrival_country_code
  • String
  • CN
  • 到达地国家代码:可空
  • └ arrival_country_name
  • String
  • 中国
  • 到达地国家名称:可空
  • └ arrival_state_code
  • String
  • 1
  • 到达州编码:可空
  • └ arrival_state_name
  • String
  • 亚洲
  • 到达州名称:可空
  • └ arrival_terminal
  • String
  • T4
  • 抵达航站楼:可空
  • └ arrive_airport_code
  • String
  • HGH
  • 抵达机场三字码:不可空
  • └ arrive_airport_name
  • String
  • 萧山国际机场
  • 抵达机场名称:可空
  • └ arrive_city_code
  • String
  • HGH
  • 抵达城市三字码:不可空
  • └ arrive_city_name
  • String
  • 杭州
  • 抵达城市名称:可空
  • └ arrive_datetime
  • String
  • 2023/10/31 9:40
  • 到达时间点:不可空
  • └ arrive_day_of_week
  • String
  • TU
  • 到达日期的周几,MOTUWETHFRSASU:可空
  • └ arrive_transfer_flag
  • String
  • TODO
  • 目的地是否是中转地:可空
  • └ arrive_transfer_info
  • String
  • TODO
  • 目的地中转的信息:可空
  • └ cabin_class_code
  • String
  • TODO
  • 舱位分类代码:可空
  • └ cabin_code
  • String
  • Y
  • 舱位代码:不可空
  • └ cabin_code_desc
  • String
  • 经济舱
  • 舱位等级代码描述:可空
  • └ departure_airport_code
  • String
  • PEK
  • 出发机场三字码:不可空
  • └ departure_airport_name
  • String
  • 首都国际机场
  • 出发机场名称:可空
  • └ departure_city_code
  • String
  • BJS
  • 出发城市code:不可空
  • └ departure_city_name
  • String
  • 北京
  • 出发城市名称:可空
  • └ departure_country_code
  • String
  • CN
  • 出发地国家代码:可空
  • └ departure_country_name
  • String
  • 中国
  • 出发地国家名称:可空
  • └ departure_datetime
  • String
  • 2023/10/31 9:40
  • 起飞具体时间:不可空
  • └ departure_day_of_week
  • String
  • TU
  • 出发日期的周几:可空
  • └ departure_state_code
  • String
  • 1
  • 出发地州编码:可空
  • └ departure_state_name
  • String
  • 亚洲
  • 出发地州名称:可空
  • └ departure_terminal
  • String
  • T3
  • 出发航站楼:可空
  • └ distance
  • String
  • 1200
  • 飞行距离:可空
  • └ duration
  • String
  • 130
  • 飞行时长:可空
  • └ flight_num
  • String
  • CA1704
  • 航班号:不可空
  • └ journey_number
  • String
  • 0
  • 行程段:可空
  • └ meal
  • String
  • TODO
  • 餐食:可空
  • └ memo
  • String
  • 测试
  • 备注:可空
  • └ order_id
  • String
  • 010000000100000000000001xxxx4926
  • 欢行订单号:不可空
  • └ plane_type
  • String
  • 789
  • 机型:可空
  • └ resource_type
  • String
  • BOOK
  • 资源类型:预定-BOOK,升舱-RISE:不可空
  • └ segment_num
  • String
  • TODO
  • 航段序号:可空
  • └ segment_type
  • String
  • -1
  • 航段类型:可空
  • └ sequence_no
  • Number
  • 1
  • 序号:可空
  • └ share_airline_code
  • String
  • 0
  • 共享航司编码:可空
  • └ share_airline_name
  • String
  • TODO
  • 共享航司名称:可空
  • └ share_flag
  • String
  • TODO
  • 是否共享航班:可空
  • └ share_flight_num
  • String
  • TODO
  • 共享航班号:可空
  • └ stop_airport_code
  • String
  • TODO
  • 经停机场代码:可空
  • └ stop_airport_name
  • String
  • TODO
  • 经停机场名称:可空
  • └ stop_arrive_datetime
  • String
  • TODO
  • 经停到达时间:可空
  • └ stop_city_code
  • String
  • TODO
  • 经停城市代码:可空
  • └ stop_city_name
  • String
  • TODO
  • 经停城市名称:可空
  • └ stop_departure_datetime
  • String
  • TODO
  • 经停起飞时间:可空
  • └ stop_flag
  • String
  • TODO
  • 经停标记:可空
  • ticket_list
  • FlightTicketDTO []
  • 机票信息:不可空
  • └ airline_union
  • String
  • TODO
  • 航司联盟:可空
  • └ cabin_code
  • String
  • Y
  • 乘客实际的舱位等级代码:同民航,A,M,X,U,V,W,G,Y,C,F等:可空
  • └ cabin_code_desc
  • String
  • 经济舱
  • 舱位等级代码描述,同民航:可空
  • └ work_no
  • String
  • 00001
  • 工号:可空
  • └ flight_segment_state
  • String
  • TODO
  • 航段状态:可空
  • └ main_book_flag
  • String
  • TODO
  • 主记录标记:可空
  • └ name
  • String
  • 张三
  • 名字:不可空
  • └ order_id
  • String
  • 010000000100000000000001xxxx4926
  • 欢行订单号:不可空
  • └ sell_ticket_country_code
  • String
  • CN
  • 售票国家码:可空
  • └ sequence_no
  • Number
  • 1
  • 序号:可空
  • └ ticket_code
  • String
  • 731-9197990821
  • 票号:不可空
  • └ ticket_state
  • String
  • 客票有效
  • 客票状态:客票有效, 已使用, 已出票, 已登机航班离港, 未使用:不可空
  • └ ticketing_carrier
  • String
  • MF
  • 出票航司:不可空
  • └ tourist_type
  • Number
  • 0
  • 出行人类型:0-成人,1-儿童,2-婴儿:可空
  • └ ticket_price
  • String
  • 100.000000000
  • 票价:不可空
  • └ ticket_id
  • String
  • 1000000001
  • 机票ID:不可空
  • └ 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);
AlibabaHappytripOrderFlightListRequest req = new AlibabaHappytripOrderFlightListRequest();
AlibabaHappytripOrderFlightListRequest.OrderGetRequest obj1 = new AlibabaHappytripOrderFlightListRequest.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);
AlibabaHappytripOrderFlightListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_happytrip_order_flight_list_response>
    <result>
        <content>
            <cotents>
                <flight_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>AIR_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>
                            <expense_ticket_id>1000000001</expense_ticket_id>
                            <expense_resource_id>111</expense_resource_id>
                        </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>4</order_class_id>
                        <order_class_id_desc>机票</order_class_id_desc>
                        <order_class_second_id>24</order_class_second_id>
                        <order_class_second_id_desc>飞猪国内机票</order_class_second_id_desc>
                        <order_id>010000000100000000000001xxxx4926</order_id>
                        <order_status>6</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>5714541906xxx</supplier_order_id>
                        <source_id>100001</source_id>
                        <source_ta_line_id>1</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>
                        <flight_resource_d_t_o>
                            <airline_code>CA</airline_code>
                            <airline_name>中国国航</airline_name>
                            <apply_list>
                                <flight_apply_d_t_o>
                                    <current_status>2</current_status>
                                    <online_flag>1</online_flag>
                                    <order_id>010000000100000000000001xxxx4926</order_id>
                                    <payment_mode>1</payment_mode>
                                    <reason_code>RISE</reason_code>
                                    <reason_describe>因航班取消、延误,或因疫情防控政策、东航特殊客票政策,改签及票差费用无需差旅人承担</reason_describe>
                                    <reason_type>1</reason_type>
                                    <sequence_no>1</sequence_no>
                                    <apply_type>CHANGE</apply_type>
                                </flight_apply_d_t_o>
                            </apply_list>
                            <arrival_country_code>CN</arrival_country_code>
                            <arrival_country_name>中国</arrival_country_name>
                            <arrival_state_code>1</arrival_state_code>
                            <arrival_state_name>亚洲</arrival_state_name>
                            <arrival_terminal>T4</arrival_terminal>
                            <arrive_airport_code>HGH</arrive_airport_code>
                            <arrive_airport_name>萧山国际机场</arrive_airport_name>
                            <arrive_city_code>HGH</arrive_city_code>
                            <arrive_city_name>杭州</arrive_city_name>
                            <arrive_datetime>2023/10/31 9:40</arrive_datetime>
                            <arrive_day_of_week>TU</arrive_day_of_week>
                            <arrive_transfer_flag>TODO</arrive_transfer_flag>
                            <arrive_transfer_info>TODO</arrive_transfer_info>
                            <cabin_class_code>TODO</cabin_class_code>
                            <cabin_code>Y</cabin_code>
                            <cabin_code_desc>经济舱</cabin_code_desc>
                            <departure_airport_code>PEK</departure_airport_code>
                            <departure_airport_name>首都国际机场</departure_airport_name>
                            <departure_city_code>BJS</departure_city_code>
                            <departure_city_name>北京</departure_city_name>
                            <departure_country_code>CN</departure_country_code>
                            <departure_country_name>中国</departure_country_name>
                            <departure_datetime>2023/10/31 9:40</departure_datetime>
                            <departure_day_of_week>TU</departure_day_of_week>
                            <departure_state_code>1</departure_state_code>
                            <departure_state_name>亚洲</departure_state_name>
                            <departure_terminal>T3</departure_terminal>
                            <distance>1200</distance>
                            <duration>130</duration>
                            <flight_num>CA1704</flight_num>
                            <journey_number>0</journey_number>
                            <meal>TODO</meal>
                            <memo>测试</memo>
                            <order_id>010000000100000000000001xxxx4926</order_id>
                            <plane_type>789</plane_type>
                            <resource_type>BOOK</resource_type>
                            <segment_num>TODO</segment_num>
                            <segment_type>-1</segment_type>
                            <sequence_no>1</sequence_no>
                            <share_airline_code>0</share_airline_code>
                            <share_airline_name>TODO</share_airline_name>
                            <share_flag>TODO</share_flag>
                            <share_flight_num>TODO</share_flight_num>
                            <stop_airport_code>TODO</stop_airport_code>
                            <stop_airport_name>TODO</stop_airport_name>
                            <stop_arrive_datetime>TODO</stop_arrive_datetime>
                            <stop_city_code>TODO</stop_city_code>
                            <stop_city_name>TODO</stop_city_name>
                            <stop_departure_datetime>TODO</stop_departure_datetime>
                            <stop_flag>TODO</stop_flag>
                            <ticket_list>
                                <flight_ticket_d_t_o>
                                    <airline_union>TODO</airline_union>
                                    <cabin_code>Y</cabin_code>
                                    <cabin_code_desc>经济舱</cabin_code_desc>
                                    <work_no>00001</work_no>
                                    <flight_segment_state>TODO</flight_segment_state>
                                    <main_book_flag>TODO</main_book_flag>
                                    <name>张三</name>
                                    <order_id>010000000100000000000001xxxx4926</order_id>
                                    <sell_ticket_country_code>CN</sell_ticket_country_code>
                                    <sequence_no>1</sequence_no>
                                    <ticket_code>731-9197990821</ticket_code>
                                    <ticket_state>客票有效</ticket_state>
                                    <ticketing_carrier>MF</ticketing_carrier>
                                    <tourist_type>0</tourist_type>
                                    <ticket_price>100.000000000</ticket_price>
                                    <ticket_id>1000000001</ticket_id>
                                </flight_ticket_d_t_o>
                            </ticket_list>
                            <resource_id>111</resource_id>
                        </flight_resource_d_t_o>
                    </resource_list>
                </flight_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_flight_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

返回
顶部