Skip to main content

Manage Product Seasons

Hotel
Utility
REST API
Hospitality
Try Now

What is it?

This set of APIs is used to retrieve, create, update or delete product seasons. Product Seasons are date ranges for pricing that are created at the product level instead of the rate plan level.

Note: Products are a combination of rates and room types. For example, a 'King Non-Smoking Room' Type for the 'Rack' Rate is a product, while the 'Queen Non-Smoking Room' type for the same 'Rack' rate is another product.

Why use it?

Use these operations to manage pricing at the product level across a date range. For example, a 'King Non-Smoking Room' has its price updated for a date range but all other rooms assigned to the same rate are not included in the message.

Note: When using rate seasons, all room types assigned to a rate must have pricing in the message for the same date range.

How to use

Retrieve a list of Product Seasons for a specified hotel

[GET] /admin/hotel/{id}/product/season/

{
  "Item": {
    "Paging": {
      "size": 50,
      "start": 0,
      "total": 146
    },
    "SeasonList": [
      {
        "criteria": {
          "rateCode": "ADV",
          "roomCode": "HCP",
          "startDate": "2020-10-01",
          "endDate": "2020-12-31"
        },
        "name": "Winter_Override",
        "hotel": {
          "id": 13098
        },
        "pricing": {
          "base": {
            "amount": 300,
            "amountSpecified": true,
            "taxesFeesIncluded": true,
            "taxesFeesIncludedSpecified": true,
            "points": 5000,
            "pointsSpecified": true
          },
          "offsets": [
            {
              "dowList": [
                {
                  "dayOfWeek": "M",
                  "price": {
                    "amount": 200,
                    "amountSpeified": 200,
                    "points": 0,
                    "pointsSpecified": 0,
                    "factor": "Amount"
                  }
                }
              ],
              "occupancyList": [
                {
                  "ageQualification": "Adult",
                  "ageRange": "string",
                  "dayOfWeek": "M",
                  "numberOfOccupants": 2,
                  "price": {
                    "amount": 200,
                    "amountSpeified": 200,
                    "points": 0,
                    "pointsSpecified": 0,
                    "factor": "Amount"
                  }
                }
              ],
              "losList": [
                {
                  "start": 10,
                  "end": 30,
                  "price": {
                    "amount": 200,
                    "amountSpeified": 200,
                    "points": 0,
                    "pointsSpecified": 0,
                    "factor": "Amount"
                  }
                }
              ],
              "mealPlanList": [
                {
                  "dayOfWeek": "M",
                  "code": "All Inclusive -AI"
                }
              ]
            }
          ]
        }
      }
    ]
  }
}

Create or Update an existing Product Season

[POST] /admin/hotel/{id}/product/season/


Delete an existing Product Season

[DELETE] /admin/hotel/{id}/product/season/