ForthCRS Ferries Web Services

Transcript

1 ForthCRS Ferries Web Services Document version December General Structures HeaderInfo User header information (all data provided by ForthCRS) AgentCode (το id του πράκτορα) AgentUser (ο χρήστης του πράκτορα) AgentPasswd (ο κωδικός του πράκτορα) AgentSignature (Κωδικοποιημένη Υπογραφή)

2 --Functions List GetLocationsList Επιστροφή των τοποθεσιών τα οποία έχουν λιμάνι/αεροδρόμιο IN HeaderInfo OUT πίνακας LocationsList με στοιχεία o LocationAbbr (το abbreviation της τοποθεσίας) o LocationName (η ονομασία της τοποθεσίας) o LocationCountry (η χώρα που βρίσκεται η τοποθεσία) GetMeanList Επιστροφή των συνδυασμων κωδικού πλοίου-ονόματος ανα εταιρεία (ανάλογα με τα δικαιώματα του χρήστη) IN HeaderInfo OUT πίνακας MeanList με στοιχεία o VesselID (το id του πλοίου) o Company (το abbreviation της εταιρείας) o VesselName (η ονομασία του πλοίου)

3 GetClassList Επιστροφή των τύπων θέσεων ανα εταιρεία (ανάλογα με τα δικαιώματα του χρήστη) IN HeaderInfo OUT πίνακας ClassList με στοιχεία o ClassAbbr (το abbr της θέσης) o Company (το abbreviation της εταιρείας) o Description (η ονομασία της θέσης) o Capacity (η χωρητικότητα της θέσης) GetVehicleTypesList Επιστροφή των κατηγοριών οχημάτων ανα εταιρεία (ανάλογα με τα δικαιώματα του χρήστη) IN HeaderInfo OUT πίνακας VehicledList με στοιχεία o VehicleTypeAbbr (το abbreviation της κατηγορίας) o Company (το abbreviation της εταιρείας) o Description (η περιγραφή της κατηγορίας) o Meters (τα default μέτρα που καταλαμβάνει η κατηγορία στο γκαράζ)

4 GetDiscounts Επιστροφή των εκπτώσεων επιβατών/οχημάτων, συνολικά ή ανά εταιρεία IN HeaderInfo Company (abbreviation εταιρείας για την οποία ζητάμε τις παραμέτρους κενό = όλες) VehicleCodes (Y εφόσον θέλουμε τους κωδικούς εκπτώσεων οχημάτων κενό = επιστροφή κωδικών εκπτώσεων επιβατών) OUT πίνακας DiscountsList με στοιχεία o Discount (το abbreviation της έκπτωσης) o Company (το abbreviation της εταιρείας) o DiscountDescr (η περιγραφή της έκπτωσης) GetLocationsCombinations Επιστροφή των έγκυρων συνδυασμών τοποθεσιών αναχώρησης/άφιξης IN HeaderInfo OUT Combinations xml string (format ίδιο με αρχείο combinations.xml)

5 GetItineraries Επιστροφή των δρομολογίων σύμφωνα με τα επιλεγμένα κριτήρια IN HeaderInfo DepDate (Ημ/νία αναχώρησης YYYYMMDD) DepTime (Ωρα αναχώρησης είναι default προς το παρόν) DepStation (abbreviation σταθμού αναχώρησης από αρχείο παραμέτρων) ArrStation (abbreviation σταθμού άφιξης από αρχείο παραμέτρων) Company (η εταιρία) Sorting (0=Με ώρα αναχώρησης, 1=Με ώρα άφιξης, 2=Με λιγότερη ώρα ταξιδιού) AvailInfo (Y για επιστροφή διαθεσιμότητας, οτιδήποτε αλλο μόνο για επιστροφη δρομολογίων) OUT Πίνακας TTimetableAns (maximum 99 γραμμές) με στοιχεία o Status (Error code-αντιστοιχία από παραμέτρους, ή 000) o DepDate (Ημ/νία αναχώρησης) o DepTime (Ωρα αναχώρησης) o DepStation (Σταθμός αναχώρησης) o ArrStation (Σταθμός άφιξης) o Company (εταιρεία) o VesselID (Κωδικός πλοίου/μέσου) o HasGaraze (Εάν το μέσο διαθέτει ή όχι γκαράζ Y/N) o HasCabins (Εάν το μέσο διαθέτει ή όχι καμπίνες Y/N) o VesselType (C=Conventional, A=Airplane, D=Dolphin/Catamaran, H=HighSpeed) o InfantCOS (ο κωδικός θέσης που επιτρέπεται/επιβάλεται να μπει ένα βρέφος στο συγκεκριμένο μέσο-εάν δεν υπάρχει θα πρέπει να μπει σε κάποια από τις οικονομικές θέσεις του μέσου) o ArrDate (Ημ/νία άφιξης) o ArrTime (Ωρα άφιξης) o Season (Κενό) o Available (YES αν υπάρχει έστω και or NO) o ClassAvail (TCLassAvail array type) ClassAbbr (Abbreviation τύπου θέσης-αντιστοιχία από παραμέτρους IX for garage) ClassPType (C=Καμπίνα, S=Seat, G=Garage) ClassAdultBasicPrice (βασική τιμή *100, 0 for garage)

