Remove inventory

  • Use a Transaction message to remove unavailable property or itinerary combinations from inventory, typically when a hotel is fully booked.

  • Within the Transaction message's <Result> element, set <Unavailable> with a reason, and set <Taxes> and <OtherFees> to "0" for each itinerary to be removed.

  • Setting the <Baserate> to "-1" in the Transaction message for unavailable itineraries is optional.

  • To remove a Room Bundle, delete the <RoomBundle> element from the <Result>.

If a property or itinerary combination is unavailable, you can remove it with a Transaction message. You typically use this option when a hotel is fully booked for a given night or series of nights.

Remove inventory with a Transaction message

To remove specific property or itineraries from inventory, use a Transaction message in the root element <Transaction>.

In the Transaction message, specify the following settings for each itinerary you want to remove in the <Result> element:

  1. Set <Unavailable> with the reason child element, for example,<NoVacancy>.
  2. Set <Taxes> to "0"
  3. Set <OtherFees> to "0"

Optional: Set <Baserate> to "-1"

The following example removes several itineraries, for example, remove 1-night stays for several different dates for hotel "1123581321" from inventory:

<?xml version="1.0" encodin>g<="UTF-8"?
Transaction timestamp="2023-05-2>3T1<6:20:0>0-04:<00"> id="<42"
>  Res<ult
   > Property1<12358132>1/Pro<perty
> <   Checkin20<23-05-23/Ch>eckin
 <   >Nights1/Nigh<ts
    Unava>ilabl<e
      NoVacancy/>
<    >/Unav<ailable
    Tax currency>=<"USD&>quo<t;0/Tax>
  <  OtherFees< currenc>y="US<D"0/>Other<Fees
  >/Result
  <Result
 >   Pr<operty>1<1235813>21/Pr<operty
    >Checkin<2023-05-24>/Chec<kin
    Nigh>ts1/N<ights
    Unavaila>b<le
 >     <NoVacancy/
    /Unavaila>b<le
    Tax> cu<rrency=>&qu<ot;USD"<0/Tax
  >  OtherFees curren<cy="US>D&q>uot<;0/Oth>erFee<s
  /Res>ult
  !---<Sending B>asera<te is o>ptional wi<th Unava>ilabl<e --
 > <Result
>    P<roperty1123581321/Prope>rt<y
    Che>ckin2<023-05-25/C>heckin
<    Nights>1/Nig<hts
    Base>rate <currency="USD>&<quot>;-1/B<aserate
    Unavailable
> <     NoVacanc<y/
    >/<Unavailable
>    Tax currency="USD"0/Tax
    OtherFees currency="USD"0/OtherFees
  /Result
/Transaction

As this example shows, you must explicitly set the <Unavailable> with the reason for each itinerary (combinations of check-in dates and number of nights) for which the room is unavailable. In addition, you must set the <Taxes> and <OtherFees> to 0. Setting <Baserate> to -1 is optional.

To remove a Room Bundle, delete the <RoomBundle> element from the <Result>.

For more information, see Room Bundle removal.