What’s new ?#

In this section we aim to offer you an overview of the major changes we did recently on our systems.

New – Annoucement#

Decommission date : Sept 30th 2023

Following the migration of Amadeus Discover to Keycloak authentication technology, endpoint POST https://api.amadeus-discover.com/api/authenticate will soon be fully decommissioned.

All users must be migrated to Keycloak-based authentication by September 30th.

Please refer to online documentation dedicated section to implement the Keycloak authentication flow.


New – Opening hours#

Delivery date – 2023 week 24

Describe opening hours for products with a highly flexible model encompassing the two Octo set up “availabilityType” as “OPENING_HOURS or as “START_TIME”.

It is possible to set opening hours for any type of products: restaurants, museums, concerts, shows…

The model allows definition of seasonal openings periods throughout the year, as well as special closure days.

Find all details at : https://docs.amadeus-discover.com/content-partner/guidelines.html#availability-of-the-product


New – Extra informations for bookings#

Delivery date – 2023 week 24

Give more visibility to travellers on cancellation policies to boost bookings

New fields are availabable at product level to describe some additionnal elements:

  • product.handiAccess - Is this product wheelchair accessible?

  • product.modalitiesIncluded - What is included in this product?

  • product.modalitiesExcluded - What is excluded in this product?

  • product.modalitiesAdditionalInfo - Any relevant info for traveller to access and book the activity?

  • product.experienceHighlights - What are the highlights/key selling points for the activity?

Find all details at : https://docs.amadeus-discover.com/content-partner/endpoints_product_management.html#create-a-product


New – Cancellation policy#

Delivery date – 2023 week 24

Give more visibility to travellers on cancellation policies to boost bookings

New fields are availabable at product level to describe cancellation policy:

  • product.isCancellable

  • product.cancellationCutOffAmount

  • product.cancellationCutOffUnit

  • product.cancellationCutOff

Find all details at : https://docs.amadeus-discover.com/content-partner/endpoints_product_management.html#create-a-product

Deprecate product / Un-deprecate product#

Delivery date – 2022 week 46

Two new endpoints : one to deprecate products when they become temporarily unavailable for booking and one to reactivate them when they become available again.

Details

You can now temporarily deprecate products and undeprecate them when they become available again using following endpoints:

It is expected to be used when a product is not available for booking, but should become available again in the future. Products that are definitely removed from the catalogue should be DELETED.

  • When a product is deprecated, it is still returned in Consumer API results, with the mention EXCLUDED and reason DEPRECATED. (contrary to BLACKLISTED and DELETED products that are NOT returned in Consumer API responses). On Discover applications, DEPRECATED products remain visible to Alex users with an alert of availability. Nevertheless, they are NOT visible to Amadeus Discover Traveller Application as they are not bookable.

  • Once un-deprecated, a product becomes visible again in Amadeus Discover Traveller Application, keeping the same Id and thus remains in all suggestions where is was included. The availability alert disappears on Alex side.

  • For both endpoints, input is product external Id


List products / List suppliers#

Delivery date – 2022 week 46

Content Partner API users can use these 2 New endpoints to list their suppliers and products in Discover DB

Details

Content Partners can now use List suppliers and list products endpoints to retrieve all the elements related to the booking engine attached to the user.

  • List suppliers endpoint returns the list of all suppliers attached to user’s Booking Engine.

  • List products endpoint returns the list of all products attached to user’s Booking Engine. It includes active, deprecated and blacklisted products, and the descriptor information is returned in the response.


Booking Engine now autofilled in supplier and product creation#

Delivery date – 2022 week 39

Each Content Partner account is now linked with a Booking Engine. It is no longer needed to input Booking Engine when importing products.


Patch product endpoint#

Delivery date – 2022 week 32

A new PATCH type endpoint allows to update only selected fields of a product

Details

Content Partners now have 2 endpoints available to update products :


Ratings#

Delivery date – 2022 week 32

Two new fields

  • Average rating : value ranging in 0.0 to 5.0

  • Number of reviews

Content Partners can now access these elements when they

  • Create products, (available as input, and in the response)

  • Update products, (available as input, and in the response)

  • Get the list of their products (available in the response)


Products location enhancements#

Delivery date – 2022 week 32

Content Partners can now import additional information about their products : dedicated fields for address, city, country, zip code

Details

Address elements for products

  • Address (existing field) : now used to import street nb and street name, with address complements

  • City name (new field)

  • Zip Code (new field)

  • Country code (new field), using iso alpha2

Content Partners can now access these elements when they

  • create products, (available as input, and in the response)

  • update products, (available as input, and in the response)

  • get the list of their products (available in the response)