Transfer Item

For bookings the specifics of a transfer item will be contained within the TransferItem sub-element.

BookingItem sub-element

Before the TransferItem sub-element is specified (within BookingItem), the Item sub-element must be specified with a Code attribute. For example: 

<BookingItem ItemType = "transfer">
    <ItemReference>1</ItemReference>
    <ItemCity Code = "LON"/>
    <Item Code = "000000084003"/>
    <TransferItem>++++++++++++++++</TransferItem>
</BookingItem>

This Item Code specifies the type of transfer being requested from which the following additional data can be derived: -

  • Type of pick up (e.g. Airport)
  • Pick up code (e.g. Airport Code)
  • Type of Drop Off (e.g. Accommodation)
  • Drop Off Code (e.g. City Code for hotel)

The Pick Up and Drop Off details specified in the TransferItem sub-element must correspond to those derived from the Item Code.

Request

TransferItem sub-element

The following gives a list of the attributes and sub-elements allowed for a TransferItem sub-element within a request:

Parameter

Description

PickUpDetails

Mandatory. See below for details.

DropOffDetails

Mandatory.See below for details.

TransferDate

Mandatory. Specifies the data of the transfer

TransferLanguage

Optional.  Specifies  the code for the language required. 

Transfer Vehicle

Mandatory.See below for details


PickUpDetails

Parameter

Description

PickUpDetails

Mandatory. Specifies the pick up details of transfer item.

 

Attribute

Description

City

Code

Mandatory if this is different to the ItemCity Code and  it is used  in conjunction with <MeetingPoint Code>. 

PickUpAccommodation , PickUpAirport, PickUpStation, PicUpPort, PickUpOther

See below for details.


PickUpAccomodation sub-elements

Parameter

Description

PickUpFrom

Mandatory. Specifies the pick up details of the transfer item.  See below

 

Attribute

Description

Hotel, Apartment, Address or Meeting point

Code

Mandatory. Specifies the GTA code.  If address is specified please see below for further details.

PickUpTime

Mandatory. Specifies the time at which the passengers will be picked up. Format of hh.mm


PickUpAddress sub-elements

Parameter

Description

AddressLine1

Mandatory. Specifies the pick up address where the passenger will be picked up from.

AddressLine2

Optional.

 

Attribute

Description

City

Code 

Optional. Specifies the City. 

County

Optional. Specifies the County.

PostCode

Mandatory. Specifies the post code of the address where the passenger will be picked up from.

Telephone

Optional. Specifies the telephone number.


PickUpAirport sub-elements

Parameter

Description

ArrivingFrom

Mandatory. Specifies the pick up details of transfer item. See below

 

Attribute

Description

Airport

Code

Mandatory. Specify the GTA airport code the passenger is arriving from.

FlightNumber

Mandatory. Specifies the flight number the passenger is travelling in.

EstimateArrival

Mandatory. Specifies the time at which the flight the passenger is travelling on is estimate to arrive. Format of hh.mm

PickUpStation Sub-elements

Parameter

Description

 

Attribute

Description

Station

Code 

Mandatory. Specify the GTA station code the passenger will be picked up from. 

ArrivingFrom 

Specifies the pick up details of transfer item. See below 

 

Attribute

Description

City

Code

Mandatory. Specify the GTA city code the passenger is arriving from.

TrainName

Mandatory. Specifies the name of the train the  passenger is traveling on.

EstimateArrival

Mandatory. Specifies the time at which the train the passenger is travelling on is estimate to arrive. Format of hh.mm


PickUpPort Sub-elements

Parameter

Description

ArrivingFrom

Mandatory. Specifies the GTA city code where the passenger is arriving from.

ShipName

Mandatory. Specifies the name of the ship the passenger is traveling on.

ShippingCompany

Mandatory. Specifies the name of shipping company the passenger is traveling with.

EstimateArrival

Mandatory. Specifies the time at which the ship the passenger is travelling on is estimate to arrive. Format of hh.mm


PickUpOther Sub-elements

Parameter

Description

PickUpFrom 

Mandatory. Specifies the pick up details of the transfer item.   

 

Attribute

Description

Hotel, Apartment, Address or Meeting point

Code 

Mandatory. Specifies the GTA code. If address is specified please see below for further details 

PickUpTime 

Mandatory. Specifies the time at which the passenger will be  picked up. Format of hh.mm


PickUpAddress Sub-elements

Parameter

Description

AddressLine1

Mandatory. Specifies the pick up address where the passenger will be picked up from.

AddressLine2

Optional.

 

Attribute

Description

City

Code 

Optional. Specifies the City. 

County

Optional. Specifies the County.

PostCode

Mandatory. Specifies the post code of the address where the passenger will be picked up from.

Telephone

Optional. Specifies the telephone number.


DropOff Details

Parameter

Description

DropOffDetails

Mandatory. Specifies the drop off details of transfer item.

 

Attribute

Description

City

Code 

Mandatory if this is different to the ItemCity Code.  Specifies the GTA city code. 

DropOffAccommodation , DropOffAirport, DropOffStation, DropOffPort, DropOffOther

Mandatory. See below for details.


DropOffAccommodation  Sub-elements

Parameter

Description

DropOffTo

Mandatory. Specifies the drop off details of the transfer item.  See below

 

Attribute

Description

Hotel, Apartment, Address or Meeting point

Code

Mandatory. Specifies the GTA code.  If address is specify please see below for further details.


DropOffAddress Sub-elements

Parameter

Description

AddressLine1

Mandatory. Specifies the drop off address where the passenger will be dropped off to.

AddressLine2

Optional.

 

Attribute

Description

City

Code 

Optional. Specifies the City. 

County

Optional. Specifies the County.

PostCode

Mandatory. Specifies the post code of the address where the passenger will be dropped off to.

Telephone

Optional. Specifies the telephone number.

DropOffAirport Sub-elements

Parameter

Description

DepartingTo

Mandatory. Specifies the drop off  details of the  transfer item. See below

 

Attribute

Description

Airport

Code

Mandatory. Specify the GTA airport code the passenger is departing to.

FlightNumber

Mandatory. Specifies the flight number the passenger is traveling on. 

DepartureTime

Mandatory. Specifies the time at which the flight the passenger is travelling on is departing. Format of hh.mm

 

Attribute

Description

 

NextDay

Optional. If set to true the flight departure falls on the day after the pick up date.


DropOffStation Sub-elements

Parameter

Description

 

Attribute

Description

Station

Code 

Mandatory. Specify the GTA station code the passenger will be dropped off to. 

DepartingTo 

Mandatory. Specifies the drop off details of  the transfer item. See below 

 

Attribute

Description

City

Code

Mandatory. Specify the GTA city code the passenger is departing to.

TrainName

Mandatory. Specifies the name of the train the  passenger is traveling on.

DepartureTime

Mandatory. Specifies the time at which the train the passenger is travelling on is departing. Format of hh.mm


DropOffPort Sub-elements

Parameter

Description

Departing to

Mandatory. Specifies the GTA city code where the passenger is departing to.

ShipName

Mandatory. Specifies the name of the ship the passenger is travelling on.

ShippingCompany

Mandatory. Specifies the name of shipping company the passenger is travelling with.

DepartureTime

Mandatory. Specifies the time at which the ship the passenger is travelling on is departing. Format of hh.mm


DropOffOther Sub-elements

Parameter

Description

DropOffTo 

Mandatory. Specifies the drop off details of the transfer item.   

 

Attribute

Description

Hotel, Apartment, Address or Meeting point

Code 

Mandatory. Specifies the GTA code. If address is specify please see below for further details 


DropOffAddress Sub-elements

Parameter

Description

AddressLine1

Mandatory. Specifies the drop off address where the passenger will be dropped off to.

AddressLine2

Optional.

 

Attribute

Description

City

Code 

Optional. Specifies the City. 

County

Optional. Specifies the County.

PostCode

