PETRA Gränssnittsbeskrivning

PETRA Gränssnittsbeskrivning Ekonomimeddelande Version 3.03 Utgiven 2013-05-28 Författare Henrik Nyman, Henrik Olofsson Filnamn PETRA Gränssnittsbeskrivning Ekonomimeddelande 3.03.docx

Innehåll 0 Revisioner... 4 1 Inledning... 5 2 Innehåll i XML-meddelandet... 6 2.1 DTD... 6 2.2 Beskrivning av meddelandestrukturen... 6 2.2.1 Elementet <DateTime> 13 2.2.2 Elementet <PriceInclVat> 13 2.2.3 Elementet <Vat> 14 2.3 Beskrivning av elementen i meddelandet... 14 2.3.1 Unik identifierare 14 2.3.2 Återsändning av meddelande 14 2.3.3 Säljställe 14 2.3.4 Tidpunkt för händelse 14 2.3.5 Beställare av första raden (fr o m 2007-06-02) 15 2.3.6 Händelser 15 2.3.7 Säljställekategori (fr o m 2006-11-11) 15 2.3.8 Redigeringsinformation (vid beställningskedja) 16 2.3.9 Kontokortsuppgifter 16 2.3.10 Kundkort för betalare 16 2.3.11 Konteringsinformation 16 2.3.12 Fakturareferens (fr o m 2008-03-08) 17 2.3.13 Kundprioritet (fr o m 2008-03-08) 17 2.3.14 Kundkort för resenär 17 2.3.15 Korttyp 17 2.3.16 Biljettnummer 18 2.3.17 Distributionssätt (fr o m 2009-10-17) 18 2.3.18 Tjänstepris 18 2.3.19 Momsspecifikation (fr o m 2009-06-06) 18 2.3.20 Krediteringsorsak (fr o m 2008-03-08) 20 2.3.21 Summerad betalningsinformation per beställningsrad 20 2.3.22 Resenärstyp 20 2.3.23 Antal resenärer 21 2.3.24 Lokaler 21 2.3.25 Komfort, prisnivå, prisgrupp och fare type 22 2.3.26 Avgång och ankomst 22 2.3.27 Färdmedelstyp 23 2.3.28 Beräknad andel av tjänstepris och moms på delsträckenivå och tillval 24 2.3.29 Orabatterat pris 24 2.3.30 Komponentens grundpris 25 2.3.31 Bokningsavgift 25 2.3.32 Statistikkilometer (fr o m 2009-10-17) 25 2.3.33 Betalningsinformation på komponentnivå (fr o m 2012-03-10) 26 2.3.34 Redigeringsåtgärd (fr o m 2011-10-22) 26 2.3.35 Obligatoriska komponenter (fr o m 2009-06-06) 26 2.3.36 Komponentnummer (fr o m 2009-06-06) 26 3 Beställningar i en beställningskedja... 27 2

3.1 Betalnings av ny version i kedjan (redigeringsbetalning)... 27 3.2 Blandning av betalningsmedel... 28 3.3 Exempel på en beställningskedja och vilka typer av Ekonomimeddelanden som genereras... 28 4 Exempel... 29 4.1 Elementet... 29 4.1.1 Delsträcka med färd och plats 29 4.1.2 Delsträcka utan platsreservation 30 4.1.3 Delsträcka i separat platsreservation 31 4.1.4 Övriga tjänster 32 4.1.5 Flexibilitet 33 4.2 Olika typer av tjänster... 34 4.2.1 SJ 1 klass med mat, kan återbetalas 34 4.2.2 SJ 1 klass utan mat, kan ombokas 35 4.2.3 SJ 2 klass, kan återbetalas, utan plats 35 4.2.4 SJ 2 klass, kan ombokas 35 4.2.5 SJ 2 klass, kan ej ombokas 35 4.2.6 SJ 2 klass, kan ej ombokas med tillvalet Internet ombord 36 4.2.7 Separat platsreservation 36 4.2.8 SJ Internet ombord 36 4.2.9 Hotellrum 37 4.2.10 Taxi 37 5 Exempel vid beställningskedja... 37 6 Versioner... 39 6.1 Giltiga versioner... 39 6.2 Förändringar i version 3.00... 39 6.2.1 Nya strukturer och fält 39 6.2.2 Förändrad användning av befintliga strukturer 41 6.3 Förändringar i samband med version 3.01... 42 6.3.1 Nya element 42 6.3.2 Förändringar av befintliga strukturer 42 6.4 Förändringar i version 3.02... 43 7 Referenser... 44 3

0 Revisioner Följande revisioner av dokumentet är gjorda: Datum Avsnitt Kommentar 2013-05-28 2.3.15, 2.3.22, Utökade förklaringar för vissa element. 2.3.27 2013-04-25 Nya element: From version 3.03 <JourneyconnectionReference> <ItineraryReference> <TravellerNumber> 2013-02-20 2.3.26 Förtydligande om ankomstdatum. 2012-10-30 2.3.9 Förtydligande rörande kontokortsuppgifter. 2012-10-15 2.3.30, 2.3.31, Omstrukturering av moms på komponentnivå 6.4 2012-06-18 2.3.1, 2.3.2, 2.3.19, 2.3.21, 2.3.28, 2.3.31, 2.3.33, 6.1, 6.3 Justering av betalningsinformation och tillägg av MessageId, version 3.01 2012-03-10 2.2, 2.3.8, 2.3.9, 2.3.16, 2.3.20, 2.3.21, 2.3.33, 2.3.34, 3, 3.1, 3.2, 3.3, 6.1, 6.2.1, 6.2.2 Hantering av beställningskedja och blandning av betalningsmedel, version 3.00 2011-04-05 Nytt element <BarCode> fr o m version 2.02 2010-03-15 4.2.9, 4.2.10 Fler exempel 2009-06-02 Nytt element <BarCode> fr o m version 2.01. 2009-05-10 2.3.4 2.3.17 2.3.32 Nya och ändrade element fr o m version 2.01: <PaymentDateTime> <DistributionCode> <StatisticalKilometer> 4

1 Inledning Detta dokument beskriver 3.03 av PETRA Ekonomimeddelande, som tas i produktion 2013-03-09 och kommer att finnas tillgängligt i testmiljöerna från december 2012. PETRA Ekonomimeddelande (EM) är ett XML-meddelande som kan skickas från PETRA till: 1. Ett resekontoföretag om valt betalningsmedel har åtgärden Ekonomimeddelande. 2. Säljställen som har tjänsten Ekonomimeddelande. 3. Beställningens betalande kund om denne har tjänsten Ekonomimeddelande. 4. Externa kompletteringssystem och säljsystem (för närvarande Icomera, SJ Kundprogramsystem och AccesRail) om beställningen har aktiva rader vars varunummer ska generera ett ekonomimeddelande. Ekonomimeddelande kan sändas då någon av följande transaktioner genomförs: Debitera beställning Uppdatering av tillfällig resenär på beställningsrad (enligt punkt 4 ovan) Avbeställa beställningsrad (enligt punkt 4 ovan) Kreditera beställningsrad Betala hos Biljett direkt Uthämtning av beställning (enligt punkt 4 ovan) fr o m 2007-03-10 Vid debitering av en beställning i status Delbetald kan både skickas debiterings-, avbeställning- och krediterings-em. Det kan även vara fler än ett avbeställnings- respektive krediterings-em som skickas. Se avsnitt 3.1 för en detaljerad beskrivning. Vid Kreditera särskilda fall skapas en ny beställning med ett nytt beställningsnummer och ett annat varunummer än den vara eller tjänst som krediteras. Inga detaljerade uppgifter om resenärer, sträckor, platser etc finns i detta meddelande. Orsaken till detta är att uppgifterna i den ursprungliga beställningen inte finns kvar eller att försäljningen gjorts i ett annat system än PETRA. 5

