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

Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

  • Upload
    others

  • View
    7

  • Download
    0

Embed Size (px)

Citation preview

Page 1: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

ForthCRS Ferries Web Services Document version 1.0.9 r121 – Ιούνιος 2014 --General Structures— HeaderInfo User header information (all data provided by ForthCRS)

AgentCode (το id του πράκτορα) AgentUser (ο χρήστης του πράκτορα) AgentPasswd (ο κωδικός του πράκτορα) AgentSignature (Κωδικοποιημένη Υπογραφή)

Page 2: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

--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 (η ονομασία του πλοίου)

Page 3: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

GetClassList Επιστροφή των τύπων θέσεων ανα εταιρεία (ανάλογα με τα δικαιώματα του χρήστη)

IN HeaderInfo

OUT πίνακας ClassList με στοιχεία

o ClassAbbr (το abbr της θέσης) o Company (το abbreviation της εταιρείας) o Description (η ονομασία της θέσης) o Capacity (η χωρητικότητα της θέσης)

GetVehicleTypesList Επιστροφή των κατηγοριών οχημάτων ανα εταιρεία (ανάλογα με τα δικαιώματα του χρήστη)

IN HeaderInfo

OUT πίνακας VehiclesList με στοιχεία

o VehicleTypeAbbr (το abbreviation της κατηγορίας) o Company (το abbreviation της εταιρείας) o Description (η περιγραφή της κατηγορίας) o Meters (τα default μέτρα που καταλαμβάνει η κατηγορία στο

γκαράζ)

Page 4: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

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)

Page 5: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

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)

Page 6: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

GetItinerariesExt Επιστροφή δρομολογίων σύμφωνα με τα επιλεγμένα κριτήρια, καθώς και ένδειξη διαθεσιμότητας ανά κατηγορία θέσης εφόσον ζητηθεί.

IN HeaderInfo DepDate (Ημ/νία αναχώρησης YYYYMMDD) DepTime (Ωρα αναχώρησης HHMM– Εάν καταχωρηθεί και υπάρχει

συμπληρωμένη και η εταιρεία στο αίτημα, τότε η μέθοδος θα ψάξει για μια συγκεκριμένη αναχώρηση μόνο, δηλαδή τον συνδυασμό date-from-to-company-departure time)

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)

Page 7: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

ClassPType (C=Καμπίνα, S=Seat, G=Garage . Σε περίπτωση που δεν επιστρέφεται ο διαχωρισμός θέσεων από την εταιρεία, η τιμή είναι πάντα “C”)

ClassAdultBasicPrice (βασική τιμή *100 , 0 for garage) AvailWhole (αριθμός διαθέσιμων ολόκληρων

καμπινών/θέσεων. ο αριθμός αυτός είναι 9 εάν οι ελεύθερες θέσεις είναι >=9, ειδάλλως επιστρέφεται ο πραγματικός αριθμός των διαθέσιμων καμπινών/θέσεων)

AvailMale (αριθμός διαθέσιμων ανδρικών καμπινών/θέσεων. ο αριθμός αυτός είναι 9 εάν οι ελεύθερες θέσεις είναι >=9, ειδάλλως επιστρέφεται ο πραγματικός αριθμός των διαθέσιμων καμπινών/θέσεων)

AvailFemale (αριθμός διαθέσιμων γυναικείων καμπινών/θέσεων. ο αριθμός αυτός είναι 9 εάν οι ελεύθερες θέσεις είναι >=9, ειδάλλως επιστρέφεται ο πραγματικός αριθμός των διαθέσιμων καμπινών/θέσεων)

PriceList1 (συγκεκριμένες πληροφορίες τιμοκαταλόγου σε μορφή κειμένου – αν διατίθενται)

PriceList2 (συγκεκριμένες πληροφορίες τιμοκαταλόγου σε μορφή κειμένου – αν διατίθενται)

Page 8: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

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 (Μήκος οχήματος) Height (Υψος οχήματος – δεν είναι υποχρεωτικό) Discount (Κωδικός έκπτωσης) FareCode (Κωδικός τιμοκαταλόγου, αν υπάρχει) SpecialType (Δες παράρτημα Δ)

OUT Πίνακας TPricingAnswer με στοιχεία

o Status (Error code-αντιστοιχία από παραμέτρους, ή 000) o DepDate (Ημ/νία αναχώρησης) o DepTime (Ωρα αναχώρησης) o DepStation (Σταθμός αναχώρησης) o ArrStation (Σταθμός άφιξης) o Company (εταιρεία) o VesselID (Κωδικός πλοίου/μέσου) o Currency (Κωδικός νομίσματος τιμολόγησης) o FareCode (Κωδικός τιμοκαταλόγου-Αν υπάρχει)

Page 9: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

o ExtraCharges (Επιπλέον χρεώσεις στο σύνολο της κράτησης – Αν υπάρχουν)

o PricesPerPassenger (TPricesPerPassenger array type) Price (Μικτή αξία επιβάτη)

o PricesPerVehicle (TPricesPerVehicle array type) Price (Μικτή αξία οχήματος)

Page 10: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο εγκυρότητας της σύνθεσης της κράτησης. Στις BSF, ANEK, ANSF, APN, LNN, ATC, GRI, ο έλεγχος δεν γίνεται από τα συστήματα των εταιρειών και ενδέχεται να μην ισχύει απόλυτα. *Όλες οι τιμές επιστρέφονται σαν πολλαπλασιασμένες* 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 τύπου θέσης – να ζητείται με την

ίδια σειρά που έχουν ζητηθεί οι θέσεις στον TClassAnalysis)

PassType (Τύπος επιβάτη – AD=Adult, CH=Child, IN=Infant, ST=Student, SE=Senior, JU=Youth)

Discount (Κωδικός έκπτωσης) FareCode (Κωδικός τιμοκαταλόγου, αν υπάρχει ή δες

παράρτημα Α) o Πίνακας TpricingPerVehicle (μέχρι 4 οχήματα) με στοιχεία

VehicleType (Abbreviation κατηγορίας οχήματος) Meters (Μήκος οχήματος) Height (Υψος οχήματος) Discount (Κωδικός έκπτωσης) FareCode (Κωδικός τιμοκαταλόγου, αν υπάρχει) SpecialType (Δες παράρτημα Δ)

Page 11: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

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 (Μικτή αξία οχήματος)

Page 12: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

ItineraryFareRules Επιστρέφει σε μορφή ελεύθερου κειμένου τους κανονισμούς ναύλου για μια συγκεκριμένη σύνθεση κράτησης από την εκάστοτε εταιρεία. Για την περιγραφή της σύνθεσης της κράτησης χρησιμοποιείται η ίδια δομή με αυτή της μεθόδου ItineraryPricing

IN HeaderInfo Πίνακας ΤFareRulesTrip (μέχρι 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 (Μήκος οχήματος) Height (Υψος οχήματος) Discount (Κωδικός έκπτωσης) FareCode (Κωδικός τιμοκαταλόγου, αν υπάρχει) SpecialType (Δες παράρτημα Δ)

OUT Πίνακας ItineraryFareRulesAns με στοιχεία

o Status (Error code-αντιστοιχία από παραμέτρους, ή 000) o RulesText (Κείμενο με τα fare rules)

Page 13: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

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 Email (Ηλεκτρονική διεύθυνση πελάτη) o LeaderName (Το 1ο Ονομα στην κράτηση) o Address (διεύθυνση πελάτη) o Phone (τηλέφωνο πελάτη) o Mobile (κινητό τηλέφωνο πελάτη - σε περίπτωση που δεν δοθεί

θα ενημερωθεί η ακτοπλοϊκή εταιρεία ότι ο πελάτης αρνήθηκε να δώσει το τηλέφωνο του)

o City (Πόλη διαμονής πελάτη) o ZipCode (Ταχ.κώδικας διαμονής πελάτη) o DeliveryAddr (Διεύθυνση παράδοσης εισιτηρίου) o DeliveryCity (πόλη παράδοσης) o DeliveryZipCode (Ταχ.κώδικας παράδοσης) o Amount (Χρηματικό πόσό πληρωμής από πελάτη) o ApprovalCode (Κωδικός έγκρισης από σύστημα ηλεκτρονικής

πληρωμής)

Page 14: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

o TransactionCode (Κωδικός κίνησης από σύστημα ηλεκτρονικής πληρωμής)

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 – να ζητείται με την ίδια σειρά που έχουν ζητηθεί οι θέσεις στον TClassAnalysis) , με στοιχεία 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 (ημ/νία γέννησης) – Στην εταιρεία GRI το πεδίο

