OTA_HotelInvCountNotifRQ

Permintaan

Sintaksis

Pesan OTA_HotelInvCountNotifRQ menggunakan sintaksis berikut:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="message_ID"
                          TimeStamp="timestamp"
                          Version="3.0">
  <POS>
    <Source>
      <RequestorID ID="partner_key"/>
    </Source>
  </POS>
  <Inventories HotelCode="HotelID">
    <Inventory>
      <StatusApplicationControl Start="YYYY-MM-DD"
                                End="YYYY-MM-DD"
                                Mon="boolean_value"
                                Tue="boolean_value"
                                Weds="boolean_value"
                                Thur="boolean_value"
                                Fri="boolean_value"
                                Sat="boolean_value"
                                Sun="boolean_value"
                                InvTypeCode="RoomID"/>
      <InvCounts>
        <InvCount Count="integer" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Elemen dan atribut

Pesan OTA_HotelInvCountNotifRQ memiliki elemen dan atribut berikut:

Element / @Attribute Kejadian Jenis Deskripsi
OTA_HotelInvCountNotifRQ 1 Complex element Elemen root untuk pesan yang menentukan ketersediaan tarif kamar.
OTA_HotelInvCountNotifRQ / @xmlns 0..1 string (URI) Namespace XML.
OTA_HotelInvCountNotifRQ / @EchoToken 1 string ID unik untuk pesan permintaan ini. Nilai ini ditampilkan dalam pesan respons. Karakter yang diizinkan adalah a–z, A–Z, 0–9, _ (garis bawah), dan - (tanda hubung).
OTA_HotelInvCountNotifRQ / @TimeStamp 1 DateTime Tanggal dan waktu pembuatan pesan ini.
OTA_HotelInvCountNotifRQ / @Version 1 decimal Versi pesan OpenTravel.
OTA_HotelInvCountNotifRQ / POS 0..1 POS Penampung untuk menentukan akun partner bagi pesan ini (biasanya digunakan jika backend Anda menyediakan feed harga untuk beberapa akun partner).
OTA_HotelInvCountNotifRQ / POS/ Source 1 Source Wajib diisi jika <POS> ada. Container untuk <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Wajib diisi jika <POS> ada. Menentukan akun partner.
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID 1 string Akun partner untuk pesan ini. Nilai string ini adalah nilai Kunci partner yang tercantum di halaman Setelan akun di Pusat Pengelolaan Hotel.

Catatan: Jika Anda memiliki backend yang menyediakan feed untuk beberapa akun, nilai ini harus cocok dengan nilai atribut partner pesan Transaksi (Data Properti) dan nilai atribut ID di elemen <RequestorID> pesan <OTA_HotelRateAmountNotifRQ> Anda untuk akun yang sama.

OTA_HotelInvCountNotifRQ / Inventories 1 Inventories Penampung untuk satu atau beberapa elemen <Inventory>.
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode 1 string ID unik untuk properti. Nilai ini harus cocok dengan ID Hotel yang ditentukan menggunakan <id> di elemen <listing> feed Daftar Hotel. ID Hotel juga tercantum di Pusat Pengelolaan Hotel.
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory Menentukan jumlah kamar yang tersedia untuk berbagai rentang waktu untuk satu properti.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl 1 StatusApplicationControl Menentukan rentang tanggal, serta ID untuk jenis kamar (InvTypeCode).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start 1 Date Tanggal mulai (berdasarkan zona waktu properti), inklusif, dari rentang tanggal.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Tanggal akhir (berdasarkan zona waktu properti), inklusif, dari rentang tanggal. Harus sama atau lebih besar dari nilai start. Jika start dan end sama, maka update berlaku untuk tanggal tersebut.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon 0..1 boolean Tetapkan ke true atau 1 untuk menyertakan hari Senin secara eksplisit.

