Petra2 Java API – SjStinaInformationProviderInterface.findAvailableHotelRoom

Method description

Metoden används för att söka hotellrum på en angiven ort under en angiven period.

Antal personer anges vid sökning för att man enbart ska få tillbaka bokningsbara hotellrum i svaret från Netbook. Om man bokar med barn måste man använda GivenNumberOfRooms:NetbookgivenNumberOfRooms.

Om man vill ha avstånd till närmaste järnvägsstation i svaret så skickar man in det i IncludeDistanceToTrain.

I svaret får man tillbaka en lista av bokningsbara alternativ. Sorteringen i svaret sker hos Netbook. Sorteringsordningen styrs av SortOrder.

Ett bokningsbart alternativ kan innehålla flera hotellrum. Pris returneras både per bokningsbart alternativ och per rum.

Man får även tillbaka diverse information per hotellrum i svaret. Bland annat en URL till mer info om hotellet, antal sängar per rum, om bokningen måste garanteras med kontokort.

Typisk sekvens av metoder.
For Javadoc, click here.

Input

FindAvailableHotelRoomQuery

Olika attribut kan sättas för att precisera sökningen.

HotelCustomerID
Kundnummer hos Netbook.

HotelLocationId
Orten man vill söka på. Tas ifrån uppsökt station (Location) som för vissa stationer innehåller en HotelLocationId

HotelNamePattern
Hotellnamn. Del av namn kan anges. Används för att söka efter ett specifikt hotell.

GivenNumberOfGuests:NetbookGivenNumberOfGuests
Används om man vill boka rum enbart för vuxen. Antal vuxna och antal önskade vuxna per rum anges.

GivenNumberOfRooms:NetbookGivenNumberOfRooms
Används om man vill boka rum för barn och vuxen. Antal rum, antal vuxna och barnens ålder skickas in. Anger man fler än ett rum blir det samma antal vuxna och barn för varje rum. Barnens ålder läggs in i en lista och antal åldrar visar antalet barn.

SortOrder
Styr hur Netbook ska sortera sökresultatet. Default är blankt, då sorteras söksvaret enligt överenskommelse mellan SJ och Netbook. Man kan även sortera på:
  • SJPConstans.VHotelSortOrderAgreement
  • SJPConstans.VHotelSortOrderHotel
  • SJPConstans.VHotelSortOrderLocation
  • SJPConstans.VHotelSortOrderPrice
  • SJPConstans.VHotelSortOrderRandom

    • IncludeDistanceToTrain
    Bestämmer ifall avstånd till närmaste järnvägsstation ska skicka med i sökresultatet.

    Output

    FindAvailableHotelRoomResult

    Innehåller olika bokningsalternativ inkl. diverse information om hotellet och rummen.

    NetbookAvailableList
    Lista med olika hotell och rumsförslag (NetbookAvailable). Listan kan innehålla flera olika rum och rumstyper ifall man har sökt hotellrum för flera personer. Här presenteras även övergripande hotellinformation.

    NetbookAvailable:HotelShortInfoUrl
    En länk till en webbsida som är administrerad av Netbook med information om hotellet.

    BookableOption
    En lista med bokningsbara alternativ, kan bestå av flera olika typer av rum. Innehåller rum för samtliga personer som angavs vid sökning.

    BookableRoom
    En lista med hotellrum.

    BookableRoom:LastPossibleTimeForCancellation
    Visar sista möjliga avbokningstidpunkt, datum och tid.

    BookableRoom:GuaranteeRequired
    En flagga som talar om ifall bokningen måste garanteras med kontokort. Om flaggan är True måste kontokortsuppgifter skickas in vid bokning.

    BookableRoom:RoomTypeLockData
    Nyckel till ett rumsförslag. Används i metoden addHotelRoomLock för att lägga till ett rumsförslag till en varukorg.

    HotelRoomType:NetbookHotelRoomType
    Beskriver rumstypen.

    NetbookAgreement:NetbookAgreement
    Innehåller rummets priskategori (Agreement), erbjudandekod (HotelOfferCode) och en beskrivning av priskategorin (AgreementDescriptionText).