Sign in
RatePlan

Replace a rate plan

Use this call to modify a rate plan.<br>You must have this scope: 'setup.manage'.

put/rateplan/v1/rate-plans/{id}

Path parameters

idstring required

The id of the rate plan.

Request body

nameobject required

The name for the rate plan

descriptionobject required

The description for the rate plan

minGuaranteeType'PM6Hold' | 'CreditCard' | 'Prepayment' | 'Company' required

The minimum guarantee to be provided when this rate plan is booked so the reservation will be guaranteed to the guest

priceCalculationMode'Truncate' | 'Round' nullable

The calculation mode is used when calculating the adults' surcharges and derived rates. Defaults to Truncate. Example: for a rate of 125.99 and a surcharge of +10%, when Truncate is selected, the result would be 125.99 + 12 = 137.99 When Round is selected, the result would be 125.99 + 12.60 = 138.59

channelCodesstring[] required

The channel codes the rate plan is sold through

promoCodesstring[] nullable

The rate codes for promotional and hidden rates. If at least one code is set the rate will be not publicly visible anymore and only be offered when one of the promo codes is given in the offer request. For backward compatibility it is still not possible to set multiple promo codes.

isSubjectToCityTaxboolean nullable

Whether the rate plan is subject to city tax or not. Default value is true

cancellationPolicyIdstring required

The id of the cancellation policy valid for this rate plan

noShowPolicyIdstring nullable

The id of the no-show policy valid for this rate plan

marketSegmentIdstring nullable

The id of the market segment for this rate plan

Example request

{
  "name": {
    "de": "Nicht Stornierbar",
    "en": "Non Refundable"
  },
  "description": {
    "de": "Nicht Stornierbar",
    "en": "Non Refundable"
  },
  "minGuaranteeType": "PM6Hold",
  "priceCalculationMode": "Truncate",
  "channelCodes": [
    "Direct",
    "BookingCom",
    "Ibe"
  ],
  "cancellationPolicyId": "MUC-NONREF",
  "bookingPeriods": [
    {
      "from": "2026-08-27T11:46:04.6206305+02:00",
      "to": "2026-09-10T11:46:04.6206305+02:00"
    },
    {
      "from": "2026-09-13T11:46:04.6206305+02:00",
      "to": "2026-11-02T11:46:04.6206305+02:00"
    }
  ],
  "restrictions": {
    "minAdvance": {
      "hours": 12,
      "days": 180
    },
    "maxAdvance": {
      "months": 24
    }
  },
  "includedServices": [
    {
      "serviceId": "MUC-BRKF",
      "grossPrice": {
        "amount": 10,
        "currency": "EUR"
      }
    },
    {
      "serviceId": "MUC-WLAN",
      "grossPrice": {
        "amount": 5,
        "currency": "EUR"
      }
    }
  ],
  "companies": [
    {
      "id": "MUC-APA",
      "corporateCode": "APA-DBL"
    }
  ],
  "pricingRule": {
    "baseRatePlanId": "MUC-NONREF-SGL",
    "type": "Absolute",
    "value": 20
  },
  "surcharges": [
    {
      "adults": 2,
      "type": "Percent",
      "value": 10
    }
  ],
  "ageCategories": [
    {
      "id": "MUC-BABY",
      "surcharges": [
        {
          "adults": 1,
          "value": 10
        }
      ]
    },
    {
      "id": "MUC-CHILD",
      "surcharges": [
        {
          "adults": 1,
          "value": 40
        }
      ]
    }
  ],
  "marketSegmentId": "BUSR"
}

Response

Replace of the rate plan was successful.

Changes

No recorded changes to this endpoint across all 2 revisions of this API.