Documentation

Dashboard Menu
Pickup time possibilities Transfers logo icon

How times must be requested

The pickup time logic depends on the direction of the transfer and the type of origin/destination. The only routes not supported are:

-Transfers from same terminal type to same terminal type, like airport (IATA) to airport (IATA)
-Point to Point transfers, like Hotel (Atlas/GPS) to Hotel (Atlas/GPS)

A part of these two limitations, these are the expected results in each situation:

  1. Origin: Airport / Train Station - Destination: Hotel / Port/ Train /airport

    The arrival time of the flight or train must always be provided.
    We DO NOT calculate the pickup time in this case.
    The system will return the same time provided as the arrival time as the pickup time.
  2. Origin: Hotel → Destination: Airport / Train Station

    The pickup time is calculated by us or by the provider (especially for shared services).
    This calculation is based on the departure time of the flight or train.
    The pickup time is NOT the one requested by the client, but the one required to ensure arrival on time
  3. Origin: Hotel → Destination: Port

    The pickup time corresponds to the time requested by the client.
    It is NOT based on the ship’s departure time.
    We DO NOT calculate the pickup time, as cruise boarding typically spans several hours and passengers can choose when to arrive.
  4. Origin: Port → Destination: Hotel / Airport

    The pickup time corresponds to the time requested by the client.
    It is NOT based on the ship’s arrival time.
    We DO NOT calculate the pickup time, as disembarkation may also take several hours and passengers can leave at their convenience.



See full table :


From ATLAS (HB hotel codes)

fromType toType RqTime PickupTime
ATLAS IATA Flight Departure time It will be calculated.
ATLAS TRAIN Train Departure time It will be calculated.
ATLAS PORT Pickup Time It will be desired pick-up time.


From GPS

fromType toType RqTime PickupTime
GPS IATA Flight Departure time It will be calculated.
GPS TRAIN Train Departure time It will be calculated.
GPS PORT Pickup Time It will be desired pick-up time.


From IATA (Airport code)

fromType toType RqTime PickupTime
IATA ATLAS Flight Arrival time It will be the arrival time indicated.
IATA GPS Flight Arrival time It will be the arrival time indicated.
IATA TRAIN Flight Arrival time It will be the arrival time indicated.
IATA PORT Flight Arrival time It will be the arrival time indicated.


From train station

fromType toType RqTime PickupTime
TRAIN ATLAS Train Arrival time It will be the arrival time indicated.
TRAIN GPS Train Arrival time It will be the arrival time indicated.
TRAIN IATA Train Arrival time It will be the arrival time indicated.


From port

fromType toType RqTime PickupTime
PORT ATLAS Vessel Arrival time It will be desired pick-up time.
PORT GPS Vessel Arrival time It will be desired pick-up time.
PORT IATA Vessel Arrival time It will be desired pick-up time.


Returned pickup time options

Usually the pickupTime will be returned in the availability, but in some cases, the time could be null.


For cases pickupTime is null:

  • If “mustCheckPickupTime” is true, you must show the final client the “checkPickup” information, before he confirms, saying they must check the website before x hours of the service date in order to see the confirmed pickup time.

  • Or the pickupTime is null, the “mustCheckPickupTime” is false in the “transferRemarks” it will specify how the time must be checked, could be calling a phone number, or the provider will contact the client hotel in order to confirm the time for.

 

IF(services[x].pickupInformation.time = null) {

 

 

    IF(services[x].pickupInformation.pickup.checkPickup.mustCheckPickupTime = true) {

        Display “The pickup time will be provided in “...pickupInformation.pickup.checkPickup.url @ value” “…pickupInformation.pickup.checkPickup.hoursBeforeConsulting @ value” hours before the departure.

        For example “The pickup time will be provided in https: //checkpickup.com/ 36 hours before the departure.

    }

}


Remember that in case of returning “mustCheckPickupTime = true” the website information must be shown in the voucher, also, the transfer remarks always need to be also shown, before confirmation and must be present in the voucher.