SetProduct

Request URL: https://supply.agoda.com/api?apiKey=ADDYOURAPIKEYHERE

SetProduct Intro

This call allow partners to update room setting (such as Maximum number of person per room, minimum rate threshold of the room) and rateplan restriction (such as minimum and maximum night of stay, minimum and maximum days purchase in advance).

Room Level

  • any value set at Room Level affects Price parameters for SetARI call. SetProduct min_rate = ‘100’, SetARI ‘prices’ default, single, double &/or full Rate must be > 100 SetProduct num_persons = ‘3’, SetARI ‘prices’ default or single, double & full Rate is Mandatory * SetProduct num_persons = ‘2’, SetARI ‘prices’ default or single & double Rate is Mandatory

Rate Plan Level

  • all items in this section will apply the restriction to existing cached ARI at Rate Plan level for all dates. However, min_los & max_los can also be set via SetARI at date level and will override cached restrictions for the specified room, Rate Plan and date only.

Example Senerios

  • Update # 1.
    SetProduct min_los = ‘2’ this will apply minLOS ‘2’ restrictions to all dates for room, rates & dates associated with the specified rate plan.
    - Update # 2.
    SetARI min = ‘3’ for a specific room ID, Rate Plan ID & date. This will change minLOS to ‘3’ only for the specific room, Rateplan & date only until it is override by a subsequent minLOS update via SetARI or SetProduct.

Example Request

curl --location 'https://supply.agoda.com/api?apiKey=ADDYOURAPIKEYHERE' \
            --header 'Content-Type: text/xml' \
            --data '<?xml version="1.0" encoding="UTF-8"?>
            <request timestamp="1436931804" type="8">
                <criteria property_id="10730279" currency="THB">
                    <rooms>
                        <room room_id="129340033" num_persons="3" min_rate="100.0"/>
                    </rooms>
                    <rateplans>
                        <rateplan rateplan_id="3392615" min_los="1" max_los="1" min_adv_days="1" max_adv_days="1"/>
                        <rateplan rateplan_id="3392615" min_los="1" max_los="1"/>
                        <rateplan rateplan_id="3392615" min_adv_days="1" max_adv_days="1"/>
                    </rateplans>
                </criteria>
            </request>'

Example Response

<result timestamp="1587536688255">
                <success/>
            </result>