6 ItineraryPricing Τιμολόγηση δρομολογίων *Όλες οι τιμές επιστρέφονται πολλαπλασιασμένες* 100, πχ 10 EUR θα επιστραφούν σαν «1000» IN HeaderInfo Πίνακας TPricingRequest (μέχρι 4 δρομολόγια) με στοιχεία o DepDate (Ημ/νία αναχώρησης YYYYMMDD) o DepTime (Ωρα αναχώρησης ΗΗΜΜ) o DepStation (abbreviation σταθμού αναχώρησης από αρχείο παραμέτρων) o ArrStation (abbreviation σταθμού άφιξης από αρχείο παραμέτρων) o Company (η εταιρία) o VesselID (κωδικός μέσου) o Πίνακας TpricingPerPassenger (μέχρι 9 επιβάτες) με στοιχεία ClassAbbr (Abbreviation τύπου θέσης) PassType (Τύπος επιβάτη AD=Adult, CH=Child, IN=Infant, ST=Student, SE=Senior, JU=Youth) Discount (Κωδικός έκπτωσης) FareCode (Κωδικός τιμοκαταλόγου, αν υπάρχει ή δες παράρτημα Α) o Πίνακας TpricingPerVehicle (μέχρι 4 οχήματα) με στοιχεία VehicleType (Abbreviation κατηγορίας οχήματος) Meters (Μήκος οχήματος) Discount (Κωδικός έκπτωσης) FareCode (Κωδικός τιμοκαταλόγου, αν υπάρχει) OUT Πίνακας TPricingAnswer με στοιχεία o Status (Error code-αντιστοιχία από παραμέτρους, ή 000) o DepDate (Ημ/νία αναχώρησης) o DepTime (Ωρα αναχώρησης) o DepStation (Σταθμός αναχώρησης) o ArrStation (Σταθμός άφιξης) o Company (εταιρεία) o VesselID (Κωδικός πλοίου/μέσου) o Currency (Κωδικός νομίσματος τιμολόγησης) o FareCode (Κωδικός τιμοκαταλόγου-αν υπάρχει) o ExtraCharges (Επιπλέον χρεώσεις στο σύνολο της κράτησης Αν υπάρχουν)

7 o PricesPerPassenger (TPricesPerPassenger array type) Price (Μικτή αξία επιβάτη) o PricesPerVehicle (TPricesPerVehicle array type) Price (Μικτή αξία οχήματος)

8 ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο εγκυρότητας της σύνθεσης της κράτησης. Στις BSF, ANEK, ANSF, APN, LNN, ANEN, SFF, AFE, EPT, AGL, SNAV, BLN, ο έλεγχος δεν γίνεται από τα συστήματα των εταιρειών και ενδέχεται να μην ισχύει απόλυτα. *Όλες οι τιμές επιστρέφονται σαν πολλαπλασιασμένες* 100, πχ 10 EUR θα επιστραφούν σαν «1000» IN HeaderInfo Πίνακας TPricingRequest (μέχρι 4 δρομολόγια) με στοιχεία o DepDate (Ημ/νία αναχώρησης YYYYMMDD) o DepTime (Ωρα αναχώρησης ΗΗΜΜ) o DepStation (abbreviation σταθμού αναχώρησης από αρχείο παραμέτρων) o ArrStation (abbreviation σταθμού άφιξης από αρχείο παραμέτρων) o Company (η εταιρία) o VesselID (κωδικός μέσου) o Πίνακας TClassAnalysis με στοιχεία ClassAbbr (Abbreviation τύπου θέσης) ClassResType (F=Female, M=Male, W=Whole cabin) Quantity (Ποσότητα του παραπάνω τύπου/κατηγορίας θέσης- Το αθροισμα των πεδίων αυτών σε όλο τον πίνακα, ανα ταξίδι, δεν πρέπει να ξεπερνάει τα 9) UpDownBed (Πάνω ή κάτω κρεβάτι μόνο για κατηγορίες καμπινών) o Πίνακας TpricingPerPassenger (μέχρι 9 επιβάτες) με στοιχεία ClassAbbr (Abbreviation τύπου θέσης) PassType (Τύπος επιβάτη AD=Adult, CH=Child, IN=Infant, ST=Student, SE=Senior, JU=Youth) Discount (Κωδικός έκπτωσης) FareCode (Κωδικός τιμοκαταλόγου, αν υπάρχει ή δες παράρτημα Α) o Πίνακας TpricingPerVehicle (μέχρι 4 οχήματα) με στοιχεία VehicleType (Abbreviation κατηγορίας οχήματος) Meters (Μήκος οχήματος) Discount (Κωδικός έκπτωσης) FareCode (Κωδικός τιμοκαταλόγου, αν υπάρχει)

