คำขอ
ไวยากรณ์
ข้อความ OTA_HotelRateAmountNotifRQ
ใช้ไวยากรณ์ต่อไปนี้
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05"
EchoToken="message_ID"
TimeStamp="timestamp"
Version="3.0"
NotifType="[Overlay|Delta|Remove]"
NotifScopeType="[ProductRate]">
<POS>
<Source>
<RequestorID ID="partner_key"/>
</Source>
</POS>
<RateAmountMessages HotelCode="HotelID">
<RateAmountMessage>
<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"
RatePlanCode="PackageID"
RatePlanType="[26]" />
<Rates>
<Rate>
<BaseByGuestAmts>
<BaseByGuestAmt AmountBeforeTax="float"
AmountAfterTax="float"
CurrencyCode="currency"
NumberOfGuests="integer"/>
</BaseByGuestAmts>
<AdditionalGuestAmounts>
<AdditionalGuestAmount Amount="float"
AgeQualifyingCode="[10|8]"
MaxAge="integer"/>
</AdditionalGuestAmounts>
</Rate>
</Rates>
</RateAmountMessage>
</RateAmountMessages>
</OTA_HotelRateAmountNotifRQ>
องค์ประกอบและแอตทริบิวต์
ข้อความ OTA_HotelRateAmountNotifRQ
มีองค์ประกอบต่อไปนี้และ
ดังนี้
องค์ประกอบ / @แอตทริบิวต์ | จำนวนข้อผิดพลาด | ประเภท | คำอธิบาย |
---|---|---|---|
OTA_HotelRateAmountNotifRQ | 1 | Complex element | องค์ประกอบรูทของข้อความราคา |
OTA_HotelRateAmountNotifRQ / @xmlns | 0..1 | string (URI) | เนมสเปซ XML |
OTA_HotelRateAmountNotifRQ / @EchoToken | 1 | string | ตัวระบุที่ไม่ซ้ำกันสำหรับข้อความคำขอนี้ ระบบแสดงผลค่านี้
ในข้อความตอบกลับ อักขระที่อนุญาตคือ a-z , A-Z , 0-9 , _ (underscore) และ - (dash) |
OTA_HotelRateAmountNotifRQ / @TimeStamp | 1 | DateTime | วันที่และเวลาที่สร้างข้อความนี้ |
OTA_HotelRateAmountNotifRQ / @Version | 1 | decimal | เวอร์ชันข้อความของ OpenTravel |
OTA_HotelRateAmountNotifRQ / @NotifType | 0..1 | enum | ประเภทของการแจ้งเตือนที่จะใช้กับ
ค่าที่ใช้ได้มีดังนี้ หากต้องการทำความเข้าใจวิธีการทำงานของแอตทริบิวต์เหล่านี้ ให้ดูที่ ตัวอย่าง
|
OTA_HotelRateAmountNotifRQ / @NotifScopeType | 0..1 | enum | ขอบเขตของ ค่าที่ใช้ได้มีดังนี้
|
OTA_HotelRateAmountNotifRQ / POS | 0..1 | POS | คอนเทนเนอร์สำหรับระบุบัญชีพาร์ทเนอร์สำหรับข้อความนี้ (มักใช้หากแบ็กเอนด์แสดงฟีดราคาสำหรับ บัญชีพาร์ทเนอร์หลายบัญชี) |
OTA_HotelRateAmountNotifRQ / POS / Source | 1 | Source | ต้องระบุหากมี <POS> ปรากฏอยู่ คอนเทนเนอร์สำหรับ
<RequestorID> |
OTA_HotelRateAmountNotifRQ / POS / RequestorID | 1 | RequestorID | ต้องระบุหากมี <POS> ปรากฏอยู่ กําหนดพาร์ทเนอร์
ของคุณได้ |
OTA_HotelRateAmountNotifRQ / POS / RequestorID / @ID | 1 | string | บัญชีพาร์ทเนอร์สำหรับข้อความนี้ ค่าสตริงนี้คือค่า
"คีย์พาร์ทเนอร์" มูลค่าที่แสดงใน
หน้าการตั้งค่าบัญชีใน Hotel Center
หมายเหตุ: หากคุณมีแบ็กเอนด์ที่มีฟีดสำหรับ
บัญชี ค่านี้ต้องตรงกับ |
OTA_HotelRateAmountNotifRQ / RateAmountMessages | 1 | RateAmountMessages | คอลเล็กชันขององค์ประกอบ <RateAmountMessage> ที่
ให้กำหนดราคา |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / @HotelCode | 1 | string | ตัวระบุที่ไม่ซ้ำกันของที่พัก ค่านี้ต้องตรงกับแอตทริบิวต์ รหัสโรงแรมที่ระบุโดยใช้ <id> ใน องค์ประกอบ <listing> ในโรงแรม แสดงรายการฟีด นอกจากนี้ รหัสโรงแรมยังอยู่ใน Hotel Center ด้วย |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage | 1..n | RateAmountMessage | คอนเทนเนอร์สำหรับกำหนดราคาห้องพัก (ประเภทและราคาห้องพัก ชุดค่าผสมของแผนในช่วงวันที่) |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl | 1 | StatusApplicationControl | กำหนดช่วงวันที่ รวมทั้งตัวระบุสำหรับประเภทห้องพัก
(InvTypeCode ) และแพ็กเกจราคา (RatePlanCode ) |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Start | 1 | Date | วันที่เริ่มต้น (ตามเขตเวลาของที่พัก) ซึ่งก็คือ ช่วงวันที่ |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @End | 1 | Date | วันที่สิ้นสุด (ตามเขตเวลาของที่พัก) ของ
ช่วงวันที่ ต้องเท่ากับหรือมากกว่าค่า start
หาก start และ end เท่ากัน การอัปเดตจะมีผล
ถึงวันที่นั้น โปรดทราบว่า Google รองรับข้อมูลสูงสุด 3 ปี |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Mon | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมอย่างชัดเจน
วันจันทร์
หากตั้งค่าเป็น |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Tue | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมอย่างชัดเจน
วันอังคาร
หากตั้งค่าเป็น |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Weds | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมอย่างชัดเจน
วันพุธ
หากตั้งค่าเป็น |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Thur | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมอย่างชัดเจน
วันพฤหัสบดี
หากตั้งค่าเป็น |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Fri | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมอย่างชัดเจน
วันศุกร์
หากตั้งค่าเป็น |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sat | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมอย่างชัดเจน
วันเสาร์
หากตั้งค่าเป็น |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @Sun | 0..1 | boolean | ตั้งค่าเป็น true หรือ 1 เพื่อรวมอย่างชัดเจน
วันอาทิตย์
หากตั้งค่าเป็น |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @InvTypeCode | 1 | string | ตัวระบุที่ไม่ซ้ำกันสำหรับห้องพัก (ประเภทห้องพัก) ค่านี้จะแมป
กับ <RoomID> ในข้อความ Transaction (Property Data) |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanCode | 1 | string | ตัวระบุที่ไม่ซ้ำกันสำหรับแพ็กเกจราคา ตัวระบุนี้จะแมปกับ
<PackageID> ในธุรกรรม (ข้อมูลพร็อพเพอร์ตี้)
โดยจะมีการกำหนดและอ้างอิงถึงแพ็กเกจราคาเพิ่มเติม
ใน <StatusApplicationControl> ทั้ง
<OTA_HotelRateAmountNotifRQ> และ
<OTA_HotelAvailNotifRQ> ข้อความ |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / StatusApplicationControl / @RatePlanType | 0..1 | string | ตัวระบุที่ระบุประเภทของโมเดลราคา ARI ที่
จะมีผลกับการอัปเดตราคานี้ ควรระบุเฉพาะโดยใช้
ของ 26 เมื่อใช้รูปแบบการกำหนดราคาตาม LOS การยกเว้น
ของแอตทริบิวต์นี้ระบุว่านี่เป็นราคาต่อวัน
อัปเดต |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates | 0..1 | Rates | คอนเทนเนอร์สำหรับคอลเล็กชันขององค์ประกอบ <Rate> ถ้า
NotifType คือ "Remove" องค์ประกอบนี้ต้องไม่
ได้ หากไม่เป็นเช่นนั้น คุณต้องระบุองค์ประกอบนี้เพียงครั้งเดียว |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate | 1 | Rate | คอนเทนเนอร์สำหรับคอลเล็กชันของ <BaseByGuestAmts>
จากองค์ประกอบเหล่านี้ |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @RateTimeUnit | 0..1 | String | หน่วยซึ่งระบุระยะเวลาในการเข้าพัก ตัวเลือกเดียวที่รองรับ
ค่าคือ "Day" ซึ่งหมายความว่าระยะเวลาในการเข้าพักจะเท่ากับ
ระบุเป็นวัน
หากต้องการใช้การกำหนดราคาตาม LOS
|
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / @UnitMultiplier | 0..1 | Integer | จำนวนของ RateTimeUnits ที่เขียนความยาวของ
จะเข้าพักในราคานี้
ตัวอย่างเช่น หากค่า อัตราการเข้าพักที่ระบุไว้ใน หากต้องการใช้การกำหนดราคาตาม LOS
|
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts | 1 | BaseByGuestAmts | คอนเทนเนอร์สำหรับคอลเล็กชันของค่าใช้จ่ายพื้นฐาน |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt | 1..n | BaseByGuestAmt | ระบุราคาห้องพักในสกุลเงินที่ระบุไว้ ราคาอาจเป็น
ต่ออัตราการเข้าพักโดยใช้ <BaseByGuestAmt> หลายรายการ
และแต่ละองค์ประกอบมีค่า NumberOfGuests ต่างกัน
หากไม่เป็นเช่นนั้น ราคาจะเป็นไปตามจำนวนผู้เข้าพักสูงสุด
กำหนดโดย NumberOfGuests |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountBeforeTax | 0..1 | float |
ราคารายวันของห้องพักก่อนรวมภาษีและค่าธรรมเนียม ทั้ง หากใช้โปรโมชัน ค่า
ส่วนลดจะใช้กับ |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @AmountAfterTax | 0..1 | float | ราคารายวันของห้องพักหลังรวมภาษีที่เกี่ยวข้อง และ
หากระบุ AmountAfterTax ให้แยกต่อพร็อพเพอร์ตี้
ไม่ต้องส่ง <TaxFeeInfo> ข้อความ ช่วงเวลานี้
แอตทริบิวต์ใช้ร่วมกับ AmountBeforeTax ได้
เพื่อระบุทั้งราคาฐานและราคารวมที่แสดงต่อผู้ใช้ในประเทศ
บางภูมิภาค
คำเตือน: หากคุณใช้โปรโมชัน เราขอแนะนำอย่างยิ่ง
ไม่แนะนำให้ใช้ หมายเหตุ: หาก |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @CurrencyCode | 1 | enum | รหัสอักขระที่เป็นตัวอักษร 3 หลักในรูปแบบ ISO 4217 สำหรับหน่วยเงินตราเฉพาะ
โปรดดูรายการ สกุลเงิน |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / BaseByGuestAmts / BaseByGuestAmt / @NumberOfGuests | 0..1 | integer | จำนวนแขกสูงสุดที่รองรับด้วยราคานี้
ค่าเริ่มต้นจะเป็นผู้เข้าร่วม 2 คน หากไม่ได้ระบุไว้
โปรดทราบว่าหาก |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts | 0..1 | AdditionalGuestAmounts | คอนเทนเนอร์สำหรับการเรียกเก็บเงินสำหรับแขกเพิ่มเติม
ไวยากรณ์นี้มีประโยชน์หากราคาเพิ่มเติมสำหรับแขกหรือการเข้าพักสำหรับเด็ก
เปลี่ยนไปตามวันที่ ลองใช้
เช่น สมมติว่ามีการระบุราคาฐานเป็นเลข 1 และ 2 ผู้ใหญ่
|
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount | 0..n | AdditionalGuestAmount | ระบุราคาตามประเภทของแขก ระบุผ่าน
AgeQualifyingCode และอายุของแขก (หากมี)
ที่ระบุผ่าน MaxAge
|
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @AgeQualifyingCode | 1 | enum | กำหนดประเภทของแขกเพิ่มเติม ไม่ว่าจะเป็นผู้ใหญ่หรือเด็ก ถูกต้อง
ได้แก่
สามารถตั้งค่า ต้องระบุ |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @MaxAge | 0..1 | integer | ต้องระบุ MaxAge เมื่อ
AgeQualifyingCode คือ8 จะต้องไม่
ระบุเมื่อ AgeQualifyingCode คือ 10
การระบุค่า ค่าที่มากกว่า สามารถระบุช่วงอายุของเด็กหลายช่วงแยกกันได้
องค์ประกอบ |
OTA_HotelRateAmountNotifRQ / RateAmountMessages / RateAmountMessage / Rates / Rate / AdditionalGuestAmounts / AdditionalGuestAmount / @Amount | 1 | float | จำนวนเงินก่อนรวมภาษีและค่าธรรมเนียมที่เพิ่มลงในอัตราฐานของแต่ละรายการ
ผู้เข้าร่วมเพิ่มเติม
ภาษีและค่าธรรมเนียมที่ขึ้นอยู่กับผู้อยู่อาศัย ต้องระบุอายุผ่าน
องค์ประกอบ |
ตัวอย่าง
ส่วนนี้จะแสดงตัวอย่างโค้ดที่ไฮไลต์วิธีการดังนี้
- กำหนดราคาฐานและราคารวม
- เพิ่ม วางซ้อน และนำราคาออก
- เพิ่ม วางซ้อน และนำจำนวนแขกเพิ่มเติมออก
- ตั้งค่าอัตราตาม LOS
- เพิ่ม วางซ้อน และนำราคาที่อิงตาม LOS ออก
เมื่อคุณตั้งค่า add
, overlay
หรือ remove
ช่วงวันที่สามารถ
จะเท่ากันหรือต่างกันขึ้นอยู่กับเป้าหมายของคุณ ตัวอย่างเช่น คุณสามารถใช้
overlay
เพื่อตั้งระยะเวลาเพียงไม่กี่สัปดาห์สำหรับวันหยุดเดือนธันวาคม แทนที่จะกำหนด
ตั้งค่าช่วงทั้งหมดเป็น "อัตราการเพิ่ม" การดำเนินการนี้จะแทนที่อัตราการเข้าพัก
ในช่วงนี้เท่านั้น
ราคาต่อวัน
สำหรับห้องพักและแพ็กเกจราคาหนึ่งๆ จะมีอัตราการเข้าพักได้สูงสุด 50 รายการต่อ หากอัตราเหมือนกันสำหรับอัตราการเข้าพักทั้งหมด คุณควรส่ง อัตราการเข้าพักสูงสุดด้วยราคาที่กำหนด การดำเนินการดังกล่าว Google อนุมานว่า อัตราการเข้าพักที่ต่ำกว่าจะได้รับอัตราฐานเดียวกัน
กำหนดราคาฐานและราคารวม
ตัวอย่างที่ 1
ราคาฐาน (ไม่รวมภาษีหรือค่าธรรมเนียม) สำหรับอัตราการเข้าพักเริ่มต้น (ห้องพักแบบคู่) ด้วยวิธีนี้
โมเดล ภาษี และค่าธรรมเนียมสำหรับที่พักต้องกำหนดโดยใช้
<TaxFeeInfo>
ข้อความ ราคาฐานจะมีมากกว่า
โดดเด่นสำหรับผู้ใช้ที่ค้นหาจากบางภูมิภาค
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="100.00" CurrencyCode="USD"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
ตัวอย่างที่ 2
ราคาฐานและราคารวมสำหรับอัตราการเข้าพักเริ่มต้น (ห้องพักแบบคู่) ในโมเดลนี้ ภาษี
และค่าธรรมเนียมไม่ควรกำหนดแยกกันโดยใช้ <TaxFeeInfo>
ข้อความ ราคาฐานจะโดดเด่นขึ้นสำหรับผู้ใช้ที่ค้นหาจาก
บางภูมิภาค
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="100.00" AmountAfterTax="110.00" CurrencyCode="USD"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
ตัวอย่างที่ 3
ราคารวม (รวมภาษีและค่าธรรมเนียม) สำหรับอัตราการเข้าพักหลายรายการ ในโมเดลนี้
ไม่ควรกำหนดภาษีและค่าธรรมเนียมแยกกันโดยใช้ <TaxFeeInfo>
ข้อความ
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountAfterTax="100.00" CurrencyCode="USD" NumberOfGuests="1"/> <BaseByGuestAmt AmountAfterTax="110.00" CurrencyCode="USD" NumberOfGuests="2"/> <BaseByGuestAmt AmountAfterTax="120.00" CurrencyCode="USD" NumberOfGuests="3"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
ตัวอย่าง 4
ราคาฐานและราคารวมสำหรับประเภทห้องพักและแพ็กเกจราคาหลายรายการใน ช่วงวันที่ที่แตกต่างกัน
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-23" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="100.00" AmountAfterTax="110.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> <RateAmountMessage> <StatusApplicationControl Start="2020-05-01" End="2020-05-31" InvTypeCode="RoomID_2" RatePlanCode="PackageID_2"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="200.00" AmountAfterTax="220.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
เพิ่ม วางซ้อน และนำราคาออก
จำกัดจำนวนผลิตภัณฑ์ไว้ที่ 5,000 รายการ ได้แก่ ประเภทห้องพักและแพ็กเกจ
ชุดค่าผสมต่อพร็อพเพอร์ตี้ ใช้การแจ้งเตือน Overlay
หรือ Remove
ประเภทเพื่อนำผลิตภัณฑ์ที่กำหนดไว้ก่อนหน้านี้ออก
เพิ่มราคา
กําหนด NotifType
เป็น Delta
เพื่อเพิ่มราคาต่ออัตราการเข้าพักสำหรับ
RoomID_1 และ PackageID_1 ระหว่าง 20-10-2021 ถึง 31-12-2021 โปรดทราบว่า
Google รองรับข้อมูลนานสูงสุด 3 ปี
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Delta" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="100.00" CurrencyCode="USD" NumberOfGuests="1"/> <BaseByGuestAmt AmountBeforeTax="110.00" CurrencyCode="USD" NumberOfGuests="2"/> <BaseByGuestAmt AmountBeforeTax="120.00" CurrencyCode="USD" NumberOfGuests="3"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
วางซ้อนราคา
กำหนด NotifType
เป็น Overlay
เพื่อลบการเข้าพักทั้งหมดต่ออัตราการเข้าพัก
ราคาสำหรับ RoomID_1 และ PackageID_1 ระหว่างวันที่ 20-10-2021 ถึง 31-12-2021
แล้วแทนที่ด้วยราคาต่ออัตราการเข้าพักที่ระบุใหม่
เช่น หากข้อความนี้ส่งหลังจาก "เพิ่มราคา" ระบบจะลบอัตราการเข้าพัก 1, 2 และ 3 ออก และเฉพาะอัตราการเข้าพัก 1 ใหม่เท่านั้น อัตราที่จะจัดเก็บไว้ คุณยังสามารถกำหนดช่วงวันที่ที่สั้นลง (เช่น 20-12-2021 และ 2021-12-31) เพื่อแทนที่อัตราการเข้าพักเพียงบางส่วน ราคาในบางวัน เช่น วันหยุด
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Overlay" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="200.00" CurrencyCode="USD" NumberOfGuests="1"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
นําราคาออก
ตั้งค่า NotifType
เป็น Remove
เพื่อลบทั้งหมดต่ออัตราการเข้าพัก
ราคาสำหรับ RoomID_1 และ PackageID_1 ระหว่างวันที่ 20-10-2021 ถึง 31-12-2021
เช่น ถ้าข้อความนี้ส่งหลังจากตัวอย่างอื่น โดยไม่จัดเก็บราคาต่ออัตราการเข้าพัก
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Remove" NotifScopeType="ProductRate">> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
เพิ่ม วางซ้อน และนำจำนวนแขกเพิ่มเติมออก
เพิ่มจำนวน
กำหนด NotifType
เป็น Delta
เพื่อเพิ่มราคาฐานสำหรับ
อัตราการเข้าพัก 1 และ 2 และจำนวนแขกเพิ่มเติมสำหรับ RoomID_1 และ
PackageID_1 ระหว่าง 20-10-2021 ถึง 31-12-2021
ระบบจะคำนวณจำนวนเงินเพิ่มเติมสำหรับแขกจากราคาฐาน ซึ่งจะ จะขึ้นอยู่กับอัตราการเข้าพักในการค้นหาของผู้ใช้ ผู้ใช้ระบุ อัตราการเข้าพักต้องอยู่ภายในความจุของ RoomID_1
ในตัวอย่างนี้ จำนวนเงินสำหรับแขกเพิ่มเติมจะมีผลบังคับใช้ดังนี้
- $5 สำหรับเด็กอายุ 0 ถึง 10 ปี (นับรวมด้วย)
- $10 สำหรับเด็กอายุ 11 ถึง 17 ปี (รวม)
- $20 สำหรับผู้ใหญ่
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Delta" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="100.00" CurrencyCode="USD" NumberOfGuests="1"/> <BaseByGuestAmt AmountBeforeTax="110.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> <AdditionalGuestAmounts> <AdditionalGuestAmount Amount="5.00" AgeQualifyingCode="8" MaxAge="10" /> <AdditionalGuestAmount Amount="10.00" AgeQualifyingCode="8" MaxAge="17" /> <AdditionalGuestAmount Amount="20.00" AgeQualifyingCode="10" /> </AdditionalGuestAmounts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
จำนวนโฆษณาซ้อนทับ
กำหนด NotifType
เป็น Overlay
เพื่อลบการเข้าพักทั้งหมดต่ออัตราการเข้าพัก
ราคาและจำนวนแขกเพิ่มเติมทั้งหมดสำหรับ RoomID_1 และ PackageID_1
2021-10-20 ถึง 31-12-2021 และแทนที่ด้วย
ราคาต่ออัตราการเข้าพักที่ระบุและจำนวนเงินเพิ่มเติม
เช่น หากข้อความนี้ส่งหลังจาก "เพิ่มราคา" ระบบจะลบราคาฐาน 1 และ 2 และเฉพาะฐานใหม่ ระบบจะจัดเก็บอัตราการเข้าพัก 1 อัตรา ผู้เข้าร่วมเพิ่มเติมชุดก่อนหน้า จะถูกลบ และจะเก็บเฉพาะจำนวนเงินชุดใหม่เท่านั้น ในตอนนี้ จำนวนแขกเพิ่มเติมจะใช้ราคาสำหรับอัตราการเข้าพัก 1 ใหม่เป็น อัตราฐาน โปรดทราบว่าจะไม่มีผู้เข้าร่วมเพิ่มเติมหลังจากการอัปเดตนี้ ค่าใช้จ่ายที่กำหนดไว้สำหรับเด็ก
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Overlay" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="200.00" CurrencyCode="USD" NumberOfGuests="1"/> </BaseByGuestAmts> <AdditionalGuestAmounts> <AdditionalGuestAmount Amount="30.00" AgeQualifyingCode="10" /> </AdditionalGuestAmounts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
นำจำนวนเงินออก
กำหนด NotifType
เป็น Delete
เพื่อลบการเข้าพักทั้งหมดต่ออัตราการเข้าพัก
ราคาฐานและจำนวนผู้เข้าพักเพิ่มเติมทั้งหมดสำหรับ RoomID_1 และ PackageID_1
ระหว่าง 20-10-2021 ถึง 31-12-2021
เช่น ถ้าข้อความนี้ส่งหลังจากตัวอย่างอื่น ไม่มีราคาฐานต่ออัตราการเข้าพัก หรือจำนวนแขกเพิ่มเติม ที่สามารถจัดเก็บไว้ได้
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Remove" NotifScopeType="ProductRate">> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
นำออกเฉพาะจำนวนแขกเพิ่มเติม
โปรดตั้งค่า NotifType
เป็น Delta
ด้วย
<AdditionalGuestAmounts>
องค์ประกอบที่จะลบทั้งหมด
จำนวนแขกเพิ่มเติมสำหรับ RoomID_1 และ PackageID_1 โดยไม่ส่งผลต่อ
อัตราฐานระหว่างวันที่ 20-10-2021 ถึง 31-12-2021
เช่น ถ้าข้อความนี้ส่งหลังจากตัวอย่างอื่น ระบบจะจัดเก็บเฉพาะจำนวนเงินฐานเท่านั้น
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Delta" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1"/> <Rates> <Rate> <AdditionalGuestAmounts/> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
การกำหนดราคาตาม LOS
ตั้งค่าอัตราตาม LOS
ตัวอย่างที่ 1
กำหนดราคาสำหรับการเข้าพัก 1, 2 และ 3 คืนตั้งแต่วันที่ 18-05-2020 ราคารวมสำหรับการเข้าพัก 1, 2 และ 3 คืนในตัวอย่างนี้จะเท่ากับ $100 $180 และ $240 ตามลำดับ
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-18" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1" RatePlanType="26"/> <Rates> <Rate UnitMultiplier="1" RateTimeUnit="Day"> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="100.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> </Rate> <Rate UnitMultiplier="2" RateTimeUnit="Day"> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="90.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> </Rate> <Rate UnitMultiplier="3" RateTimeUnit="Day"> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="80.00" CurrencyCode="USD" NumberOfGuests="2" /> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
เพิ่ม วางซ้อน และนำราคาที่อิงตาม LOS ออก
เพิ่มระยะเวลาในการเข้าพัก
การกำหนดราคาตาม LOS ทำให้การดำเนินการ Delta
อนุญาตให้มีราคา
อัปเดตส่วนน้อยสำหรับช่วงวันที่เช็คอินที่ระบุไว้ใน
<StatusApplicationControl>
และระยะเวลาเข้าพักทุกช่วง
ที่ระบุโดยองค์ประกอบย่อย Rate
แต่ละรายการ
UnitMultiplier
อัตราการเข้าพักทั้งหมดสำหรับวันที่เช็คอินและระยะเวลาในการเข้าพักที่เกี่ยวข้องแต่ละรายการ ต้องระบุอัตรา
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0" NotifType="Delta" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-18" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1" RatePlanType="26"/> <Rates> <Rate UnitMultiplier="3" RateTimeUnit="Day"> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="80.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
ระยะเวลาในการเข้าพักซ้อนทับ
การกำหนดราคาตาม LOS มีการดำเนินการ Overlay
แทนที่อัตราสำหรับระยะเวลาในการเข้าพักของผลิตภัณฑ์และวันที่เช็คอิน
ช่วงที่ระบุใน <StatusApplicationControl>
ข้อความนี้แสดงราคาต่ออัตราการเข้าพักสำหรับระยะเวลาในการเข้าพักทั้งหมดใน ระบบจะนำวันที่เข้าพักที่ระบุไว้ออก และแทนที่ด้วยห้องพักแบบคู่ ราคาที่กำหนดไว้สำหรับระยะเวลาในการเข้าพัก 3 เท่านั้น
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2020-05-19T20:50:37-05:00" Version="3.0" NotifType="Overlay" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2020-05-18" End="2020-05-18" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1" RatePlanType="26"/> <Rates> <Rate UnitMultiplier="3" RateTimeUnit="Day"> <BaseByGuestAmts> <BaseByGuestAmt AmountBeforeTax="80.00" CurrencyCode="USD" NumberOfGuests="2"/> </BaseByGuestAmts> </Rate> </Rates> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
นําระยะเวลาในการเข้าพักออก
เมื่อใช้การกำหนดราคาแบบ LOS การดำเนินการ Remove
จะนำราคาออก
สำหรับระยะเวลาในการเข้าพักของผลิตภัณฑ์และช่วงวันที่เช็คอินที่ระบุไว้ใน
<StatusApplicationControl>
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0" NotifType="Remove" NotifScopeType="ProductRate"> <RateAmountMessages HotelCode="Property_1"> <RateAmountMessage> <StatusApplicationControl Start="2021-10-20" End="2021-12-31" InvTypeCode="RoomID_1" RatePlanCode="PackageID_1" RatePlanType="26"/> </RateAmountMessage> </RateAmountMessages> </OTA_HotelRateAmountNotifRQ>
การตอบกลับ
ไวยากรณ์
ข้อความ OTA_HotelRateAmountNotifRS
ใช้ไวยากรณ์ต่อไปนี้
<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelRateAmountNotifRS 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_HotelRateAmountNotifRS>
องค์ประกอบและแอตทริบิวต์
ข้อความ OTA_HotelRateAmountNotifRS
มีข้อมูลต่อไปนี้
องค์ประกอบและแอตทริบิวต์:
องค์ประกอบ / @แอตทริบิวต์ | จำนวนข้อผิดพลาด | ประเภท | คำอธิบาย |
---|---|---|---|
OTA_HotelRateAmountNotifRS | 1 | Complex element | องค์ประกอบรูทสำหรับการตอบกลับข้อความความพร้อมจำหน่ายสินค้า |
OTA_HotelRateAmountNotifRS / @TimeStamp | 1 | DateTime | วันที่และเวลาที่สร้างข้อความนี้ |
OTA_HotelRateAmountNotifRS / @EchoToken | 1 | string | ตัวระบุที่ไม่ซ้ำกันจาก
OTA_HotelRateAmountNotifRQ ข้อความ |
OTA_HotelRateAmountNotifRS / Success | 0..1 | Success | ระบุว่าข้อความ OTA_HotelRateAmountNotifRQ ถูก
ประมวลผลสำเร็จแล้ว
|
OTA_HotelRateAmountNotifRS / Errors | 0..1 | Errors | คอนเทนเนอร์สำหรับปัญหาอย่างน้อย 1 รายการที่พบขณะประมวลผล
OTA_HotelRateAmountNotifRQ ข้อความ
|
OTA_HotelRateAmountNotifRS / Errors / Error | 1..n | Error | คำอธิบายของข้อผิดพลาดที่พบขณะประมวลผล
OTA_HotelRateAmountNotifRQ ข้อความ ดูรายละเอียดเกี่ยวกับ
ดูข้อผิดพลาดได้ในข้อความแสดงข้อผิดพลาดของสถานะฟีด |
OTA_HotelRateAmountNotifRS / Errors / Error / @Type | 1 | integer | OpenTravel Alliance EWT (ประเภทคําเตือนข้อผิดพลาด) ที่เกี่ยวข้องกับ
ใช้เฉพาะค่า 12 (Processing exception) เท่านั้น |
OTA_HotelRateAmountNotifRS / Errors / Error / @Code | 1 | integer | OpenTravel Alliance ERR (รหัสข้อผิดพลาด) ที่เกี่ยวข้องกับข้อผิดพลาดนี้
ใช้เฉพาะค่า 450 (Unable to process) เท่านั้น |
OTA_HotelRateAmountNotifRS / Errors / Error / @Code | 1 | enum | สถานะของคำขอเดิม เฉพาะค่า
ใช้งาน NotProcessed |
OTA_HotelRateAmountNotifRS / Errors / Error / @ShortText | 1 | string | ตัวระบุ Google สำหรับปัญหา รายละเอียดเกี่ยวกับข้อผิดพลาดเหล่านี้อาจ ที่พบในข้อความแสดงข้อผิดพลาดของสถานะฟีด |
ตัวอย่าง
สำเร็จ
การตอบกลับการประมวลผลสำเร็จมีดังนี้ ข้อความ OTA_HotelRateAmountNotifRQ
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0"> <Success/> </OTA_HotelRateAmountNotifRS>
ข้อผิดพลาด
การตอบกลับข้อความ OTA_HotelRateAmountNotifRQ เป็นข้อความต่อไปนี้ ประมวลผลเนื่องจากมีข้อผิดพลาด
<?xml version="1.0" encoding="UTF-8"?> <OTA_HotelRateAmountNotifRS xmlns="http://www.opentravel.org/OTA/2003/05" EchoToken="12345678" TimeStamp="2021-10-20T20:50:37-05:00" Version="3.0"> <Errors> <Error Type="12" Code="450" Status="NotProcessed" ShortText="8001">Example</Error> </Errors> </OTA_HotelRateAmountNotifRS>