Hotel.getPriceActions | Previo API

Hotel.getPriceActions

Hotels offer specific discounts based on time range from booking to arrival, based on  booked length of stay or other criteria. 

This function returns required data to determine discounts.

Parameters

Name Description
login Username
password Password
hotId Hotel ID

Sample request

<request>
    <login>user_login</login>
    <password>heslo</password>
    <hotId>hotId</hotId>
</request>

Output

<priceActions> [1]  
 
<firstMinutes> [1]  
 
<firstMinute> [0..*]  
 
<pfmId> [1] Discount ID
<minNumOfDaysBeforeArrival> [1] Minimum number of days booked before arrival to receive the discount
<discountRate> [1] Discount %
<actionFrom> Valid until
<actionTo> Valid to
<isForActionPrices> May by applied to action prices
<isForNonRefundablePrices> May by applied to non-refundable prices
<objectKinds> Valid for these Object Kinds
 
<objectKind> Object kind
 
<obkId> Object kind ID
 
<lastMinutes> [1]  
 
<lastMinute> [0..*]  
 
<plmId> [1] Discount ID
<maxNumOfHoursBeforeArrival> [1] Maximum number of hours booked before arrival to receive the discount
<discountRate> [1] Discount %
<actionFrom> Valid until
<actionTo> Valid to
<isForActionPrices> May by applied to action prices
<isForNonRefundablePrices> May by applied to non-refundable prices
<objectKinds> Valid for these Object Kinds
 
<objectKind> Object kind
 
<obkId> Object kind ID
 
<longTerms> [1]  
 
<longTerm> [0..*]  
 
<palId> [1] Discount ID
<minNumOfNights> [1] Minimum number of nights booked to receive the discount
<discountRate> [1] Discount %
<actionFrom> Valid until
<actionTo> Valid to
<isForActionPrices> May by applied to action prices
<isForNonRefundablePrices> May by applied to non-refundable prices
<objectKinds> Valid for these Object Kinds
 
<objectKind> Object kind
 
<obkId> Object kind ID

Sample output

<priceActions> 
    <firstMinutes> 
        <firstMinute> 
            <pfmId>1991</pfmId> 
            <minNumOfDaysBeforeArrival>10</minNumOfDaysBeforeArrival> 
            <discountRate>20</discountRate>
            <actionFrom>2017-10-12</actionFrom>
            <actionTo>2017-10-22</actionFrom>
            <isForActionPrices>true</isForActionPrices>
            <isForNonRefundablePrices>false</isForNonRefundablePrices>
            <objectKinds>
                <objectKind>
                    <obkId>1234567</obkId>
                </objectKind>
            </objectKinds>  
        </firstMinute> 
    </firstMinutes> 
    <lastMinutes> 
        <lastMinute> 
            <plmId>5111</plmId> 
            <maxNumOfHoursBeforeArrival>24</maxNumOfHoursBeforeArrival> 
            <discountRate>15</discountRate> 
            <actionFrom/>
            <actionTo>2017-10-22</actionFrom>
            <isForActionPrices>false</isForActionPrices>
            <isForNonRefundablePrices>false</isForNonRefundablePrices>
            <objectKinds>
                <objectKind>
                    <obkId>4444444</obkId>
                </objectKind>
                <objectKind>
                    <obkId>3434343</obkId>
                </objectKind>
            </objectKinds>  
        </lastMinute> 
    </lastMinutes> 
    <longTerms> 
        <longTerm> 
            <palId>13096</palId> 
            <minNumOfNights>1</minNumOfNights> 
            <discountRate>20</discountRate> 
            <actionFrom>2017-10-12</actionFrom>
            <actionTo/>
            <isForActionPrices>true</isForActionPrices>
            <isForNonRefundablePrices>true</isForNonRefundablePrices>
            <objectKinds/>  
        </longTerm> 
    </longTerms> 
</priceActions>