Skip Navigation

Reservation Utilities

Hotel
Reservation
REST API
Hospitality

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