2 Innehåll i XML-meddelandet 2.1 DTD En DTD som utgör den formella definitionen på meddelandet finns på http://docs.linkon.se/ekonomimeddelande/. Normalt finns det två versioner publicerade, där den ena är aktuell version i produktionsmiljön. I de element som kan innehålla text ersätts vissa specialtecken med koder enligt XMLstandarden, till exempel: Tecken < < & Skrivs i XML som & 2.2 Beskrivning av meddelandestrukturen Meddelandet är hierarkiskt uppbyggt och innehållet hämtas i huvudsak från orderboken i PETRA. Efter vissa element finns styrtecken med följande betydelse:? Frivilligt element som kan utelämnas eller förekomma en gång + Obligatoriskt element som kan förekomma en eller flera gånger * Frivilligt element som kan utelämnas eller förekomma en eller flera gånger I nedanstående beskrivning av meddelandet är nya element markerade med fet stil och borttagna element markerade med genomstruken stil. Meddelandets innehåll (utan sluttaggar): Element Beskrivning Längd Källa <Em> E k o n o m i m e d d e l a n d e <Data> <MessageInfo> <HostSystem> Avsändare 6 LINKON <Version> Version av EM Varierar 3.00 <MessageId> Unik identifierare för meddelandet 15 Se avsnitt 2.3.1 <ResentMessage>? Flagga som indikerar återsänt meddelande Se avsnitt 2.3.2 <AgentInfo> Se avsnitt 2.3.3 <Destination> Mottagande resekontosystem 2 TFK.KORTKOD <PaymentSalesUnitId> Betalande säljställe resp. Krediterande säljställe 4 TFO.BETSTNR resp. TFOR.KDTSTNR <SalesUnitName> Säljställenamn 30 TMSST.SSTNMN <UserId> Användarid 6 TFO.BETANVDID <OrderCreator> Beställare 10 TFO.BSKNDNR <TerminalId> Betalningsterminal resp. Krediteringsterminal 8 TFO.BETTMLID resp. TFOR.KDTTMLID <PaymentDateTime> Händelsetidpunkt Se avsnitt 2.3.4 <RetrievalDateTime> Uthämtningstidpunkt TFO.UTHDAT & TFO.UTKLS <SalesUserName>? Resebyråns säljares namn 8 TFORBS.SLJNMN <OrderCreatorCardNumber>* Beställarens kortnummer 19 TFKIK.KORTNR 6

Element Beskrivning Längd Källa <CreatorUserId> Användarid för den som skapat första beställningsraden <OrderInfo> B e s t ä l l n i n g 6 Se avsnitt 2.3.5 <SalesOrderId> Beställningsalias 8 TFO.BSALIAS <SalesOrderSequenceNr> Kedjelöpnummer 2 TFO.KDJLOPNR <OrderId> Beställningsnummer 8 TFO.BSNR <DebitCredit> Händelse 1 Se avsnitt 2.3.6 <Reference1> Beställningens referensefternamn 35 TFONMN.KNDENMN <Reference2> Beställningens referensförnamn 15 TFONMN.KNDFNMN <EmailAddress> Beställningens referens e-postadress 80 TFONMN.EPSTADR_VAR <SalesUnitCategoryCode>? <EditPaymentEvent>? <EditedOrder>? Säljställekategori för säljstället som skapat händelsen i <DebitCredit> Flagga som indikerar att meddelandet skickas i samband med en redigeringsbetalning, samt anger kedjelöpnumret på den version som betalats Flagga som indikerar att beställningen ifråga ingår i en beställningskedja (har redigerats i någon form) <PaymentInfo> 2 Se avsnitt 2.3.7 1 Se avsnitt 2.3.8 1 Se avsnitt 2.3.8 <CustomerId> Betalande kund (PETRA kundnummer) 10 TFO.KNDNR <PaymentType> Betalningsmedel 2 TFO.BETKOD <CreditCardCode> Kortkod 2 TFO.KKORTDATA <CreditCardNumber> Kontokortsnummer 19 Se avsnitt 2.3.9 <CreditCardValidThru> Kontokortsgiltighet <Month> 2 TFO.KKORTDATA <Year> Tvåsiffrigt årtal 2 TFO.KKORTDATA <RequisitionId> Rekvisitionsnummer 6 TFO.REKVNR <PaymentType2>? Betalningsmedel 2. Används bl a vid restidsgaranti. 2 TFO.BETKOD2 <TravellerCard>? Kundkort för betalare Se avsnitt 2.3.14 <CardType> Korttyp 2 TFO.KORTTYP <CardNumber> Kortnummer 24 TFO.KORTNR <CustomerInfo>? <TravelAgentCustomerId> Säljställets kunds kundnummer 14 TFORBS.RBRKNDNR <CompanyName> Säljställets kunds företagsnamn 20 TFORBS.FTGAVDNMN <CustomerAccount> Säljställets kunds kostnadskonto 50 Se avsnitt 2.3.11 <InvoiceReferences>? Säljställets fakturareferenser Se avsnitt 2.3.12 <InvoiceReference>+ Fakturareferens n 50 TFOFKTRF.FKTREFn <Note> Säljställets anteckningar 20 TFORBS.RSTXT <StreetName> Säljställets kunds gatuadress 30 TFORBS.KNDGTAADR <ZipCode> Säljställets kunds postnummer 6 TFORBS.KNDPSTNR <CityName> Säljställets kunds postadress 20 TFORBS.KNDPSTADR <TextInfo>? Beställningsanteckningar <OrderNote>+ Anteckningsrad 50 TFOANT.ATKRD <RowInfo>+ B e s t ä l l n i n g s r a d e r <RowData> <PassengerInfo> <TravellerId> Resenärens kundnummer 10 TFOR.RENKNDNR <CustomerName> används för att slå upp: <FirstName> Resenärens förnamn 15 TFK.KNDFNMN 7

Element Beskrivning Längd Källa <LastName> Resenärens efternamn 35 TFK.KNDENMN <EmployeeId>? Används inte <TravellerNumber> Resenärsnummer 2 TFOR.RENNR <Priority>? Kundprioritet 3 Se avsnitt 2.3.13 <TravellerCard>* Kundkort Se avsnitt 2.3.14 <CardType> Korttyp 2 Se avsnitt 2.3.15 <CardNumber> Kortnummer 19 TFKKK.KORTNR <DocumentInfo> <OrderItemId> Beställningsradnummer 3 TFOR.BSRDNR <ProducerCode> Första komponentens färdmedelsproducent (bör inte användas) 3 TFORK.FMPRCNR <TicketId> Biljettnummer 12 Se avsnitt 2.3.16 <JourneyconnectionReference> Reseförslagnummer 10 TFOR.RESFSGNR <ItineraryReference> Förbindelsenummer 2 TFOR.FORBNR <DistributionCode> Distributionssätt 2 Se avsnitt 2.3.17 <FareInfo> <ServiceName> Varunamn 20 TCT.VRANMN <FareType> Varunamnförkortning 10 TCT.VRANMNFKN <Price> Tjänstepris resp. Krediteringsbelopp TFOR.TJPRS resp. TFOR.KDTBEL. Se avsnitt 2.3.18 <PriceVat> <PriceInclVat> <Vat> <VatDescriptions>? <VatDescription>+ <VatPercentage> <PriceInclVat> <Vat> Moms på tjänstepriset resp. krediteringsbeloppet Lista med de olika momsregler som tillämpas på beställningsraden Momssats Pris inklusive moms med den angivna momssatsen Momsbelopp för angiven momssats TFOR.MOMSBEL resp. TFOR.KDTMOMSBEL Se avsnitt 2.3.19 <ServiceId> Varunummer 8 TFOR.VRANR <BookingFee1>? Bokningsavgift 1 för tjänsten Se avsnitt 2.3.31 <PriceInclVat> SUM(TFORK.AVGIFT1) <BookingFee2>? Bokningsavgift 2 för tjänsten Se avsnitt 2.3.31 <PriceInclVat> SUM(TFORK.AVGIFT2) <Price2>? Andel av tjänstepris betalt med <PaymentType2>. <PriceVat> Se avsnitt 2.3.18 <PriceInclVat> TFOR.TJPRSBET2 <Vat> TFOR.MOMSBEL eller 0 om priset skiljer sig från tjänstepriset. <CampaignCode>? Kampanjkod för PETRA-kampanjer 20 TFOR.KAMPANJKOD <ReasonCode>? Krediteringsorsak 2 Se avsnitt 2.3.20 <PaymentSummaries> Se avsnitt 2.3.21 <PaymentSummary>+ Se avsnitt 2.3.21 <PaymentType> Betalningsmedel Se avsnitt 2.3.21 <CreditCardCode>? Kortkod 2 TFORK.KKORTDATA <CreditCardNumber>? Kontokortsnummer 19 TFORK.KKORTDATA Se även avsnitt 2.3.9 8