είναι υποχρεωτικό 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)

Page 15: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

Nationality (Εθνικότητα πινακίδων οχήματος, two letter country code)

Loyalty (Κάρτα μέλους ακτοπλοϊκής εταιρείας, αν υπάρχει) Height (Υψος οχήματος) AddFees (Πρόσθετα κόστη, πχ παράδοσης, service fees

για το όχημα) SpecialType (Δες παράρτημα Δ)

OUT ReserveAnswer με στοιχεία

o Status (Error code-αντιστοιχία από παραμέτρους, ή 000) o CRSReservationCode (Κωδικός κράτησης ForthCRS) o CompanyReservationCode (Κωδικός κράτησης ακτοπλοικής

εταιρείας) o OptionDate (Ημερομηνία option κράτησης) o OptionTime (Ωρα option κράτησης) o Remarks (Πιθανά σχόλια της ακτοπλοικής εταιρείας πάνω στην

κράτηση)

Page 16: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

IssuePrepayedTickets Εκδοση προπληρωμένων εισιτηρίων, εφόσον επιτρέπεται στον χρήστη και από την εταιρεία

*Όλες οι τιμές επιστρέφονται σαν πολλαπλασιασμένες* 100, πχ 10 EUR θα επιστραφούν σαν «1000»

IN Ιδιο ακριβώς με της μεθόδου MakeReservation

OUT Πίνακας TIssueAnswer με στοιχεία

o Status (Error code-αντιστοιχία από παραμέτρους, ή 000) o CRSReservationCode (Κωδικός κράτησης ForthCRS) o CompanyReservationCode (Κωδικός κράτησης ακτοπλοικής

εταιρείας) o Remarks (Πιθανά σχόλια της ακτοπλοικής εταιρείας πάνω στην

κράτηση) o AdditionalData (άλλα πρόσθετα στοιχεία) o Πίνακας TIssueAnswerPerPassenger με στοιχεία

NetValue (Καθαρή αξία ναύλου επιβάτη) Taxes (Σύνολο φόρων ναύλου επιβάτη) Vat (ΦΠΑ ναύλου επιβάτη) PriorityNo (Αριθμός προτεραιότητας-Πρέπει να τυπώνεται

στο voucher) SpecialDiscount (Κωδικός έκπτωσης που μπορεί να δωθεί

αυτόματα από το σύστημα της ακτοπλοικής εταιρείας, αν συντρέχουν κάποιες συνθήκες)

TicketNo (Αριθμός εισιτηρίου) o Πίνακας TIssueAnswerPerVehicle με στοιχεία

NetValue (Καθαρή αξία ναύλου οχήματος) Taxes (Σύνολο φόρων ναύλου οχήματος) Vat (ΦΠΑ ναύλου οχήματος) PriorityNo (Αριθμός προτεραιότητας-Πρέπει να τυπώνεται

στο voucher) SpecialDiscount (Κωδικός έκπτωσης που μπορεί να δωθεί

αυτόματα από το σύστημα της ακτοπλοικής εταιρείας, αν συντρέχουν κάποιες συνθήκες)

