方法名称

hotel.list

使用说明

1. 
   

2. 1.酒店列表搜索,可搜索180天内的可卖酒店数据。日期的限定可以在日历上实现，同时在调用接口前验证。

3. 
   

4. 2.搜索结果对应的库存已经做到每分钟更新。
   

5. 
   

6. 3.【注意】目前列表搜索每个酒店只返回最多两个产品。如果有展开报价的功能，需请求一次hotel.detail接口。
   

7. 
   

8. 4.支付方式：

     分为现付和预付

     现付：分为担保与非担保：

     担保：分为全额担保和首晚担保，都需要考虑取消的情况，但客户到店依然需要支付房费，担保的费用会退回用户。

     预付：预付都是全额预付，也要考虑取消的情况。

     现付的担保和预付的全款都需要调用支付功能。

     艺龙提供一种公司担保业务，开通此业务，成单时可以不向艺龙提交用户的信用卡信息。需要开通请联系商务。

输入参数

Position节点

响应结果

根节点

Hotel节点

BookingRule节点

GuaranteeRule节点

PrepayRule节点

GuaranteeRuleExtend节点

PrepayRuleExtend节点

PenaltyWindowType 节点

ValueAdd节点

DrrRule节点

Room节点

RatePlan节点

NightlyRate节点

Detail节点

Review节点

ExchangeRate节点

NightlyRateWithBreakfast节点

HotelFilterType节点

当FilterType=1031 且 FilterId=11031 需要筛选钟点房时，还需要ResultType传入9。

输入参数示例

    https://api-test.elong.com/rest?timestamp=1489721030&format=json
    &method=hotel.list&signature=5b293eddc2fa89fe560e62aeba6b7ee4
    &user={userid}&data={"Version":"1.28","Local":"zh_CN",
    "Request":{"ArrivalDate":"2017-3-18","DepartureDate":"2017-3-19",
    "CityId":"0101","PageIndex":1,"PageSize":10,"ResultType":"1,2,4","PaymentType":"All"}}

输出参数示例

    {
        "Code":"0",
        "Result":{
            "Count":13,
            "Hotels":[
                {
                    "HotelId":"90101033",
                    "LowRate":200.0,
                    "CurrencyCode":"RMB",
                    "Distance":0.0,
                    "BookingRules":[
                        {
                            "BookingRuleId":70660,
                            "TypeCode":"NeedPhoneNo",
                            "DateType":"BookDay",
                            "StartDate":"2013-07-05T00:00:00 08:00",
                            "EndDate":"2063-07-05T00:00:00 08:00",
                            "StartHour":"00:00:00",
                            "EndHour":"23:59:00",
                            "Description":"酒店要求客人务必提供手机号"
                        }
                    ],
                    "GuaranteeRules":[
                   
                    ],
                    "PrepayRules":[
                        {
                            "PrepayRuleId":1,
                            "DateType":"CheckInDay",
                            "StartDate":"2017-03-18T00:00:00 08:00",
                            "EndDate":"2017-03-19T00:00:00 08:00",
                            "WeekSet":"1,2,3,4,5,6,7,",
                            "ChangeRule":"PrepayNoChange",
                            "CashScaleFirstAfter":"FristNight",
                            "CashScaleFirstBefore":"FristNight",
                            "DateNum":"2017-03-17T00:00:00 08:00",
                            "Time":"",
                            "DeductFeesAfter":1,
                            "DeductFeesBefore":0,
                            "DeductNumAfter":0.0,
                            "DeductNumBefore":0.0,
                            "Hour":0,
                            "Hour2":0,
                            "Description":"预付规则：在17.03.18 到17.03.19期间入住，需要提供信用卡预付全额房费。一经预订成功不可变更/取消。"
                        }
                    ],
                    "ValueAdds":[
                   
                    ],
                    "DrrRules":[
                   
                    ],
                    "Rooms":[
                        {
                            "RoomId":"0016",
                            "Name":"标准间",
                            "RatePlans":[
                                {
                                    "Status":true,
                                    "CustomerType":"All",
                                    "CurrentAlloment":0,
                                    "InstantConfirmation":false,
                                    "ProductTypes":"3",
                                    "IsLastMinuteSale":false,
                                    "StartTime":"00:00:00",
                                    "EndTime":"23:59:00",
                                    "TotalRate":200.0,
                                    "AverageRate":200.0,
                                    "AverageBaseRate":200.0,
                                    "CurrencyCode":"RMB",
                                    "Coupon":0.0,
                                    "NightlyRates":[
                                        {
                                            "Member":200.0,
                                            "Cost":-1.0,
                                            "Status":true,
                                            "AddBed":-1.0,
                                            "Date":"2017-03-18T00:00:00 08:00",
                                            "BreakfastCount":0,
                                            "coupon":0.0
                                        }
                                    ],
                                    "BookingRuleIds":"70660",
                                    "PrepayRuleIds":"1",
                                    "ValueAddIds":"",
                                    "RoomTypeId":"0016",
                                    "HotelCode":"90101033",
                                    "InvoiceMode":"Elong",
                                    "BookingChannels":"1,2,3",
                                    "CooperationType":1,
                                    "RatePlanId":478789,
                                    "RatePlanName":"不含早(代理预付)",
                                    "MinAmount":1,
                                    "MinDays":1,
                                    "MaxDays":365,
                                    "PaymentType":"Prepay"
                                }
                            ]
                        }
                    ],
                    "Gifts":[
                   
                    ],
                    "HAvailPolicys":[
                   
                    ]
                }
            ]
        },
        "Guid":"cd9620d8-d188-45e2-9938-e6200ad303ab"
    }

注意事项

1. 
   

2. 1.InvoiceModel字段为Elong时，不代表一定由艺龙开具发票。只有预付产品才有可能为Elong，预付产品如果接入方自己不想要开发票，可以联系商务开通代开发票服务，此时才是艺龙开具发票，如果不开通代开服务，则由接入方自己开具发票。

3. 
   

4. 2.入参中CustomerType字段传入All表示搜索对所有宾客售价一致的产品，此时搜索结果中不包含CustomerType类型为Chinese、OtherForeigh等类型的产品。常见问题是，调用hotel.list时传入CustomerType为All，返回结果中没有产品，但是调用hotel.detail查询该酒店时发现有产品。此时请注意hotel.detail返回的产品中是没有CustomerType为All类型的产品的。如果需要查询所有产品，那么调用hotel.list时CustomerType传None。

5. 
   

6. 3.Product节点和Room节点是两套体系，数据存在重复，只返回其中一套即可。ResultType字段不包含6，返回Room节点，传入6则仅返回Product节点。一般使用Room节点。
   

7. 
   

8. 4.担保规则（GuaranteeRule节点）使用说明：展示的时候只需要展示描述字段，不需要进行其他处理。在填写订单时根据以下判断是否需要提交支付信息。调用hotel.list和hotel.detail这两个搜索接口的时候若出现了担保规则，则有可能需要担保的（但也可能根据客人选择的条件判断后没有满足条件的担保规则，那么不需要担保），如果没有出现担保规则，则是不需要担保的。担保规则筛选顺序：先判断IsAmountGuarantee和IsTimeGuarantee字段，再根据结果来决定最后判断的字段。IsAmountGuarantee和IsTimeGuarantee字段的详细判断如下：
   

常见错误码