Element Beskrivning Längd Källa <PaymentTypeAmount> <Price> Betalt belopp resp. krediteringsbelopp för angivet betalningsmedel <PriceVat> <PriceInclVat> <Vat> <VatDescriptions>? <VatDescription>+ <VatPercentage> <PriceInclVat> <Vat> Moms på betalt belopp resp. krediteringsbeloppet Lista med de olika momsregler som tillämpas på beställningsraden för listat betalningsmedel Momssats Pris inklusive moms med den angivna momssatsen Momsbelopp för angiven momssats - Se avsnitt 2.3.21 <DiscountInfo>? <DiscountData>+ Se avsnitt 2.3.19 och 2.3.21 <DiscountCode> Rabattformskod för standardrabatt 3 TFOR.RBTFOSTDn <NumberOfDiscounts> Antal rabatterade resenärer 4 TFOR.ANTRBTFOSTDn <InvoiceReferences>? Säljställets fakturareferenser Se avsnitt 2.3.12 <InvoiceReference>+ Fakturareferens n 50 TFOFKTRF.FKTREFn <Quantity>? Se avsnitt 2.3.21 <Traveller>+ <Category> Resenärstyp 2 Se avsnitt 2.3.22 <NumberOfTravellers> Antal resenärer 3 Se avsnitt 2.3.23 + Ko mpon en ter (p er delsträcka) <Departure> Avgångsstation <Location> Se avsnitt 2.3.24 <LocationId> Lokalnummer 5 TFORK.LOKAL1 <LocationShortName> Lokalnamn 15 TMSTN.STNNMNFKN <LocationProducerCode> Landsnummer 3 TFORK.LOKALPRCNR1 <DateTime> Avgångsdatum och tid TFORK.DATUM1 & TFORK.KLS1 <Arrival> Ankomststation <Location> Se avsnitt 2.3.24 <LocationId> Lokalnummer 5 TFORK.LOKAL2 <LocationShortName> Lokalnamn 15 TMSTN.STNNMNFKN <LocationProducerCode> Landsnummer 3 TFORK.LOKALPRCNR2 <DateTime> Ankomstdatum och tid TFORK.DATUM2 & TFORK.KLS2 <ProducerCode> Färdmedelsproducent 3 TFORK.FMPRCNR <TransportId> Färdmedelsnummer (tågnummer) 5 TFORK.FMNR <TransportName> Färdmedelsnamn 33 TFORK.VARUMRKTXT <TransportTypeCode> Färdmedelstypkod 2 Se avsnitt 2.3.27 <ProductCode> Produktkod (tågtyp) 3 TFORK.PRDKOD <Transport>? F ä r d k o m p o n e n t <TravelRoute> Resväg 2 TFORK.RVGKOD <PriceVat>? Beräknad andel av tjänstepriset för Se avsnitt 2.3.28 denna komponent <PriceInclVat> Se avsnitt 2.3.28 <Vat> Se avsnitt 2.3.28 <PriceInclDiscount>? Beräknad andel av tjänstepriset för denna komponent inklusive rabattbelopp Se avsnitt 2.3.29 9

Element Beskrivning Längd Källa <PriceInclVat> TFORK.BERATJPRS + TFORK.BERARABBELSTD <Price2>? Andel av tjänstepris betalt med <PaymentType2>. Se avsnitt <PriceVat> <PriceInclVat> TFORK.BERATJPRSBET2 <Vat> TFORK.BERAMOMSBEL eller 0 om priset skiljer sig från tjänstepriset. <Points>? Kundprogramsrabatt uttryckt i poäng 8 TFORK.KPSPOANG <BasePrice> Grundpris för komponenten, exklusive eventuella bokningsavgifter <PriceVat> Se avsnitt 2.3.30 <PriceInclVat> Se avsnitt 2.3.30 <Vat> Se avsnitt 2.3.30 <VatPercentage> TFORK.MOMSPROC <BookingFee1>? Bokningsavgift 1 för komponenten Se avsnitt 2.3.31 <PriceVat> <PriceInclVat> Se avsnitt 2.3.31 <Vat> Se avsnitt 2.3.31 <VatPercentage> TFORK.AVGMOMSPROC <BookingFee2>? Bokningsavgift 2 för komponenten Se avsnitt 2.3.31 <PriceVat> <PriceInclVat> Se avsnitt 2.3.31 <Vat> Se avsnitt 2.3.31 <VatPercentage> TFORK.AVGMOMSPROC <StatisticalKilometer>? Statistikkilometer 4 Se avsnitt 2.3.32 <BarCode>? Streckkod eller liknande för e-biljett 25 TFORK.BJTSTRECKKOD <PaymentDetails> Se avsnitt 2.3.33 <PaymentType> Betalningsmedel 2 TFORK.BETKOD <CreditCardCode>? Kortkod 2 TFORKEK.KKORTDATA <CreditCardNumber>? Kontokortsnummer 19 TFORKEK.KKORTDATA Se även avsnitt 2.3.9 <CreditCardValidThru>? Kontokortsgiltighet <Month> 2 TFORKEK.KKORTDATA <Year> Tvåsiffrigt årtal 2 TFORKEK.KKORTDATA <RequisitionId>? Rekvisitionsnummer 6 TFORK.REKVNR <PaymentType2>? <ReusedPayment>? <OrderingSalesUnitInfo> Betalningsmedel 2. Används bl a vid restidsgaranti. Indikerar återanvänd betalning el. kreditering 2 TFORK.BETKOD2 1 Se avsnitt 2.3.33 <SalesUnitId> Beställande säljställe 4 TFORK.BSSTNR <SalesUnitSectionId> Beställande säljställeenhet 2 TFORK.BSSTENR <OrderingUserId> Beställande användarid 6 TFORK.BSANVDID <PlacementDescription>? P l a t s k o m p o n e n t <BookingClass> Komfort (bokningsklass) 2 TFORK.KMFT <SeatInfo>* Platsreservationer <SpecialCompartment> Särskild avdelning 2 TFORKPS.UTREGS <CarriageId> Vagnsnummer 3 TFORKPS.SKLTVGNNR <SmokingDepartment> Rökutrymme 2 TFORKPS.UTRROK 10