TicketNo (Αριθμός εισιτηρίου)

Page 17: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

CancelPNR Διαγραφή ενός κωδικού κράτησης με ή χωρίς εισιτήρια

IN HeaderInfo CancelPNRRequest

o CRSReservationCode (Κωδικός κράτησης FCRS που έχει επιστραφεί από την MakeReservation ή την IssuePrepayedTickets)

OUT CancelPNRAnswer

o Status (Error code-αντιστοιχία από παραμέτρους, ή 000) o CRSReservationCode (Κωδικός κράτησης FCRS) o ReturnAmount (Ποσό επιστροφής που δικαιούται ο πελάτης – Η

πληροφορία αυτή έρχεται από την εταιρεία σε περίπτωση που η κράτηση έχει εισιτήρια)

o Remarks (Πιθανά σχόλια από την εταιρεία σχετικά με την συγκεκριμένη ακύρωση)

Page 18: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

GetFinanceDataForCompany Επιστροφή οικονομικών παραμέτρων ανά εταιρεία για τον εκάστοτε λογαριασμό/κωδικό πρακτορείου με την μορφή free text.

IN HeaderInfo Company (Υποχρεωτικό πεδίο)

OUT TFinanceDataAnswer

o Status (Error code-αντιστοιχία από παραμέτρους, ή 000) o InfoLine1 (γραμμή ελεύθερου κειμένου με μέγιστο μήκος 80

χαρακτήρες, όπως το επιστρέφει η εταιρεία σχετικά με τα οικονομικά στοιχεία του λογαριασμού που εστάλη στα πεδία του HeaderInfo)

o InfoLine2 o InfoLine3 o InfoLine4 o InfoLine5

Page 19: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

Παράρτημα Α Το πεδίο 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, ATC, GRI.

Page 20: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

Παράρτημα Β – Κωδικοί λαθών Πεδίο 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 Itinerary not in date/time order 014 No suitable sailings found 015 Invalid time 016 Invalid date 017 Sailing cancelled 018 Time is not valid on open returns

Page 21: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

019 Arrival and departure port can not be 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 missing 102 Wrong number of passengers 103 Passenger type quota exceeded 104 Passengers exceed commercial rules 105 Passenger type invalid 106 Passenger type not supported 107 Class capacity exceeded 108 No foot passenger reservations 109 Passenger types must be the same on both legs 110 At least 1 adult must travel

Page 22: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

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 cannot 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 You cannot change the departure date 201 Car deck space not available 202 Vehicle code repeated 203 Vehicles quota exceeded 204 Absolute vehicle limit exceeded 205 Vehicle or trailer is too long 206 More than allowed - bicycles 207 Invalid vehicle type 208 Invalid vehicle type for this carrier 209 Vehicle length missing or invalid 210 Trailer length missing or invalid 211 Invalid Trailer type 212 Invalid Vehicle trailer combination 213 Invalid trailer type for this carrier 214 Vehicle or trailer is too high 215 Deck position for vehicle not available 216 Non accompanied vehicle

Page 23: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

217 This plate number belongs to a 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 Accommodation repeats not allowed 306 No foot passenger reservations 307 Under occupancy not allowed 308 Accommodation mandatory for overnight sailings 309 Maximum number of dogs exceeded 310 Requested space unavailable 311 Invalid Cabin numbers 312 Invalid Seat numbers 313 Invalid Place numbers 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 cabin reservation must include at least one adult 319 When requesting place - complete one field only in ext 320 Too many cabin types requested 321 Number of passengers and number of berths must be the same 322 Cabins can only be booked complete - no individual berths

Page 24: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

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 Offer not available 409 Journey date or time is not available 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 after ticketing

Page 25: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

417 Cannot ticket unpriced booking 418 Tickets do not match reservations 419 A ticket has already been issued for this reservation 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 a day after the 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

