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 |
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 |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue | 0..1 | boolean | Tetapkan ke true atau 1 untuk menyertakan hari Selasa secara eksplisit.
Jika ditetapkan ke |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds | 0..1 | boolean | Tetapkan ke true atau 1 untuk menyertakan hari Rabu secara eksplisit.
Jika ditetapkan ke |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur | 0..1 | boolean | Tetapkan ke true atau 1 untuk menyertakan hari Kamis secara eksplisit.
Jika ditetapkan ke |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri | 0..1 | boolean | Tetapkan ke true atau 1 untuk menyertakan hari Jumat secara eksplisit.
Jika ditetapkan ke |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat | 0..1 | boolean | Tetapkan ke true atau 1 untuk menyertakan hari Sabtu secara eksplisit.
Jika ditetapkan ke |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun | 0..1 | boolean | Tetapkan ke true atau 1 untuk menyertakan hari Minggu secara eksplisit.
Jika ditetapkan ke |
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:
|
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.
|
OTA_HotelInvCountNotifRS / Errors | 0..1 | Errors | Container untuk satu atau beberapa masalah yang ditemukan saat memproses pesan OTA_HotelInvCountNotifRQ .
|
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>