Element Beskrivning Längd Källa <CompartmentType> Sovkupéns kön 2 TFORKPS.UTRKON <PlacementOrientation> Platsplacering 2 TFORKPS.PLSPLAC <PlacementNumber> Platsnummer 3 TFORKPS.PLSNR <PlacementCharacteristics> Platsegenskap 2 TFORKPS.PLSEGS <CompartmentSize> Utrymmesstorlek 2 TFORK.UTRSTL <PriceVat>? Beräknad andel av tjänstepriset för Se avsnitt 2.3.28 denna komponent. <PriceInclVat> Se avsnitt 2.3.28 <Vat> Se avsnitt 2.3.28 <Price2>? Andel av tjänstepris betalt med <PaymentType2>. Se avsnitt <PriceVat> <PriceInclVat> TFORK.BERATJPRSBET2 <Vat> TFORK.BERAMOMSBEL eller 0 om priset skiljer sig från tjänstepriset. <PriceInclDiscount>? Beräknad andel av tjänstepriset för denna komponent inklusive rabattbelopp Se avsnitt 2.3.29 <PriceInclVat> TFORK.BERATJPRS + TFORK.BERARABBELSTD <Points>? Kundprogramsrabatt uttryckt i poäng 8 TFORK.KPSPOANG <BasePrice> Grundpris för komponenten, exklusive eventuella bokningsavgifter <PriceVat> Se avsnitt 2.3.30 <PriceInclVat> Se avsnitt 2.3.30 <Vat> Se avsnitt 2.3.30 <VatPercentage> TFORK.MOMSPROC <BookingFee1>? Bokningsavgift 1 för komponenten Se avsnitt 2.3.31 <PriceVat> <PriceInclVat> Se avsnitt 2.3.31 <Vat> Se avsnitt 2.3.31 <VatPercentage> TFORK.AVGMOMSPROC <BookingFee2>? Bokningsavgift 2 för komponenten Se avsnitt 2.3.31 <PriceVat> <PriceInclVat> Se avsnitt 2.3.31 <Vat> Se avsnitt 2.3.31 <VatPercentage> TFORK.AVGMOMSPROC <Mandatory>? Obligatorisk komponent 0 Se avsnitt 2.3.33 <PaymentDetails> Se avsnitt 2.3.33 <PaymentType> Betalningsmedel 2 TFORK.BETKOD <CreditCardCode>? Kortkod 2 TFORKEK.KKORTDATA <CreditCardNumber>? Kontokortsnummer 19 TFORKEK.KKORTDATA Se avsnitt 2.3.9 <CreditCardValidThru>? Kontokortsgiltighet <Month> 2 TFORKEK.KKORTDATA <Year> Tvåsiffrigt årtal 2 TFORKEK.KKORTDATA <RequisitionId>? Rekvisitionsnummer 6 TFORK.REKVNR <PaymentType2>? Betalningsmedel 2. Används bl a vid restidsgaranti. 2 TFORK.BETKOD2 11

Element Beskrivning Längd Källa <ReusedPayment>? Indikerar återanvänd betalning el. kreditering 1 Se avsnitt 2.3.33 <EditActionInfo> Komponentredigeringsinformation - Se avsnitt 2.3.34 <EditActionCode> Redigeringsåtgärd 2 TFORKRH.KOMPREDATG <CreditReasonCode>? Krediteringsåtgärd 2 TFORKRH.BORTTAGKOD <OrderingSalesUnitInfo> <SalesUnitId> Beställande säljställe 4 TFORK.BSSTNR <SalesUnitSectionId> Beställande säljställeenhet 2 TFORK.BSSTENR <OrderingUserId> Beställande användarid 6 TFORK.BSANVDID <ServiceOption>* Ö v r i g a k o m p o n e n t e r <OptionDescription> <ComponentNumber> Komponentnummer Se avsnitt 2.3.36 <VariantNumber> Variantnummer Se avsnitt 2.3.36 <Description> Verbal beskrivning Se avsnitt 2.3.36 <PriceVat>? Beräknad andel av tjänstepriset för Se avsnitt 2.3.28 denna komponent <PriceInclVat> Se avsnitt 2.3.28 <Vat> Se avsnitt 2.3.28 <Price2>? Andel av tjänstepris betalt med <PaymentType2>. Se avsnitt <PriceVat> <PriceInclVat> TFORK.BERATJPRSBET2 <Vat> TFORK.BERAMOMSBEL eller 0 om priset skiljer sig från tjänstepriset. <PriceInclDiscount>? Beräknad andel av tjänstepriset för denna komponent inklusive rabattbelopp Se avsnitt 2.3.29 <PriceInclVat> TFORK.BERATJPRS + TFORK.BERARABBELSTD <Points>? Kundprogramsrabatt uttryckt i poäng 8 TFORK.KPSPOANG <BasePrice> Grundpris för komponenten, exklusive eventuella bokningsavgifter <PriceVat> Se avsnitt 2.3.30 <PriceInclVat> Se avsnitt 2.3.30 <Vat> Se avsnitt 2.3.30 <VatPercentage> TFORK.MOMSPROC <BookingFee1>? Bokningsavgift 1 för komponenten Se avsnitt 2.3.31 <PriceVat> <PriceInclVat> Se avsnitt 2.3.31 <Vat> Se avsnitt 2.3.31 <VatPercentage> TFORK.AVGMOMSPROC <BookingFee2>? Bokningsavgift 2 för komponenten Se avsnitt 2.3.31 <PriceVat> <PriceInclVat> Se avsnitt 2.3.31 <Vat> Se avsnitt 2.3.31 <VatPercentage> TFORK.AVGMOMSPROC <Mandatory>? Obligatorisk komponent 0 Se avsnitt 2.3.33 <BarCode>? Streckkod eller liknande för e-biljett. 25 TFORK.BJTSTRECKKOD <PaymentDetails> Se avsnitt 2.3.33 <PaymentType> Betalningsmedel 2 TFORK.BETKOD 12

Element Beskrivning Längd Källa <CreditCardCode>? Kortkod 2 TFORKEK.KKORTDATA <CreditCardNumber>? Kontokortsnummer 19 TFORKEK.KKORTDATA Se avsnitt 2.3.9 <CreditCardValidThru>? Kontokortsgiltighet <Month> 2 TFORKEK.KKORTDATA <Year> Tvåsiffrigt årtal 2 TFORKEK.KKORTDATA <RequisitionId>? Rekvisitionsnummer 6 TFORK.REKVNR <PaymentType2>? <ReusedPayment>? Betalningsmedel 2. Används bl a vid restidsgaranti. Indikerar återanvänd betalning el. kreditering 2 TFORK.BETKOD2 1 Se avsnitt 2.3.33 <EditActionInfo> Komponentredigeringsinformation - Se avsnitt 2.3.34 <EditActionCode> Redigeringsåtgärd 2 TFORKRH.KOMPREDATG <CreditReasonCode>? Krediteringsåtgärd 2 TFORKRH.BORTTAGKOD <OrderingSalesUnitInfo> <SalesUnitId> Beställande säljställe 4 TFORK.BSSTNR <SalesUnitSectionId> Beställande säljställeenhet 2 TFORK.BSSTENR <OrderingUserId> Beställande användarid 6 TFORK.BSANVDID Några av de sammansatta elementen är inte expanderade i tabellen med meddelandebeskrivningen ovan. De beskrivs i stället separat nedan. Vid eventuella skillnader i elementens namn, placering, längd eller beskrivning så är det EM.DTD som gäller framför detta dokument. 2.2.1 Elementet <DateTime> Alla datumelement är uppbyggda av en <DateTime>: Element Beskrivning Längd <DateTime> <TimeZone> Tidzon 3 <Year> År 4 <Month> Månad 2 <Day> Dag 2 <Hour>? Timmar 2 <Minute>? Minuter 2 <Second>? Sekunder 2 Dessa element är inte specificerade i tabellen med meddelandebeskrivningen i ovan. Elementet <TimeZone> innehåller alltid CET oavsett om vintertid eller sommartid tillämpas vid den aktuella tidpunkten. Även avgångstider och ankomsttider i länder utanför den centraleuropeiska tidzonen har värdet CET. 2.2.2 Elementet <PriceInclVat> Elementet <PriceInclVat> innehåller pris inklusive moms och förekommer på flera ställen i meddelandet och har följande utseende: Element Beskrivning Längd <PriceInclVat> <Money> <CurrencyCode> Valutaslagkod 3 13

