Some activities have mandatory questions that need to be answered in order to be able to confirm.
Please note, it’s very important to advise to final customers to always provide an accurate response as if not, operational issues may occur.
-Availability response (RS.activities/modalities/questions).
-Details response (RS.activity/modalities/questions).
-Booking response / booking details (RS.booking/activities/questions).
-Portfolio avail from cache API (RS/ctivities/modalities/questions).
See one example of question array:
"modalities": [{
...
},
"questions": [{
"code": "DIRECCIONHTL",
"text": "Please, advise the address, city and zip code of your hotel.",
"required": true
}, {
"code": "EMAIL",
"text": "Please, provide the email address",
"required": true
}, {
"code": "HOTEL",
"text": "Please advise the name of your hotel",
"required": true
}, {
"code": "NC-CTEL",
"text": "PLEASE ENTER YOUR CONTACT DETAILS (PHONE NUMBER) IN HALF-WIDTH CHARACTERS.",
"required": true
}
],
See confirmation request example with customer question answers:
"activities": [
{
"preferedLanguage": "en",
"serviceLanguage": "en",
"rateKey": "h1tuookogm8j00dqi0uku1rb2d",
"from": "2020-12-22",
"to": "2020-12-22",
"answers": [
{
"question": {
"code": "DIRECCIONHTL"
},
"answer": "Francesc Vidal I Sureda, 23, 07015 Palma, Illes Balears"
},
{
"question": {
"code": "EMAIL"
},
"answer": "test@hotelbeds.com"
},
{
"question": {
"code": "HOTEL"
},
"answer": "Valparaíso Palace and Spa"
},
{
"question": {
"code": "NC-CTEL"
},
"answer": "123456789"
}
]
}
]Note, some questions as the phone numbers and email are automatically taken from the holder fields, so phone number and email questions can be skipped if they are present in the holder, if not the confirmation step will fail.
The best implementation approach is to always display the returned API question with free text field for final customers.
So, for each returned question, display the question.text to final customers with the corresponding free text field, then at confirmation, provide the customer filed response according to the question code.
We are working to standardize all the question codes (have same code for same question instead of multiple for same) in order to map them, but for the moment we don't have an approximate LIVE date, meanwhile please find a list with all the mandatory questions created so far here.
We really recommend advise to final customers to always provide accurate responses and fill all the questions as skipping them, providing incorrect answers or generic/default (for example “to be provided”) can cause operational issues, the suppliers require the question to be present and accurate in order to provide a quality service.