Reservation Utilities | SynXis Developer Portal

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 of API in conjunction with the Reservation Services API.

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
    }
  ]
}
```