Jika ditetapkan ke true, hari lain yang tidak ditetapkan secara eksplisit ke true akan dikecualikan (sebenarnya, hari tersebut akan difilter dari tanggal dalam Start dan End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean Tetapkan ke true atau 1 untuk menyertakan hari Selasa secara eksplisit.

Jika ditetapkan ke true, hari lain yang tidak ditetapkan secara eksplisit ke true akan dikecualikan (sebenarnya, hari tersebut akan difilter dari tanggal dalam Start dan End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean Tetapkan ke true atau 1 untuk menyertakan hari Rabu secara eksplisit.

Jika ditetapkan ke true, hari lain yang tidak ditetapkan secara eksplisit ke true akan dikecualikan (sebenarnya, hari tersebut akan difilter dari tanggal dalam Start dan End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean Tetapkan ke true atau 1 untuk menyertakan hari Kamis secara eksplisit.

Jika ditetapkan ke true, hari lain yang tidak ditetapkan secara eksplisit ke true akan dikecualikan (sebenarnya, hari tersebut akan difilter dari tanggal dalam Start dan End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean Tetapkan ke true atau 1 untuk menyertakan hari Jumat secara eksplisit.

Jika ditetapkan ke true, hari lain yang tidak ditetapkan secara eksplisit ke true akan dikecualikan (sebenarnya, hari tersebut akan difilter dari tanggal dalam Start dan End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean Tetapkan ke true atau 1 untuk menyertakan hari Sabtu secara eksplisit.

Jika ditetapkan ke true, hari lain yang tidak ditetapkan secara eksplisit ke true akan dikecualikan (sebenarnya, hari tersebut akan difilter dari tanggal dalam Start dan End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean Tetapkan ke true atau 1 untuk menyertakan hari Minggu secara eksplisit.

Jika ditetapkan ke true, hari lain yang tidak ditetapkan secara eksplisit ke true akan dikecualikan (sebenarnya, hari tersebut akan difilter dari tanggal dalam Start dan End).

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string ID unik untuk inventaris (jenis kamar). Nilai ini dipetakan ke <RoomID> di pesan Transaksi (Data Properti).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Penampung untuk menentukan jumlah inventaris tunggal.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount Menentukan jumlah ruang tersedia yang dapat dipesan.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer Jumlah ruang yang tersedia yang dapat dipesan untuk jenis kamar tersebut. Nilai nol menunjukkan bahwa jenis kamar terjual habis. Nilai negatif diperlakukan sebagai nol.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

Jenis jumlah inventaris yang ditentukan. Nilai yang valid adalah:

  • 2: Ketersediaan pasti.

Contoh

Inventaris tersisa

Menetapkan 5 ruang yang tersisa untuk RoomID_1 pada tanggal yang ditentukan.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="5" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Inventaris terjual habis

Tandai RoomID_1 terjual habis pada tanggal yang ditentukan.

<OTA_HotelInvCountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
                          EchoToken="12345678"
                          TimeStamp="2023-07-13T20:50:37-05:00"
                          Version="3.0">
  <Inventories HotelCode="Property_1">
    <Inventory>
      <StatusApplicationControl Start="2023-07-18"
                                End="2023-07-23"
                                InvTypeCode="RoomID_1"/>
      <InvCounts>
        <InvCount Count="0" CountType="2"/>
      </InvCounts>
    </Inventory>
  </Inventories>
</OTA_HotelInvCountNotifRQ>

Respons

Sintaksis

Pesan OTA_HotelInvCountNotifRS menggunakan sintaksis berikut:

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="timestamp"
                          EchoToken="echo_token"
                          Version="3.0">
  <!-- Either Success or Errors will be populated. -->
  <Success/>
  <Errors>
    <Error Type="12" Status="NotProcessed" ShortText="issue_code">issue_description</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>

Elemen dan atribut

Pesan OTA_HotelInvCountNotifRS memiliki elemen dan atribut berikut:

Element / @Attribute Kejadian Jenis Deskripsi
1 Complex element Elemen root untuk respons terhadap pesan ketersediaan.
OTA_HotelInvCountNotifRS / @TimeStamp 1 DateTime Tanggal dan waktu pembuatan pesan ini.
OTA_HotelInvCountNotifRS / @EchoToken 1 string ID unik dari pesan OTA_HotelInvCountNotifRQ terkait.
OTA_HotelInvCountNotifRS / Success 0..1 Success Menunjukkan bahwa pesan OTA_HotelInvCountNotifRQ berhasil diproses.

<Success> atau <Errors> ada di setiap pesan.

OTA_HotelInvCountNotifRS / Errors 0..1 Errors Container untuk satu atau beberapa masalah yang ditemukan saat memproses pesan OTA_HotelInvCountNotifRQ.

<Success> atau <Errors> ada di setiap pesan.

OTA_HotelInvCountNotifRS / Errors / Error 1..n Error Deskripsi error yang ditemukan saat memproses pesan OTA_HotelInvCountNotifRQ. Detail tentang error ini dapat ditemukan di Pesan Error Status Feed.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer EWT OpenTravel Alliance (Jenis Peringatan Error) yang terkait dengan error. Hanya nilai 12 (Processing exception) yang digunakan.
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 integer OpenTravel Alliance ERR (Kode Error) yang terkait dengan error. Hanya nilai 450 (Unable to process) yang digunakan.
OTA_HotelInvCountNotifRS / Errors / Error / @Code 1 enum Status permintaan asli. Hanya nilai NotProcessed yang digunakan.
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText 1 string ID Google untuk masalah. Detail tentang error ini dapat ditemukan di Pesan Error Status Feed.

Contoh

Berhasil

Berikut adalah respons terhadap pesan OTA_HotelInvCountNotifRQ yang berhasil diproses.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Success/>
</OTA_HotelInvCountNotifRS>

Error

Berikut adalah respons terhadap pesan OTA_HotelInvCountNotifRQ yang tidak diproses karena error.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelInvCountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05"
                          TimeStamp="2023-07-23T20:50:37-05:00"
                          Version="3.0">
  <Errors>
    <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error>
  </Errors>
</OTA_HotelInvCountNotifRS>