ForthCRS Ferries Web Services

Transcription

1 ForthCRS Ferries Web Services Document version r121 June General Structures HeaderInfo User header information (all data provided by ForthCRS) AgentCode (the agent s ID) AgentUser (the agent's user) AgentPasswd (the agent s password) AgentSignature (encoded signature)

2 --Functions List GetLocationsList Returns locations with a harbour/airport IN HeaderInfo OUT LocationsList table with the following items o LocationAbbr (abbreviation of location) o LocationName (name of location) o LocationCountry (country of location - two letter country code) GetMeanList Returns the combinations of vessel code - name per company (depending on the user s rights) IN HeaderInfo OUT MeanList table with the following items o VesselID (id of vessel) o Company (abbreviation of company) o VesselName (name of vessel)

3 GetClassList Returns the types of seats per company (depending on the user s rights) IN HeaderInfo OUT ClassList table with the following items o ClassAbbr (abbreviation of seat) o Company (abbreviation of company) o Description (description of seat) o Capacity (capacity of seat) GetVehicleTypesList Returns the categories of vehicles per company (depending on the user s rights) IN HeaderInfo OUT VehicledList table with the following items o VehicleTypeAbbr (abbreviation of category) o Company (abbreviation of company) o Description (description of category) o Meters (the meters a vehicle category occupies in the garage by default)

4 GetDiscounts Returns the discount codes of passengers/vehicles, all or per company IN HeaderInfo Company (company abbreviation for which we request the discount codes for null = all companies) VehicleCodes (Y if we want to request the vehicle discount codes null = the method will return the passenger discount codes) OUT DiscountsList table with the following fields o Discount (discount abbreviation) o Company (company abbreviation) o DiscountDescr (discount description) GetLocationsCombinations Returns the valid combinations of departure/arrival locations IN HeaderInfo OUT Combinations xml string (with a format similar to combinations.xml)

5 GetItineraries Returns itineraries depending on the selected criteria IN HeaderInfo DepDate (Date of departure, YYYYMMDD) DepTime (Time of departure currently default) DepStation (abbreviation of departure station taken from file of attributes) ArrStation (abbreviation of arrival station taken from file of attributes) Company (the company) Sorting (0=with time of departure, 1=with time of arrival, 2=with shorter length of trip) AvailInfo (Y to return availability, anything else is used to return itineraries only) OUT TTimetableAns table (maximum 99 rows) with the following items o Status (Error code-correlation with attributes, or 000) o DepDate (Date of departure) o DepTime (Time of departure) o DepStation (Station of departure) o ArrStation (Station of arrival) o Company (company) o VesselID (ID of ship/vessel) o HasGarage (Whether the vessel has a garage or not, Y/N) o HasCabins (Whether the vessel has cabins or not, Y/N) o VesselType (C=Conventional, A=Airplane, D=Dolphin/Catamaran, H=HighSpeed) o InfantCOS (code of seat where an infant is allowed/imposed to be placed within the vessel-if null it must be placed a some kind of economy/deck class.) o ArrDate (Date of arrival) o ArrTime (Time of arrival) o Season (break) o Available (YES if applicable, or NO) o ClassAvail (TCLassAvail array type) ClassAbbr (Abbreviation of seat type-correlation with attributes - IX for garage) ClassPType (C=Cabin, S=Seat, G=Garage. In case there is no class type distinction by the company, all types are returned as C ) ClassAdultBasicPrice (basic price *100, 0 for garage)

6 GetItinerariesExt Returns itineraries depending on the selected criteria, along with availability indication per class category. IN HeaderInfo DepDate (Date of departure, YYYYMMDD) DepTime (Time of departure, HHMM if a value is provided at this field, and the field company also has a value, then the method searches only for a specific trip by using the date-from-to-companydeparture time search criteria) DepStation (abbreviation of departure station taken from file of attributes mandatory field) ArrStation (abbreviation of arrival station taken from file of attributes - mandatory field) Company (the company) Sorting (0=with time of departure, 1=with time of arrival, 2=with shorter length of trip) AvailInfo (Y to return availability, anything else is used to return itineraries only) OUT TTimetableAns table (maximum 99 rows) with the following items o Status (Error code-correlation with attributes, or 000) o DepDate (Date of departure) o DepTime (Time of departure) o DepStation (Station of departure) o ArrStation (Station of arrival) o Company (company) o VesselID (ID of ship/vessel) o HasGarage (Whether the vessel has a garage or not, Y/N) o HasCabins (Whether the vessel has cabins or not, Y/N) o VesselType (C=Conventional, A=Airplane, D=Dolphin/Catamaran, H=HighSpeed) o InfantCOS (code of seat where an infant is allowed/imposed to be placed within the vessel-if null it must be placed a some kind of economy/deck class.) o ArrDate (Date of arrival) o ArrTime (Time of arrival) o Season (break) o Available (YES if applicable, or NO) o ClassAvail (TCLassAvail array type) ClassAbbr (Abbreviation of seat type-correlation with attributes - IX for garage) ClassPType (C=Cabin, S=Seat, G=Garage) ClassAdultBasicPrice (basic price *100, 0 for garage)

7 AvailWhole (number of available whole cabins/seats. This number is 9 when free cabins/seats are >=9, otherwise the exact number of free cabins/seats, is returned to the user) AvailMale (number of available male cabins/seats. This number is 9 when free cabins/seats are >=9, otherwise the exact number of free cabins/seats, is returned to the user) AvailFemale (number of available female cabins/seats. This number is 9 when free cabins/seats are >=9, otherwise the exact number of free cabins/seats, is returned to the user) PriceList1 (specific price list information in text format if available) PriceList2 (specific price list information in text format if available)

8 ItineraryPricing Pricing of itineraries *All prices returned are multiplied by 100, i.e 10 EUR will be returned as 1000 IN HeaderInfo TPricingRequest table (up to 4 itineraries) with the following items o DepDate (Date of departure, YYYYMMDD) o DepTime (Time of departure, ΗΗΜΜ) o DepStation (abbreviation of departure station taken from file of attributes) o ArrStation (abbreviation of arrival station taken from file of attributes) o Company (the company) o VesselID (ID of vessel) o TpricingPerPassenger table (up to 9 passengers) with the following items ClassAbbr (Abbreviation of seat type) PassType (Passenger type AD=Adult, CH=Child, IN=Infant, ST=Student, SE=Senior, JU=Youth) Discount (Discount code) FareCode (Code of fare pricelist, if applicable, or see appendix A) o TpricingPerVehicle table (up to 4 vehicles) with the following items VehicleType (abbreviation of vehicle type) Meters (length of vehicle) Height (height of vehicle not mandatory) Discount (Discount code) FareCode (Code of fare pricelist, if applicable) SpecialType (see Appendix D) OUT TPricingAnswer table with the following items o Status (Error code-correlation with attributes, or 000) o DepDate (Date of departure) o DepTime (Time of departure) o DepStation (Station of departure) o ArrStation (Station of arrival) o Company (the company) o VesselID (ID of ship/vessel) o Currency (Code of pricing currency) o FareCode (Code of fare pricelist, if applicable)

9 o ExtraCharges (extra charges in the total cost of the reservation, if applicable) o PricesPerPassenger (TPricesPerPassenger array type) Price (Gross passenger s price) o PricesPerVehicle (TPricesPerVehicle array type) Price (Gross price of vehicle)

10 ItineraryPricingExt Pricing of itineraries with simultaneous check of the validity of the composition of the reservation. In BSF, ANEK, ANSF, APN, LNN, ATC, GRI, the check is not performed by the systems of the companies and it is possible to be inaccurate. *All prices returned are multiplied by 100, i.e 10 EUR will be returned as 1000 IN HeaderInfo TPricingRequest table (up to 4 itineraries) with the following items o DepDate (Date of departure, YYYYMMDD) o DepTime (Time of departure, ΗΗΜΜ) o DepStation (abbreviation of departure station taken from file of attributes) o ArrStation (abbreviation of arrival station taken from file of attributes) o Company (the company) o VesselID (ID of vessel) o TClassAnalysis table with the following items ClassAbbr (Abbreviation of seat type) ClassResType (F=Female, M=Male, W=Whole cabin) Quantity (Quantity of the above seat type/category - the sum of these table fields per trip should be no more than 9) UpDownBed (Up or down bed only for cabin categories) o TpricingPerPassenger table (up to 9 passengers use the same assignment series for each cos as the one you requested in TClassAnalysis ) with the following items ClassAbbr (Abbreviation of seat type) PassType (Passenger type AD=Adult, CH=Child, IN=Infant, ST=Student, SE=Senior, JU=Youth) Discount (Discount code) FareCode (Code of fare pricelist, if applicable, or see appendix A) o TpricingPerVehicle table (up to 4 vehicles) with the following items VehicleType (abbreviation of vehicle type) Meters (length of vehicle) Height (height of vehicle not mandatory) Discount (Discount code) FareCode (Code of fare pricelist, if applicable) SpecialType (see Appendix D)

11 OUT TPricingAnswer table with the following items o Status (Error code-correlation with attributes, or 000) o DepDate (Date of departure) o DepTime (Time of departure) o DepStation (Station of departure) o ArrStation (Station of arrival) o Company (the company) o VesselID (ID of ship/vessel) o Currency (Code of pricing currency) o FareCode (Code of fare pricelist, if applicable) o ExtraCharges (extra charges in the total cost of the reservation, if applicable) o PricesPerPassenger (TPricesPerPassenger array type) Price (Gross passenger s price) o PricesPerVehicle (TPricesPerVehicle array type) Price (Gross price of vehicle)

12 ItineraryFareRules Returns itinerary fare rules for the specific reservation composition, from each company in every itinerary, and in the form of free text. To describe the reservation composition, the structure of method ItineraryPricing is used. IN HeaderInfo ΤFareRulesTrip table (up to 4 itineraries) with the following items o DepDate (Date of departure, YYYYMMDD) o DepTime (Time of departure, ΗΗΜΜ) o DepStation (abbreviation of departure station taken from file of attributes) o ArrStation (abbreviation of arrival station taken from file of attributes) o Company (the company) o VesselID (ID of vessel) o TpricingPerPassenger table (up to 9 passengers) with the following items ClassAbbr (Abbreviation of seat type) PassType (Passenger type AD=Adult, CH=Child, IN=Infant, ST=Student, SE=Senior, JU=Youth) Discount (Discount code) FareCode (Code of fare pricelist, if applicable, or see appendix A) o TpricingPerVehicle table (up to 4 vehicles) with the following items VehicleType (abbreviation of vehicle type) Meters (length of vehicle) Height (height of vehicle not mandatory) Discount (Discount code) FareCode (Code of fare pricelist, if applicable) SpecialType (see Appendix D) OUT ItineraryFareRulesAns table with the following items o Status (Error code-correlation with attributes, or 000) o RulesText (Fare rules free text)

13 MakeReservation Make a reservation, provided it is allowed for the user and by the company *Red fields Mandatory *Blue fields Mandatory, per case, for some international trips *Green fields Mandatory if online payment is available and we want the ferry company to be able to know it *Orange fields Mandatory for particular foreign companies *When you have to fill an alphabetic field not from the system s parameters, but instead from user input, use only latin capital letters IN HeaderInfo TReserveIssueRequest table (up to 4 itineraries) with the following items o DepDate (Date of departure, YYYYMMDD) o DepTime (Time of departure, ΗΗΜΜ) o DepStation (abbreviation of departure station taken from file of attributes) o ArrStation (abbreviation of arrival station taken from file of attributes) o Company (the company) o VesselID (ID of vessel) o Remarks (Remarks about reservation) o CRSReservationCode (Reservation number-when appearing in IssuePrepayedTickets, it indicates a recall of existing reservation and issue of tickets) o (the customer s address) o LeaderName (the 1st name in reservation) o Address (the customer s postal address) o Phone (the customer s phone number) o Mobile (the customer s mobile number in case this is not provided, the ferry company will be notified that the customer refused to give his phone number) o City (the customer s city of residence) o ZipCode (the customer s postal code) o DeliveryAddr (address where the ticket will be delivered) o DeliveryCity (city of delivery) o DeliveryZipCode (postal code of delivery) o Amount (the amount paid by the customer) o ApprovalCode (the code of approval issued by online payment system)

14 o TransactionCode (the transaction code issued by online payment system) o PayType (Type of payment) o CardType (Type of credit card) o DeliveryType (how the ticket will be delivered) o AddFees (additional fees, e.g. delivery fees, service fees) o ReservationCountry (Customer's country of residence two letter country code) o DeliveryCountry (Country of ticket delivery two letter country code) o TClassAnalysis table with the following items ClassAbbr (Abbreviation of seat type) ClassResType (F=Female, M=Male, W=Whole cabin) Quantity (Quantity of the above seat type/category - the sum of these table fields per trip should be no more than 9) UpDownBed (Up or down bed only for cabin categories) o TReserveIssuePerPassenger table (up to 9 use the same assignment series for each cos as the one you requested in TClassAnalysis) with the following items ClassAbbr (Abbreviation of seat type) Discount (Code of discount, if applicable) FareCode (Code of fare pricelist, if applicable) PassType (Type of passenger, AD,CH,IN,ST,SE) PassSex (Passenger s sex: F=Female, M=Male) PassName (Passenger s surname) PassInitial (Passenger s first name initial) PassSSR (Special Service Request Y for Disabled) Nationality (Passenger s nationality) BirthDate (date of birth For company GRI this field is mandatory) BirthPlace (Place of birth) Loyalty (Membership card of coastal shipping company, if applicable) Residence (passenger s home address) DocumentNo (Number of passenger s travel document) DocumentType (Type of travel document free format) DocExpire (Expiry date of travel document free format) AddFees (Additional costs, e.g. delivery fees, service fees imposed on passenger) o TReserveIssuePerVehicle table (up to 4) with the following items VehicleType (abbreviation of vehicle type) Meters (length of vehicle) Trailer (Y if the vehicle is a trailer) Discount (Code of discount, if applicable) FareCode (Code of fare pricelist, if applicable) PlateNo (Number plate of vehicle) Brand (Brand of vehicle free format)

15 Model (Model of vehicle free format) Nationality (Nationality of vehicle number plate) Loyalty (Coastal shipping company membership card, if applicable) Height (Height of vehicle) AddFees (Additional costs, e.g. delivery fees, service fees, for the vehicle) SpecialType (see Appendix D) OUT ReserveAnswer table with the following items o Status (Error code-correlation with attributes, or 000) o CRSReservationCode (ForthCRS reservation code) o CompanyReservationCode (Reservation code of coastal shipping company) o OptionDate (option date of the reservation) o OptionTime (option time of the reservation) o Remarks (Possible remarks of coastal shipping company about the reservation)

16 IssuePrepayedTickets Issues prepaid tickets, provided it is allowed for the user and by the company *All prices returned are multiplied by 100, i.e. 10 EUR will be returned as 1000 IN Exactly the same with MakeReservation function. OUT TIssueAnswer table with the following items o Status (Error code-correlation with attributes, or 000) o CRSReservationCode (ForthCRS reservation code) o CompanyReservationCode (Reservation code of coastal shipping company) o Remarks (Possible remarks of coastal shipping company about the reservation) o AdditionalData (other informational data) o TIssueAnswerPerPassenger table with the following items NetValue (Net value of passenger s fare) Taxes (Total taxes of passenger s fare) Vat (VAT on passenger s fare) PriorityNo (Number of priority-it should be printed on the voucher) SpecialDiscount (Code of discount that can be automatically generated by the coastal shipping company system, if such conditions are applicable) TicketNo (Ticket number) o TIssueAnswerPerVehicle table with the following items NetValue (Net value of vehicle fare) Taxes (Total taxes imposed on vehicle fare) Vat (VAT of vehicle fare) PriorityNo (Number of priority-it should be printed on the voucher) SpecialDiscount (Code of discount that can be automatically generated by the coastal shipping company system, if such conditions are applicable) TicketNo (Ticket number)

17 CancelPNR Cancels a reservation code with or without tickets IN HeaderInfo CancelPNRRequest o CRSReservationCode (An FCRS reservation code returned by MakeReservation or IssuePrepayedTickets) OUT CancelPNRAnswer o Status (Error code-correlation with attributes, or 000) o CRSReservationCode (FCRS reservation code) o ReturnAmount (Refund amount the customer is entitled to - this information item derives from the company in case the reservation comes with tickets) o Remarks (Possible remarks made by the company about the particular cancellation)

18 GetFinanceDataForCompany Returns finance data per company (credit limit, etc) for the used agency account, in the form of free text. IN HeaderInfo Company (mandatory field) OUT TFinanceDataAnswer o Status (Error code-correlation with attributes, or 000) o InfoLine1 (free text with maximum length of 80 characters, concerning the finance details of the agency for a specific company) o InfoLine2 o InfoLine3 o InfoLine4 o InfoLine5

19 Appendix A The FareCode field (only for the ItineraryPricing and ItineraryPricingExt function) should be used for some companies as an indicator of how we ask the particular seat to be booked. The variable value consists of the letter C, if it is a cabin, or "B" if it is a bed/seat, followed by a sequence number "01", "02", etc. concerning the different groups of similar seats requested for any trip of the reservation. If we want to request a sequence of seats, we should assign them an identical value in the said variable. Therefore, if we want to request pricing for an entire Α43 (capacity 3) cabin, we should assign the same value to all involved passengers in the FareCode field, e.g. C01. These are some indicative examples: 1 trip, 4 passengers, 2 of them in double exclusive cabin, the 3rd in a shared cabin bed and the 4th on the DECK o 1st FareCode field = C01 o 2nd FareCode field = C01 o 3rd FareCode field = B02 o 4th FareCode field = B03 2 trips, 6 passengers, 2 of them in a double exclusive cabin, 3 in a three-bed exclusive cabin and the 6th on the DECK o 1st trip, 1st FareCode field = C01 o 1st trip, 2nd FareCode field = C01 o 1st trip, 3rd FareCode field = C02 o 1st trip, 4th FareCode field = C02 o 1st trip, 5th FareCode field = C02 o 1st trip, 6th FareCode field = B03 o 2nd trip, 1st FareCode field = C04 o 2nd trip, 2nd FareCode field = C04 o 2nd trip, 3rd FareCode field = C05 o 2nd trip, 4th FareCode field = C05 o 2nd trip, 5th FareCode field = C05 o 2nd trip, 6th FareCode field = Β06 Companies that use this approach for their pricing (according to the abbreviations generated by GetItineraries) are: BSF, ANEK, ANSF, APN, LNN, ATC, GRI.

20 Appendix B - Error codes Status field on function answer: 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

21 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

22 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

23 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

24 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

25 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

26 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

27 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

28 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

29 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

30 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

31 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

32 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

33 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

34 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

35 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

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

37 Appendix C ANEK/ANSF/APN/ATC manual fare quotation handling If you want to use manual fare quotation codes for company SuperFast, you must follow this procedure. Since every single fare quotation code refers to the whole reservation, you must add to the FareCode field of the 1 st itinerary and 1 st passenger of the reservation, next to the B01 or C01 identifier, the two digit code that corresponds to the manual fare quotation code that you want to use, from the list below: 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% After this the first FareCode field should be something like B0104, while the second FareCode field should be as for a normal case without manual fare quotation, e.g. B02. The rest FareCode fields of the request should also remain the same as for a request without manual fare quotation. For ANEK/ANSF/APN fare code E (and possibly other future fare codes) that is used for early booking, should be placed next to B01/C01 identifiers, e.g. the first FareCode field should be something like B01E, while the second FareCode field should be as for a normal case without manual fare quotation, e.g. B02. The same stands for company GRI. When you use fare code E, the corresponding fare quotation code ECON will be sent to the company s system.

38 Appendix D Additional clarifications Timeout between SOAP adaptor and the client application is totally handled by the SOAP adaptor. The client application should not disconnect, unless special conditions occur. At every system response you get, we recommend that you check, except the status field, also other fields, in order to be sure about the request/response validity. When you request passenger type Infant, the place you request it in TReserveIssuePerPassenger matrix is highly recommended to co insist with the corresponding place in ClassAnalysis table. For example if you request in ClassAnalysis 3 Decks and 1 AB4 berth, you must place the infant in one of the 3 first rows of the TReserveIssuePerPassenger table. Access credentials are operative directly on the live systems of the ferry companies. During system development you may use test companies TS2 and MON if you have commercial reasons not to use directly the live systems, or if you just prefer not to. For details about test data you must contact support. Company Nova Ferries, does not operate through the web services. You may only provide your clients with the itinerary data for this company. If you permit reservation/pta issue for this company, you will get an error message when you try to complete the procedure. The same issue stands also for company Saronic Ferries (SRN). In case you get error id 979 after a call to MakeReservation or IssuePrepayedTickets, we suggest that you immediately call method «CancelPNR. This because the state of the reservation is not guaranteed after this error. The reservation may be committed in the company s data base even if you received back an error message. Passenger class types/company mentioned below should always be asked as C omplete, and never as B, even when you want to reserve a single bed/seat (in that case the system will identify what you are asking for taking into account the capacity of the cos) : o BSF: DKN,OIK,DKN,OIKS,AK1,AK2,AK3,AK4,AK5 o GRI: D,POL Method «GetItinerariesExt» does not return within the passenger class blocks any vehicle classes, while method GetItineraries returns those for companies BSF,ANEK,APN,ANSF and for vehicle classes IX1, IX2, MO1,MO2,IXS,MBJ,BTR,CRM,JEEP,DK1,DK2,IX,MOTO,IXECONOMY,V1, V2,V3,V4,H1,H2,H3,H4,L1,L2. The garage availability is returned normally as for any other company in the table ClassAvail with field values ClassAbbr=IX and ClassPType=G. In order to request a camping on board vehicle type for company ATC, you have to put into field «SpecialType», to any method that requires it, the value COB. Respectively, for the same company, in order to be able to declare a vehicle as HIGH, either exclusively or in combination with the COB declaration, you have to put to any method

39 that requires it, into field Height the value 999, regardless of the real height of the vehicle. Fields PriceList1 και PriceList2 in the answer of method GetItinerariesExt, are reserved for future use. Additionally field «SpecialType will be used in the near future for additional vehicles parameterization. You may always call url /companies.txt in order to get an updated list of ForthCRS active companies