Petra2 Java API – SjStinaInformationProviderInterface.calculateTravelServiceTransportDetailedPriceBasedOnSpecification

Method description

Metoden användas för att ställa en prisfråga och hämta detaljerat pris för en eller flera tjänster kopplade till en förbindelse med fler delsträckor utan någon uppsökt tidtabell.

I stället för en tidtabell (ItineraryReference) används en lista av delsträckor (TransportSectionSpecificationList) som indata. Eftersom inget tidtabellssvar (Itinerary) finns som grund till prisfrågan byggs en förbindelse upp internt i StinaServer med hjälp av de delsträckor som finns i frågan. Denna förbindelse används sedan vid prisfråga mot det centrala systemet.

När en tidtabell (Itinerary) finns tillgänglig ska i stället metoden calculateTravelServiceDetailedPriceBasedOnLightSpecification användas.


For Javadoc, click here.

Input

TravelServiceTransportDetailedPriceSpecification

Output

TravelServiceTransportDetailedPriceResult

Strukturen utgör utdata för metoden och returnerar priser för den specificerade förbindelsen, resenärer och tillval.

Här beskrivs endast vissa av elementen i TravelServiceDetailedPriceLight. För de enkla fälten finns förklaringar vid respektive fält.

TravelServiceDetailedPriceLight
TravelServiceDetailedPriceLight innehåller samtliga resenärers priser i en viss prisgrupp.
PriceGroupCode
Aktuell prisgrupp.
Price
Summan av samtliga tjänsters (PriceItemLightDescription) priser inklusive alla tillvalskomponenter och alla deras varianter och därför bör fältet endast användas vid en specifik prisfråga.
Points
Summan av samtliga tjänsters priser inklusive alla tillvalskomponenter och alla deras varianter uttryckt i SJ Prio-poäng för poängtjänster. Detta fält används enbart för SJ-tjänster, som kan betalas med SJ Prio-poäng och bör endast användas vid en specifik prisfråga.
PriceItemLightList
En lista med priser för respektive resenär.
Price
Summan av priserna för tjänstens samtliga komponenter och alla deras varianter och därför bör fältet endast användas vid en specifik prisfråga. För att presentera ett korrekt tjänstepris ska BasePriceDescription.PriceInclVat, PlacementPriceDescription.PriceInclVat och Variant.Price för de valda tillvalskomponentvarianterna summeras.
ExchangeVoucherAmount
Tjänstens ombokningsvärde.
OtherProducersFees
Summan av av tjänstens samtliga komponentvarianters bokningsavgift och därför bör fältet endast användas vid en specifik prisfråga.
BasePriceDescription
Fr o m 2009-03-21 basresan, som består av färdkomponenter, obligatoriska platskomponenter och obligatoriska tillvalskomponenter inklusive de vars pris ska särredovisas som ett "varav-pris".
PriceInclVat
Basresans pris. Observera att även de obligatoriska tillvalskomponenter, vars pris ska särredovisas som ett "varav-pris", ingår här.
SeparateServiceOptionList
De obligatoriska tillvalskomponenter, vars pris ska särredovisas som ett "varav-pris", t ex Stationsavgift Arlanda C.
TransportPriceDescription
Summan av färdkomponenternas priser. Färdkomponenternas priser ska aldrig presenteras var för sig eftersom alla färdkomponenter måste säljas tillsammans för att bilda en komplett resa. Fr o m 2009-03-21 används inte denna struktur. Priset på färdkomponenterna ingår i stället i BasePriceDescription.
PlacementPriceDescription
Samtliga platskomponenter finns med i denna struktur.
PriceInclVat
Summan av de frivilliga platskomponenternas priser. De obligatoriska platskomponenternas priser ingår i BasePriceDescription.
PlacementPriceSectionDescriptionList
En lista med samtliga platskomponenter i varsin PlacementPriceSectionDescription.
PriceInclVat
Platskomponentens pris, om den är frivillig. En obligatorisk platskomponents pris ingår i BasePriceDescription.
DepartureLocation
Stationen där resan börjar, dvs första delsträckans frånstation.
ArrivalLocation
Stationen där resan slutar, dvs sista delsträckans tillstation.
ServiceOptionList
En lista med möjliga tillvalskomponenter i varsin ServiceOption och deras varianter. Om tillvalet bara finns på en delsträcka identifieras den med SectionReference. Om tillvalet gäller hela resan finns ingen SectionReference.
OptionDescription
En beskrivning av tillvalskomponenten.
VariantNumber
Fr o m 2009-03-21 används inte detta fält. I stället returneras tillvalskomponentens möjliga varianter i VariantList.
VariantList
Fr o m 2009-03-21 en lista med de olika varianterna av tillvalskomponenten i varsin Variant.
Price
Tillvalskomponentvariantens pris. De tillvalskomponenter som finns i SeparateServiceOptionList har inget pris här för att undvika felaktig summering av priser.
Mandatory
Fr o m 2009-03-21 markerar detta fält att tillvalskomponenten är obligatorisk.
Price
Fr o m 2009-03-21 finns priset för tillvalskomponenten endast i bokningssvar, aldrig i svaret på en prisfråga. Priset på respektive tillvalskomponentvariant finns i stället i VariantList.
Points
Tjänstens pris inklusive alla tillvalskomponenter och alla deras varianter uttryckt i SJ Prio-poäng för poängtjänster. Detta fält används enbart för SJ-tjänster, som kan betalas med SJ Prio-poäng och bör endast användas vid en specifik prisfråga.
ServiceName
Varunamnet är en beteckning på tjänst eller vara som ingår i försäljningsutbudet, t ex Normalbiljett.
DiscountTypeList
Här redovisas om någon av resenärerna i ConsumerDescription har någon form av rabatt samt hur mycket den i så fall utgör av det aktuella priset. Bör endast användas för en specifik prisfråga.
ConsumerDescriptionList
Innehåller en lista med alla resenärernas resenärstyp.
PriceSectionDescriptionList
Innehåller för vissa klientapplikationer en beskrivning av resans delsträckor.