Requote
The Requote plugin allows you to deactivate any Requote app available in the Travelgate App Store.
The Requote app is a Travelgate feature that automatically evaluates if other of your suppliers in the Marketplace can offer the same or better conditions at a lower price whenever you request a quote.
With Requote, you can:
-
See cheaper or better-value alternatives for the same hotel.
-
Compare offers from different suppliers before confirming a booking.
-
Choose at the quote step whether to continue with your original option or one of the suggested alternatives. The alternatives are returned ordered from best to worst and if the list is empty, it means there are no better options than your original quote.
To use this feature, you must have at least one Requote app activated in the Travelgate Apps Marketplace.
1. Execute Requote Price Plugin in your Queryโ
The plugin is optional. By default, Requote will always be applied if you have the app enabled in your Marketplace. However, you can use the plugin when you want to temporarily disable Requote for a quote request, without removing its global configuration.
To use the plugin, add the following field to the settings node of your request. Note that the Requote plugin can be executed during a quote request (quote step). To successfully execute the Requote plugin, you need to create the request with the following variables:
name: "appSupplier.appName.version"enable: "false". You'll need to indicate if you want to disable the APP in your quote query with this boolean.parameters: list of parameters depending on the APP supplier.
For instance, to use the Requote app from Travelgate:
"settings": {
"plugins" : [
{
"pluginsType" : [
{
"name" : "tgx.requote.1",
"enable" : "false",
"parameters" : [
{
"key" : "key",
"value" : "value"
}
]
}
]
}
]
}
2. Create the Requote RQโ
Here is a sample structure for criteriaQuote:
{
"query": "query ($criteriaQuote: HotelCriteriaQuoteInput!, $settings: HotelSettingsInput) {\n hotelX {\n quote(criteria: $criteriaQuote, settings: $settings) {auditData { transactions { request response } timeStamp}optionQuote { optionRefId status hotelCode boardCode price { currency binding net gross exchange { currency rate } markups { channel currency binding net gross exchange { currency rate } } } surcharges { code mandatory chargeType price { currency binding net gross exchange { currency rate } markups { channel currency binding net gross exchange {currencyrate } } } description } cancelPolicy { refundable cancelPenalties { deadline penaltyType currency value } } rooms { occupancyRefId legacyRoomId code supplierCode description features { code } } cardTypes remarks paymentType}errors { code type description}warnings { code type description}apps {requote { appSupplierCode options { savings { value currency } optionQuote { optionRefId boardCode accessCode hotelCode hotelCodeSupplier supplierCode status paymentType price { currency binding net gross exchange {currencyrate } markups {channelcurrencybindingnetgrossexchange { currency rate} } } surcharges { chargeType mandatory price {currencybindingnetgrossexchange { currency rate}markups { channel currency binding net gross exchange { currency rate }} } description } cancelPolicy { refundable cancelPenalties {deadlinehoursBeforepenaltyTypecurrencyvalue } } rooms { occupancyRefId legacyRoomId code supplierCode description features {code } } cardTypes remarks } }}\n }\n }\n }\n}\n ",
"variables": {
"criteriaQuote": {
"optionRefId": "13[%!03!~|3[%@241028!~|241029!~|1!~|1!~|0!~|ES!~|ES!~|es!~|EUR!~|0!~|2!~|1!~|1!~|1!~|0!~|15091141!~|BAR[%@BAR!~|146[%@0[%@false[%@EUR[%@[%@0[%@!~|1|30#30|1|2024-10-28|1|4132467|4132468|1|11|0!~|2269[%!2269!~|30[%@30!~|!~|Double Standard!~|1!~|!~|mercado[%@ES[%!ExpireDate[%@29/10/2024[%!tarifaNRF[%@true[%!RateRule[%@tarifaNoRefundablePorHabitacion!~|OK!~|Sith!~|0!~|"
},
"settings": {
"client": "<YOUR_CLIENT>",
"testMode": true
}
}
}
3. Read the Requote resultsโ
When Requote is active (by default or if you havenโt disabled it via plugin), make sure to request also the field "apps > requote" to obtain the information in your response. In this field, you will receive:
- A list of alternative options from other suppliers, already evaluated by the app. These options include the same level of detail as your original quote response.
- In each alternative option, the
savingsnode indicates how much you can save compared to your original quoted option.
{
"data" : {
"hotelX" : {
"quote" : {
"optionQuote" : {
"optionRefId" : "31[a1[e[PUSD[Q[R0DoAclH...",
"status" : "OK",
"supplierCode" : "SUP1",
"accessCode" : "xxxxx",
"hotelCode" : "049598",
"boardCode" : "FB",
"paymentType" : "MERCHANT",
"price" : {
"currency" : "USD",
"binding" : false,
"net" : 43039.2,
"gross" : 43039.2
},
"surcharges" : null,
"cancelPolicy" : {
"refundable" : true,
"cancelPenalties" : [
{
"deadline" : "2026-04-20T09:59:00Z",
"penaltyType" : "IMPORT",
"currency" : "USD",
"value" : 43039.2
}
]
},
"rooms" : [
{
"code" : "049598#Superior Room",
"description" : "Superior Room"
}
]
},
"apps" : {
"requote" : {
"appSupplierCode" : "tgx.requote.1",
"options" : [
{
"savings" : {
"value" : 2009.95,
"currency" : "USD"
},
"optionQuote" : {
"optionRefId" : "31[a1[b26BL.SU-1[ADBL.S836ZU...",
"status" : "OK",
"supplierCode" : "SUP4",
"accessCode" : "xxxxx",
"hotelCode" : "328034",
"boardCode" : "AI",
"paymentType" : "MERCHANT",
"price" : {
"currency" : "USD",
"binding" : false,
"net" : 41029.25,
"gross" : 41029.25
},
"surcharges" : null,
"cancelPolicy" : {
"refundable" : false
},
"rooms" : [
{
"code" : "DBL.SU-1",
"description" : "Superior Room"
}
]
}
}
]
}
}
}
}
}
}
Once you have the results:
- Review the alternative options and savings.
- Decide which option is best for your business.
- For the book step, use the
optionIDof the option you finally want to confirm.
4. Examplesโ
Interactive reQuote Demoโ
Use this embedded demo to compare the original quote response with the reQuote option for that same request. This interactive demo is a visual representation of how data retrieved in real time via the API could be displayed using reQuote plugin.
Interactive reQuote Playgroundโ
query ($criteriaQuote: HotelCriteriaQuoteInput!, $settings: HotelSettingsInput) {
hotelX {
quote(criteria: $criteriaQuote, settings: $settings) {
auditData {
transactions {
request
response
}
timeStamp
}
optionQuote {
optionRefId
status
hotelCode
boardCode
price {
currency
binding
net
gross
exchange {
currency
rate
}
markups {
channel
currency
binding
net
gross
exchange {
currency
rate
}
}
}
surcharges {
code
mandatory
chargeType
price {
currency
binding
net
gross
exchange {
currency
rate
}
}
description
}
cancelPolicy {
refundable
cancelPenalties {
deadline
penaltyType
currency
value
}
}
rooms {
occupancyRefId
legacyRoomId
code
supplierCode
description
features {
code
}
}
cardTypes
remarks
paymentType
}
errors {
code
type
description
}
warnings {
code
type
description
}
apps {
requote {
appSupplierCode
options {
savings {
value
currency
}
optionQuote {
optionRefId
boardCode
accessCode
hotelCode
hotelCodeSupplier
supplierCode
status
paymentType
price {
currency
binding
net
gross
}
surcharges {
chargeType
mandatory
price {
currency
binding
net
gross
markups {
channel
currency
binding
net
gross
exchange {
currency
rate
}
}
}
description
}
cancelPolicy {
refundable
cancelPenalties {
deadline
currency
value
}
}
rooms {
occupancyRefId
legacyRoomId
code
supplierCode
description
features {
code
}
}
cardTypes
remarks
}
}
}
}
}
}
}
{
"criteriaQuote": {
"optionRefId": "33!~|a0!~|b270528!~|c270529!~|d1!~|e14!~|f0!~|gES!~|hES!~|ien!~|jEUR!~|k0!~|l42021!~|mES284122!~|n14!~|nTGX!~|o0!~|p1!~|x28101610!~|r!~|sBARRF!~|M122!~|N0!~|Ofalse!~|PEUR!~|Q!~|R0!~|S!~|T!~|z1|30#30|1|2027-05-28|1|4247163|4247164|14|11|0!~|A5683!~|Bdesu----d--!~|C30|30!~|EDeluxe Double Suite!~|FDouble Suite Deluxe!~|G1!~|U2,115.90,1810548000|2,122,1811239200!~|H1!~|I1|30#30|1|2027-05-28|1|4247163|4247164|14|11|0!~|J1!~|K1!~|L1!~|H2!~|IES!~|J1!~|K0!~|L1!~|H703!~|I1#3@#!~|J0!~|K1!~|L0!~|H710!~|I244!~|J0!~|K0!~|L0!~|H708!~|I2816ca56-2b01-47dc-958d-837dbe4bde88!~|J0!~|K0!~|L0!~|tOK!~|uConnectors!~|v0!~|w!~|yPACKAGE!~|q!~|q0!~|y!~|"
},
"settings": {
"client": "<YOUR_CLIENT>",
"testMode": false,
"timeout": 5000
}
}