Element Beskrivning Längd <Amount> Belopp 14.2 Dessa element är inte specificerade i tabellen med meddelandebeskrivningen ovan. 2.2.3 Elementet <Vat> Elementet <Vat> innehåller ett momsbelopp och förekommer på flera ställen i meddelandet och har följande utseende: Element Beskrivning Längd <Vat> <Money> <CurrencyCode> Valutaslagkod 3 <Amount> Belopp 14.2 Dessa element är inte specificerade i tabellen med meddelandebeskrivningen ovan. 2.3 Beskrivning av elementen i meddelandet 2.3.1 Unik identifierare Ett flertal mottagare av EM har framställt önskemål om en unik identifierare av varje skickat meddelande. Den finns nu i form av <MessageId>. Termen är alltid 15 tecken lång och byggs ihop av följande: (Tvåställigt år från <PaymentDateTime>) + <SalesOrderId> + (SalesOrderSequenceNr>) + (tvåställigt första <OrderItemId> i meddelandet) + (<DebitCreditCode). Exempel: 12ABC0001Q0201K 2.3.2 Återsändning av meddelande Indikerar att meddelandet är återsänt på begäran. 2.3.3 Säljställe I EM finns information om det betalande respektive krediterande säljstället i elementet <AgentInfo>. En beställning kan innehålla flera beställningsrader <RowInfo> och raderna behöver inte vara beställda av samma säljställe som tar betalt. Flera olika säljställen kan lagra beställningsrader i beställningen innan den betalas. Beställande säljställe presenteras i strukturen <OrderingSalesUnitInfo>. 2.3.4 Tidpunkt för händelse Elementet <PaymentDateTime> innehåller uppgifter om när beställningen betalades när <DebitCredit> innehåller värdet D. Innehållet hämtas från TFO.BETDAT och TFO.BETTD i Petras orderbok. Vid kreditering, då <DebitCredit> innehåller K, innehåller <PaymentDateTime> uppgifter om när beställningsraden krediterades. Innehållet hämtas från TFOR.KDTDAT och TFOR.KDTTD i Petras orderbok. Vid avbeställning, då <DebitCredit> innehåller "A", innehåller <PaymentDateTime> fr o m 2009-10-17 uppgifter om när beställningsraden avbeställdes. Innehållet hämtas från TFOR.AVBDAT och TFOR.AVBTPU i Petras orderbok. Vid övriga händelser (t ex uppdatering), innehåller <PaymentDateTime> tomma fält: 14

<PaymentDateTime> <DateTime> <TimeZone>CET</TimeZone> <Year></Year> <Month></Month> <Day></Day> <Hour></Hour> <Minute></Minute> <Second></Second> </DateTime> </PaymentDateTime> 2.3.5 Beställare av första raden (fr o m 2007-06-02) Fältet <CreatorUserId> i <AgentInfo> innehåller användarnamnet på den som beställt den första aktiva raden i beställningen. Fältet är obligatoriskt, men kan innehålla en tom sträng. Innehållet hämtas från TFOR.BSANVDID för första beställningsraden. 2.3.6 Händelser I elementet <DebitCredit> finns information om vid vilken händelse i PETRA som ekonomimeddelandet har skickats. Följande händelser kan generera ett ekonomimeddelande: <DebitCredit> Händelse i PETRA Kommentar D U A K Debitering av en beställning Uppdatering av en beställningsrads tillfälliga resenär Avbeställning av en eller flera beställningsrader Kreditering av en eller flera beställningsrader Hela beställningen skickas till mottagaren då den betalas i PETRA. Detta meddelande skickas endast till SJ Kundprogramsystem (KPS-gränssnitt 1012) vid efterregistrering av en intjäningstjänst med setretroactivemember. Övriga prenumeranter får inte några meddelanden vid denna händelse. Detta meddelande skickas till SJ Kundprogramsystem (KPSgränssnitt I012), Icomera och SJ ARO-server (via IPL). Övriga prenumeranter får inte några meddelanden vid avbeställning. Den eller de återköpta raderna skickas till mottagaren. SJ Kundprogramsystem får detta meddelande endast vid återköp av poängtjänster. Vid prisfråga på en poängtjänst skickas inte något EM version 2.0 till SJ Kundprogramsystem (KPS-gränssnitt I018) fr o m 2009-06-06. I stället används ett särskilt meddelande vid prisfråga på en poängtjänst, se PETRA Gränssnittsbeskrivning SJ Kundprogramsystem. 2.3.7 Säljställekategori (fr o m 2006-11-11) Säljställekategorin för säljstället som skapat händelsen i <DebitCredit> finns i elementet <SalesUnitCategoryCode>. Värdet hämtas från TMSST.SSTKAT. Exempel på värden: <SalesUnitCategoryCode> AG AR BD BM CC CW Säljställekategori Agent AccesRail Biljett direkt SJ Biljettautomat Veolia contact center Veolia webb 15

<SalesUnitCategoryCode> IK PR SJ TF Säljställekategori SJ Internet kundbokning Pressbyrån/7-eleven SJ Resebutik SJ Telefonförsäljning 2.3.8 Redigeringsinformation (vid beställningskedja) För identifiering av händelser i beställningskedjor som kan kräva/önska specialhantering har två flaggor införts. Elementet <EditPaymentEvent> identifierar att meddelandet ifråga är del av en debitering av delbetald beställning (en redigeringsbetalning), där ett flertal olika typer av ekonomimeddelanden skickas. Den visar kedjelöpnumret för den version av beställningskedjan som betalades i samband med utskicket av ekonomimeddelandet. Genom att läsa SalesOrderId och EditPaymentEvent kan mottagare lätt länka ihop alla de meddelanden som skickats vid en redigeringsbetalning om så önskas. Elementet <EditedOrder> visar att beställningen, oavsett vilken version av beställningskedjan det specifika ekonomimeddelandet skickas för, ingår i just en beställningskedja en redigerad beställning. När så är fallet skall betalnings- och krediteringsinformation läsas från <PaymentSummaries> för summerad information och <PaymentDetails> för detaljerad information. Se 2.3.21 respektive 2.3.33 för mer information. Betalnings- och krediteringsinformation från <PaymentInfo> får då INTE användas då det inte visar den fullständiga bilden. 2.3.9 Kontokortsuppgifter Elementet <CreditCardNumber> innehåller för kontokortsnummer ett maskat kortnummer, dvs ett antal siffror i mitten har ersatts med asterisker. Innehållet hämtas från TFO.KKORTDATA respektive TFORKEK.KKORTDATA enligt angivelse. Om betalningsmedlet är Resekonto så innehåller elementet ett resekontonummer, och detta nummer maskas ej. Innehållet hämtas från TFO.KRYPTKORTNR resp TFORKEK.KRYPTKORTNR, och dekrypteras. 2.3.10 Kundkort för betalare Om en medlem i SJ Kundprogram har köpt s k poängtjänster finns medlemskortets uppgifter i elementet <TravellerCard> i <PaymentInfo>. Existensen av detta element innebär att en eller flera av beställningsraderna har rabatterats med poäng från SJ Kundprogram och innehåller information om vilket konto i SJ Kundprogramsystem (KPS) som ska belastas. Detta element är endast av intresse för KPS. Övriga prenumeranter på EM kan ignorera detta element. 2.3.11 Konteringsinformation Fr o m 2007-06-02 överförs kunders konteringsinformation normalt i elementet <CustomerAccount> (Säljställets kunds kostnadskonto) i stället för som tidigare i elementet <Reference1> (Beställningens referensefternamn). Det är dock upp till säljaren respektive säljklienten exakt vad som lagras var. Innehållet hämtas från TFORBS.KSTKTO. 16

