What is it?
The Hotel Reservation Utilities provide supplimental information that can be included when creating, updating or deleting a reservations on the SynXis Platform.
Why use it?
The Reservation Utilities allow a Custom Booking Engine, Call Center Application, Property Management System or other application to manage reservations for a hotel in the SynXis Enterprise Platform.
How it works
Use this set of APIs in conjunction with the Reservation APIs.
How to use
Retrieve Booking Preferences
[GET] /reservation/lists/bookingPreferences
- Gets a list of booking preferences to use when creating or modifying a group so that the system can track how the group was booked.
{
"BookingMethodList": [
{
"code": "IBIZ",
"name": "International business travel",
"level": "Hotel"
}
]
}
Retrieve Reservation Reasons
[GET] /reservation/lists/reservationReasons
- Gets Cancel Reasons, Rate Override Reasons, Room Upgrade Reasons and Tax Exemption Reasons in a single response instead of calling the individual operations.
{
"cancelreasons": {
"cancelReasons": [
{
"code": "FAM",
"description": "Family Issues",
"hotel": {
"id": 13098,
"code": "CHANCON2",
"name": "SynXis Test Hotel"
}
}
]
},
"rateoverridereasons": {
"rateoverridereasons": [
{
"code": "MGR",
"description": "Manager Approval",
"isdefault": false
}
]
},
"roomupgradereasons": {
"roomupgradereasons": [
{
"code": "VIP",
"description": "VIP Guest",
"isdefault": false
}
]
},
"taxexemptionreasons": {
"taxexemptreasons": [
{
"exemptReasonType": "FederalTaxExempt",
"code": "FEDERAL",
"description": "Federal Exemption",
"sortOrder": 1
}
]
}
}
Retrieve Cancel Reasons
[GET] /reservation/lists/cancelReasons
- Gets a list of standardized reasons why a customer may cancel a reservation.
{
"cancelReasons": [
{
"code": "FAM",
"description": "Family Issues",
"hotel": {
"id": 13098,
"code": "CHANCON2",
"name": "SynXis Test Hotel"
},
"level": "Hotel",
"type": "Property"
}
]
}
Retrieve Room Upgrade Reasons
[GET] /reservation/lists/roomUpgradeReasons
- Gets a list of standardized reasons why a customer is provided with a room upgrade.
{
"roomupgradereasons": [
{
"code": "VIP",
"description": "VIP Guest",
"isdefault": false
}
]
}
Retrieve Rate Override Reasons
[GET] /reservation/lists/rateOverrideReasons
- Gets a list of standardized reasons why a rate was overridden by an agent.
{
"rateoverridereasons": [
{
"code": "MGR",
"description": "Manager Approval",
"isdefault": false
}
]
}
Retrieve Tax Exemption Reasons
[GET] /reservation/lists/taxExemptionReasons
- Gets a list of standardized tax exemption reasons.
{
"taxexemptreasons": [
{
"exemptReasonType": "MilitaryEmployeeTaxExempt",
"code": "MILITARY",
"description": "Military Staff Exemption",
"sortOrder": 0
},
{
"exemptReasonType": "FederalTaxExempt",
"code": "FEDERAL",
"description": "Federal Exemption",
"sortOrder": 1
}
]
}
Retrieve Market Sources
[GET] /reservation/lists/taxExemptionReasons
- Gets a list of Market Sources for a hotel which are based on the content management strategy defined by the primary chain.
{
"marketSources": [
{
"code": "Meta",
"level": "Brand",
"name": "META search engines",
"isdefault": false
}
]
}
Retrieve Market Segments
[GET] /reservation/lists/taxExemptionReasons
- Gets a list of Market Segments which are used to track geographic, demographic, or other customer classification targeted by a hotel or chain for purchase and use of products and services (e.g. a hotel can determine its use of advertising dollars based on the nature of travelers staying in hotel).
{
"marketSegments": [
{
"code": "MS1",
"businessCode": "BS1",
"leisureCode": "LS1",
"level": "Hotel",
"name": "Local Promotion",
"isdefault": false
}
]
}