RatePlanToken Search RS

The Search functionality for our RatePlanToken product is directly based on our original OTA_HotelAvailRQ/RS. The response message is essentially the same with an extra attribute.

Purpose

• Confirm successful processing (<Success/>) or return error diagnostics (<Errors/>). Error Scenarios.
• Deliver one or more <RoomStay> items with pricing, guest counts, and property references.
• Return the RatePlanToken needed for RP Token bookings.

Details and Structure

All the details regarding this message can be found at OTA_HotelAvailRS.

This response works exactly the same, and depending on the distributor setup for RP Token, those new hotels will be received.

The RatePlanToken room stays will be returned with a RatePlanToken in the search RS, which will be needed at the booking step.

Response may contain a mix of RoomStays with and without RatePlanToken. If it is returned, it is needed for the booking.

RatePlanToken

The RatePlanToken consists of a string in the RoomStay, which needs to be used in the booking step.

<RoomRates>
    <RatePlans>
        <RatePlan RatePlanToken="xxxxxxxx" />
    </RatePlans>
    <RoomRate RoomTypeCode="RMSDDB0000" NumberOfUnits="3">
        <Rates>
        ...

Differences with classic Hotel Search

The structure of the message is exactly the same, but the available optional features are less for these searches.

What’s not included

• Multi-Room logic is not yet available for RP Token Search.
• Recommended Retail Price is not supported.
• Enrichment via InfoSource. Every response will be displayed as per InfoSource = 0.
• Area Search is not supported.
• Offer tags are not available in this mode.

RatePlans and Multicontracting

In this flow, rateplans and multicontracting are always included. The codes, in this case, will already be encoded inside the RatePlanToken and don’t need to be used in the traditional “concatenated to room code” approach.

The Rateplan code is needed to ensure a proper distribution of the rates. It will be visible in the response in the following section, but it does not have to be used at the booking request.

...
</RoomTypes>
<RatePlans>
    <RatePlan RatePlanCode = "BP007" />
<RatePlans>
...

Taxes and Fees

The Taxes and Fees are small rates or commissions that may be added to a booking if a contract requests it.

There are three main types of Taxes and Fees:

• Mandatory: They are treated as a supplement in the contract, and calculated as one in the booking. Visible in Price Breakdown.
• Included: They are included in the hotel rate. They are visible under the Tax section as “Inclusive”.
• Payable Locally: Taxes for the customer to pay on spot. They are visible under the tax section as “Exclusive”.

<Taxes Amount="100.00" CurrencyCode="EUR">
    <Tax Amount="50.00" CurrencyCode="EUR" Code="3" SequenceNbr="1" Type="Inclusive" ChargeFrequency="12">
        <TaxDescription>
            <Text Language="EN">This is a mandatory tax included in the rate, total amount for the whole stay</Text>
        </TaxDescription>
    </Tax>
    <Tax Amount="50" CurrencyCode="EUR" Code="18" SequenceNbr="2" Type="Inclusive" ChargeFrequency="21">
        <TaxDescription>
            <Text Language="EN">This is a mandatory tax included in the rate, value is per pax per night</Text>
        </TaxDescription>
    </Tax>
    <Tax Amount="75.00" CurrencyCode="EUR" Code="12" SequenceNbr="3" Type="Exclusive" ChargeFrequency="12">
        <TaxDescription>
            <Text Language="EN">This is a mandatory tax NOT included in the rate (payable locally), total amount for the whole stay</Text>
        </TaxDescription>
    </Tax>
    <Tax Percent="7" Code="30" SequenceNbr="4" Type="Exclusive" ChargeFrequency="12">
        <TaxDescription>
            <Text Language="EN">This is a mandatory tax NOT included in the rate (payable locally), expressed as a percentage of the total amount</Text>
        </TaxDescription>
    </Tax>
    <Tax Amount="2.00" CurrencyCode="EUR" Code="5" SequenceNbr="5" Type="Exclusive" ChargeFrequency="21">
        <TaxDescription>
            <Text Language="EN">This is a mandatory tax NOT included in the rate (payable locally), expressed as a per pax per night value</Text>
        </TaxDescription>
    </Tax>
</Taxes>

The Code represents which type of Tax or Fee the element refers to. The Mapping of the codes is the following:

ChargeFrequency uses OTA CHG codes:

• 1 per night
• 12 per stay
• 18 per room per stay
• 19 per room per night
• 20 per pax per stay
• 21 per pax per night

