הסרת המלאי

אם שילוב של נכס או מסלול נסיעה לא זמין, אפשר להסיר אותו באמצעות הודעה על עסקה. בדרך כלל משתמשים באפשרות הזו כשמלון תפוס במלואו בלילה מסוים או בסדרה של לילות.

הסרת מלאי באמצעות הודעת עסקה

כדי להסיר מלאי ספציפי של נכסים או מסלולי נסיעה, משתמשים בהודעת טרנזקציה (Transaction) ברכיב הבסיס <Transaction>.

בהודעת הטרנזקציה, מציינים את ההגדרות הבאות לכל מסלול שרוצים להסיר ברכיב <Result>:

  1. מגדירים את <Unavailable> באמצעות רכיב הבן של הסיבה, לדוגמה,<NoVacancy>.
  2. מגדירים את <Taxes> לערך '0'
  3. מגדירים את <OtherFees> לערך '0'

אופציונלי: מגדירים את <Baserate> כ-'-1'

בדוגמה הבאה מוסרים כמה מסלולי נסיעה, למשל, הסרה של אירוח ללילה אחד בכמה תאריכים שונים במלון '1123581321' מהמלאי:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-05-23T16:20:00-04:00" id="42">
  <Result>
    <Property>1123581321</Property>
    <Checkin>2023-05-23</Checkin>
    <Nights>1</Nights>
    <Unavailable>
      <NoVacancy/>
    </Unavailable>
    <Tax currency="USD">0</Tax>
    <OtherFees currency="USD">0</OtherFees>
  </Result>
  <Result>
    <Property>1123581321</Property>
    <Checkin>2023-05-24</Checkin>
    <Nights>1</Nights>
    <Unavailable>
      <NoVacancy/>
    </Unavailable>
    <Tax currency="USD">0</Tax>
    <OtherFees currency="USD">0</OtherFees>
  </Result>
  <!---Sending <Baserate> is optional with <Unavailable> -->
  <Result>
    <Property>1123581321</Property>
    <Checkin>2023-05-25</Checkin>
    <Nights>1</Nights>
    <Baserate currency="USD">-1</Baserate>
    <Unavailable>
      <NoVacancy/>
    </Unavailable>
    <Tax currency="USD">0</Tax>
    <OtherFees currency="USD">0</OtherFees>
  </Result>
</Transaction>

כפי שמוצג בדוגמה הזו, צריך להגדיר את <Unavailable> באופן מפורש עם הסיבה לכל מסלול נסיעה (שילובים של תאריכי צ'ק אין ומספר הלילות) שבהם החדר לא זמין. בנוסף, צריך להגדיר את הערכים <Taxes> ו-<OtherFees> ל-0. הגדרת <Baserate> לערך -1 היא אופציונלית.

כדי להסיר חבילת חדרים, מוחקים את הרכיב <RoomBundle> מהרכיב <Result>.

מידע נוסף זמין במאמר הסרה של חבילת חדרים.