Delete Derived Rates

Mutation Overview

The deleteDerivedRatesSetup mutation removes derived rates from a hotel in a client-seller relation in Inventory. The returned fields include:

• ratesDeleted
• success
• adviseMessages

1. Criteria

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

Mandatory Input

• clientCode
• supplierCode
• hotelCode
• derivedRateCodes

Optional Input

• contextCode

2. Settings

Ensure that the provided derived rate codes correspond to existing derived rates in your inventory setup.

Response Considerations

The mutation returns the collection of deleted derived rate codes along with success status and potential advise messages regarding the operation.

DerivedRatesSetupRs (OBJECT)

• ratesDeleted (String) - A collection of deleted derived rate codes.
• success (Boolean) - Indicates if the operation was successful.
• adviseMessages (AdviseMessage) - Messages related to the operation.

Mutation Inputs

InventoryDerivedRateSetupDeleteInput (INPUT_OBJECT)
Derived rates setup delete input data

clientCode  *  (String)

Client code.

supplierCode  *  (String)

Travelgate Supplier/Channel code.

derivedRateCodes  *  (String)

Derived rates codes to delete.

hotelCode  *  (String)

Code associated with the hotel.

contextCode(String)

Context code.

Returned Fields

DerivedRatesSetupRs (OBJECT)
Represents the response object for derived rates setup operations.

adviseMessages(AdviseMessage)

Collection of advise messages.

code  *  (ID)

AM code: The following codes can be returned:

description  *  (String)

Error description

level  *  (AdviseMessageLevel)

Indicates the level of importance of the message. Possible values: ERROR, WARN, INFO. Possible values:

• WARN: Warning message.
• ERROR: Error message.
• INFO: Info message.

external(ExternalMessage)

Specify the external message.

code(String)

External code.

message  *  (String)

External message.

correlationID  *  (ID)

Identifier to investigate the cause of the error.

ratesCreated(DerivedRateSetup)

Collection of created derived rate setup objects.

code(String)

Code associated with the derived rate.

name(String)

Name of the derived rate.

active  *  (Boolean)

Indicates whether the derived rate is active.

mealPlanIncluded(InventoryDerivedInt)

Indicates the meal plan included in the derived rate.

value(Int)

The derived value.

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

baseCode(String)

Base rate code associated with the derived rate.

inheritedAgePolicies(InventoryAgePolicies)

Age policies inherited from the base rate. Age policies are always inherited from the base 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(InventoryDerivedPaymentPolicies)

Payment policies associated with the derived rate.

inheritedCurrency  *  (Currency)

Currency inherited from the base rate.

inheritedCommission  *  (Float)

Commission inherited from the base rate.

inheritedPriceIsBinding  *  (Boolean)

Indicates whether the inherited prices are binding.

acceptedPayments(InventoryDerivedAcceptedPayments)

Accepted payment methods with inheritance metadata.

value(AcceptedPayment)

The derived value.

type  *  (PaymentType)

Possible values:

• MERCHANT: Payment is managed by the supplier.
• DIRECT: Payment is made directly to the actual payee (e.g., the hotel), without involving an intermediary or third party. The payment will be completed at check-in.
• CARD_BOOKING: Payment is managed by the supplier. The payment is effectuated at the time of booking.
• CARD_CHECK_IN: Payment is managed by the supplier and is made at the hotel during check-in.

cardTypes(PaymentCardType)

Possible values:

• VI: Visa
• AX: American Express
• BC: BC Card
• CA: MasterCard
• CB: Carte Blanche
• CU: China Union Pay
• DS: Discover
• DC: Diners Club
• T: Carta Si
• R: Carte Bleue
• N: Dankort
• L: Delta
• E: Electron
• JC: Japan Credit Bureau
• TO: Maestro
• S: Switch
• EC: Electronic Cash
• EU: EuroCard
• TP: universal air travel card
• OP: optima
• ER: Air Canada/RnRoute
• XS: access
• O: others

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

bookingRules(InventoryDerivedBookingRules)

Booking rules associated with the derived rate.

bookingWindow(InventoryDerivedBookingWindow)

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

value(InventoryBookingWindow)

The derived value.

start  *  (DateTime)

Start date of the booking window.

end  *  (DateTime)

End date of the booking window.

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

markets(InventoryDerivedMarkets)

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

value(InventoryMarkets)

The derived value.

included(String)

Included markets.

excluded(String)

Excluded markets.

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

rateRule(InventoryDerivedRateRule)

Rate rule for the derived rate.

value(RatePlanType)

The derived value. Possible values:

• NO_RATE_PLAN_TYPE
• LARGE_FAMILY
• PUBLIC_SERVANT
• NEGOTIATED
• PACKAGE
• CANARY_RESIDENT
• BALEARIC_RESIDENT
• HONEY_MOON

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

seniorRule(InventoryDerivedSeniorRule)

Senior rule for the derived rate.

value(SeniorRate)

The derived value. Possible values:

• NO_SENIOR_RATE
• SENIOR_RATE_55
• SENIOR_RATE_60
• SENIOR_RATE_65

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

cancelPolicies(InventoryDerivedCancelPoliciesRate)

Cancel policies associated with the derived rate.

value(InventoryCancelPoliciesRate)

The derived value.

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  *  (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  *  (InventoryCancelPolicy)

Cancel policy. See CancelPolicy.

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  *  (PenaltyType)

Penalty type. See PenaltyType. Possible values:

• AMOUNT
• NIGHTS
• PERCENTAGE

value  *  (Float)

Penalty value.

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

inheritedSurcharges(InventorySurcharge)

Surcharges inherited from the base rate.

chargeType  *  (InventoryChargeType)

Indicates if the surcharge is included or not in the price. Possible values:

• INCLUDED
• EXCLUDED

taxType  *  (InventoryTaxType)

The type of tax applied to the surcharge. Possible values:

• CITY: The tax is a city tax.
• LOCAL: The tax is a local tax.
• RESORT_FEE: The tax is a resort fee.
• SUPPLEMENT_TO_BE_PAID_ON_SPOT: The tax is a supplement to be paid on spot.

value  *  (Float)

The value of the surcharge.

applyType  *  (InventoryApplyType)

The type of application for the surcharge. Possible values:

• PERCENTAGE: The rate is applied as a percentage.
• AMOUNT: The rate is applied as an amount.

perNight  *  (Boolean)

Indicates whether the surcharge is applied per night.

perPax  *  (Boolean)

Indicates whether the surcharge is applied per person.

inheritAllRoomsBaseRate  *  (Boolean)

Indicates whether all rooms are inherited from the base rate for the derived rate. If true, all rooms from the base rate are inherited. If false, only specific rooms are associated with the derived rate.

rooms(InventoryRoomSetUp)

Rooms associated with the derived 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  *  (InventoryPaxType)

Gets or sets the type of guests allowed in the room. PaxType Possible values:

• INFANT: Represents an infant guest.
• CHILD: Represents a child guest.
• ADULT: Represents an adult guest.

informBaseRate  *  (Boolean)

Indicates if the base rate code has to be sent to the supplier instead of the derived rate code.

inheritMealPlanSupplements  *  (Boolean)

Indicates whether to inherit meal plan supplements from the base rate.

ratesUpdated(DerivedRateSetup)

Collection of updated derived rate setup objects.

code(String)

Code associated with the derived rate.

name(String)

Name of the derived rate.

active  *  (Boolean)

Indicates whether the derived rate is active.

mealPlanIncluded(InventoryDerivedInt)

Indicates the meal plan included in the derived rate.

value(Int)

The derived value.

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

baseCode(String)

Base rate code associated with the derived rate.

inheritedAgePolicies(InventoryAgePolicies)

Age policies inherited from the base rate. Age policies are always inherited from the base 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(InventoryDerivedPaymentPolicies)

Payment policies associated with the derived rate.

inheritedCurrency  *  (Currency)

Currency inherited from the base rate.

inheritedCommission  *  (Float)

Commission inherited from the base rate.

inheritedPriceIsBinding  *  (Boolean)

Indicates whether the inherited prices are binding.

acceptedPayments(InventoryDerivedAcceptedPayments)

Accepted payment methods with inheritance metadata.

value(AcceptedPayment)

The derived value.

type  *  (PaymentType)

Possible values:

• MERCHANT: Payment is managed by the supplier.
• DIRECT: Payment is made directly to the actual payee (e.g., the hotel), without involving an intermediary or third party. The payment will be completed at check-in.
• CARD_BOOKING: Payment is managed by the supplier. The payment is effectuated at the time of booking.
• CARD_CHECK_IN: Payment is managed by the supplier and is made at the hotel during check-in.

cardTypes(PaymentCardType)

Possible values:

• VI: Visa
• AX: American Express
• BC: BC Card
• CA: MasterCard
• CB: Carte Blanche
• CU: China Union Pay
• DS: Discover
• DC: Diners Club
• T: Carta Si
• R: Carte Bleue
• N: Dankort
• L: Delta
• E: Electron
• JC: Japan Credit Bureau
• TO: Maestro
• S: Switch
• EC: Electronic Cash
• EU: EuroCard
• TP: universal air travel card
• OP: optima
• ER: Air Canada/RnRoute
• XS: access
• O: others

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

bookingRules(InventoryDerivedBookingRules)

Booking rules associated with the derived rate.

bookingWindow(InventoryDerivedBookingWindow)

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

value(InventoryBookingWindow)

The derived value.

start  *  (DateTime)

Start date of the booking window.

end  *  (DateTime)

End date of the booking window.

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

markets(InventoryDerivedMarkets)

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

value(InventoryMarkets)

The derived value.

included(String)

Included markets.

excluded(String)

Excluded markets.

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

rateRule(InventoryDerivedRateRule)

Rate rule for the derived rate.

value(RatePlanType)

The derived value. Possible values:

• NO_RATE_PLAN_TYPE
• LARGE_FAMILY
• PUBLIC_SERVANT
• NEGOTIATED
• PACKAGE
• CANARY_RESIDENT
• BALEARIC_RESIDENT
• HONEY_MOON

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

seniorRule(InventoryDerivedSeniorRule)

Senior rule for the derived rate.

value(SeniorRate)

The derived value. Possible values:

• NO_SENIOR_RATE
• SENIOR_RATE_55
• SENIOR_RATE_60
• SENIOR_RATE_65

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

cancelPolicies(InventoryDerivedCancelPoliciesRate)

Cancel policies associated with the derived rate.

value(InventoryCancelPoliciesRate)

The derived value.

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  *  (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  *  (InventoryCancelPolicy)

Cancel policy. See CancelPolicy.

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  *  (PenaltyType)

Penalty type. See PenaltyType. Possible values:

• AMOUNT
• NIGHTS
• PERCENTAGE

value  *  (Float)

Penalty value.

isInherit  *  (Boolean)

Indicates whether the value is inherited from the base rate.

inheritedSurcharges(InventorySurcharge)

Surcharges inherited from the base rate.

chargeType  *  (InventoryChargeType)

Indicates if the surcharge is included or not in the price. Possible values:

• INCLUDED
• EXCLUDED

taxType  *  (InventoryTaxType)

The type of tax applied to the surcharge. Possible values:

• CITY: The tax is a city tax.
• LOCAL: The tax is a local tax.
• RESORT_FEE: The tax is a resort fee.
• SUPPLEMENT_TO_BE_PAID_ON_SPOT: The tax is a supplement to be paid on spot.

value  *  (Float)

The value of the surcharge.

applyType  *  (InventoryApplyType)

The type of application for the surcharge. Possible values:

• PERCENTAGE: The rate is applied as a percentage.
• AMOUNT: The rate is applied as an amount.

perNight  *  (Boolean)

Indicates whether the surcharge is applied per night.

perPax  *  (Boolean)

Indicates whether the surcharge is applied per person.

inheritAllRoomsBaseRate  *  (Boolean)

Indicates whether all rooms are inherited from the base rate for the derived rate. If true, all rooms from the base rate are inherited. If false, only specific rooms are associated with the derived rate.

rooms(InventoryRoomSetUp)

Rooms associated with the derived 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  *  (InventoryPaxType)

Gets or sets the type of guests allowed in the room. PaxType Possible values:

• INFANT: Represents an infant guest.
• CHILD: Represents a child guest.
• ADULT: Represents an adult guest.

informBaseRate  *  (Boolean)

Indicates if the base rate code has to be sent to the supplier instead of the derived rate code.

inheritMealPlanSupplements  *  (Boolean)

Indicates whether to inherit meal plan supplements from the base rate.

ratesDeleted(String)

Collection of deleted derived rate codes.

success  *  (Boolean)

Indicates whether the operation was successful based on the absence of advise messages.

Examples

Delete a derived rate