Page 26: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

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, cannot issue open ticket. 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 473 Discount offer is mandatory 500 Reservation protocol limits exceeded 501 Leg/journey/itinerary ref. Invalid 502 Legs quoted have not been reserved 503 Itinerary element does not exist 504 Cannot cancel - journey completed 505 Invalid reference number

Page 27: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

506 Cannot cancel - leg departed 507 Cannot recall - status mismatch 508 Cannot confirm - journey completed 509 One booking single - one return 510 Booking temporarily unavailable 511 Only firm bookings 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 accommodation 517 Reservation not made by this office 518 Cannot recall last booking 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 closed at this time 529 Invalid booking

Page 28: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

530 Number of nights exceeds maximum permitted 531 Incomplete booking details 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 Children limit exceeded 542 Infants limit exceeded 543 Unable to dispose room/unit 544 Too many infants 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

Page 29: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

557 Wrong room type 558 No availability for this room type 559 Room is not valid 560 Invalid Type of travel 561 Incorrect departure date 562 Incorrect arrival date 563 Wrong time 564 Incorrect number of adults 565 Incorrect number of children 566 Invalid commission 567 Invalid number of rooms/units 568 Invalid room/unit code 569 Room/unit occupancy not acceptable 570 Invalid room/unit price 571 Voucher with a negative amount not allowed 572 Please check arrival and/or departure date 573 Invalid service requested 574 Invalid Taxes 577 Departure date missing 578 Voucher amount too high 579 Reservations not allowed for specific passenger/vehicle types 580 Details may not be changed 581 Only group reservations allowed 582 Recall booking to change details

Page 30: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

585 Number of rooms/units missing 586 Room/unit details missing 587 Room/unit price missing 588 Accommodation details not complete 589 Commission not applicable 590 Zero commission not acceptable 591 Arrival 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 Group reservations not allowed 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 Premises not recognized 604 Booking not made by this agent 605 Requested action not possible 606 Agency code must be entered 607 Bookings made by different agents 608 Password not correct

Page 31: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

609 Password not allowed 610 Premise suspended 611 Booking not made by this premise 612 Agent only allowed in training mode 613 Invalid terminal 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

Page 32: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

The arrival/departure connection ports of your multiroute selection are not compatible. Please correct and try again. 637 Please check your credit limit 701 System currently unavailable 702 Last entry failed - contact service provider 703 Transaction not authorized 704 No access via this DTE address 705 Cannot accept dogs on return 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. 725 Cannot convert ticket to open 726 There is no more Dynamic Discount availability on the return trip. 801 No results found with given criteria 802 Redefine Search Criteria - Too many Results

Page 33: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

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 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 with other currency 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

Page 34: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

Mixed type of reservation prohibited when there is special price 827 Cannot issue gift ticket. Please contact the company 828 There is no more Dynamic Discount availability on the outward trip. 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 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 856 Loyalty Card is not valid 857 You cannot use Loyalty card for this item or cabin class 858 Loyalty card has been used more than once for vehicle or human in the same trip 859 Loyalty owners names with the reservation names matching failed 860 Unaccompanied vehicle (trailer) without the proper accompanying vehicle 867 You cannot insert more than 5 relative contacts for the same loyalty card and reservation 868 You cannot insert more than 1 card owner for the same loyalty card and reservation or the relative persons be above 17 years old 869 Loyalty Card is invalid 870 Numbers must be included in lic. plate number 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

Page 35: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

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 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 986 Not enough points in the card

Page 36: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

987 Can be renewed Only for Next Month 988 Service temporarily unavailable 989 Ticket is already printed

Page 37: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

