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

alibaba.happytrip.order.hotel.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
  • 可选
  • 020000000100000000000001xxxx4926
  • 订单号
  • └ 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
  • HotelOrderDTO []
  • 订单列表;可空
  • expense_list
  • OrderExpenseDetailDTO []
  • 订单费用信息;可空
  • └ amount
  • String
  • 100.000000000
  • 金额;不可空
  • └ currency_code
  • String
  • CNY
  • 币种;不可空
  • └ expense_detail
  • String
  • 酒店房费
  • 费用类型描述;不可空
  • └ expense_type
  • String
  • HOTEL_ROOM_RPICE
  • 费项类型:酒店房费 HOTEL_ROOM_RPICE、酒店退款房费 HOTEL_REFUND_FEE;不可空
  • └ order_id
  • String
  • 020000000100000000000001xxxx4926
  • 订单号;不可空
  • └ resource_id
  • String
  • 111
  • 资源ID,资源唯一标识;不可空
  • └ expense_time
  • String
  • 2023-09-10 09:12:00
  • 费用产生时间;不可空
  • └ apply_type
  • String
  • BOOK
  • 预定类型:预定 BOOK,退款 REFUND;不可空
  • └ trade_action
  • Number
  • 1
  • 支付方向:1支付 2退款;不可空
  • └ pay_type
  • Number
  • 1
  • 支付类型:1企业支付,2个人支付;不可空
  • 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
  • 5
  • 订单主类型;不可空
  • └ order_class_id_desc
  • String
  • 酒店
  • 机酒火大类;不可空
  • └ order_class_second_id
  • Number
  • 14
  • 订单子类型;不可空
  • └ order_class_second_id_desc
  • String
  • 飞猪国内酒店
  • 国内国际等;不可空
  • └ order_id
  • String
  • 020000000100000000000001xxxx4926
  • 欢行订单号;不可空
  • └ order_status
  • Number
  • 6
  • 订单状态;订单状态;1-创建中,2-已取消,3-等待付款,4-退款待确认,6-已完成,7-已关闭,11-取消中,12-下单失败;不可空
  • └ order_status_desc
  • String
  • 已完成
  • 订单状态描述;不可空
  • └ submit_user_name
  • String
  • 张三
  • 差旅单提交人名称;不可空
  • └ submit_user_work_no
  • String
  • 000001
  • 差旅单提交人工号;不可空
  • └ supplier_order_id
  • String
  • 299436555850429xxxx
  • 供应商订单号;不可空
  • └ 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
  • 单据归属公司编码;可空
  • └ pay_mode
  • Number
  • 1
  • 订单支付类型:1企业支付,2个人支付,3混合支付(企业支付+个人支付);不可空
  • └ company_pay_amount
  • String
  • 100.000000000
  • 订单企业支付实付金额,等于订单费用中公付费用的金额总和;可空
  • └ person_pay_amount
  • String
  • 100.000000000
  • 订单个付实付金额,等于订单费用中个付费用的金额总和;可空
  • resource_list
  • HotelResourceDTO []
  • 订单资源信息,一个酒店订单中对应一个酒店资源信息;不可空
  • └ address
  • String
  • 无锡xx区xx街道xxx号
  • 酒店地址;不可空
  • └ adult_count
  • Number
  • 1
  • 成人数量;可空
  • └ average_room_price
  • String
  • 150
  • 均价;不可空
  • └ brand_name
  • String
  • Crowne Plaza by IHG (CRS)
  • 品牌名称;可空
  • └ catering_standard
  • String
  • 150
  • 餐标;可空
  • └ checkin
  • String
  • 2023/09/12
  • 入住时间;不可空
  • └ checkin_user_work_no
  • String
  • 000001
  • 入住人工号;不可空
  • └ checkout
  • String
  • 2023/09/12
  • 离开时间;不可空
  • └ chummage_user_work_no
  • String
  • 000001
  • 合住人工号;可空
  • └ city_name
  • String
  • 无锡市
  • 城市名称;不可空
  • └ country
  • String
  • 中国
  • 国家;可空
  • └ hotel_standard
  • String
  • 500
  • 住宿标准;可空
  • └ name
  • String
  • xx旅馆
  • 酒店名称;不可空
  • └ nights
  • Number
  • 1
  • 入住几晚;可空
  • └ order_id
  • String
  • 020000000100000000000001xxxx4926
  • 欢行订单号;不可空
  • └ payment_mode
  • Number
  • 2
  • 支付类型:1-对公支付,2-个人支付;可空
  • people_tourist_list
  • HotelPeopleTouristDTO []
  • 常旅客信息;不可空
  • └ chummage_begin_time
  • String
  • 2023/09/12
  • 合住开始时间;可空
  • └ chummage_end_time
  • String
  • 2023/09/12
  • 合住结束时间;可空
  • └ chummage_order_id
  • String
  • 020000000100000000000001xxxx4926
  • 合住订单id;可空
  • └ chummage_status
  • String
  • 0
  • 合住确认状态;可空
  • └ work_no
  • String
  • 000001
  • 工号;不可空
  • └ first_name
  • String
  • 名;可空
  • └ last_name
  • String
  • 姓;可空
  • └ name
  • String
  • 张三
  • 入住人或者合住人姓名;可空
  • └ order_id
  • String
  • 020000000100000000000001xxxx4926
  • 欢行订单号;不可空
  • └ sequence_no
  • Number
  • 1
  • 序号;可空
  • └ phone
  • String
  • 188xxxx8888
  • 电话;可空
  • └ region
  • String
  • 江宁区
  • 行政区县;可空
  • └ room_count
  • Number
  • 1
  • 房间数量;可空
  • └ room_status
  • String
  • canbooking
  • 房态类型;可空
  • └ room_type_name
  • String
  • 四人床位-飞猪无早
  • 房名名称;可空
  • └ sequence_no
  • Number
  • 1
  • 序号;可空
  • └ 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);
