OTA_HotelInvCountNotifRQ

คำขอ

ไวยากรณ์

ข้อความ 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

หมายเหตุ: หากคุณมีแบ็กเอนด์ที่มีฟีดสำหรับ บัญชี ค่านี้ต้องตรงกับ partner ของข้อความ Transaction (Property Data) และฟังก์ชัน ID ในคอลัมน์ องค์ประกอบ <RequestorID> ของ <OTA_HotelRateAmountNotifRQ> ข้อความสำหรับ ของคุณได้

OTA_HotelInvCountNotifRQ / Inventories 1 Inventories คอนเทนเนอร์สําหรับ <Inventory> อย่างน้อย 1 รายการ จากองค์ประกอบเหล่านี้
OTA_HotelInvCountNotifRQ / Inventories / @HotelCode 1 string ตัวระบุที่ไม่ซ้ำกันของที่พัก ค่านี้ต้องตรงกับแอตทริบิวต์ รหัสโรงแรมที่ระบุโดยใช้ <id> ใน<listing> ของฟีดข้อมูลโรงแรม รหัสโรงแรม มีรายชื่ออยู่ใน Hotel Center ด้วย
OTA_HotelInvCountNotifRQ / Inventories / Inventory 1..n Inventory กำหนดจำนวนห้องว่างในช่วงเวลาต่างๆ สำหรับที่พัก 1 แห่ง
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 เพื่อรวมวันจันทร์ไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น ถูกกรองออกจากวันที่ภายใน Start และ End)

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Tue 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันอังคารไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น ถูกกรองออกจากวันที่ภายใน Start และ End)

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Weds 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันพุธไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น ถูกกรองออกจากวันที่ภายใน Start และ End)

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Thur 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันพฤหัสบดีไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น ถูกกรองออกจากวันที่ภายใน Start และ End)

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Fri 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันศุกร์ไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น ถูกกรองออกจากวันที่ภายใน Start และ End)

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sat 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันเสาร์ไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น ถูกกรองออกจากวันที่ภายใน Start และ End)

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @Sun 0..1 boolean ตั้งค่าเป็น true หรือ 1 เพื่อรวมวันอาทิตย์ไว้อย่างชัดเจน

หากตั้งค่าเป็น true วันอื่นๆ ของสัปดาห์ที่ไม่ใช่ มีการตั้งค่าเป็น true อย่างชัดเจนซึ่งได้รับการยกเว้น ถูกกรองออกจากวันที่ภายใน Start และ End)

OTA_HotelInvCountNotifRQ / Inventories / Inventory / StatusApplicationControl / @InvTypeCode 1 string ตัวระบุที่ไม่ซ้ำกันสำหรับห้องพัก (ประเภทห้องพัก) ค่านี้จะแมป ไปยัง <RoomID> ในธุรกรรม (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 แสดงว่าประเภทห้องพักนั้นเต็มแล้ว A ลบ ระบบจะถือว่าค่าเป็น 0
OTA_HotelInvCountNotifRQ / Inventories / Inventory / InvCounts / InvCount / @CountType 1 enum

ประเภทของจำนวนพื้นที่โฆษณาที่ระบุ ค่าที่ถูกต้องคือ

  • 2: ความพร้อมใช้งานที่แน่นอน

ตัวอย่าง

สินค้าคงคลังที่เหลืออยู่

กำหนดให้มีห้องเหลือ 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 ถูก ประมวลผลสำเร็จแล้ว

<Success> หรือ <Errors> อาจเป็น ที่อยู่ในแต่ละข้อความ

OTA_HotelInvCountNotifRS / Errors 0..1 Errors คอนเทนเนอร์สำหรับปัญหาอย่างน้อย 1 รายการที่พบขณะประมวลผล OTA_HotelInvCountNotifRQ ข้อความ

<Success> หรือ <Errors> อาจเป็น ที่อยู่ในแต่ละข้อความ

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 สำหรับปัญหา รายละเอียดเกี่ยวกับข้อผิดพลาดเหล่านี้อาจ ที่พบในข้อความแสดงข้อผิดพลาดของสถานะฟีด

ตัวอย่าง

สำเร็จ

การตอบกลับการประมวลผลสำเร็จมีดังนี้ 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>