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:

Elemen / @Atribut Kejadian Type 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 Container 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 jika <POS> ada. Penampung untuk <RequestorID>.
OTA_HotelInvCountNotifRQ / POS / RequestorID 1 RequestorID Wajib 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> 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 rentang waktu yang berbeda 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), termasuk rentang tanggal.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Tanggal akhir (berdasarkan zona waktu properti), termasuk rentang tanggal. Harus sama atau lebih besar dari nilai start. Jika start dan end sama, pembaruan 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 dalam seminggu 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 dalam seminggu 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 dalam seminggu 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 dalam seminggu 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 dalam seminggu 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 dalam seminggu 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 dalam seminggu 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 yang 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 sudah 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 5rooms left forRoomID_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 yang terjual habis

Tandai RoomID_1 habis terjual 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:

Elemen / @Atribut Kejadian Type 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 terjadi saat memproses pesan OTA_HotelInvCountNotifRQ. Detail tentang error ini dapat ditemukan di Pesan Error Status Feed.
OTA_HotelInvCountNotifRS / Errors / Error / @Type 1 integer OpenTravel Alliance EWT (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>