Mandatory. Specifies the post code of the address where the passenger will be dropped off to.

Telephone

Optional. Specifies the telephone number.


TransferVehicle

Parameter

Description

TransferVehicle 

Attribute 

Description 

 

Code

Mandatory. Specifies the GTA vehicle code

 

MaximumPassengers

Mandatory. Specifies the maximum number of passengers the vehicle can accommodate.

Passengers

Mandatory. Specifies the number of passengers using the transfer.

LeadPaxId

Mandatory. Specifies the lead Pax Id assigned to the vehicle.


Response

TransferItem sub-element

For a response the API will return the following attributes and sub-elements allowed for a TransferItem sub-element: 

Parameter

Description

PickUpDetails

Specifies the pick up details of transfer item.

DropOffDetails

Specifies the drop off details of transfer item.

TransferDate

Specifies date of transfer item.

TransferVehicle

Specifies the vehicle to be used for the transfer item.

TransferLanguage

Specifies the language in will the transfer will be provided.

SupplierTelephoneNumber

Specifies the telephone number of the supplier providing the transfer which can be contacted in case of emergency on the spot.

TransferConditions

Contains a TransferCondition parameter.

TransferCondition

Returns important conditions which apply to infants and children seats.

PickUpDetails sub-element

The PickUpDetails specifies pick up details of the transfer item. It can consist of one of the following sub-elements: 

Parameter

Description

PickUpDetails

See below for details.

DropOffDetails

See below for details.

TransferDate

Specifies the data of the transfer

TransferLanguage

Specifies  the code for the language required. 

Transfer Vehicle

See below for details

PickUpDetails

Parameter

Description

PickUpDetails

Specifies the pick up details of transfer item.

 

Attribute

Description

City

Code 

Specifies the unique GTA city code where the passenger will be picked up from. 

PickUpAccommodation, PickUpAirport, PickUpStation, PicUpPort, PickUpOther

See below for details.


PickUpAccommodation  Sub-elements

Parameter

Description

PickUpFrom

Specifies the pick up details of the transfer item.  See below

 

Attribute

Description

Hotel, Apartment, Address or Meeting point

Code

Specifies the unique GTA hotel/apartment code.  If address was specified on the request,  please see below for details.

PickUpTime

Specifies the time at which the passengers will be picked up.


PickUpAddress Sub-elements

Parameter

Description

AddressLine1

Specifies the pick up address where the passenger will be picked up from.

AddressLine2

Same as above.

City

If specified we will return the City.

County

If specified we will return the County.

PostCode

Specifies the post code of the address where the passenger will be picked up from.

Telephone

If specified we will return the telephone number.


PickUpAirport Sub-elements

Parameter

Description

ArrivingFrom

Specifies the pick up details of transfer item. See below

 

Attribute

Description

City

Code 

It will only be returned if the city code is different to the airport code. Specifies the GTA unique city code.

Airport

Code

Specifies the airport code the passenger is arriving from.

FlightNumber

Specifies the flight number the passenger is traveling in.

EstimateArrival

Specifies the time at which the flight the passenger is travelling on is estimate to arrive.


PickUpStation Sub-elements

Parameter

Description

 

Attribute

Description

Station

Code 

Specifies the GTA station code the passenger will be picked up from. 

ArrivingFrom 

Specifies the pick up details of transfer item. See below 

 

Attribute

Description

City

Code

Specify the GTA city code the passenger is arriving from.

TrainName

Specifies the name of the train the  passenger is traveling on.

EstimateArrival

Specifies the time at which the train the passenger is travelling on is estimate to arrive.


PickUpPort Sub-elements

Parameter

Description

ArrivingFrom

Specifies the GTA city code where the passenger is arriving from.

ShipName

Specifies the name of the ship the passenger is traveling on.

ShippingCompany

Specifies the name of shipping company the passenger is traveling with.

EstimateArrival

Specifies the time at which the ship the passenger is travelling on is estimate to arrive.


PickUpOther Sub-elements

Parameter

Description

PickUpFrom 

Specifies the pick up details of the transfer item.   

 