Παράρτημα Γ – ANEK/ANSF/APN/ATC manual fare quotation handling Εφόσον επιθυμείτε να χρησιμοποιήσετε κωδικούς δημιουργίας ναύλων στην εταιρεία SuperFast, θα πρέπει να ακολουθήσετε την παρακάτω διαδικασία. Με δεδομένο ότι ο κάθε κωδικός αναφέρεται σε ολόκληρη κράτηση, θα πρέπει στο πεδίο “FareCode” του 1ου δρομολογίου και 1ου επιβάτη, να βάλετε δίπλα στο αναγνωριστικό B01 ή C01 που χρησιμοποιείτε, τον διψήφιο αριθμητικό κωδικό που επιθυμείτε σύμφωνα με την παρακάτω λίστα : 01=EACA BARI 25% EUROPEAN AUTOM./CAMPING ASSOC. 02=IACA BARI 25% ITALIAN & GREEK AUTOM./CAMPING ASSOC. 03=EECA EARLY BOOKING EUROPEAN AUTOM./CAMPING ASSOC.OFFER 04=EICA EARLY BOOKING IT & GR AUTOM./CAMP. ASSOC.OFFER 05=NORM BROCHURE 06=ASDS AIRSEAT & DECK OFFER 20% - BARI 07=FAM FAMILY OFFER 10% - BARI 08=ERL EARLY BOOKING - 10% DISCOUNT 09=EBAD EARLY BOOKING AIRSEAT-DECK OFFER 20% 10=EBFM EARLY BOOKING FAMILY OFFER 10% Μετά από αυτό το 1ο πεδίο “FareCode” θα πρέπει να είναι, πχ, Β0104, ενώ το 2ο όπως θα ήταν και εάν δεν επιλέγαμε κωδικό δημιουργίας ναύλου, πχ, Β02. Ίδια θα πρέπει να παραμείνουν τα πεδία “FareCode” και στα υπόλοιπα δρομολόγια εάν υπάρχουν. Στις εταιρείες ANEK/ANSF/APN, ο κωδικός «Ε» (και πιθανοί άλλοι κωδικοί στο μέλλον) που χρησιμοποιείται για το early booking, θα πρέπει να μπαίνει αμέσως μετά τα αναγνωριστικά C01/B01. Έτσι, για παράδειγμα, το 1ο πεδίο “FareCode” θα πρέπει να είναι, πχ, Β01Ε, ενώ το 2ο όπως θα ήταν και εάν δεν επιλέγαμε κωδικό δημιουργίας ναύλου, πχ,Β02. Το ίδιο ισχύει και για την εταιρεία GRI. Χρησιμοποιώντας τον κωδικό «Ε», η εφαρμογή ζητάει τον κωδικό τιμολόγησης “ECON”.

Page 38: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

Παράρτημα Δ – Άλλες διευκρινίσεις

Το timeout της επικοινωνίας μεταξύ του soap adaptor και της client εφαρμογής, το χειρίζεται ο soap adaptor. Η client εφαρμογή δεν πρέπει να κάνει disconnect από μόνη της, εκτός εάν συντρέχουν ιδιαίτερες συνθήκες.

Σε κάθε απάντηση του συστήματος σας προτείνουμε να ελέγχετε, εκτός από το πεδίο “status”, και άλλα πεδία της απάντησης για να βεβαιωθείτε για την ορθότητα του αιτήματος/απάντησης.

Όταν ζητάτε τύπο επιβάτη infant, η σειρά που το ζητάτε στον αναλυτικό πίνακα επιβατών, θα πρέπει να συμφωνεί με την αντίστοιχη θέση του στον πίνακα classanalysis. Πχ ζητάτε στον classanalysis 3 DECK και 1 AB4 berth, το infant θα πρέπει να είναι σε κάποια από τις 3 πρώτες θέσεις του αναλυτικού πίνακα επιβατών.

Οι κωδικοί συστήματος που δίνονται λειτουργούν απευθείας πάνω στα παραγωγικά συστήματα των εταιρειών. Κατά την διάρκεια της ανάπτυξης μπορείτε να χρησιμοποιείτε τις δοκιμαστικές εταιρείες TS2 και ΜΟΝ, εφόσον εμπορικοί λόγοι σας εμποδίζουν να χρησιμοποιείτε live κωδικούς, ή απλά εφόσον το προτιμάτε. Για λεπτομέρειες σχετικά με δοκιμαστικά δεδομένα επικοινωνήστε με το support.

