หน้านี้ได้รับการแปลโดย Cloud Translation API

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	กำหนดจำนวนห้องว่างในช่วงเวลาต่างๆ สำหรับที่พักแห่งเดียว
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>` ในข้อความ 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	ประเภทของจำนวนสินค้าคงคลังที่ระบุ ค่าที่ถูกต้องคือ `2`: จำนวนห้องว่างที่แน่นอน

ตัวอย่าง

พื้นที่โฆษณาที่เหลืออยู่

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

ตัวอย่าง

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>