Attribute

Description

Hotel, Apartment, Address or Meeting point

Code 

Specifies the GTA code. If address is specify please see below for further details 

PickUpTime 

Specifies the time at which the passenger will be  picked up.  


PickUpAddress Sub-elements

Parameter

Description

AddressLine1

Specifies the pick up address where the passenger will be picked up from.

AddressLine2

Same as above.

City

If specified we will return the City.

County

If specified we will return the County.

PostCode

Specifies the post code of the address where the passenger will be picked up from.

Telephone

If specified we will return the telephone number.


DropOff Details

Parameter

Description

DropOffDetails

Specifies the drop off details of transfer item.

 

Attribute

Description

City

Code 

Specifies the GTA city code where the passenger will be dropped off.  

DropOffAccommodation, DropOffAirport, DropOffStation, DropOffPort, DropOffOther

See below for details.


DropOffAccommodation  Sub-elements

Parameter

Description

DropOffTo

Specifies the drop off details of the transfer item.  See below

 

Attribute

Description

Hotel, Apartment, Address or Meeting point

Code

Specifies the GTA code.  If address is specified please see below for further details.


DropOffAddress Sub-elements

Parameter

Description

AddressLine1

Specifies the pick up address where the passenger will be picked up from.

AddressLine2

Same as above.

City

If specified we will return the City.

County

If specified we will return the County.

PostCode

Specifies the post code of the address where the passenger will be picked up from.

Telephone

If specified we will return the telephone number.


DropOffAirport Sub-elements

Parameter

Description

DepartingTo

Specifies the drop off details of the  transfer item. See below

 

Attribute

Description

City

Code 

It will only be returned if the city code is different to the airport code. Specifies the GTA unique city code. 

Airport

Code

Specifes the GTA airport code the passenger is departing to.

FlightNumber

Specifies the flight number the passenger is traveling on. 

DepartureTime

Specifies the time at which the flight the passenger is travelling on is departing.


DropOffStation Sub-elements

Parameter

Description

 

Attribute

Description

Station

Code 

Specifies the GTA station code the passenger will be dropped off to. 

DepartingTo 

Specifies the drop off details of  the transfer item. See below 

 

Attribute

Description

City

Code

Specify the GTA city code the passenger is departing to.

TrainName

Specifies the name of the train the  passenger is traveling on.

DepartureTime

Specifies the time at which the train the passenger is travelling on is departing.


DropOffPort Sub-elements

Parameter

Description

Departing to

Specifies the GTA city code where the passenger is departing to.

ShipName

Specifies the name of the ship the passenger is travelling on.

ShippingCompany

Specifies the name of shipping company the passenger is travelling with.

DepartureTime

Specifies the time at which the ship the passenger is travelling on is departing. Format of


DropOffOther Sub-elements

Parameter

Description

DropOffTo 

Specifies the drop off details of the transfer item.   

 

Attribute

Description

Hotel, Apartment, Address or Meeting point

Code 

Specifies the GTA code. If address is specify please see below for further details 


DropOffAddress Sub-elements

Parameter

Description

AddressLine1

Specifies the drop off address where the passenger will be dropped off to.

AddressLine2

Same as above.

City

If specified we will return the City.

County

If specified we will return the County.

PostCode

Specifies the post code of the address where the passenger will be dropped off to .

Telephone

If specified we will return the telephone number.


TransferVehicle

Parameter

Description

TransferVehicle 

Attribute 

Description 

 

Code

Specifies the GTA vehicle code

 

MaximumPassengers

Specifies the maximum number of passengers the vehicle can accommodate.

 

MaximumLuggage

Specifies the maximum number of luggages allowed in the vehicle.

Passengers

Specifies the number of passengers using the transfer.

LeadPaxId

Specifies the lead Pax Id assigned to the vehicle.

LanguageCode

Specifies  the code for the language required.


Charge Conditions parameters

The response will include the charge conditions.

Please refer to the Search Charge Conditions document for the details of these parameters.

Docs Navigation