Offers
Query Overview
The offersSetUp query returns the offers created for a hotel rate in Inventory. The returned fields include:
codedescriptionisActiverateCoderoomCodesmontuewedthufrisatsunapplyFromapplyTonumberOfNightsminLosmaxLosnightsType
1. Criteria
When building your query, you need to provide the following input fields:
Mandatory Input
clientCodesupplierCodehotelCoderateCode
Optional Input
contextCodeofferCodes
2. Settings
To retrieve offers, ensure that all required fields are properly set and match existing hotel rate configurations.
Response Considerations
The query returns a collection of offers along with success status and possible advise messages.
OffersRs (OBJECT)
offers(OfferDto) - A collection of retrieved offers.code(String) - The offer code.description(String) - Description of the offer.isActive(Boolean) - Indicates if the offer is active.rateCode(String) - The rate code associated with the offer.nightsType(Enum of NightsType) - The type of nights the offer applies to.numberOfNights(Int) - Number of nights the offer applies to.applyFrom(DateTime) - Start date when the offer applies.applyTo(DateTime) - End date when the offer applies.minLos(Int) - Minimum length of stay required.maxLos(Int) - Maximum length of stay allowed.roomCodes(String) - The room codes associated with the offer.mon(Boolean) - Applies on Monday.tue(Boolean) - Applies on Tuesday.wed(Boolean) - Applies on Wednesday.thu(Boolean) - Applies on Thursday.fri(Boolean) - Applies on Friday.sat(Boolean) - Applies on Saturday.sun(Boolean) - Applies on Sunday.
success(Boolean) - Indicates if the operation was successful.adviseMessages(AdviseMessage) - Messages related to the operation.
Query Inputs
InventoryOffersSetupFilterInput (INPUT_OBJECT)
Rates setup filter input.
Rates setup filter input.
hotelCode * (String)
Hotel codes of the rooms to retrieve.
Hotel codes of the rooms to retrieve.
clientCode * (String)
Client code.
Client code.
supplierCode * (String)
Travelgate Supplier/Channel code.
Travelgate Supplier/Channel code.
contextCode (String)
Travelgate Supplier/Channel context code.
Travelgate Supplier/Channel context code.
offerCodes (String)
Offer codes.
Offer codes.
rateCode * (String)
Rate code.
Rate code.
Returned Fields
OffersRs (OBJECT)
Represents a response object for offers.
Represents a response object for offers.
adviseMessages (AdviseMessage)
Gets or sets the list of advise messages associated with the offers.
See AdviseMessage.
Gets or sets the list of advise messages associated with the offers. See AdviseMessage.
code * (ID)
AM code: The following codes can be returned:
AM code: The following codes can be returned:
description * (String)
Error description
Error description
level * (Enum of AdviseMessageLevel)
Indicates the level of importance of the message.
Possible values: ERROR, WARN, INFO.
Possible values:
WARN
ERROR
INFO
Indicates the level of importance of the message. Possible values: ERROR, WARN, INFO.
Possible values:
WARNERRORINFOexternal (ExternalMessage)
Specify the external message.
Specify the external message.
code (String)
External code.
External code.
message * (String)
External message.
External message.
correlationID * (ID)
Identifier to investigate the cause of the error.
Identifier to investigate the cause of the error.
offers (OfferDto)
Gets or sets the list of offers.
See OfferDto.
Gets or sets the list of offers. See OfferDto.
rateCode (String)
The rate code of the offer.
The rate code of the offer.
code (String)
The offer code.
The offer code.
isActive * (Boolean)
Indicates whether the offer is active.
Indicates whether the offer is active.
description (String)
The description of the offer.
The description of the offer.
nightsType * (Enum of NightsType)
The type of the offer.
Possible values:
FIRST
LAST
CHEAPEST
The type of the offer.
Possible values:
FIRSTLASTCHEAPESTmaxLos (Int)
The maximum length of stay for the offer.
The maximum length of stay for the offer.
minLos (Int)
The minimum length of stay for the offer.
The minimum length of stay for the offer.
applyFrom (DateTime)
The start date when the offer applies.
The start date when the offer applies.
applyTo (DateTime)
The end date when the offer applies.
The end date when the offer applies.
numberOfNights (Int)
The number of free nights for the offer.
The number of free nights for the offer.
roomCodes (String)
The room codes associated with the offer.
The room codes associated with the offer.
mon (Boolean)
Indicates whether the offer applies on Monday.
Indicates whether the offer applies on Monday.
tue (Boolean)
Indicates whether the offer applies on Tuesday.
Indicates whether the offer applies on Tuesday.
wed (Boolean)
Indicates whether the offer applies on Wednesday.
Indicates whether the offer applies on Wednesday.
thu (Boolean)
Indicates whether the offer applies on Thursday.
Indicates whether the offer applies on Thursday.
fri (Boolean)
Indicates whether the offer applies on Friday.
Indicates whether the offer applies on Friday.
sat (Boolean)
Indicates whether the offer applies on Saturday.
Indicates whether the offer applies on Saturday.
sun (Boolean)
Indicates whether the offer applies on Sunday.
Indicates whether the offer applies on Sunday.
success * (Boolean)
Gets a value indicating whether the operation was successful.
Gets a value indicating whether the operation was successful.