Valuation

Updated: 29 Oct 2018 | Edit on Github

Method Goals

This method aims to return the total price and cancellation policies of the Option selected in the previous step (Avail).

Request Format

The Valuation request format is similar to that of availabilityRQ. It’s here you will add data to the option selected.

Response Format

The returned XML contains the total price and list of cancellation policies.

Remarks

Our system allows for a maximum of 180000 milliseconds before the connection is closed.

ValuationRQ Example

<ValuationRQ>
   <StartDate>04/07/2016</StartDate>
   <EndDate>11/07/2016</EndDate>
   <MealPlanCode>15</MealPlanCode>
   <HotelCode>6259</HotelCode>
   <PaymentType>MerchantPay</PaymentType>
   <OptionType>Hotel</OptionType>
   <OnRequest>false</OnRequest>
   <BlockOption>false</BlockOption>
   <Nationality>ES</Nationality>
   <Parameters>
       <Parameter key = "ID1" value = "ID#1#VR"/>
       <Parameter key = "ID2" value = "ID#2#FGR#45187#10-5"/>
       <Parameter key = "PSR" value = "511.28"/>
   </Parameters>
   <Rooms>
       <Room id = "ITD10" roomCandidateRefId = "1" code = "TW" description = "Twinn"/>
       <Room id = "IOG22" roomCandidateRefId = "2" code = "IND" description = "Individual"/>
   </Rooms>
   <RoomCandidates>
       <RoomCandidate id = "1">
           <Paxes>
               <Pax age = "30" id = "1"/>
               <Pax age = "30" id = "2"/>
           </Paxes>
       </RoomCandidate>
       <RoomCandidate id = "2">
           <Paxes>
               <Pax age = "30" id = "1"/>
           </Paxes>
       </RoomCandidate>
   </RoomCandidates>
</ValuationRQ>

ValuationRQ Description

ValuationRS Example

    <ValuationRS>
        <Parameters>
            <Parameter key = "bd1" value = "43"/>
        </Parameters>
        <Status>OK</Status>
        <Price currency = "EUR" amount = "36.20" binding = "false" commission = "-1"/>
        <CancelPenalties nonRefundable = "false">
            <CancelPenalty>
                <HoursBefore>48</HoursBefore>
                <Penalty type = "Importe"  paymentType = "MerchantPay" currency = "EUR">72.40</Penalty>
            </CancelPenalty>
        </CancelPenalties>
        <Fees>
            <Fee includedPriceOption = "true" description = "TaxAndServiceFee">
                <Price currency = "EUR" amount = "8.11" binding = "false" commission = "-1"/>
            </Fee>
        </Fees>
        <Remarks/>
        <PaymentOptions cash="false" bankAcct="false">
            <Cards>
                <Card code="VI"/>
                <Card code="AX"/>
                <Card code="CA"/>  
            </Cards> 
        <PaymentOptions/>       
       <CancelPoliciesDescription/>
    </ValuationRS>

ValuationRS Description

Detailed Description

**Suppliers with block allotment **

There are some suppliers who use block allotments, sometimes called pre-confirmation or quote. In that case, you will have 30 minutes to complete the booking, if not, you will have to re-launch Valuation 30 minutes after the last request, normally just before booking request.

Status:

The valuation response depends if the parameter is set: if it is set as false, the integration will filter this option. If the supplier provides us a new status in ValuationRS, then we return an error because the supplier changed the status option.

CardInfo:

CancelPenalty:

Booking cancellation penalties are affected by the following elements:

• HoursBefore: cancellation fees applicable x number of hours before the check in date

• Type: There are three values that can be inside types:

• Noches: indicates the number of nights to be penalized.

• Porcentaje: indicates the percentage to pay based on the option price.

• Importe: indicates the exact amount payable

• Currency: currency of the penalty fee.

Final buying price:

If the price in the reservation is lower, we recommend taking into account the price in valuation, given that it is the price which the end customer will see. The price in reservation should always be kept in mind, especially in case it is higher than the one in valuation.

Note:

Keep the parameters in the avail response to include them in the valuation request.

Keep the parameters in the valuation response to include them in the reservation request.