GetYourGuide

Features

• Availabilities
• Holds
• Bookings

Data Mappings

GetYourGuide stores its catalog on their extranet/supplier portal.

Supported travelerType ageBands / modifiers:

• ADULT
• CHILD
• EU_CITIZEN
• GROUP
• INFANT
• MILITARY
• SENIOR
• STUDENT
• YOUTH

Availabilities Filtering Option

GetYourGuide checks for Availabilities by date and time. This can also be used to filter Rates when mapped by Product ID.

Binding by Rate ID

If a GetYourGuide ProductOption is bound directly to a Redeam RateID, no further considerations must be made on the Rate object. The same Redeam Rate will be used for every GetYourGuide booking made against this ProductOption, and the first Price on the Rate matching the GetYourGuide TravelerType/AgeBand will be used (we recommend only having one of each ageBand or modifier to avoid this ambiguity).

Binding by Product ID

If binding a GetYourGuide ProductOption to a Redeam ProductID (OTA-ProductID), the following considerations must be made on the Rate (in addition to the Rate Price considerations, above):

OpenHour Objects Must Have Times

GetYourGuide requires that all OpenHour objects represented by Hours have one or more OpenCloseTime objects assigned to their Times properties.

{

    "rate": {

        "id": "1eb334a6-c6af-11ea-86df-afc257075bb2",

        "hours": [

            {

                "times": [

                    {

                        "open": "08:00",

                        "close": "09:45"

                    },

                    {

                        "open": "9:00",

                        "close": "10:45"

                    },

                    {

                        "open": "10:00",

                        "close": "11:45"

                    }

                ]

            }

        ]

    }

}

Additionally, all Availabilities for Rates bound to the GetYourGuide channel must have 'start' times aligned with the Rate's Open time. An example of an Availability matching an Open time on a Rate can be found below. The booking logic performed by the GetYourGuide Channel Gateway is dependent on this uniqueness to ensure the proper Rate is chosen for every booking.

curl --get ${base_url}/suppliers/${supplier_id}/product/${product_id}/availability \

    --data rate_id=1eb334a6-c6af-11ea-86df-afc257075bb2 \

    --data at=2020-07-15T09:00:00Z \

    --data qty=1

{

    "availability": {

        "capacity": 100,

        "id": "e0295be6-c6b0-11ea-b36d-77b25c4776d0",

        "maxCapacity": -1,

        "start": "2020-07-15T09:00:00Z",

        "end": "2020-07-15T10:45:00Z"

    },

    "bookable": true

}

Concurrent Rates Not Supported

For a Product to be compatible with GetYourGuide, there must be no more than one Rate valid or available at any point in time. GetYourGuide searches for Rates by Product, date, and time; successful searches are expected to contain exactly one Rate object in their responses:

Multiple Rates can be applied to the same Product on the same day, they just cannot be applied concurrently.

Consider a Product that introduces a Rate change between the afternoon and evening offerings for example - while it may be tempting to create the Rates so that they start and end at midnight (especially if they are specified without times), this will cause any GetYourGuide queries requesting the Rate during the overlap period to fail:

This problem can be rectified by transitioning from one Rate during the middle of the day and eliminating any overlap: