Skip to main content

Update Rates

Mutation Overview​

The updateRatesSetUp mutation allows you to update any property of an already added rate to a hotel in a specific client-seller relation in Inventory. The returned fields include:

  • code
  • name
  • hotelCode
  • active
  • mealPlanIncluded
  • agePolicies
    • maxAgeChildren
    • maxAgeInfants
    • freeInfants
    • freeChildren
  • paymentPolicies
    • currency
    • commission
    • priceIsBinding
    • acceptedPayments
      • type
      • cardTypes
  • bookingRules
    • bookingWindow
      • start
      • end
    • markets
      • included
      • excluded
    • rateRule
    • seniorRule
  • cancelPolicies
    • baseCancelPolicy
      • refundable
      • cancelPenalties
        • daysBeforeArrival
        • penaltyType
        • value
    • cancelPoliciesByDate
      • start
      • end
      • cancelPolicy
        • refundable
        • cancelPenalties
          • daysBeforeArrival
          • penaltyType
          • value
  • surcharges
    • chargeType
    • taxType
    • value
    • applyType
    • perNight
    • perPax

1. Criteria​

When building your mutation, you need to provide the following input fields:

Mandatory Input​

  • clientCode
  • supplierCode
  • hotelCode
  • rates
    • code

Optional Input​

  • contextCode
  • rates
    • name
    • hotelCode
    • active
    • mealPlanIncluded
    • agePolicies
      • maxAgeChildren
      • maxAgeInfants
      • freeInfants
      • freeChildren
    • paymentPolicies
      • currency
      • commission
      • priceIsBinding
      • acceptedPayments
        • type
        • cardTypes
    • bookingRules
      • bookingWindow
        • start
        • end
      • markets
        • included
        • excluded
      • rateRule
      • seniorRule
    • cancelPolicies
      • baseCancelPolicy
        • refundable
        • cancelPenalties
          • daysBeforeArrival
          • penaltyType
          • value
      • cancelPoliciesByDate
        • start
        • end
        • cancelPolicy
          • refundable
          • cancelPenalties
            • daysBeforeArrival
            • penaltyType
            • value
    • surcharges
      • chargeType
      • taxType
      • value
      • applyType
      • perNight
      • perPax

2. Settings​

To update a rate, ensure that all mandatory fields are properly filled out and associate the rate with the correct hotel and seller.

Response Considerations​

The mutation returns the updated rate along with success status and possible advise messages.

RatesSetUpRs (OBJECT)​

  • rates (InventoryRateSetup) - A collection of updated rates.
    • code (String) - The rate code.
    • name (String) - The name of the rate.
    • active (Boolean) - Indicates if the rate is active.
    • mealPlanIncluded (Int) - Indicates if a meal plan is included.
    • paymentPolicies (InventoryPaymentPolicies) - Payment policies associated with the rate.
    • bookingRules (InventoryBookingRules) - Booking rules associated with the rate.
    • cancelPolicies (InventoryCancelPoliciesRate) - Cancellation policies associated with the rate.
    • surcharges (InventorySurcharge) - Surcharges associated with the rate.
    • rooms (InventoryRoomSetUp) - Rooms associated with the rate.
  • success (Boolean) - Indicates if the operation was successful.
  • adviseMessages (AdviseMessage) - Messages related to the operation.

Returned Fields​

RatesSetUpRs (OBJECT)
Represents a rates setup response object.

adviseMessages (AdviseMessage)
List of advise messages. See AdviseMessage.

code  *  (ID)
AM code: The following codes can be returned:

type  *  (String)
Error type: The following types are valid:[type]

description  *  (String)
Error description

level  *  (Enum of AdviseMessageLevel)
Indicates the level of importance of the message. Possible values: ERROR, WARN, INFO.
Possible values:
WARN
ERROR
INFO

external (ExternalMessage)
Specify the external message.

code (String)
External code.

message  *  (String)
External message.

correlationID  *  (ID)
Identifier to investigate the cause of the error.

success  *  (Boolean)
Indicates whether the operation was successful.

ratesCreated (InventoryRateSetup)
List of created rates. See RateSetup.

code (String)
Code associated with the rate.

name (String)
Name of the rate.

active  *  (Boolean)
Indicates whether the rate is active.

mealPlanIncluded  *  (Int)
Indicates if the meal plan included in the rate.

baseCode (String)
Base rate code associated with the rate.

agePolicies (InventoryAgePolicies)
Age policies associated with the rate.

maxAgeInfants  *  (Int)
Max age baby not inclusive

freeInfants  *  (Boolean)
If true the babies are free of charge

maxAgeChildren  *  (Int)
Max age child not inclusive

freeChildren  *  (Boolean)
If true children are free of charge

paymentPolicies (InventoryPaymentPolicies)
Payment policies associated with the rate.

currency  *  (Currency)
Currency of the rate

commission  *  (Float)
Commission applied for all rooms in this rate, leave value 0 for net price. Only Informative.

priceIsBinding  *  (Boolean)
Indicates whether the prices are binding prices, meaning they cannot be sold for a lower price. This information is for informative purposes only.

acceptedPayments (AcceptedPayment)
Accepted payment methods for the rate. If not informed, it defaults to MerchantPay.

type  *  (Enum of PaymentType)

Possible values:
MERCHANT
DIRECT
CARD_BOOKING
CARD_CHECK_IN

cardTypes  *  (Enum of PaymentCardType)

Possible values:
VI
AX
BC
CA
CB
CU
DS
DC
T
R
N
L
E
JC
TO
S
EC
EU
TP
OP
ER
XS
O

bookingRules (InventoryBookingRules)
Booking rules associated with the rate.

bookingWindow (InventoryBookingWindow)
Booking Dates for which the rate will be available. Do not send it if you want the rate available for all dates.

start  *  (DateTime)
Start date of the booking window.

end  *  (DateTime)
End date of the booking window.

markets (InventoryMarkets)
Markets included or excluded. Do not send if the rate is available for all markets. Only informative.

included (String)
Included markets.

excluded (String)
Excluded markets.

rateRule (Enum of RatePlanType)
"NoRatePlanType" indicates absence of a specific rate plan. "LargeFamily" and "PublicServant" denote rates tailored for those groups. "Negotiated" and "Package" signify negotiated rates and package deals, respectively. "CanaryResident" and "BalearicResident" are special rates for residents of the Canary Islands and the Balearic Islands, respectively. Lastly, "HoneyMoon" designates rates intended for honeymooners or couples celebrating their honeymoon.
Possible values:
NO_RATE_PLAN_TYPE
LARGE_FAMILY
PUBLIC_SERVANT
NEGOTIATED
PACKAGE
CANARY_RESIDENT
BALEARIC_RESIDENT
HONEY_MOON

seniorRule (Enum of SeniorRate)
"NoSeniorRate" indicates the absence of a senior rate. "SeniorRate_55", "SeniorRate_60", and "SeniorRate_65" denote rates applicable to individuals aged 55, 60, and 65, respectively. These rates are typically offered to seniors as a special discount or incentive.
Possible values:
NO_SENIOR_RATE
SENIOR_RATE_55
SENIOR_RATE_60
SENIOR_RATE_65

cancelPolicies (InventoryCancelPoliciesRate)
Cancel policies associated with the rate.

baseCancelPolicy (InventoryCancelPolicy)
Defines the base cancel policies. Only Informative.

refundable  *  (Boolean)
Indicates if the rate is refundable.

cancelPenalties (InventoryCancelPenalty)
List of penalties applicable for the rate. See CancelPenalty.

daysBeforeArrival  *  (Int)
Number of days prior to arrival day in which this Cancellation policy applies.

penaltyType  *  (Enum of PenaltyType)
Penalty type. See PenaltyType.
Possible values:
AMOUNT
NIGHTS
PERCENTAGE

value  *  (Float)
Penalty value.

cancelPoliciesByDate (InventoryCancelPolicyByDate)
This defines a calendar of cancel policies, serving as informational data. If base cancel policies exist for a particular day, the CancelPoliciesByDate take precedence.

start  *  (DateTime)
Start date where the cancel policy must apply.

end  *  (DateTime)
End date where the cancel policy must apply.

cancelPolicy  *  (undefined)
Cancel policy. See CancelPolicy.

surcharges (InventorySurcharge)
Surcharges associated with the rate.

chargeType  *  (Enum of InventoryChargeType)
Indicates if the surcharge is included or not in the price.
Possible values:
INCLUDED
EXCLUDED

taxType  *  (Enum of InventoryTaxType)
The type of tax applied to the surcharge.
Possible values:
CITY
LOCAL
RESORT_FEE
SUPPLEMENT_TO_BE_PAID_ON_SPOT

value  *  (Float)
The value of the surcharge.

applyType  *  (Enum of InventoryApplyType)
The type of application for the surcharge.
Possible values:
PERCENTAGE
AMOUNT

perNight  *  (Boolean)
Indicates whether the surcharge is applied per night.

perPax  *  (Boolean)
Indicates whether the surcharge is applied per person.

rooms (InventoryRoomSetUp)
Rooms associated with the rate.

code (String)
Code associated with the room.

master (InventoryMasterRoom)
Master of the room.

id  *  (Int)
Id associated with the room master.

code (String)
Code associated with the room.

name (String)
Name associated with the room.

active  *  (Boolean)
Indicates whether the room is active.

externalCode (String)
External code associated with the room.

standard  *  (Int)
Standard of the room. Typically the number of guests.

uses  *  (InventoryRoomUse)
List of uses associated with the room.

numberOfGuests  *  (Int)
Gets or sets the number of guests allowed in the room.

minAge  *  (Int)
Gets or sets the minimum age allowed for guests in the room.

maxAge  *  (Int)
Gets or sets the maximum age allowed for guests in the room.

paxType  *  (Enum of InventoryPaxType)
Gets or sets the type of guests allowed in the room. PaxType
Possible values:
INFANT
CHILD
ADULT

hotelCode (String)
Hotel code associated with the rate.

ratesDeleted (String)
List of deleted rates.

Examples​

Update properties from a rate​

With the following mutation, we are going to update the meal plan included in a rate and its cancel policies.

note

The possible values for mealPlanIncluded can be retrieved using the query Mealplans.