Petra2 Java API – SjItineraryResultInterface.getItineraries
Method description
Metoden används för att hämta svaret på en förbindelsesökning. Man måste först göra en förbindelsesökning med findItineraries eller findItinerariesLight för att få tag i objektet SjItineraryResultInterface.
Svaret innehåller en lista med förbindelser enligt frågan (ItineraryList). Varje förbindelse (Itinerary) innehåller en lista med en eller flera delsträckor (SectionList) där varje delsträcka (Section) beskrivs med avgångstid, ankomsttid, avgångsstation, ankomststation, färdmedel som finns för den delsträckan m m. Valbara prisgrupper ligger på förbindelsenivå. Prisgrupperna måste man hålla reda på så att man inte ställer en prisfråga eller försöker boka på en ogiltig prisgrupp. För varje prisgrupp finns det även en statuskod (StatusCode):
- J = Prisgruppen är tillgänglig för försäljning
- N = Prisgruppen är ej tillgänglig för försäljning pga. förköpsregler
- S = Prisgruppen är tillfälligt slutsåld
BookingRule beskriver vad som gäller för reserveration av plats på ett tåg. Bookable finns kvar av bakåtkompabilitetsskäl, men bör inte användas.
För varje prisgrupp (AvailablePriceGroup) finns en lista med tillgängliga tillval. De olika frivilliga komponenterna presenteras i en lista (OptionDescriptionList). Färdkomponenterna, som är obligatoriska, och är grunden för prisgruppen finns inte med i listan utan är implicit beskrivna i prisgruppen (PriceGroupCode). Tillvalen skickas sedan in vid prisfråga och bokning. Tillvalen delas in i olika typer av tillval (TypeOfOption).
När man är klar med sökningsresultatet bör man anropa metoden close.
For Javadoc, click here.
Input
No input
Output
Itineraries
- Itineraries
- ItineraryList, sekvens av:
- Itinerary
- ItineraryReference:ObjectStringRef
- DepartureLocation:Location
- ProducerCode:Code
- LocationId:Identity
- LocationName:String
- [LocationLongName:String]
- [HotelLocationId:Identity]
- [LocationCode:String]
- [ExistsInTimetable:boolean]
- DepartureDateTime:DateTime
- TimeZone:String
- Year:int
- Month:int
- Day:int
- Hour:int
- Minute:int
- [Second:int]
- ArrivalLocation:Location
- ProducerCode:Code
- LocationId:Identity
- LocationName:String
- [LocationLongName:String]
- [HotelLocationId:Identity]
- [LocationCode:String]
- [ExistsInTimetable:boolean]
- ArrivalDateTime:DateTime
- TimeZone:String
- Year:int
- Month:int
- Day:int
- Hour:int
- Minute:int
- [Second:int]
- TransportationDuration:TimeSpan
- Days:int
- Hours:int
- Minutes:int
- Seconds:int
- NumberOfSections:IntegerString
- [SectionList], sekvens av:
- Section
- SectionReference:ObjectStringRef
- DepartureLocation:Location
- ProducerCode:Code
- LocationId:Identity
- LocationName:String
- [LocationLongName:String]
- [HotelLocationId:Identity]
- [LocationCode:String]
- [ExistsInTimetable:boolean]
- DepartureDateTime:DateTime
- TimeZone:String
- Year:int
- Month:int
- Day:int
- Hour:int
- Minute:int
- [Second:int]
- ArrivalLocation:Location
- ProducerCode:Code
- LocationId:Identity
- LocationName:String
- [LocationLongName:String]
- [HotelLocationId:Identity]
- [LocationCode:String]
- [ExistsInTimetable:boolean]
- ArrivalDateTime:DateTime
- TimeZone:String
- Year:int
- Month:int
- Day:int
- Hour:int
- Minute:int
- [Second:int]
- TransportationDuration:TimeSpan
- Days:int
- Hours:int
- Minutes:int
- Seconds:int
- ProductCode:Code
- [Comfort:Code]
- TransportId:Identity
- TravelMethodCode:Code
- [TransportInformation], sekvens av:
- CodePlaintext
- Code:Code
- Plaintext:String
- [SectionProducerCode:Code]
- [SectionProducerName:String]
- Bookable:boolean
- [BookingRule:String]
- [ViaLocationList], sekvens av:
- Location
- ProducerCode:Code
- LocationId:Identity
- LocationName:String
- [LocationLongName:String]
- [HotelLocationId:Identity]
- [LocationCode:String]
- [ExistsInTimetable:boolean]
- [ServiceBrandInformation:ServiceBrandInformation]
- [ServiceBrandName:String]
- [LimitedSeatsList], sekvens av:
- Availability
- [DescriptionCode:String]
- [Description:String]
- Amount:String
- [SeatAvailability:String]
- [FareAvailability:String]
- [SpecialFareAvailabilities], sekvens av:
- FareAvailability
- FareType:String
- FareAvailability:String
- [PriceGroupList], sekvens av:
- AvailablePriceGroup
- PriceGroupCode:Code
- [ContractualPriceGroup:Code]
- [OptionList], sekvens av:
- Option
- OptionDescription:OptionDescription
- TypeOfOption:String
- ComponentNumber:IntegerString
- [VariantNumber:IntegerString]
- [Description:String]
- [VariantList], sekvens av:
- Variant
- VariantNumber:IntegerString
- Description:String
- [DefaultVariant:boolean]
- [Price:Money]
- CurrencyCode:Code
- Amount:DecimalString
- [OtherProducersFees:Money]
- CurrencyCode:Code
- Amount:DecimalString
- [ExchangeVoucherAmount:Money]
- CurrencyCode:Code
- Amount:DecimalString
- [SummarizeAmountCode:Code]
- [PaymentInformationList], sekvens av:
- PaymentInformation
- PaymentType:Code
- [CardNumber:String]
- Amount:Money
- CurrencyCode:Code
- Amount:DecimalString
- [VariantHelpText:String]
- [OptionHelpText:String]
- [Mandatory:boolean]
- [SectionReference:ObjectStringRef]
- StatusCode:Code
- [Amount:IntegerString]
- [MaximumNumberOfTravellers:IntegerString]
- [LimitedSeatsCode:String]
- [DemandLevel:String]
- [ExtendedLimitedSeatsList], sekvens av:
- LimitedSeats
- [DescriptionCode:String]
- [Description:String]
- Amount:String
- [PriceCoefficient:String]
- [ItineraryCampaignInformationList], sekvens av:
- ItineraryCampaignInformation
- [MaximumNoOfItinerariesReached:boolean]
- [MaximumNumberOfPriceQuotes:IntegerString]
- [ItineraryResult:ByteArray]
- [ClientInformation:ClientInformation]
- ClientSessionData:ClientSessionData
- SessionId:String
- [SessionLanguageCode:String]
- [OrderNumber:String]
- [CustomerRoleCode:Code]
- [OrderCreatorCustomerId:String]
- [LockId:String]
- [ClientVersion:String]
- Protocol:Protocol
- Compressed:boolean
- [Algorithm:String]
- [Encoding:String]
- [CachePolicy:String]
- [TimeInformation], sekvens av:
- [TimeInformation]
- [CloneName:String]
- Description:String
- MethodName:String
- Time:String
- LogTime:String
- [TimeInformation:TimeInformation]
- [InitialCloneName:String]
- [ExternalEventSpecification:ExternalEventSpecification]
- [OverrideTimeLogLevel:boolean]