2.3.12 Fakturareferens (fr o m 2008-03-08) Vissa PETRA-klienter kan lagra upp till fem rader med fakturareferensuppgifter i en beställning. Fr o m 2008-03-08 skickas dessa fakturareferenser i ekonomimeddelandet i elementet <InvoiceReferences>. Fakturareferenser på beställningsnivå finns i elementet <CustomerInfo> och fakturareferenser på radnivå finns i elementet <RowData>. 2.3.13 Kundprioritet (fr o m 2008-03-08) Fr o m 2008-03-08 finns ett frivilligt element för kundprioritet med i <PassengerInfo>. Elementet finns bara med för kända kunder (med kundnummer) som har en kundprioritet i kundregistret (TFK.KNDPRIO). För närvarande förekommer följande värden: <Prioritiy> Betydelse 1 Commeo 1-stjärnig medlem 2 Commeo 2-stjärnig medlem 4 Commeo 4-stjärnig medlem Vit Grå Sva SJ Prio-medlem på vit nivå SJ Prio-medlem på grå nivå SJ Prio-medlem på svart nivå 2.3.14 Kundkort för resenär Om kunden har kundkort registrerade i PETRA, finns varje giltigt kundkort med som ett <TravellerCard>, till exempel SJ årskort eller SJ Avtalskort. Om en medlem i SJ Prio registrerat ett medlemskortnummer på beställningsraden finns detta kortnummer med i <TravellerCard>. Inga andra medlemskort för SJ Prio finns då med. 2.3.15 Korttyp Elementet <CardType> visar korttypen och kan för närvarande ha något av följande värden: <CardType> Beskrivning A B C D E Affärståget (utfärdas inte längre) Årskort Guld med Resplus Årskort Silver Årskort Silver Plus SJ Tjänsteresekort F SJ Prio-kort (fr o m 2006-11-11) G SJ Årspendlarkort (fr o m 2007-12-08) H SJ Årskort Silver med Resplus (fr o m 2009-10-24) J SJ Årskort Silver Plus med Resplus (fr o m 2009-10-24) K SJ Avtalskort (fr o m 2007-06-11), tidigare Commeokort L Årskort Guld (fr o m 2012-10-01) M SJ Månadskort (fr o m 2007-12-08) R S T Reslustkort (utfärdas inte längre) Sista minuten-pilot (utfärdas inte längre) TiM-kort U SAS och SJ årskort Sverige (fr om 2009-04-24). V SAS och SJ årskort Destination+ (fr om 2009-04-24). X SAS Destination (fr om 2009-04-24). Säljs inte i PETRA. 17

Innehållet hämtas från TFKK.KORTTYP. 2.3.16 Biljettnummer PETRA Gränssnittsbeskrivning Ekonomimeddelande Elementet <TicketId> innehåller beställningsradens biljettnummer (TFOR.BJTNR). Normalt utgör biljettnumrets första 8 tecken av beställningsalias, men bland annat följande undantag finns: Beställningsrader beställda av PETRA i utländska system (referensnumret från det utländska systemet används som biljettnummer) Återköp särskilda fall lagrar den ursprungliga biljettens biljettnummer i <TicketId>. 2.3.17 Distributionssätt (fr o m 2009-10-17) Elementet <DistributionCode> visar på vilket sätt man har för avsikt att skriva ut (distribuera) beställningen (alla koder utom US nedan) samt att den har skrivits ut (koden US nedan). Elementet innehåller beställningens distributionskod (TFO.DISTKOD). Om distributionskod saknas, används i stället utskriftskoden (TFO.UTSKOD). För att förbereda för andra förändringar är elementet placerat på beställningsradsnivå i meddelandet och det innebär att alla beställningsrader tills vidare innehåller samma värde. Elementet har något av följande värden: UTSKOD A4 C4 DB DU ID KK MB UB US Betydelse Beställningen är inte utskriven på pappersbiljetter ännu. Användaren har valt distributionssättet Egenutskriven biljett utan streckkod Användaren har valt distributionssättet Egenutskriven biljett med streckkod (för SJ-sträckor) En beställning som ska eller har skrivits ut som ett direktbrev. Beställningen är delvis utskriven. Användaren har valt distributionssättet Id-buret kontrakt (för Veolia-sträckor). Användaren har valt distributionssättet Biljettlöst med kundkort. Användaren har valt distributionssättet Mobilbiljett med incheckning. En beställning som håller på att skrivas ut som ett direktbrev, men ännu inte är klar. Beställningen är utskriven på pappersbiljetter. 2.3.18 Tjänstepris Det pris som kunden betalar lagras i <FareInfo><Price> och inkluderar eventuell moms i <Vat> och bokningsavgift i <BookingFee1> och <BookingFee2>. I vissa fall, till exempel vid betalning med en restidsgarantivoucher, kan det hända att två olika betalningsmedel har använts för att betala tjänsten. I elementet <FareInfo><Price> finns tjänstens totala pris varav den del som är betald med betalningsmedlet <PaymentInfo><PaymentType2> finns i elementet <Fareinfo><Price2>. 2.3.19 Momsspecifikation (fr o m 2009-06-06) En beställningsrad (tjänst) kan fr o m 2009-06-06 innehålla flera momsbelopp och momssatser. I elementet <Price> redovisas det totala momsbeloppet, se avsnitt 2.3.18. I elementet <VatDescriptions> redovisas de olika momsbeloppen och momssatserna. En beställningsrad med tjänstepriset 600 kr med 6 % moms på 500 kr och 25 % moms på 100 kr ser ut så här: <Price> <PriceVat> 18

<PriceInclVat> <Money> <CurrencyCode>SEK</CurrencyCode> <Amount>600.00</Amount> </Money> </PriceInclVat> <Vat> <Money> <CurrencyCode>SEK</CurrencyCode> <Amount>128.30</Amount> </Money> </Vat> </PriceVat> <VatDescriptions> <VatDescription> <VatPercentage>6.00</VatPercentage> <PriceInclVat> <Money> <CurrencyCode>SEK</CurrencyCode> <Amount>500.00</Amount> </Money> </PriceInclVat> <Vat> <Money> <CurrencyCode>SEK</CurrencyCode> <Amount>28.30</Amount> </Money> </Vat> </VatDescription> <VatDescription> <VatPercentage>25.00</VatPercentage> <PriceInclVat> <Money> <CurrencyCode>SEK</CurrencyCode> <Amount>100.00</Amount> </Money> </PriceInclVat> <Vat> <Money> <CurrencyCode>SEK</CurrencyCode> <Amount>20.00</Amount> </Money> </Vat> </VatDescription> </VatDescriptions> </Price> Fr o m 2009-06-06 kan en och samma beställningsrad innehålla en tjänst med flera olika momsbelopp och momssatser. Delar av tjänsten kan vara momsfri, vilket också redovisas i <VatDescriptions>. Fr.o.m. 2012-11-10 beskrivs även hur stor andel av momsen, per momssats, som har betalats med respektive betalningsmedel, i <PaymentSummary>. 19

2.3.20 Krediteringsorsak (fr o m 2008-03-08) Fr o m 2008-03-08 finns krediteringsorsaken med vid kreditering, dvs då <DebitCredit> har värdet K. Vid övriga händelser finns inte <ReasonCode> med i meddelandet. Krediteringsorsaken hämtas från TFOR.KDTORSAK och kan för närvarande ha följande värden: <ReasonCode> AT BY DA DS EA FB FE IF KO LÄ PR RD RG TO Betydelse Normalt återköp Byte Del av antal personer (endast vid Kreditera annan orsak) Del av sträcka (endast vid Kreditera annan orsak) Ej gått att avbeställa, i externt reservationssystem (endast vid Kreditera annan orsak) Fel belopp, ska vara annat än beräknat i PETRA (endast vid Kreditera annan orsak) Felexpediering Internationell färdbiljett, som inte avbeställts före 1:a giltighetsdatum (endast vid Kreditera annan orsak) Annat kontokortsnummer (endast vid Kreditera annan orsak) Läkarintyg (endast vid Kreditera annan orsak) Prisändring vid någon form av ombokning (endast vid Kreditera annan orsak) Redigerad (återköpt och helt eller delvis återanvänd i samband med en debitering av Delbetald beställning) Restidsgaranti Timeout 2.3.21 Summerad betalningsinformation per beställningsrad Från och med version 3.00 hanterar Ekonomimeddelandet beställningskedjor, där det är tillåtet att blanda betalningsmedel både inom beställningen och inom enskilda beställningsrader. Se kapitel 3 för mer information och exempel på detta. Strukturen PaymentSummaries visar, per beställningsrad (RowInfo), en lista av vilka betalningsmedel som använts för att betala raden, samt hur mycket med momsspecifikation (<Price>). Andelen av bokningsavgifterna specificeras också, fr.o.m. version 3.01, i <BookingFee1> och <BookingFee2>. Vid krediteringsmeddelanden visas motsvarande summering för krediterade belopp. Listan visar även kortnummer och korttyp (för resekonto) om detta är relevant, i enlighet med 2.3.9. Listan gör ingen skillnad på PaymentType och PaymentType2, utan listar alla likvärdigt. Alla beräkningar och summeringar görs utifrån komponenternas information, varför totalsumman av <PaymentSummary> kan skilja sig från <Price> i <FareInfo> på grund av avrundning. 2.3.22 Resenärstyp Elementet <Category> innehåller resenärstypen. De vanligaste koderna som används för resor är: <Category> B6 BA PE ST TO Betydelse Barn 7-15 år Barn 0-6 år Pensionär Student Tomplats 20