Code uses OTA FTT codes:

• 3 city tax
• 6 federal tax
• 30 country tax
• 12 resort fee
• 18 tourism tax
• 27 miscellaneous
• 5 energy tax
• 36 VAT

Complete Examples

Basic

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<OTA_HotelAvailRS xmlns="http://www.opentravel.org/OTA/2003/05" TimeStamp="2026-09-23T14:41:58.873112234" Version="2008.1" TransactionIdentifier="1-1/1">
    <Success/>
    <RoomStays>
        <RoomStay RoomStayCandidateRPH="0" RPH="0" ResponseType="PropertyList">
            <RoomTypes>
                <RoomType RoomTypeCode="VICS00G200">
                    <RoomDescription>
                        <Text Language="EN">Classic Villa (Garden or Pool View)</Text>
                    </RoomDescription>
                </RoomType>
            </RoomTypes>
            <RatePlans>
                <RatePlan RatePlanToken="NGDjY1BxMJshnFFtjbCh_FrakddKXJqOLLrrvn66FbmdudA1XpPQoqnSjk8Am1Nt3S4VojCFMoSbqGmQc3Vq6-4mrLpBTJ1574B_YNHwg8MXORWTDjfIxlDx4D7RYw_oJ9PI4M7Hd2g3kCQBMxF8pY70SZI9Cnk2xwG1ftXJOtLp9pp6twC-etx3To6prOGR-QCVy-No-8R9lyAGiuq2Ig"/>
            </RatePlans>
            <RoomRates>
                <RoomRate RoomTypeCode="VICS00G200" NumberOfUnits="196707">
                    <Rates>
                        <Rate>
                            <Total AmountAfterTax="1224.00" CurrencyCode="EUR"/>
                        </Rate>
                    </Rates>
                    <Features>
                        <Feature>
                            <Description>
                                <Text>BB</Text>
                            </Description>
                        </Feature>
                    </Features>
                </RoomRate>
            </RoomRates>
            <GuestCounts>
                <GuestCount AgeQualifyingCode="10" Count="2"/>
            </GuestCounts>
            <TimeSpan Start="2026-11-20" End="2026-11-25"/>
            <BasicPropertyInfo HotelCode="AMTMLA5L7C"/>
        </RoomStay>
        <RoomStay RoomStayCandidateRPH="0" RPH="1" ResponseType="PropertyList">
            <RoomTypes>
                <RoomType RoomTypeCode="VICS00G200">
                    <RoomDescription>
                        <Text Language="EN">Classic Villa (Garden or Pool View)</Text>
                    </RoomDescription>
                </RoomType>
            </RoomTypes>
            <RatePlans>
                <RatePlan RatePlanToken="NGDjY1BxMJshnFFtjbCh_FrakddKXJqOLLrrvn66FbmdudA1XpPQoqnSjk8Am1Nt3S4VojCFMoSbqGmQc3Vq6-4mrLpBTJ1574B_YNHwg8MXORWTDjfIxlDx4D7bYw_oJ9PI4M7Hd2g3kCQBMxF8pY70SZI9Cnk2xwG1ftXJOtLp9pp6tzyActx3To6prOGRuiNrljFQNNmUpQeOYT0vrg"/>
            </RatePlans>
            <RoomRates>
                <RoomRate RoomTypeCode="VICS00G200" NumberOfUnits="196707">
                    <Rates>
                        <Rate>
                            <Total AmountAfterTax="1377.00" CurrencyCode="EUR"/>
                        </Rate>
                    </Rates>
                    <Features>
                        <Feature>
                            <Description>
                                <Text>HB</Text>
                            </Description>
                        </Feature>
                    </Features>
                </RoomRate>
            </RoomRates>
            <GuestCounts>
                <GuestCount AgeQualifyingCode="10" Count="2"/>
            </GuestCounts>
            <TimeSpan Start="2026-11-20" End="2026-11-25"/>
            <BasicPropertyInfo HotelCode="AMTMLA5L7C"/>
        </RoomStay>
        <RoomStay RoomStayCandidateRPH="0" RPH="2" ResponseType="PropertyList">
            <RoomTypes>
                <RoomType RoomTypeCode="VICF000000">
                    <RoomDescription>
                        <Text Language="EN">Comfort Villa</Text>
                    </RoomDescription>
                </RoomType>
            </RoomTypes>
            <RatePlans>
                <RatePlan RatePlanToken="NGDjY1BxMJshnFFtjbCh_FrakddKXJqOLLrrvn66FbmdudA1XpPQoqnSjk8Am1Nt3S4VojCFMoSbqGmQc3Vq6-4mrLpBTJ1574B_ddHw9MEXORWTDjfIxlDx4D7RYw_oJ9PI4M7Hd2g3kCQBMxF8pY70SZI9Cnk2xwG1ftXJOtLp9pp6tzjiatx3To6prOGRLs7aKDa67cIeBojsDMcCgw"/>
            </RatePlans>
            <RoomRates>
                <RoomRate RoomTypeCode="VICF000000" NumberOfUnits="196707">
                    <Rates>
                        <Rate>
                            <Total AmountAfterTax="1530.00" CurrencyCode="EUR"/>
                        </Rate>
                    </Rates>
                    <Features>
                        <Feature>
                            <Description>
                                <Text>BB</Text>
                            </Description>
                        </Feature>
                    </Features>
                </RoomRate>
            </RoomRates>
            <GuestCounts>
                <GuestCount AgeQualifyingCode="10" Count="2"/>
            </GuestCounts>
            <TimeSpan Start="2026-11-20" End="2026-11-25"/>
            <BasicPropertyInfo HotelCode="AMTMLA5L7C"/>
        </RoomStay>
        <RoomStay RoomStayCandidateRPH="0" RPH="3" ResponseType="PropertyList">
            <RoomTypes>
                <RoomType RoomTypeCode="VICS00PK00">
                    <RoomDescription>
                        <Text Language="EN">Classic Villa (Park View)</Text>
                    </RoomDescription>
                </RoomType>
            </RoomTypes>
            <RatePlans>
                <RatePlan RatePlanToken="NGDjY1BxMJshnFFtjbCh_FrakddKXJqOLLrrvn66FbmdudA1XpPQoqnSjk8Am1Nt3S4VojCFMoSbqGmQc3Vq6-4mrLpBTJ1574B_YNHwlLoXORWTDjfIxlDx4D7RYw_oJ9PI4M7Hd2g3kCQBMxF8pY70SZI9Cnk2xwG1ftXJOtLp9pp6tzjiatx3To6prOGRituAuchYwVwPY0Pa1Td0Zw"/>
            </RatePlans>
            <RoomRates>
                <RoomRate RoomTypeCode="VICS00PK00" NumberOfUnits="196707">
                    <Rates>
                        <Rate>
                            <Total AmountAfterTax="1530.00" CurrencyCode="EUR"/>
                        </Rate>
                    </Rates>
                    <Features>
                        <Feature>
                            <Description>
                                <Text>BB</Text>
                            </Description>
                        </Feature>
                    </Features>
                </RoomRate>
            </RoomRates>
            <GuestCounts>
                <GuestCount AgeQualifyingCode="10" Count="2"/>
            </GuestCounts>
            <TimeSpan Start="2026-11-20" End="2026-11-25"/>
            <BasicPropertyInfo HotelCode="AMTMLA5L7C"/>
        </RoomStay>
        <RoomStay RoomStayCandidateRPH="0" RPH="4" ResponseType="PropertyList">
            <RoomTypes>
                <RoomType RoomTypeCode="VICF000000">
                    <RoomDescription>
                        <Text Language="EN">Comfort Villa</Text>
                    </RoomDescription>
                </RoomType>
            </RoomTypes>
            <RatePlans>
                <RatePlan RatePlanToken="NGDjY1BxMJshnFFtjbCh_FrakddKXJqOLLrrvn66FbmdudA1XpPQoqnSjk8Am1Nt3S4VojCFMoSbqGmQc3Vq6-4mrLpBTJ1574B_ddHw9MEXORWTDjfIxlDx4D7bYw_oJ9PI4M7Hd2g3kCQBMxF8pY70SZI9Cnk2xwG1ftXJOtLp9pp6tzTEYtx3To6prOGR6-TicrosADI_um2ckwimKg"/>
            </RatePlans>
            <RoomRates>
                <RoomRate RoomTypeCode="VICF000000" NumberOfUnits="196707">
                    <Rates>
                        <Rate>
                            <Total AmountAfterTax="1683.00" CurrencyCode="EUR"/>
                        </Rate>
                    </Rates>
                    <Features>
                        <Feature>
                            <Description>
                                <Text>HB</Text>
                            </Description>
                        </Feature>
                    </Features>
                </RoomRate>
            </RoomRates>
            <GuestCounts>
                <GuestCount AgeQualifyingCode="10" Count="2"/>
            </GuestCounts>
            <TimeSpan Start="2026-11-20" End="2026-11-25"/>
            <BasicPropertyInfo HotelCode="AMTMLA5L7C"/>
        </RoomStay>
        <RoomStay RoomStayCandidateRPH="0" RPH="5" ResponseType="PropertyList">
            <RoomTypes>
                <RoomType RoomTypeCode="VICS00PK00">
                    <RoomDescription>
                        <Text Language="EN">Classic Villa (Park View)</Text>
                    </RoomDescription>
                </RoomType>
            </RoomTypes>
            <RatePlans>
                <RatePlan RatePlanToken="NGDjY1BxMJshnFFtjbCh_FrakddKXJqOLLrrvn66FbmdudA1XpPQoqnSjk8Am1Nt3S4VojCFMoSbqGmQc3Vq6-4mrLpBTJ1574B_YNHwlLoXORWTDjfIxlDx4D7bYw_oJ9PI4M7Hd2g3kCQBMxF8pY70SZI9Cnk2xwG1ftXJOtLp9pp6tzTEYtx3To6prOGRT_G440TOLKwu36aqSvjQzg"/>
            </RatePlans>
            <RoomRates>
                <RoomRate RoomTypeCode="VICS00PK00" NumberOfUnits="196707">
                    <Rates>
                        <Rate>
                            <Total AmountAfterTax="1683.00" CurrencyCode="EUR"/>
                        </Rate>
                    </Rates>
                    <Features>
                        <Feature>
                            <Description>
                                <Text>HB</Text>
                            </Description>
                        </Feature>
                    </Features>
                </RoomRate>
            </RoomRates>
            <GuestCounts>
                <GuestCount AgeQualifyingCode="10" Count="2"/>
            </GuestCounts>
            <TimeSpan Start="2026-11-20" End="2026-11-25"/>
            <BasicPropertyInfo HotelCode="AMTMLA5L7C"/>
        </RoomStay>
        <RoomStay RoomStayCandidateRPH="0" RPH="6" ResponseType="PropertyList">
            <RoomTypes>
                <RoomType RoomTypeCode="VI4C000000">
                    <RoomDescription>
                        <Text Language="EN">Cape Villa</Text>
                    </RoomDescription>
                </RoomType>
            </RoomTypes>
            <RatePlans>
                <RatePlan RatePlanToken="NGDjY1BxMJshnFFtjbCh_FrakddKXJqOLLrrvn66FbmdudA1XpPQoqnSjk8Am1Nt3S4VojCFMoSbqGmQc3Vq6-4mrLpBTJ1574AIcNHw9MEXORWTDjfIxlDx4D7RYw_oJ9PI4M7Hd2g3kCQBMxF8pY70SZI9Cnk2xwG1ftXJOtLp9pp6tyyoetx3To6prOGR4wFDDxDUh0WMz768UIiiHQ"/>
            </RatePlans>
            <RoomRates>
                <RoomRate RoomTypeCode="VI4C000000" NumberOfUnits="196707">
                    <Rates>
                        <Rate>
                            <Total AmountAfterTax="2040.00" CurrencyCode="EUR"/>
                        </Rate>
                    </Rates>
                    <Features>
                        <Feature>
                            <Description>
                                <Text>BB</Text>
                            </Description>
                        </Feature>
                    </Features>
                </RoomRate>
            </RoomRates>
            <GuestCounts>
                <GuestCount AgeQualifyingCode="10" Count="2"/>
            </GuestCounts>
            <TimeSpan Start="2026-11-20" End="2026-11-25"/>
            <BasicPropertyInfo HotelCode="AMTMLA5L7C"/>
        </RoomStay>
        <RoomStay RoomStayCandidateRPH="0" RPH="7" ResponseType="PropertyList">
            <RoomTypes>
                <RoomType RoomTypeCode="VI4C000000">
                    <RoomDescription>
                        <Text Language="EN">Cape Villa</Text>
                    </RoomDescription>
                </RoomType>
            </RoomTypes>
            <RatePlans>
                <RatePlan RatePlanToken="NGDjY1BxMJshnFFtjbCh_FrakddKXJqOLLrrvn66FbmdudA1XpPQoqnSjk8Am1Nt3S4VojCFMoSbqGmQc3Vq6-4mrLpBTJ1574AIcNHw9MEXORWTDjfIxlDx4D7bYw_oJ9PI4M7Hd2g3kCQBMxF8pY70SZI9Cnk2xwG1ftXJOtLp9pp6tyiKctx3To6prOGRR9clqwaPZZgOsYTnJrzzOg"/>
            </RatePlans>
            <RoomRates>
                <RoomRate RoomTypeCode="VI4C000000" NumberOfUnits="196707">
                    <Rates>
                        <Rate>
                            <Total AmountAfterTax="2193.00" CurrencyCode="EUR"/>
                        </Rate>
                    </Rates>
                    <Features>
                        <Feature>
                            <Description>
                                <Text>HB</Text>
                            </Description>
                        </Feature>
                    </Features>
                </RoomRate>
            </RoomRates>
            <GuestCounts>
                <GuestCount AgeQualifyingCode="10" Count="2"/>
            </GuestCounts>
            <TimeSpan Start="2026-11-20" End="2026-11-25"/>
            <BasicPropertyInfo HotelCode="AMTMLA5L7C"/>
        </RoomStay>
        <RoomStay RoomStayCandidateRPH="0" RPH="8" ResponseType="PropertyList">
            <RoomTypes>
                <RoomType RoomTypeCode="VICL000000">
                    <RoomDescription>
                        <Text Language="EN">Club Villa</Text>
                    </RoomDescription>
                </RoomType>
            </RoomTypes>
            <RatePlans>
                <RatePlan RatePlanToken="NGDjY1BxMJshnFFtjbCh_FrakddKXJqOLLrrvn66FbmdudA1XpPQoqnSjk8Am1Nt3S4VojCFMoSbqGmQc3Vq6-4mrLpBTJ1574B_f9Hw9MEXORWTDjfIxlDx4D7RYw_oJ9PI4M7Hd2g3kCQBMxF8pY70SZI9Cnk2xwG1ftXJOtLp9pp6tyurWtx3To6prOGRqzjqTDV9izXhDoVc02Vx8g"/>
            </RatePlans>
            <RoomRates>
                <RoomRate RoomTypeCode="VICL000000" NumberOfUnits="196707">
                    <Rates>
                        <Rate>
                            <Total AmountAfterTax="2244.00" CurrencyCode="EUR"/>
                        </Rate>
                    </Rates>
                    <Features>
                        <Feature>
                            <Description>
                                <Text>BB</Text>
                            </Description>
                        </Feature>
                    </Features>
                </RoomRate>
            </RoomRates>
            <GuestCounts>
                <GuestCount AgeQualifyingCode="10" Count="2"/>
            </GuestCounts>
            <TimeSpan Start="2026-11-20" End="2026-11-25"/>
            <BasicPropertyInfo HotelCode="AMTMLA5L7C"/>
        </RoomStay>
        <RoomStay RoomStayCandidateRPH="0" RPH="9" ResponseType="PropertyList">
            <RoomTypes>
                <RoomType RoomTypeCode="VICL000000">
                    <RoomDescription>
                        <Text Language="EN">Club Villa</Text>
                    </RoomDescription>
                </RoomType>
            </RoomTypes>
            <RatePlans>
                <RatePlan RatePlanToken="NGDjY1BxMJshnFFtjbCh_FrakddKXJqOLLrrvn66FbmdudA1XpPQoqnSjk8Am1Nt3S4VojCFMoSbqGmQc3Vq6-4mrLpBTJ1574B_f9Hw9MEXORWTDjfIxlDx4D7bYw_oJ9PI4M7Hd2g3kCQBMxF8pY70SZI9Cnk2xwG1ftXJOtLp9pp6tyeNUtx3To6prOGRbhLSFrnrZsXAsmAsTKrVWw"/>
            </RatePlans>
            <RoomRates>
                <RoomRate RoomTypeCode="VICL000000" NumberOfUnits="196707">
                    <Rates>
                        <Rate>
                            <Total AmountAfterTax="2397.00" CurrencyCode="EUR"/>
                        </Rate>
                    </Rates>
                    <Features>
                        <Feature>
                            <Description>
                                <Text>HB</Text>
                            </Description>
                        </Feature>
                    </Features>
                </RoomRate>
            </RoomRates>
            <GuestCounts>
                <GuestCount AgeQualifyingCode="10" Count="2"/>
            </GuestCounts>
            <TimeSpan Start="2026-11-20" End="2026-11-25"/>
            <BasicPropertyInfo HotelCode="AMTMLA5L7C"/>
        </RoomStay>
    </RoomStays>
</OTA_HotelAvailRS>