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 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 di 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 untuk 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 Container 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), inklusif, dari rentang tanggal.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End 1 Date Tanggal akhir (berdasarkan zona waktu properti), inklusif, dari rentang tanggal. Harus sama dengan 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 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 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 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 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 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 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 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> dalam pesan Transaksi (Data Properti).
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts 1 InvCounts Penampung untuk menentukan satu jumlah inventaris.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount 1 InvCount Menentukan jumlah kamar yang tersedia dan dapat dipesan.
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count 1 integer Jumlah kamar yang tersedia yang dapat dipesan untuk jenis kamar. Nilai nol menunjukkan bahwa jenis kamar tersebut 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 yang tersisa

Menetapkan 5 kamar 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:

Elemen / @Atribut 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 yang 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 dialami 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>