<Category> U1 UN VU Betydelse Ungdom 16-19 år Ungdom 20-25 år Vuxen För evenemang och andra tjänster kan ett stort antal olika och varierande koder förekomma. Innehållet hämtas från TFORK.RENTKn. 2.3.23 Antal resenärer Normalt gäller en tjänst endast för en resenär, vilket innebär att det endast förekommer ett element av typen <Quantity> <Traveller> <Category>VU</Category> <NumberOfTravellers>1</NumberOfTravellers> </Traveller> </Quantity> För gruppresor och vissa nattågsbiljetter kan flera resenärer förekomma i samma tjänst och då kan det se ut så här när 10 vuxna och 20 ungdomar åker: <Quantity> <Traveller> <Category>VU</Category> <NumberOfTravellers>10</NumberOfTravellers> </Traveller> <Traveller> <Category>UN</Category> <NumberOfTravellers>20</NumberOfTravellers> </Traveller> </Quantity> Gruppbiljettens tjänstepris i <FareInfo><Price> gäller för hela gruppen. Det finns inga uppgifter om priset per person. Innehållet hämtas från TFORK.ANTRENTn. 2.3.24 Lokaler Alla lokaler eller stationer beskrivs i elementet <Location> och identifieras med sitt landsnummer och sitt lokalnummer, till exempel: <LocationProducerCode> <LocationId> <LocationShortName> 74 1 Stockholm C 74 100 Limmared 76 100 Oslo S 86 1 Frederikshavn Följande landsnummer förekommer till exempel i SJs trafik: <LocationProducerCode> Land 74 Sverige 21