9 OUT Πίνακας TPricingAnswer με στοιχεία o Status (Error code-αντιστοιχία από παραμέτρους, ή 000) o DepDate (Ημ/νία αναχώρησης) o DepTime (Ωρα αναχώρησης) o DepStation (Σταθμός αναχώρησης) o ArrStation (Σταθμός άφιξης) o Company (εταιρεία) o VesselID (Κωδικός πλοίου/μέσου) o Currency (Κωδικός νομίσματος τιμολόγησης) o FareCode (Κωδικός τιμοκαταλόγου-αν υπάρχει) o ExtraCharges (Επιπλέον χρεώσεις στο σύνολο της κράτησης Αν υπάρχουν o PricesPerPassenger (TPricesPerPassenger array type) Price (Μικτή αξία επιβάτη) o PricesPerVehicle (TPricesPerVehicle array type) Price (Μικτή αξία οχήματος)

10 MakeReservation Δημιουργία κράτησης, εφόσον επιτρέπεται στον χρήστη και από την εταιρεία *Πεδία με κόκκινο Υποχρεωτικά *Πεδία με μπλε Υποχρεωτικά κατά περίπτωση για διεθνή ταξίδια *Πεδία με πράσινο Υποχρεωτικά αν υπάρχει ηλεκτρονική πληρωμή και θέλουμε να μπορεί η ακτοπλοική εταιρεία να το γνωρίζει *Πεδία με πορτοκαλί Υποχρεωτικά για συγκεκριμένες εταιρείες στο εξωτερικό *Εφόσον πρόκειται να συμπληρωθεί πεδίο με αλφαβητικούς χαρακτήρες που δεν προέρχονται από παραμέτρους του συστήματος αλλά από user input, χρησιμοποιείτε μόνο κεφαλαίους χαρακτήρες IN HeaderInfo Πίνακας TReserveIssueRequest (μέχρι 4 δρομολόγια) με στοιχεία o DepDate (Ημ/νία αναχώρησης YYYYMMDD) o DepTime (Ωρα αναχώρησης ΗΗΜΜ) o DepStation (abbreviation σταθμού αναχώρησης από αρχείο παραμέτρων) o ArrStation (abbreviation σταθμού άφιξης από αρχείο παραμέτρων) o Company (η εταιρία) o VesselID (κωδικός μέσου) o Remarks (Σχόλια σχετικά με την κράτηση) o CRSReservationCode (Αριθμός κράτησης-εφόσον συμπληρωθεί στην IssuePrepayedTickets, σημαίνει ανάκληση υπάρχουσας κράτησης και έκδοση εισιτηρίων) o (Ηλεκτρονική διεύθυνση πελάτη) o LeaderName (Το 1 ο Ονομα στην κράτηση) o Address (διεύθυνση πελάτη) o Phone (τηλέφωνο πελάτη) o Mobile (κινητό τηλέφωνο πελάτη) o City (Πόλη διαμονής πελάτη) o ZipCode (Ταχ.κώδικας διαμονής πελάτη) o DeliveryAddr (Διεύθυνση παράδοσης εισιτηρίου) o DeliveryCity (πόλη παράδοσης) o DeliveryZipCode (Ταχ.κώδικας παράδοσης) o Amount (Χρηματικό πόσό πληρωμής από πελάτη) o ApprovalCode (Κωδικός έγκρισης από σύστημα ηλεκτρονικής πληρωμής) o TransactionCode (Κωδικός κίνησης από σύστημα ηλεκτρονικής πληρωμής)

11 o PayType (Τρόπος πληρωμής) o CardType (Είδος πιστωτικής κάρτας) o DeliveryType (τρόπος παραλλαβής εισιτηρίου) o AddFees (Πρόσθετα κόστη, πχ παράδοσης, service fees) o ReservationCountry (Χώρα κατοικίας πελάτη) o DeliveryCountry (Χώρα παράδοσης εισιτηρίου) o Πίνακας TClassAnalysis με στοιχεία ClassAbbr (Abbreviation τύπου θέσης) ClassResType (F=Female, M=Male, W=Whole cabin) Quantity (Ποσότητα του παραπάνω τύπου/κατηγορίας θέσης- Το αθροισμα των πεδίων αυτών σε όλο τον πίνακα, ανα ταξίδι, δεν πρέπει να ξεπερνάει τα 9) UpDownBed (Πάνω ή κάτω κρεβάτι μόνο για κατηγορίες καμπινών) o Πίνακας TReserveIssuePerPassenger (μέχρι 9) με στοιχεία ClassAbbr (Abbreviation τύπου θέσης) Discount (Κωδικός έκπτωσης) FareCode (Κωδικός τιμοκαταλόγου, αν υπάρχει) PassType (Τύπος επιβάτη AD,CH,IN,ST,SE) PassSex (Φύλο F=Female, M=Male) PassName (Επώνυμο επιβάτη) PassInitial (Αρχικό ονόματος επιβάτη) PassSSR (Special Service Request Y for Disabled) Nationality (Εθνικότητα επιβάτη, two letter country code) BirthDate (ημ/νία γέννησης) BirthPlace (Τόπος γέννησης) Loyalty (Κάρτα μέλους ακτοπλοικής εταιρείας, αν υπάρχει) Residence (κατοικία επιβάτη) DocumentNo (Αριθμός ταξιδιωτικού εγγράφου επιβάτη) DocumentType (Τύπος ταξιδιωτικού εγγράφου, free format) DocExpire (Λήξη ταξιδιωτικού εγγράφου, free format) AddFees (Πρόσθετα κόστη, πχ παράδοσης, service fees για τον επιβάτη) o Πίνακας TReserveIssuePerVehicle (μέχρι 4) με στοιχεία VehicleType (Abbreviation κατηγορίας οχήματος) Meters (Μήκος οχήματος) Trailer (Y αν το όχημα είναι trailer) Discount (Κωδικός έκπτωσης) FareCode (Κωδικός τιμοκαταλόγου, αν υπάρχει) PlateNo (Πινακίδες οχήματος) Brand (Μάρκα οχήματος, free format) Model (Τύπος μάρκας οχήματος, free format) Nationality (Εθνικότητα πινακίδων οχήματος, two letter country code) Loyalty (Κάρτα μέλους ακτοπλοϊκής εταιρείας, αν υπάρχει) Height (Υψος οχήματος)

12 AddFees (Πρόσθετα κόστη, πχ παράδοσης, service fees για το όχημα) OUT ReserveAnswer με στοιχεία o Status (Error code-αντιστοιχία από παραμέτρους, ή 000) o CRSReservationCode (Κωδικός κράτησης ForthCRS) o CompanyReservationCode (Κωδικός κράτησης ακτοπλοικής εταιρείας) o OptionDate (Ημερομηνία option κράτησης) o OptionTime (Ωρα option κράτησης) o Remarks (Πιθανά σχόλια της ακτοπλοικής εταιρείας πάνω στην κράτηση)

13 IssuePrepayedTickets Εκδοση προπληρωμένων εισιτηρίων, εφόσον επιτρέπεται στον χρήστη και από την εταιρεία *Όλες οι τιμές επιστρέφονται σαν πολλαπλασιασμένες* 100, πχ 10 EUR θα επιστραφούν σαν «1000» IN Ιδιο ακριβώς με της μεθόδου MakeReservation OUT Πίνακας TIssueAnswer με στοιχεία o Status (Error code-αντιστοιχία από παραμέτρους, ή 000) o CRSReservationCode (Κωδικός κράτησης ForthCRS) o CompanyReservationCode (Κωδικός κράτησης ακτοπλοικής εταιρείας) o Remarks (Πιθανά σχόλια της ακτοπλοικής εταιρείας πάνω στην κράτηση) o Πίνακας TIssueAnswerPerPassenger με στοιχεία NetValue (Καθαρή αξία ναύλου επιβάτη) Taxes (Σύνολο φόρων ναύλου επιβάτη) Vat (ΦΠΑ ναύλου επιβάτη) PriorityNo (Αριθμός προτεραιότητας-πρέπει να τυπώνεται στο voucher) SpecialDiscount (Κωδικός έκπτωσης που μπορεί να δωθεί αυτόματα από το σύστημα της ακτοπλοικής εταιρείας, αν συντρέχουν κάποιες συνθήκες) TicketNo (Αριθμός εισιτηρίου) o Πίνακας TIssueAnswerPerVehicle με στοιχεία NetValue (Καθαρή αξία ναύλου οχήματος) Taxes (Σύνολο φόρων ναύλου οχήματος) Vat (ΦΠΑ ναύλου οχήματος) PriorityNo (Αριθμός προτεραιότητας-πρέπει να τυπώνεται στο voucher) SpecialDiscount (Κωδικός έκπτωσης που μπορεί να δωθεί αυτόματα από το σύστημα της ακτοπλοικής εταιρείας, αν συντρέχουν κάποιες συνθήκες) TicketNo (Αριθμός εισιτηρίου)

14 CancelPNR Διαγραφή ενός κωδικού κράτησης με ή χωρίς εισιτήρια IN HeaderInfo CancelPNRRequest o CRSReservationCode (Κωδικός κράτησης FCRS που έχει επιστραφεί από την MakeReservation ή την IssuePrepayedTickets) OUT CancelPNRAnswer o Status (Error code-αντιστοιχία από παραμέτρους, ή 000) o CRSReservationCode (Κωδικός κράτησης FCRS) o ReturnAmount (Ποσό επιστροφής που δικαιούται ο πελάτης Η πληροφορία αυτή έρχεται από την εταιρεία σε περίπτωση που η κράτηση έχει εισιτήρια) o Remarks (Πιθανά σχόλια από την εταιρεία σχετικά με την συγκεκριμένη ακύρωση)

15 Παράρτημα Α Το πεδίο FareCode (μόνο για τις λειτουργίες ItineraryPricing και ItineraryPricingExt),για κάποιες εταιρείες, πρέπει να χρησιμοποιηθεί σαν δείκτης για τον τρόπο με τον οποίο ζητάμε να κλείσουμε την συγκεκριμένη θέση. Η τιμή της μεταβλητής αποτελείται από το γράμμα C εάν πρόκειται για καμπίνα ή B εάν πρόκειται για κρεβάτι/καρέκλα, ακολουθούμενο από έναν αύξων αριθμό «01»,»02» κλπ, που αφορά όλες τις διαφορετικές ομάδες ίδιων θέσεων που θέλουμε να ζητήσουμε, σε όσα ταξίδια και εάν περιέχονται στην κράτηση. Μια αλληλουχία θέσεων που θέλουμε να τις ζητήσουμε ολόκληρες, τις χαρακτηρίζουμε με την ίδια τιμή στην εν λόγω μεταβλητή. Έτσι εάν πχ θέλουμε να ζητήσουμε τιμολόγηση για μια ολόκληρη Α43 (χωρητικότητα 3) καμπίνα, θα βάλουμε σε κάθε επιβάτη που ζητάμε την ίδια τιμή στο πεδίο FareCode, πχ C01. Ακολουθούν μερικά παραδείγματα : 1 ταξίδι, 4 επιβάτες, οι 2 σε δίκλινη αποκλειστική καμπίνα, ο 3 ος σε κρεβάτι καμπίνας μοιρασμένης, και ο 4 ος σε DECK o 1o πεδίο FareCode = C01 o 2o πεδίο FareCode = C01 o 3o πεδίο FareCode = B02 o 4o πεδίο FareCode = B03 2 ταξίδια, 6 επιβάτες, οι 2 σε δίκλινη αποκλειστική καμπίνα, 3 σε τρίκλινη αποκλειστική και ο 6 ος σε DECK o 1ο ταξίδι, 1 ο πεδίο FareCode = C01 o 1ο ταξίδι, 2 ο πεδίο FareCode = C01 o 1ο ταξίδι, 3 ο πεδίο FareCode = C02 o 1ο ταξίδι, 4 ο πεδίο FareCode = C02 o 1ο ταξίδι, 5 ο πεδίο FareCode = C02 o 1ο ταξίδι, 6 ο πεδίο FareCode = Β03 o 2ο ταξίδι, 1 ο πεδίο FareCode = C04 o 2ο ταξίδι, 2 ο πεδίο FareCode = C04 o 2ο ταξίδι, 3 ο πεδίο FareCode = C05 o 2ο ταξίδι, 4 ο πεδίο FareCode = C05 o 2ο ταξίδι, 5 ο πεδίο FareCode = C05 o 2ο ταξίδι, 6 ο πεδίο FareCode = Β06 Οι εταιρείες που,μέχρι σήμερα,απαιτούν αυτή την λογική στην τιμολόγηση τους είναι (σύμφωνα με τις συντομογραφίες της απάντησης της GetItineraries) οι : BSF, ANEK, ANSF, APN, LNN, ANEN, SFF, AFE, EPT, AGL, SNAV, BLN.

16 Παράρτημα Β Κωδικοί λαθών Πεδίο Status στην απάντηση των function : Network connectivity errors: SAE, RIF, CRF, BFA, ACE, UNF 999 General exception A91 System authentication errors 001 No sailing at this time 002 Service does not exist for this carrier 003 No sailing on this date 004 Cannot recall - movement departed 005 Sailing temporarily blocked 006 Requested movement closed 007 Route code invalid 008 Closed to unaccompanied vehicles 009 Route not reservable 010 Requested sailing full in total 011 Only one class permitted 012 Sailing times incompatible 013 Legs not in chronological order 014 No suitable sailings found 015 Invalid time 016 Invalid date 017 Sailing cancelled 018 Time is not valid on open returns

17 019 Out/in departure port the same 020 Invalid port code 021 Port does not exist 022 Invalid departure port 023 Invalid arrival port 024 Unable to check-in on this sailing 030 Sailing is certified and definite 031 Ship is still en route 032 There are still reservations on cruise 033 Only reservations are allowed on this route 035 Vessel code invalid 040 Invalid cruise 041 Cruise type does not exist 042 The requested cruise is not direct 101 Name 102 Number of passengers 103 Quota exceeded - passengers 104 Passengers exceed commercial rules 105 Passenger type invalid 106 Passenger type error - this carrier 107 Class capacity exceeded 108 Foot passengers not bookable 109 Passenger types must be the same on both legs 110 At least 1 adult must travel

18 111 There is no passenger availability 112 Additional passenger info is mandatory 113 You need to put passenger types by order (AD-CH-IN) 120 The outward trip can not be later than the return trip 121 Tickets are not allowed to be cancelled 122 Tickets are not allowed to be transformed to open 123 Departure transfer is not allowed for current reservation 124 Υou cannot change the departure date 201 Car deck space not available 202 Vehicle code repeated 203 Quota exceeded - vehicles 204 Absolute vehicle limit exceeded 205 Vehicle or trailer is too long 206 More than allowed - bicycles 207 Vehicle type invalid 208 Vehicle type error - this carrier 209 Vehicle length missing or invalid 210 Trailer length missing or invalid 211 Trailer type invalid 212 Vehicle trailer combination invalid 213 Trailer type error - this carrier 214 Vehicle or trailer is too high 215 Deck position for vehicle not available 216 Non accompanied vehicle

19 217 The plate number belongs to truck 218 Vehicle cannot be transferred to another reservation 301 Ship accommodation capacity exceeded 302 Class accommodation capacity exceeded 303 Insufficient availability 304 Dogs not allowed 305 Ship accommodation repeated 306 Foot passengers not bookable 307 Must book to full cabin capacity 308 Accommodation mandatory for overnight sailings 309 This number of dogs not permitted 310 Requested space unavailable 311 Cabin numbers invalid 312 Seat numbers invalid 313 Place numbers invalid 314 Passenger accommodation not available 315 No berths empty for this sex 316 Accommodation type unrecognized 317 Male/female berths in field 2 failed in cabin type or "E" in "EX" failed 318 Infants and children may not occupy cabins by themselves 319 When requesting place - complete one field only in ext 320 Too many cabin types requested 321 Passengers and cabin places must be the same 322 Cabins can only be booked complete - no individual berths

20 323 Invalid accommodation for this package 324 No extra berth available for this cabin type 325 Invalid number of berths 326 Only one extra berth permitted in this cabin 327 Discrepancy between passenger numbers - types and accommodation 328 To be advised 329 Cannot satisfy infant booking request 333 Your request can only be placed on a waiting list 401 Requested tariff type not allowed 402 Concession needs at least 1 person 403 Adults/children combination 404 Journeys outside existing tariffs 405 Price data is not yet available 406 Invalid standing or special offer 407 No price data exists for tariff 408 Concession not available 409 Journey date or time barred 410 Unrecognized concession code 411 Concession needs at least one adult 412 Prices do not exist 413 No price data exists for this offer 414 Ticket numbers required 415 Invalid currency code 416 Cannot requote on ticketed booking

21 417 Cannot ticket unpriced booking 418 Tickets do not match reservations 419 A ticket has already been issued for this booking 420 Open return not allowed for this route 421 Cannot book cabin for open return 422 Cannot book cabin without a route 423 Return journey must be day after departure 424 Return journey must be within 2 months from departure 425 Cannot ticket - agent not allowed 426 Cannot ticket - booking cancelled 427 Cannot ticket - booking expired 428 Cannot ticket - booking departed 429 Cannot ticket - information incomplete 430 Unable to issue ticket 431 Tickets available only during departure 432 Cannot ticket - Reservation contains unsubstantial cabins 433 Scheme qualifications not fulfilled 434 Scheme membership not recognized 435 Insufficient scheme credit units 436 Insufficient scheme units requested 437 Booking not eligible for scheme 438 Cabin already occupied 450 Discount cannot be applied on this route 451 Discount cannot be applied on this accommodation

22 452 Agency level is not proper for this Discount 453 Passenger Type and Discount conflict 454 Domestic/International discount conflict 455 Cannot combine local-international routes under that currency 456 Conflict on cancellation fees 457 Unable to complete request - Invalid ticket state 458 Unable to Replace - Ticket reached its replacement limits 459 Ticket remained open for too long 460 Discrepancy between destinations of old and new ticket 461 Unable to confirm - Ticket is not Open 462 Invalid or missing seasonality 463 Due to departure, ticket cannot be opened. 464 Too close to departure, ticket cannot be opened. 465 Cannot convert ticket due to Fare quotation rule 470 Ticket has already checked-in 471 Unable to transfer. The ticket is checked in. 472 Discount requires id number 501 Invalid leg identifier 502 Legs quoted have not been reserved 503 Item number does not exist 504 Cannot cancel - journey complete 505 Invalid reference number 506 Cannot cancel - leg departed 507 One booking firm - one provisional

23 508 Cannot confirm - journey complete 509 One booking single - one return 510 Booking being accessed 511 OK - firm reservation only allowed 512 Identical reference numbers 513 Booking already cancelled 514 Bookings are on the same route 515 Reservation not found 516 No reservation for this place 517 Reservation not made by this office 518 Cannot recall - no last booking stored 519 Closed - berthing list called 520 Requested reference not connected 521 Cannot recall - journey complete 522 Accommodation not available 523 Cannot access - provider ticketed 524 Accommodation units requested exceeds maximum allowed 525 Bookings not accepted this far in advance 526 Unknown accommodation code 527 Bookings not accepted this close to arrival date 528 Accommodation not available - closed 529 Invalid booking 530 Number of nights exceeds maximum permitted 531 Incomplete booking details

24 532 Wrong accommodation upgrade 533 Wrong meal timetable 534 Wrong room category 535 Unable to recall booking details 536 Wrong reservation status 537 Overbooked room 538 Accommodation cannot be changed 539 Accommodation not available under contract terms 540 Arrival date passed 541 Too many children 542 Too many infants 543 Unable to dispose room/unit 544 Too many babies in room/unit 545 Cannot outreach extra-bed limits for given accommodation 546 Unable to recall, reservation concerns group processing 550 Reservation already exists 551 Invalid package coding 552 Package limited to one car only 553 Car is not included in this package 554 Requested package closed - contact carrier 555 Package date too close to departure 556 One car included in this package 557 Wrong room type 558 No availability for this room type

25 559 Room is not valid 560 Type of travel invalid 561 FROM date incorrect 562 TO date incorrect 563 Wrong time 564 Number of adults incorrect 565 Number of children incorrect 566 Commission invalid 567 Number of rooms/units incorrect 568 Room/unit code incorrect 569 Room/unit occupancy not acceptable 570 Room/unit price incorrect 571 Voucher with a negative amount not allowed 572 Please check arrival and/or departure date 573 Service requested incorrect 574 Taxes incorrect 577 FROM date missing 578 Voucher amount too high 579 Not used 580 Details may not be changed 581 Not used 582 Recall booking to change details 585 Number of rooms/units missing 586 Room/unit details missing

26 587 Room/unit price missing 588 Accommodation details not complete 589 Commission not applicable 590 Zero commission not acceptable 591 TO date missing 592 Voucher without amount not allowed 593 At least one room/unit or service must be requested 594 Search criterion not possible 595 Deposit voucher must be cancelled first 596 not used 597 Deposit has been cancelled 598 Deposit already deducted from voucher 599 No deposit voucher stored with this booking 600 Payment denied 601 Agent does not exist 602 Invalid agent code 603 Premise does not exist 604 Booking not made by this agent 605 Movement not available to agents 606 Agency code must be entered 607 Bookings made by different agents 608 Password not correct 609 Password not allowed 610 Premise suspended

27 611 Booking not made by this premise 612 Agent only allowed in training mode 613 Terminal invalid 614 Agents Market is not defined 615 Password missing 616 Agent suspended 617 Invalid language code 618 Quotation unavailable to this agent 619 Booking closed - contact carrier 620 Insufficient rights for application use 621 Agent cannot close reservations and/or issue tickets 622 Unregistered application 623 Obsolete version. Please obtain a newest one in order to continue 624 Outmoded version. A newest one is available 625 Non proper market for this agent 630 Agent Model is missing 631 Agent is inactive 632 Missing company data 633 User is allowed only Voucher issues 634 Valid only to Ticket Owner or Central Agent 635 Selected service not bookable online within 24hrs before departure. Please select a different date. For information please contact our call center. 636 The arrival/departure connection ports of your multi route selection are not compatible. Please correct and try again. 701 System unavailable

28 702 Last entry failed - contact service provider 703 Transaction not authorized 704 No access via this DTE address 705 Cannot book return dogs from UK 706 Cannot accept dogs via this port 707 System full - try later 708 Cannot recall reservation - not made via Unicorn 709 Cannot recall reservation - changed by telephone 710 Failure of cancellation - contact service provider 711 No bookings for selection made 712 Service restricted - security 713 Service restricted - Access time 720 Unable to modify/cancel - Ticket is not printed 721 Unable to modify/cancel - Reservation contains Fare Quotation 722 Reservation must be fully cancelled 723 There is no more Early Booking Discount availability on the outward trip. 724 There is no more Early Booking Discount availability on the return trip. 801 No results found with given criteria 802 Redefine Search Criteria - Too many Results 803 Error in miles total 804 Miles are not registered for this accommodation/route 805 Card already charged on given trip 806 Loyalty card not valid 807 Package of multiple tickets not found

29 808 No ticket from packages left 809 The package is booked for other ports 810 The package is booked for other class 811 Member does not have any package booked 812 General error in package 813 The package is booked for other coin 814 No miles are registered at discounted tickets. Remove card or discount. 815 Cancellation time limit is over 816 Printing of cancellation document failed 817 Cannot issue ticket that has already checked-in 818 Cancelled seats cannot be characterized by gender 819 Mandatory fields, Name-Surname of passenger and Lic.Plate for vehicle are missing 820 Unaccompanied Vehicles Found 821 There is a prohibiting rule to make a garage reservation 822 Your credit limit is Overdraft 823 Discount not valid for this trip 824 Early booking discount must be applied to the whole of the itinerary 825 Wrong passenger type discount 826 Mixed type of reservation prohibited when there is special price 827 Cannot issue gift ticket. Please contact the company 850 Only direct ticket issue allowed for Deck economy Seats 851 No more availability for DTE class 852 There is mismatch between passenger sex and cabin type 853

30 Booking Individual Beds Is Not Allowed For This Cabin Type 854 Choose cabin type with the right number of beds. 855 Unescorted children not allowed in cabins 900 Join not allowed for specific reservations 901 Inappropriate ticket number 902 Could not alter option date 903 Transfer date failed 904 You can only issue tickets for this reservation 905 This vessel does not carry vehicles 906 Selected tariff cannot apply 907 Meter based pricing failed 908 This agent cannot make reservations and/or issue tickets 909 Your credit limit is Overdraft 910 Error returned by the Server 911 Unable to make reservation - Invalid vehicle type 912 Ticket is already attached to a voucher 913 Invalid passenger ticket 914 Invalid vehicle ticket 915 Refund is valid only for stop sails. 916 Cannot find the corresponding CRS PNR 917 Failed changing allotments 918 Unable to find agent in credit limits 971 There is no cashier information 978 Ticket already issued 979

31 Please repeat recall and cancel 980 Card not active 981 Non existing Card 982 Card has expired 983 Card not valid for this itinerary 984 This card has exceeded daily limit 985 Non existing customer 987 Can be renewed Only for Next Month

32 Παράρτημα Γ SFF/ANEK/ANSF/APN manual fare quotation handling Εφόσον επιθυμείτε να χρησιμοποιήσετε κωδικούς δημιουργίας ναύλων στην εταιρεία SuperFast, θα πρέπει να ακολουθήσετε την παρακάτω διαδικασία. Με δεδομένο ότι ο κάθε κωδικός αναφέρεται σε ολόκληρη κράτηση, θα πρέπει στο πεδίο FareCode του 1 ου δρομολογίου και 1 ου επιβάτη, να βάλετε δίπλα στο αναγνωριστικό B01 ή C01 που χρησιμοποιείτε, τον διψήφιο αριθμητικό κωδικό που επιθυμείτε σύμφωνα με την παρακάτω λίστα : 01=ADO 02=ADR 03=TCO 04=TCR 05=OCC 06=RCC 07=NKO 08=NKR 09=GRO 10=GRR 11=CFO 12=CFR 13=AEO 14=AER 15=TEO 16=TER 17=OEO 18=OER 19=AEO 20=AER 21=ELO 22=ELR 23=IEO 24=IER 25=TIO 26=TIR 27=ECO 28=ECR 29=AFO 30=AFR 31=INB 32=OUT ADAC/ANWB/ACE/OEAMTC Offer o/w ADAC/ANWB/ACE/OEAMTC Offer r/trip TCS Camper Offer o/w TCS Camper Offer R/Trip French Market O/Way French Market R/Trip NKC O/Way NKC R/Trip Greek Market O/Way Greek Market R/Trip Italian Campers O/Way Italian Campers R/Trip Early Booking ADAC/ANWB/ACE/OEAMTC/NKC offer o/w Early Booking ADAC/ANWB/ACE/OEAMTC/NKC offer r/trip TCS Camper Offer O/Way Early Booking TCS Camper Offer R/Trip Early Booking French & Belgium Markets O/Way Early Booking French & Belgium Markets R/Trip Early Booking Early Booking ADAC/ANWB/ACE/OEAMTC/NKC offer o/w Early Booking ADAC/ANWB/ACE/OEAMTC/NKC offer r/trip Greek Market O/Way Early Booking Greek Market R/Trip Early Booking Italian Campers O/Way Early Booking Italian Campers R/Trip Early Booking Touring Club Italia O/Way Touring Club Italia R/Trip Touring Club Italia O/Way Early Booking Touring Club Italia R/Trip Early Booking KAMPEERTOERIST/T.CLUB BELGIUM Camper offer O/W KAMPEERTOERIST/T.CLUB BELGIUM Camper offer R/trip Normal brochure fare for one way bookings Normal brochure fare for round trip bookings Μετά από αυτό το 1 ο πεδίο FareCode θα πρέπει να είναι, πχ, Β0117, ενώ το 2 ο όπως θα ήταν και εάν δεν επιλέγαμε κωδικό δημιουργίας ναύλου, πχ, Β02. Ίδια θα πρέπει να παραμείνουν τα πεδία FareCode και στα υπόλοιπα δρομολόγια εάν υπάρχουν.

33 Στις εταιρείες ANEK/ANSF/APN, ο κωδικός «Ε» (και πιθανοί άλλοι κωδικοί στο μέλλον) που χρησιμοποιείται για το early booking, θα πρέπει να μπαίνει αμέσως μετά τα αναγνωριστικά C01/B01. Έτσι, για παράδειγμα, το 1 ο πεδίο FareCode θα πρέπει να είναι, πχ, Β01Ε, ενώ το 2 ο όπως θα ήταν και εάν δεν επιλέγαμε κωδικό δημιουργίας ναύλου, πχ,β02.

34 Παράρτημα Δ Άλλες διευκρινίσεις Το timeout της επικοινωνίας μεταξύ του soap adaptor και της client εφαρμογής, το χειρίζεται ο soap adaptor. Η client εφαρμογή δεν πρέπει να κάνει disconnect από μόνη της, εκτός εάν συντρέχουν ιδιαίτερες συνθήκες. Σε κάθε απάντηση του συστήματος σας προτείνουμε να ελέγχετε, εκτός από το πεδίο status, και άλλα πεδία της απάντησης για να βεβαιωθείτε για την ορθότητα του αιτήματος/απάντησης. Όταν ζητάτε τύπο επιβάτη infant, η σειρά που το ζητάτε στον αναλυτικό πίνακα επιβατών, θα πρέπει να συμφωνεί με την αντίστοιχη θέση του στον πίνακα classanalysis. Πχ ζητάτε στον classanalysis 3 DECK και 1 AB4 berth, το infant θα πρέπει να είναι σε κάποια από τις 3 πρώτες θέσεις του αναλυτικού πίνακα επιβατών. Οι κωδικοί συστήματος που δίνονται λειτουργούν απευθείας πάνω στα παραγωγικά συστήματα των εταιρειών. Κατά την διάρκεια της ανάπτυξης μπορείτε να χρησιμοποιείτε τις δοκιμαστικές εταιρείες TS2 και ΜΟΝ, εφόσον εμπορικοί λόγοι σας εμποδίζουν να χρησιμοποιείτε live κωδικούς, ή απλά εφόσον το προτιμάτε. Για λεπτομέρειες σχετικά με δοκιμαστικά δεδομένα επικοινωνήστε με το web support. Η εταιρεία Nova Ferries δεν μπορεί να λειτουργήσει μέσα από τα web services. Μπορείτε να παράσχετε μόνο πληροφορίες δρομολογίων. Εάν επιτρέψετε την διαδικασία κράτησης/έκδοσης για την εταιρεία αυτή, θα πάρετε μήνυμα λάθους κατά την ολοκλήρωση της διαδικασίας. Σε περίπτωση που μετά την κλήση της MakeReservation ή της IssuePrepayedTickets λάβετε το error id 979, προτείνουμε να εκτελέσετε την μέθοδο «CancelPNR. Αυτό γιατί δεν είναι δεδομένη η κατάσταση της κράτησης μετά από αυτό το λάθος. Μπορεί να έχει αποθηκευτεί στο σύστημα της εταιρείας, παρόλο που λάβατε μήνυμα λάθους. Τις παρακάτω θέσεις/εταιρεία θα πρέπει να τις ζητάτε πάντα σαν C omplete, και ποτέ σαν B, ακόμα και όταν ζητάτε μόνο ένα κρεβάτι/καρέκλα (το σύστημα της εταιρείας θα το καταλάβει από την χωρητικότητα) : o BSF: DKN,OIK,DKN,OIKS,AK1,AK2,AK3,AK4,AK5 o SFF: D,S o EPT: OIK o GRI: D,POL