November 8, 2024

Change Summary

Updates to the mealplan and occupancy nodes in the Search, Quote, Book, GetReservation, and Modify end-points. 

New mealPlanCodes added

To provide greater flexibility in meal plan offerings and reduce distribution challenges, we’ve added a range of new mealPlanCodes. For instance, options like Free Grab & Go Breakfast For 2, previously tied to BI, can now be represented with new, specific codes.

Action Required:

1. Update your API implementation: Ensure your system reads the mealPlanCodes attribute from the mealplanOptions node.
2. System Handling: Update your system to handle these scenarios:
   • Create a new mealplan if a Hotel Trader mealPlanCode doesn't exist in your system (when possible)
   • If you can't create new mealplans, map the Hotel Trader mealPlanCode to the basic option (e.g., map "Free Grab & Go Breakfast For 2" to "Room only")
   • If your system cannot map the mealPlanCode, ignore it

Previous

"mealplanOptions": {
        "breakfastIncluded": true,
        "lunchIncluded": false,
        "dinnerIncluded": false,
        "allInclusive": false,
        "mealplanDescription": "Breakfast Included"
}

New

"mealplanOptions": {
        "mealplanDescription": "Free Breakfast",
        "mealplanCode": "BBF",
        "mealplanName": "Free Breakfast"
}

Read the Mealplans article to get more information on how Hotel Trader handles it.

New field guestAges attribute in the occupancy node

We’ve simplified occupancy management by introducing the guestAges attribute, allowing you to send consolidated guest age details.

Previous

"occupancies": [
            {
                "checkInDate": "2024-12-06",
                "checkOutDate": "2024-12-07",
                "numberOfAdults": 2,
                "numberOfChildren": 1,
                "childrenAges": "5"
            }
        ],

New

"occupancies": [
            {
                "checkInDate": "2024-12-06",
                "checkOutDate": "2024-12-07",
                "guestAges": "30,5"
            }
        ],

End-points impacted

1. Search
2. Quote
3. Book
4. Modify
5. GetReservation