Skip to main content

Reservation Utilities

Hotel
Reservation
REST API
Hospitality
Try Now

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