AlibabaHappytripOrderHotelListRequest req = new AlibabaHappytripOrderHotelListRequest();
AlibabaHappytripOrderHotelListRequest.OrderGetRequest obj1 = new AlibabaHappytripOrderHotelListRequest.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("020000000100000000000001xxxx4926");
obj1.setPageNumber(1L);
obj1.setPageSize(20L);
obj1.setUserWorkNo("000001");
obj1.setSourceTaHeadId("100001");
obj1.setCorpId("-1");
req.setParamOrderGetRequest(obj1);
AlibabaHappytripOrderHotelListResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alibaba_happytrip_order_hotel_list_response>
    <result>
        <content>
            <cotents>
                <hotel_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>HOTEL_ROOM_RPICE</expense_type>
                            <order_id>020000000100000000000001xxxx4926</order_id>
                            <resource_id>111</resource_id>
                            <expense_time>2023-09-10 09:12:00</expense_time>
                            <apply_type>BOOK</apply_type>
                            <trade_action>1</trade_action>
                            <pay_type>1</pay_type>
                        </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>5</order_class_id>
                        <order_class_id_desc>酒店</order_class_id_desc>
                        <order_class_second_id>14</order_class_second_id>
                        <order_class_second_id_desc>飞猪国内酒店</order_class_second_id_desc>
                        <order_id>020000000100000000000001xxxx4926</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>299436555850429xxxx</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>
                        <pay_mode>1</pay_mode>
                        <company_pay_amount>100.000000000</company_pay_amount>
                        <person_pay_amount>100.000000000</person_pay_amount>
                    </order_base_info>
                    <resource_list>
                        <hotel_resource_d_t_o>
                            <address>无锡xx区xx街道xxx号</address>
                            <adult_count>1</adult_count>
                            <average_room_price>150</average_room_price>
                            <brand_name>Crowne Plaza by IHG (CRS)</brand_name>
                            <catering_standard>150</catering_standard>
                            <checkin>2023/09/12</checkin>
                            <checkin_user_work_no>000001</checkin_user_work_no>
                            <checkout>2023/09/12</checkout>
                            <chummage_user_work_no>000001</chummage_user_work_no>
                            <city_name>无锡市</city_name>
                            <country>中国</country>
                            <hotel_standard>500</hotel_standard>
                            <name>xx旅馆</name>
                            <nights>1</nights>
                            <order_id>020000000100000000000001xxxx4926</order_id>
                            <payment_mode>2</payment_mode>
                            <people_tourist_list>
                                <hotel_people_tourist_d_t_o>
                                    <chummage_begin_time>2023/09/12</chummage_begin_time>
                                    <chummage_end_time>2023/09/12</chummage_end_time>
                                    <chummage_order_id>020000000100000000000001xxxx4926</chummage_order_id>
                                    <chummage_status>0</chummage_status>
                                    <work_no>000001</work_no>
                                    <first_name>三</first_name>
                                    <last_name>张</last_name>
                                    <name>张三</name>
                                    <order_id>020000000100000000000001xxxx4926</order_id>
                                    <sequence_no>1</sequence_no>
                                </hotel_people_tourist_d_t_o>
                            </people_tourist_list>
                            <phone>188xxxx8888</phone>
                            <region>江宁区</region>
                            <room_count>1</room_count>
                            <room_status>canbooking</room_status>
                            <room_type_name>四人床位-飞猪无早</room_type_name>
                            <sequence_no>1</sequence_no>
                            <resource_id>111</resource_id>
                        </hotel_resource_d_t_o>
                    </resource_list>
                </hotel_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_hotel_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

返回
顶部