<LocationProducerCode> Land 76 Norge 80 Tyskland 86 Danmark 2.3.25 Komfort, prisnivå, prisgrupp och fare type Det finns många begrepp som beskriver vilken typ av biljett som finns i beställningen. I säljdialogen används normalt begreppet prisgrupp som en sammanfattande beskrivning av biljettens innehåll och regelverk. Internt i PETRA används prisnivå vid prissättning av färdkomponenter och komfort vid platsreservation. Term XML-element Databaskolumn Beskrivning Exempel <ServiceId> VRANR Varunumret identifierar unikt den tjänst som sålts. Vissa tjänster kan bestå av olika komponenter och därför går det inte alltid att dra slutsatser om exakt vad som sålts enbart med hjälp av varunumret. Varunamn <ServiceName> VRANMN Varunamnet beskriver i klartext vilken tjänst som sålts. Komfort <BookingClass> KMFT Beskriver komforten i fordonet, dvs bredd och benutrymme för stolen samt vissa andra komfortegenskaper som kan finnas i olika fordon. Prisnivå PRSNV Beskriver prisets nivå och är det grundläggande begreppet för prissättning. Prisgrupp DEFGRP Beskriver mycket kortfattat biljettens egenskaper och vilka produkter (tågtyper) som kan ingå i biljetten. Prisgruppen kopplar ihop prisnivå och komfort. Varunummer Varunamnförkortning <FareType> VRANMNFKN Fare type används i Linkons ekonomimeddelande (EM) och i Amadeus SIR-meddelande. Elementet används endast i ekonomimeddelanden samt i vissa rapporter i PETRA Ekonomi. I PETRA Sälj används det inte. 10132002 1 KL FK (1 klass), AK (2 klass) AM (1 klass Plus), AL (1 klass), F1 (Just nu 1 kl), NO (Normal), FO (Just nu 2 kl), SM (Sista minuten) AM (1 klass Plus), AL (1 klass), S1 (1 klass utrikes), F1 (Just nu 1 kl), NO (2 klass), S2 (2 klass utrikes), FO (Just nu 2 kl, SM (Sista minuten) 1 KL PLUS, 1 KL, 2 KL, JUST NU, SM 2.3.26 Avgång och ankomst För avgångstider och ankomsttider är elementet <Second> alltid fyllt med 00. Ankomst vid midnatt den 1 februari 2006 anges som: <DateTime> <TimeZone>CET</TimeZone> 22

<Year>2006</Year><Month>02</Month><Day>01</Day> <Hour>24</Hour> <Minute>00</Minute><Second>00</Second> </DateTime> Avgång vid midnatt den 2 februari 2006 (dvs vid samma tidpunkt som ankomsten ovan) anges som: <DateTime> <TimeZone>CET</TimeZone> <Year>2006</Year><Month>02</Month><Day>02</Day> <Hour>00</Hour> <Minute>00</Minute><Second>00</Second> </DateTime> Ankomstdatum bör användas med försiktighet eftersom fältet inte alltid innehåller korrekt ankomstdatum, till exempel vid dygnsöverskridande resor eller öppna biljetter med flera dagars giltighet. Fältet <Arrival><DateTime> innehåller färdkomponentens (<Transport>) sista giltighetsdatum för resans början. 2.3.27 Färdmedelstyp Elementet <TransportTypeCode> innehåller färdmedelstypkoden för aktuell delsträcka. För resor inom Sverige och beställda från tidtabell används följande koder: <TransportTypeCode> A B F J S T U Betydelse Flyg Buss Färja Järnväg Spårvagn Taxi Tunnelbana För resor bokade i utländska system kan ett stort antal olika och varierande koder förekomma, till exempel: <TransportTypeCode> AE AV CL EA EC EI EK EN ES IC IE IF IN PM RE SH TG Betydelse Allegro AVE City Night Line Eurostar Italia Eurocity ES* Italia PKP ExpressIC EuroNight Eurostar InterCity, Euromed, Alaris, Altaria, Arco m fl ICE ICE Allemange-France InterCittyNotte Italia Alvia, Avant, Precios Mercado Regional, NSB Regiontog, ATOC member operated service Ship, Ferry, Hovercraft TGV Innehållet hämtas från TFORK.FMTK. 23

2.3.28 Beräknad andel av tjänstepris och moms på delsträckenivå och tillval Elementen <Transport><PriceVat>, <PlacementDescription><PriceVat> och <ServiceOption><PriceVat> innehåller den beräknade andelen av tjänstepriset (TFORK.BERATJPRS) och dess momsandel (TFORK.BERAMOMSBEL), som finns i elementet <FareInfo><Price>. Vid kreditering (<DebitCredit>K</DebitCredit>) innehåller elementet den beräknade andelen av krediteringsbeloppet (BERAKDTBEL och BERAMOMSKDTBEL). Summan av alla priser och momsbelopp på nivån kan avvika från motsvarande uppgifter i <FareInfo> på grund av avrundning. T.o.m. version 3.00 beskrevs enbart PriceInclVat, men från version 3.01 beskrivs även momsbeloppet per delsträcka/tillval. 2.3.29 Orabatterat pris <PriceInclDiscount> är ett frivilligt element och förekommer endast då ekonomimeddelanden skickas vid debitering och endast då tjänsten är rabatterad med standardrabatten Byte av resa, som används för tjänster som har restriktioner på återköp, men tillåter byte till en annan avgång. Elementet är i första hand avsett för SJ Kundprogramsystem (KPS) och bör inte användas generellt av andra mottagande system. Nedanstående exempel visar hur en tjänst rabatterad för Byte av resa ser ut i ekonomimeddelandet. Endast relevanta delar av meddelandet visas här. <RowData> <FareInfo> <Price> <PriceVat> <PriceInclVat> <Money> <CurrencyCode>SEK</CurrencyCode> Beställningsraden är rabatterad 100 % <Amount>00000000000.00</Amount> och därför är tjänstepriset 0 kr. </Money> </PriceInclVat> </PriceVat> </Price> </FareInfo> <DiscountInfo> <DiscountData> <DiscountCode>BAR</DiscountCode> Den använda rabattformen är Byte av resa. <NumberOfDiscounts>001</NumberOfDiscounts> </DiscountData> </DiscountInfo> </Rowdata> <Price> <PriceVat> 24

<PriceInclVat> <Money> <CurrencyCode>SEK</CurrencyCode> <Amount>00000000000.00</Amount> </Money> </PriceInclVat> </PriceVat> </Price> <PriceInclDiscount> <PriceInclVat> <Money> <CurrencyCode>SEK</CurrencyCode> <Amount>00000000410.00</Amount> </Money> </PriceInclVat> </PriceInclDiscount> Komponentens andel av tjänstepriset är 0 kr. Utan rabatt skulle komponentens andel av tjänstepriset varit 410 kr. 2.3.30 Komponentens grundpris <BasePrice> presenterar komponentens grundpris, exklusive eventuella bokningsavgifter. Här inkluderas även momsbelopp och momsprocentsats. I de fall ingen bokningsavgift tas ut är beloppet samma som i motsvarande <Price>. <BasePrice> specificeras för <Transport>, <PlacementDescription> och <ServiceOption>. Den presenteras enbart vid debitering och kreditering och hämtas från följande kolumner: Debitering Kreditering PriceInclVat TFORK.BASPRS TFORK.BASKDTBEL Vat TFORK.BASMOMSBEL TFORK.BASKDTMOMSBEL VatPercentage TFORK.MOMSPROC TFORK.MOMSPROC 2.3.31 Bokningsavgift Bokningsavgift i <BookingFee1> och <BookingFee2> tas i vissa fall ut för en tjänst och lagras på beställningsradsnivå i <FareInfo>. <BookingFee1> återbetalas vid kreditering. <BookingFee2> återbetalas inte vid kreditering. Fr o m 2007-03-10 finns bokningsavgiften specificerad per komponent (delsträcka och tillval). Fr o m 2013-03-09 specificeras även momsbelopp och momsprocent för komponenternas bokningsavgifter. 2.3.32 Statistikkilometer (fr o m 2009-10-17) Det frivilliga elementet <StatisticalKilometer> beskriver resans längd i kilometer. Vissa sträckproducenter levererar inte statistikkilometrar till PETRA, vilket innebär att elementet kan saknas på vissa delsträckor. Uppgifterna hämtas från SUM(TFORKDS.STATKM). 25

2.3.33 Betalningsinformation på komponentnivå (fr o m 2012-03-10) Strukturen PaymentDetails visar den enskilda komponentens betalnings- respektive krediteringsinformation. I och med införandet av beställningskedjor kan detta skilja sig mellan komponenterna i samma beställningsrad. Elementet ReusedPayment används enbart i samband med betalning av en beställning i status Delbetald (en redigeringsbetalning). Om elementet finns med i meddelandet indikerar det att denna komponent har betalats i en tidigare version av beställningskedjan och att betalningen återanvänts i samband med denna version. Det finns då alltid ett motsvarande kredit- eller debitbelopp i ett annat meddelande som skickats samtidigt. Ekonomimeddelande visar alla belopp som brutto, men bifogar denna flagga för att mottagarna skall kunna använda sig av nettohantering om de så önskar och behöver. Se avsnitt 3 för exempel. 2.3.34 Redigeringsåtgärd (fr o m 2011-10-22) Elementet <EditAction> beskriver redigeringshändelser på specifika komponenter i samband med en redigeringsbetalning. Elementet har följande värden: <EditAction> A CF CT D Betydelse tillägg av komponent byte från (vid byte av komponentvariant eller platsdetaljer) byte till (vid byte av komponentvariant eller platsdetaljer) borttag av komponent 2.3.35 Obligatoriska komponenter (fr o m 2009-06-06) I en resa kan platsreservering, måltider och annan service i vissa fall vara obligatoriska, dvs resenären kan inte välja bort komponenten. Det markeras genom existensen av det tomma elementet <Mandatory/>. Frivilliga komponenter saknar elementet <Mandatory>. 2.3.36 Komponentnummer (fr o m 2009-06-06) Övriga komponenter som inte enkelt kan beskrivas med till exempel avgångs- och ankomststation, vagn och plats kan i stället identifieras med hjälp av <ComponentNumber> (komponentnummer i TFORK.KOMPNR) och <VariantNumber> (variantnummer i TFORK.VARNR). Det finns också en textbeskrivning av komponenten i <Description>. När SJs nya tjänsteutbud är definierat och en fastställd version av ekonomimeddelandet finns, kommer dessa uppgifter att publiceras. 26

3 Beställningar i en beställningskedja Från och med 2012-03-10 kan beställningar i Petra versionshanteras. Det benämns som en beställningskedja. Publik lansering av beställningskedjor sker dock senare under 2012. En beställningskedja är en serie av sammanlänkade beställningar som presenterar en samlad bild av en kunds försäljningsorder, med ett genomgående beställningsalias. Syftet är att kunden ska kunna öppna en redan betald beställning och utföra någon (eller båda) av följande aktiviteter: Lägga till, ta bort eller byta ut komponenter på befintliga, betalda rader Lägga till en eller flera nya rader Öppnas en betald beställning skapas en ny beställning som får ett nytt beställningsnummer men samma beställningsalias som tidigare. En ny version av beställningskedjan skapas helt enkelt. Ur kundens synvinkel är det samma beställning själva versionshanteringen och dess kopplingar till underliggande beställningar döljs av de funktioner som läser orderboken. Det är beställningsalias som presenteras för kunden inte beställningsnummer. I backoffice-funktioner som t.ex. Ekonomimeddelande specificeras både beställningsalias (SalesOrderId) och beställningsnummer (OrderId) då båda behövs. Återigen är det dock SalesOrderId som är den referens som kunden känner till och som därför skall kommuniceras om så behövs. Beställningsalias: ABC1234A Beställning: ABC1234A Initial bild av kundens önskemål Kunden betalar allt. Beställning: DEF5678B Kunden redigerar rad(er) i ABC1234A. Denna beställning skapas. Kunden betalar/får tillbaka mellanskillnad Beställning: GHI9012C Kunden redigerar rad(er) i DEF5678B och lägger till ett par nya. Denna beställning skapas. Kunden betalar/får tillbaka mellanskillnad 3.1 Betalnings av ny version i kedjan (redigeringsbetalning) En ny version i en beställningskedja kan alltså bestå av två typer av rader. Helt nya rader som tillkommit efter senaste betalning, eller redigerade rader där komponenter i raden lagts till, ändrats eller tagits bort. De redigerade raderna återanvänder betalningen från den föregående versionen, så kunden betalar bara för de tillägg som görs. Rent tekniskt innebär det att den föregående radversionen krediteras och betalningen flyttas för oförändrade delar av raden. För att korrekt spegla vad som hänt i samband med detta krävs att tre olika händelsers ekonomimeddelanden skickas vid redigeringsbetalning: Debitering av nya beställningen Avbokning av eventuella redigerade raders föregående version Kreditering av eventuella redigerade raders föregående version Genom att skicka dessa till berörda mottagare undviks dubbelbokningar eller andra former av dubbel registrering t.ex. av Priopoäng. 27