Transfer Information

DROP-OFF & PICK-UP POINTS FOR TRANSFERS

If the drop-off point for a transfer booking is located in the outer suburbs of a large city or in an entirely different town to the pick-up point the price may be higher than the initial quote. This also applies if the pick-up point for a transfer booking is located in the outer suburbs of a larger city or in an entirely different town to the drop-off point. In those cases we will contact you after receiving your booking request with the revised final price. Please note that we will confirm the service as per the information provided. If any of these changes then you must amend the details accordingly. We cannot be held responsible for problems arising as a result of incorrect information being provided.

AREA CODES FOR TRANSFERS (<SearchItemInformationResponse>)

<SearchItemInformationRequest ItemType = "transfer"> may return an Area Code that is not included within the area codes returned with the <SearchAreaReponse>. If you need to know the cities within those area codes you can still perform a <SearchCitiesInAreaRequest> for the area in question.

AREA CODES FOR TRANSFERS (<SearchTransferPriceResponse>)

 Occasionally the <SearchTransferPriceResponse> returns an area code rather than a city code (as shown in the example below).

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
    <Source>
        <RequestorID
            Client = "*"
            EMailAddress = "**********"
            Password = "******"/>
        <RequestorPreferences Language = "en">
            <RequestMode>SYNCHRONOUS</RequestMode>
        </RequestorPreferences>
    </Source>
    <RequestDetails>
        <SearchTransferPriceRequest>
            <TransferPickUp>
                <PickUpCityCode>zrh</PickUpCityCode>
                <PickUpCode>a</PickUpCode>
            </TransferPickUp>
            <TransferDropOff>
                <DropOffCode>h</DropOffCode>
            </TransferDropOff>
            <TransferDate>2011-09-01</TransferDate>
            <NumberOfPassengers>2</NumberOfPassengers>
            <PreferredLanguage>e</PreferredLanguage>
        </SearchTransferPriceRequest>
    </RequestDetails>
</Request>


<?xml version="1.0" encoding="UTF-8"?>
<Response ResponseReference = "REF_P_028_6-449300-833684680897001">
    <ResponseDetails Language = "en">
        <SearchTransferPriceResponse>
            <TransferDetails>
                <Transfer HasExtraInfo = "true">
                    <City Code = "ZRH"><![CDATA[Zurich]]></City>
                    <Item Code = "000000552006   "><![CDATA[Zurich Airport to Accommodation in Zurich with a Driver speaking the Local Language only]]></Item>
                    <PickUpDetails>
                        <PickUp Code = "A"><![CDATA[Airport]]></PickUp>
                        <Airport Code = "ZRH"><![CDATA[Zurich]]></Airport>
                    </PickUpDetails>
                    <DropOffDetails>
                        <DropOff Code = "H"><![CDATA[Accommodation]]></DropOff>
                        &lt;Area Code = "ZRH1"&gt;&lt;![CDATA[Zurich, Switzerland]]&gt;&lt;/Area&gt;
                    </DropOffDetails>
                    <OutOfHoursSupplements>
                        <OutOfHoursSupplement>
                            <FromTime>00.00</FromTime>
                            <ToTime>06.00</ToTime>
                            <Supplement>25.00%</Supplement>
                        </OutOfHoursSupplement>
                        <OutOfHoursSupplement>
                            <FromTime>20.30</FromTime>
                            <ToTime>23.59</ToTime>
                            <Supplement>25.00%</Supplement>
                        </OutOfHoursSupplement>
                    </OutOfHoursSupplements>
                    <ApproximateTransferTime Time = "0.25"><![CDATA[ 25 mins]]></ApproximateTransferTime>
                    <TransferVehicles>
                        <TransferVehicle>
                            <Vehicle
                                Code = "SA"
                                MaximumLuggage = "3"
                                MaximumPassengers = "3">Standard Car</Vehicle>
                            <ItemPrice Currency = "EUR">141.00</ItemPrice>
                            <Confirmation Code = "IM"><![CDATA[AVAILABLE]]></Confirmation>
                        </TransferVehicle>
                </Transfer>
            </TransferDetails>
        </SearchTransferPriceResponse>
    </ResponseDetails>
</Response>

In those cases, when the <AddBookingRequest> is sent  it is necessary to specify a GTA hotel code from  a city within the area code returned  in <SearchTransferPriceResponse>;  see example below:

<?xml version="1.0" encoding="UTF-8" ?>
<Request>
    <Source>
        <RequestorID
            Client = "**"
            EMailAddress = "*************"
            Password = "****"/>
        <RequestorPreferences Language = "en">
            <RequestMode>SYNCHRONOUS</RequestMode>
        </RequestorPreferences>
    </Source>
    <RequestDetails>
        <AddBookingRequest>
            <BookingReference>sdfsdf361</BookingReference>
            <PaxNames>
                <PaxName PaxId = "1"><![CDATA[olivares a]]></PaxName>
            </PaxNames>
            <BookingItems>
                <BookingItem ItemType = "transfer">
                    <ItemReference>1</ItemReference>
                    <ItemCity Code = "zrh"/>
                    <Item Code = "000000552006"/>
                    <TransferItem>
                        <PickUpDetails>
                            <PickUpAirport>
                                <ArrivingFrom>
                                    <Airport Code = "lhr"/>
                                </ArrivingFrom>
                                <FlightNumber>ba123</FlightNumber>
                                <EstimatedArrival>14.00</EstimatedArrival>
                            </PickUpAirport>
                        </PickUpDetails>
                        <DropOffDetails>
                            <DropOffAccommodation>
                                <DropOffTo>
                                    <Hotel Code = "hil"/>
                                </DropOffTo>
                            </DropOffAccommodation>
                        </DropOffDetails>
                        <TransferDate>2011-11-01</TransferDate>
                        <TransferLanguage></TransferLanguage>
                        <TransferVehicle>
                            <Vehicle Code = "sa" MaximumPassengers = "1"/>
                            <Passengers>1</Passengers>
                            <LeadPaxId>1</LeadPaxId>
                        </TransferVehicle>
                    </TransferItem>
                </BookingItem>
            </BookingItems>
        </AddBookingRequest>
    </RequestDetails>
</Request>

OUT OF HOUR SUPPLEMENT 

The <SearchTransferPriceResponse> returns the basic price of the transfer service (see below in blue) as well as the <OutOfHoursSupplements> (in yellow), that needs to be added depending on the time at which the service will take place:

<OutOfHoursSupplements>
           <OutOfHoursSupplement>
                            <FromTime>00.00</FromTime>
                            <ToTime>06.00</ToTime>
                            <Supplement>20.00%</Supplement>
                        </OutOfHoursSupplement>
                        <OutOfHoursSupplement>
                            <FromTime>20.00</FromTime>
                            <ToTime>23.59</ToTime>
                            <Supplement>20.00%</Supplement>
                        </OutOfHoursSupplement>  
                    </OutOfHoursSupplements>
                    <ApproximateTransferTime Time = "0.45"><![CDATA[ 45 mins]]></ApproximateTransferTime>
                    <TransferVehicles>
                        <TransferVehicle>
                            <Vehicle
                                Code = "SA"
                                MaximumLuggage = "2"
                                MaximumPassengers = "2">Standard Car</Vehicle>
                            <ItemPrice Currency = "EUR">67.00</ItemPrice>
                            <Confirmation Code = "IM"><![CDATA[AVAILABLE]]></Confirmation>
                        </TransferVehicle>
                        <TransferVehicle>
                            <Vehicle
                                Code = "PC"
                                MaximumLuggage = "4"
                                MaximumPassengers = "4">People Carrier</Vehicle>
                            <ItemPrice Currency = "EUR">84.50</ItemPrice>
                            <Confirmation Code = "IM"><![CDATA[AVAILABLE]]></Confirmation>
                        </TransferVehicle>

Therefore when displaying the price on the search results page to your customers it is necessary to either calculate the supplements and show the total price for the various times of the day or advise at what times what amount applies for the out of hours supplement.

As the time of the service must be specified in the <AddBookingRequest>, the <BookingResponse> will return the final price, including the <OutOfHoursSupplement> when applicable and no calculation is required. 

When sending a <SearchChargeConditionsRequest>, the time of the service is a mandatory field. Therefore, if the time is within the range where out of hours supplement applies, charges will include the corresponding percentage mark-up.

TRANSFER TIME

Our systems will check that there is enough time between the pick-up; e.g.: from the hotel, and the departure of a flight, train or ship/ferry. If a transfer pick-up time is being requested that does not allow sufficient time our systems will return an error:

<Error>
	     <ErrorId>GRT0145</ErrorId>
	     <ErrorText><![CDATA[Departure time is invalid]]></ErrorText>
	     <ErrorContext ItemReference="1" Sequence="1"/>
	</Error>

In order to calculate the minimum transfer time correctly it is necessary to take the following values into account:

  • The <ApproximateTransferTime> (if returned with the <SearchTransferPriceResponse>)
  • The ‘AllowForCheckInTime’ (if returned with the <SearchTransferPriceResponse>)
  • Add 1 minute

All three values need to me added up to calculate the minimum time required between pick-up time and departure time from the airport, station or port.

This is the <SearchTransferPriceResponse> for a transfer from a hotel in London to Gatwick airport:

<SearchTransferPriceResponse>
            <TransferDetails>
                <Transfer HasExtraInfo = "true">
                    <City Code = "LON"><![CDATA[London]]></City>
                    <Item Code = "000002190006   "><![CDATA[Accommodation in central London to London Gatwick Airport with a Driver speaking the Local Language only]]></Item>
                    <PickUpDetails>
                        <PickUp Code = "H"><![CDATA[Accommodation]]></PickUp>
                        <City Code = "LON"><![CDATA[London]]></City>
                    </PickUpDetails>
                    <DropOffDetails>
                        <DropOff AllowForCheckInTime = "1.00" Code = "A"><![CDATA[Airport]]></DropOff>
                        <Airport Code = "LGW"><![CDATA[Gatwick]]></Airport>
                    </DropOffDetails>
                    <OutOfHoursSupplements>
                        <OutOfHoursSupplement>
                            <FromTime>00.00</FromTime>
                            <ToTime>05.00</ToTime>
                            <Supplement>67.65%</Supplement>
                        </OutOfHoursSupplement>
                        <OutOfHoursSupplement>
                            <FromTime>23.30</FromTime>
                            <ToTime>23.59</ToTime>
                            <Supplement>67.65%</Supplement>
                        </OutOfHoursSupplement>
                    </OutOfHoursSupplements>
                    <ApproximateTransferTime Time = "2.00"><![CDATA[2 hours]]></ApproximateTransferTime>
                    <TransferVehicles>
                        <TransferVehicle>
                            <Vehicle
                                Code = "SA"
                                MaximumLuggage = "3"
                                MaximumPassengers = "3">Standard Car</Vehicle>
                            <ItemPrice Currency = "EUR">122.00</ItemPrice>
                            <Confirmation Code = "IM"><![CDATA[AVAILABLE]]></Confirmation>
                        </TransferVehicle>
                    </TransferVehicles>
                </Transfer>
            </TransferDetails>
        </SearchTransferPriceResponse>

For this transfer it is necessary to allow a minimum of 3 hours and 1 minute between the pick-up time from the hotel and the departure time of the flight.

TRANSFER LIST CODE ENGLISH ARABIC      CHINESE SIMPLIFIED CHINESE TRADITIONAL FRENCH GERMAN HEBREW ITALIAN JAPANESE KOREAN RUSSIAN SPANISH THAI SWEDISH
  EN AR ZH ZZ FR DE IW IT JA KO RU ES TH SW
A Airport المطار 机场 機場 Aéroport Flughafen שדה תעופה Aeroporto 空港 공항 Аэропорт Aeropuerto สนามบิน Flygplats
H Accommodation السكن 住宿 住宿 Hébergement Unterkunft אירוח Sistemazione 宿泊施設 숙박시설 проживание Alojamiento สถานที่พัก Övernattning
P Port الميناء 港口 港口 Port Hafen נמל ים Porto 항구 Порт Puerto ท่าเทียบเรือ Hamn
S Station المحطة 火车站 火車站 Gare Bahnhof תחנת רכבת Stazione 기차역 Станция Estación สถานีรถไฟ Station
O Other أخرى 其它 其他 Autre Andere אחר Altro その他 기타 Другое Otro อื่น Annat

Transfer Mapping Suggestions

Port Transfers

Language Codes For Transfers & Tailor-Made Sightseeing Tours

Airport Codes Worldwide

Transfer Portfolio

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 


 

 

 

 

 

Docs Navigation