Η εταιρεία Nova Ferries, δεν μπορεί να λειτουργήσει μέσα από τα web services. Μπορείτε να παράσχετε μόνο πληροφορίες δρομολογίων. Εάν επιτρέψετε την διαδικασία κράτησης/έκδοσης για την εταιρεία αυτή, θα πάρετε μήνυμα λάθους κατά την ολοκλήρωση της διαδικασίας. Το ίδιο ισχύει και για την εταιρεία Saronic Ferries (SRN).

Σε περίπτωση που μετά την κλήση της MakeReservation ή της IssuePrepayedTickets λάβετε το error id 979, προτείνουμε να εκτελέσετε την μέθοδο «CancelPNR”. Αυτό γιατί δεν είναι δεδομένη η κατάσταση της κράτησης μετά από αυτό το λάθος. Μπορεί να έχει αποθηκευτεί στο σύστημα της εταιρείας, παρόλο που λάβατε μήνυμα λάθους.

Τις παρακάτω θέσεις/εταιρεία θα πρέπει να τις ζητάτε πάντα σαν “C”omplete, και ποτέ σαν “B” , ακόμα και όταν ζητάτε μόνο ένα κρεβάτι/καρέκλα (το σύστημα της εταιρείας θα το καταλάβει από την χωρητικότητα) :

o BSF: DKN,OIK,DKN,OIKS,AK1,AK2,AK3,AK4,AK5 o GRI: D,POL

Η νέα μέθοδος «GetItinerariesExt» δεν επιστρέφει πλέον ενδιάμεσα στις θέσεις των επιβατών, τις θέσεις οχημάτων (IX1,IX2,MO1,MO2,IXS,MBJ,BTR,CRM,JEEP,DK1,DK2,IX,MOTO,IXECONOMY,V1,V2,V3,V4,H1,H2,H3,H4,L1,L2), που επιστρέφουν εκεί οι εταιρείες BSF,ANEK,APN,ANSF στην απλή έκδοση της “GetItineraries”. Επιστρέφεται απλά η διαθεσιμότητα ή όχι του garage στον πίνακα “ClassAvail” με τιμές στα πεδία ClassAbbr=IX και ClassPType=G

Για να ζητήσετε τύπο οχήματος camping on board στην εταιρεία ATC , θα πρέπει στο πεδίο «SpecialType» σε όποια μέθοδο χρειάζεται, να μπει η τιμή “COB”. Αντίστοιχα, για την ίδια εταιρεία, εφόσον θα πρέπει να δηλωθεί ένα όχημα σαν «High”, είτε συνδυαστικά με το COB, είτε

Page 39: Web Services Ferries109 - Forthcrssupport.forth-crs.gr/Webservices/Version 1.0.9/Web...ItineraryPricingExt Τιμολόγηση δρομολογίων με ταυτόχρονο έλεγχο

αποκλειστικά, θα πρέπει να μπει στο πεδίο “Height” σε όποια μέθοδο χρειάζεται, η τιμή «999» ανεξάρτητα του πραγματικού του ύψους.

Τα πεδία “PriceList1” και “PriceList2” στην απάντηση της μεθόδου “GetItinerariesExt”, έχουν δεσμευτεί για μελλοντική χρήση. Επίσης μελλοντικά το πεδίο «SpecialType” θα χρησιμοποιηθεί και για επιπλέον παραμετροποίηση οχημάτων.

Στο url http://webservices.forth-crs.gr/FerriesWS-1.0.9/companies.txt μπορείτε να λαμβάνετε οποτεδήποτε το καλέσετε, την λίστα με τις ενεργές εταιρείες της ForthCRS