คำขอ
ไวยากรณ์
ข้อความ OTA_HotelInvCountNotifRQ
ใช้ไวยากรณ์ต่อไปนี้
<?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>
องค์ประกอบและแอตทริบิวต์
ข้อความ OTA_HotelInvCountNotifRQ
มีองค์ประกอบและแอตทริบิวต์ต่อไปนี้
องค์ประกอบ / @แอตทริบิวต์ | จำนวนข้อผิดพลาด | ประเภท | คำอธิบาย |
---|---|---|---|
OTA_HotelInvCountNotifRQ | 1 | Complex element | องค์ประกอบรูทของข้อความที่กำหนดความพร้อมใช้งานของราคาห้องพัก |
OTA_HotelInvCountNotifRQ / @xmlns | 0..1 | string (URI) | เนมสเปซ XML |
OTA_HotelInvCountNotifRQ / @EchoToken | 1 | string | ตัวระบุที่ไม่ซ้ำกันสำหรับข้อความคำขอนี้ ค่านี้จะแสดงในข้อความตอบกลับ อักขระที่อนุญาตคือ a-z, A-Z, 0-9, _ (ขีดล่าง) และ - (ขีดกลาง) |
OTA_HotelInvCountNotifRQ / @TimeStamp | 1 | DateTime | วันที่และเวลาที่สร้างข้อความนี้ |
OTA_HotelInvCountNotifRQ / @Version | 1 | decimal | เวอร์ชันข้อความของ OpenTravel |
OTA_HotelInvCountNotifRQ / POS | 0..1 | POS | คอนเทนเนอร์สำหรับการระบุบัญชีพาร์ทเนอร์ของข้อความนี้ (โดยปกติแล้วจะใช้หากแบ็กเอนด์แสดงฟีดราคาสำหรับบัญชีพาร์ทเนอร์หลายบัญชี) |
OTA_HotelInvCountNotifRQ / POS/ Source | 1 | Source | ต้องระบุหากมี <POS> ปรากฏอยู่ คอนเทนเนอร์สำหรับ <RequestorID> |
OTA_HotelInvCountNotifRQ / POS / RequestorID | 1 | RequestorID | ต้องระบุหากมี <POS> ปรากฏอยู่ กำหนดบัญชีพาร์ทเนอร์ |
OTA_HotelInvCountNotifRQ / POS / RequestorID / @ID | 1 | string | บัญชีพาร์ทเนอร์สำหรับข้อความนี้ ค่าสตริงนี้คือค่าคีย์พาร์ทเนอร์ที่แสดงใน
หน้าการตั้งค่าบัญชีใน Hotel Center
หมายเหตุ: หากคุณมีแบ็กเอนด์ที่มีฟีดสำหรับหลายบัญชี ค่านี้ต้องตรงกับค่าแอตทริบิวต์ |
OTA_HotelInvCountNotifRQ / Inventories | 1 | Inventories | คอนเทนเนอร์สําหรับองค์ประกอบ <Inventory> อย่างน้อย 1 รายการ |
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode | 1 | string | ตัวระบุที่ไม่ซ้ำกันของที่พัก ค่านี้ต้องตรงกับรหัสโรงแรมที่ระบุโดยใช้ <id> ในองค์ประกอบ <listing> ของฟีดข้อมูลโรงแรม นอกจากนี้ รหัสโรงแรมยังอยู่ใน Hotel Center ด้วย |
OTA_HotelInvCountNotifRQ / Inventories / Inventory | 1..n | Inventory | กำหนดจำนวนห้องว่างในช่วงเวลาต่างๆ สำหรับที่พักเดียว |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl | 1 | StatusApplicationControl | กำหนดช่วงวันที่ รวมทั้งตัวระบุสำหรับประเภทห้องพัก (InvTypeCode ) |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Start | 1 | Date | วันที่เริ่มต้น (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @End | 1 | Date | วันที่สิ้นสุด (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย ต้องเท่ากับหรือมากกว่าค่า start
หาก start และ end เท่ากัน การอัปเดตจะมีผลในวันที่ดังกล่าว |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Mon | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันจันทร์ไว้อย่างชัดเจน
หากตั้งค่าเป็น |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันอังคารไว้อย่างชัดเจน
หากตั้งค่าเป็น |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันพุธไว้อย่างชัดเจน
หากตั้งค่าเป็น |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันพฤหัสบดีไว้อย่างชัดเจน
หากตั้งค่าเป็น |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันศุกร์ไว้อย่างชัดเจน
หากตั้งค่าเป็น |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันเสาร์ไว้อย่างชัดเจน
หากตั้งค่าเป็น |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันอาทิตย์ไว้อย่างชัดเจน
หากตั้งค่าเป็น |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode | 1 | string | ตัวระบุที่ไม่ซ้ำกันสำหรับห้องพัก (ประเภทห้องพัก) ค่านี้จะแมปกับ <RoomID> ในข้อความ Transaction (Property Data) |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts | 1 | InvCounts | คอนเทนเนอร์สำหรับกำหนดจำนวนพื้นที่โฆษณาเดียว |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount | 1 | InvCount | กำหนดจำนวนห้องว่างที่จองได้ |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @Count | 1 | integer | จำนวนห้องว่างที่จองได้สำหรับประเภทห้องพัก หากค่าเป็น 0 แสดงว่าประเภทห้องพักนั้นเต็มแล้ว ระบบจะถือว่าค่าลบเป็น 0 |
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType | 1 | enum | ประเภทของจำนวนพื้นที่โฆษณาที่ระบุ ค่าที่ถูกต้องคือ
|
ตัวอย่าง
สินค้าคงคลังที่เหลืออยู่
กำหนดให้มีห้องเหลือ 5 ห้องสำหรับ RoomID_1
ในวันที่ที่ระบุ
<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>
สินค้าคงคลังที่ขายหมดแล้ว
ทําเครื่องหมายว่า RoomID_1
เต็มแล้วในวันที่ที่ระบุ
<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>
การตอบกลับ
ไวยากรณ์
ข้อความ OTA_HotelInvCountNotifRS
ใช้ไวยากรณ์ต่อไปนี้
<?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>
องค์ประกอบและแอตทริบิวต์
ข้อความ OTA_HotelInvCountNotifRS
มีองค์ประกอบและแอตทริบิวต์ต่อไปนี้
องค์ประกอบ / @แอตทริบิวต์ | จำนวนข้อผิดพลาด | ประเภท | คำอธิบาย |
---|---|---|---|
1 | Complex element | องค์ประกอบรูทสำหรับการตอบกลับข้อความความพร้อมจำหน่ายสินค้า | |
OTA_HotelInvCountNotifRS / @TimeStamp | 1 | DateTime | วันที่และเวลาที่สร้างข้อความนี้ |
OTA_HotelInvCountNotifRS / @EchoToken | 1 | string | ตัวระบุที่ไม่ซ้ำกันจากข้อความ OTA_HotelInvCountNotifRQ ที่เชื่อมโยง |
OTA_HotelInvCountNotifRS / Success | 0..1 | Success | บ่งบอกว่าประมวลผลข้อความ OTA_HotelInvCountNotifRQ เรียบร้อยแล้ว
แต่ละข้อความจะมี |
OTA_HotelInvCountNotifRS / Errors | 0..1 | Errors | คอนเทนเนอร์สำหรับปัญหาอย่างน้อย 1 รายการที่พบขณะประมวลผลข้อความ OTA_HotelInvCountNotifRQ
แต่ละข้อความจะมี |
OTA_HotelInvCountNotifRS / Errors / Error | 1..n | Error | คำอธิบายของข้อผิดพลาดที่พบขณะประมวลผลข้อความ OTA_HotelInvCountNotifRQ ดูรายละเอียดเกี่ยวกับข้อผิดพลาดเหล่านี้ได้ในข้อความแสดงข้อผิดพลาดของสถานะฟีด |
OTA_HotelInvCountNotifRS / Errors / Error / @Type | 1 | integer | OpenTravel Alliance EWT (ประเภทคำเตือนของข้อผิดพลาด) ที่เกี่ยวข้องกับข้อผิดพลาดนี้ ใช้เฉพาะค่า 12 (Processing exception) เท่านั้น |
OTA_HotelInvCountNotifRS / Errors / Error / @Code | 1 | integer | OpenTravel Alliance ERR (รหัสข้อผิดพลาด) ที่เกี่ยวข้องกับข้อผิดพลาดนี้
ใช้เฉพาะค่า 450 (Unable to process) เท่านั้น |
OTA_HotelInvCountNotifRS / Errors / Error / @Code | 1 | enum | สถานะของคำขอเดิม ใช้เฉพาะค่า NotProcessed เท่านั้น |
OTA_HotelInvCountNotifRS / Errors / Error / @ShortText | 1 | string | ตัวระบุ Google สำหรับปัญหา ดูรายละเอียดเกี่ยวกับข้อผิดพลาดเหล่านี้ได้ในข้อความแสดงข้อผิดพลาดของสถานะฟีด |
ตัวอย่าง
Success
การตอบกลับข้อความ OTA_HotelInvCountNotifRQ
ที่ประมวลผลเรียบร้อยแล้วมีดังนี้
<?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>
ข้อผิดพลาด
การตอบกลับข้อความ OTA_HotelInvCountNotifRQ
ที่ไม่ได้ประมวลผลเนื่องจากเกิดข้อผิดพลาดมีดังนี้
<?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>