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

การเปลี่ยนแปลงอัตรา

ภาพรวม

API นี้ให้คุณกำหนดวิธีใช้การดำเนินการแบบไดนามิกกับราคาเมื่อตรงตามเงื่อนไข เช่น การปรับราคาหรือเปิดใช้การคืนเงิน API นี้ต่างจาก Promotions API ที่ใช้ได้เฉพาะโปรโมชันที่มีสิทธิ์ซึ่งมีส่วนลดสูงสุดเท่านั้น แต่จะใช้การดำเนินการทุกอย่างเมื่อเป็นไปตามเงื่อนไขบางอย่าง ซึ่งรวมถึงการปรับราคาที่อาจเพิ่มราคาสุดท้ายในท้ายที่สุด

คำขอ

ไวยากรณ์

ข้อความ RateModifications ใช้ไวยากรณ์ต่อไปนี้

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="partner_key"
                      id="message_ID"
                      timestamp="timestamp">
  <HotelRateModifications hotel_id="HotelID" action="[overlay]">
    <ItineraryRateModification id="ModificationID" action="[delete]">
      <BookingDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </BookingDates>
      <BookingWindow min="integer" max="integer"/>
      <CheckinDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </CheckinDates>
      <CheckoutDates>
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </CheckoutDates>
      <Devices>
        <Device type="[desktop|tablet|mobile]"/>
      </Devices>
      <LengthOfStay min="integer" max="integer"/>
      <MinimumAmount before_discount="integer"/>
      <RatePlans>
        <RatePlan id="PackageID_1"/>
        <RatePlan id="PackageID_2"/>
      </RatePlans>
      <RoomTypes>
        <RoomType id="RoomID_1"/>
        <RoomType id="RoomID_2"/>
      </RoomTypes>
      <StayDates application="[all|any]">
        <DateRange start="YYYY-MM-DD" end="YYYY-MM-DD" days_of_week=""MTWHFSU_or_subset""/>
      </StayDates>
      <UserCountries type="[include|exclude]">
        <Country code="country_code"/>
      </UserCountries>
      <ModificationActions>
        <PriceAdjustment multiplier="float"/>
        <RateRule id="RateRuleID"/>
        <Refundable available="[false|true]"
                       refundable_until_days="number_of_days"
                       refundable_until_time="time"/>
        <Availability status="[unavailable]"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

องค์ประกอบและแอตทริบิวต์

ข้อความ RateModifications มีองค์ประกอบและแอตทริบิวต์ต่อไปนี้

องค์ประกอบ / @แอตทริบิวต์	จำนวนข้อผิดพลาด	ประเภท	คำอธิบาย
RateModifications	1	Complex element	องค์ประกอบรูทของข้อความการปรับราคา
RateModifications / @partner	1	string	บัญชีพาร์ทเนอร์สำหรับข้อความนี้ ค่าของสตริงนี้คือค่า "Partner key" ซึ่งแสดงอยู่ที่ หน้าการตั้งค่าบัญชีใน Hotel Center หมายเหตุ: หากคุณมีแบ็กเอนด์ที่มีฟีดสำหรับหลายบัญชี ค่านี้ต้องตรงกับค่าแอตทริบิวต์ `ID` ที่ระบุในองค์ประกอบ `<RequestorID>` ของข้อความ `<OTA_HotelRateAmountNotifRQ>` และ `<OTA_HotelAvailNotifRQ>` สำหรับบัญชีเดียวกัน
RateModifications / @id	1	string	ตัวระบุที่ไม่ซ้ำกันสำหรับข้อความคำขอนี้ ค่านี้จะแสดงในข้อความตอบกลับ อักขระที่อนุญาตคือ a-z, A-Z, 0-9, _ (ขีดล่าง) และ - (ขีดกลาง)
RateModifications / @timestamp	1	DateTime	วันที่และเวลาที่สร้างข้อความนี้
RateModifications / HotelRateModifications	0..n	HotelRateModifications	การปรับราคาสำหรับพร็อพเพอร์ตี้ การปรับราคาแต่ละครั้งจะมีผลกับที่พักรายการเดียว หมายเหตุ: หากใช้การแก้ไขราคาหลายรายการกับอัตราเดียวกันได้ ระบบจะใช้การแก้ไขทั้งหมด เราไม่รับประกันคำสั่งซื้อที่เฉพาะเจาะจง
RateModifications / HotelRateModifications / @hotel_id	1	string	ตัวระบุที่ไม่ซ้ำกันของที่พัก ค่านี้ต้องตรงกับรหัสโรงแรมที่ระบุโดยใช้ `<id>` ในองค์ประกอบ `<listing>` ในฟีดข้อมูลโรงแรม นอกจากนี้ รหัสโรงแรมยังแสดงอยู่ใน Hotel Center ด้วย
RateModifications / HotelRateModifications / @action	0..1	enum	หากไม่ได้ระบุ `action` ระบบจะเพิ่มหรืออัปเดตการแก้ไขภายในองค์ประกอบนี้สำหรับโรงแรมนี้ หากระบุ `action="overlay"` ระบบจะลบการแก้ไขที่กำหนดไว้ก่อนหน้านี้ทั้งหมดสำหรับโรงแรมแห่งนี้ก่อน จากนั้นระบบจะเขียนการแก้ไขที่ระบุที่นี่ หากใช้ `action="overlay"` และไม่ได้ระบุการแก้ไขภายในองค์ประกอบนี้ ระบบจะลบการแก้ไขทั้งหมดสำหรับโรงแรมนี้
RateModifications / HotelRateModifications / ItineraryRateModification	0..200	ItineraryRateModification	การแก้ไขอัตราเดียวสำหรับที่พัก หมายเหตุ: การแก้ไขราคาจะแก้ไขข้อบกพร่องได้ยาก และเราขอแนะนําให้ใช้แต่น้อย โปรดติดต่อผู้จัดการลูกค้าด้านเทคนิค (TAM) สำหรับ Use Case ที่ต้องมีการปรับราคามากกว่า 200 รายการ
RateModifications / HotelRateModifications / ItineraryRateModification / @id	1	string	ตัวระบุที่ไม่ซ้ำกันสำหรับการปรับเปลี่ยนราคา จำนวนอักขระสูงสุดที่อนุญาตคือ 40 ตัว อักขระที่อนุญาตคือ a-z, A-Z, 0-9, _ (ขีดล่าง), - (ขีดกลาง) และ (เครื่องหมายมหัพภาค)
RateModifications / HotelRateModifications / ItineraryRateModification / @action	0..1	enum	หากไม่ได้ระบุ และไม่ได้จัดเก็บการแก้ไขราคาที่มี `id` เดียวกัน ระบบจะเก็บการแก้ไขราคานี้ มิเช่นนั้น หากไม่ได้ระบุและจัดเก็บการแก้ไขราคาด้วย `id` เดียวกันไว้ ระบบจะอัปเดตการแก้ไขราคาที่มีอยู่ หากระบุไว้ ค่าต้องเป็น `"delete"` หากระบุ `"delete"` ระบบจะลบการแก้ไขราคาที่จัดเก็บไว้ด้วย `id` เดียวกัน เมื่อใช้ `"delete"` อย่าใส่องค์ประกอบย่อยใดๆ ใน `<ItineraryRateModification>` นอกจากนี้ `"delete"` ยังไม่ได้รับอนุญาตให้ใช้ร่วมกับ `<HotelRateModifications action="overlay"/>` ด้วย
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates	0..1	BookingDates	คอนเทนเนอร์สำหรับช่วงวันที่อย่างน้อย 1 ช่วงซึ่งกำหนดเมื่อต้องทำการจองเพื่อให้ใช้การแก้ไขราคาได้
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange	1..99	DateRange	ช่วงวันที่ที่ระบุเมื่อต้องทำการจองเพื่อให้การแก้ไขราคามีผล
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @start	0..1	Date	วันที่เริ่มต้น (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่ก่อนหน้าหรือวันที่เดียวกับ `end` หากไม่มีการระบุ `start` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่เริ่มต้น
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @end	0..1	Date	วันที่สิ้นสุด (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่เดียวกันหรือหลังจาก `start` หากไม่มีการระบุ `end` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่สิ้นสุด
RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates / DateRange / @days_of_week	0..1	string	วันของสัปดาห์ที่อนุญาตให้ใช้ในช่วงวันที่ หากไม่ระบุ ระบบจะอนุญาตให้ใช้ทุกวันในช่วงวันที่ อักขระแต่ละตัวในสตริงจะระบุวัน เช่น "MTWHF" จะระบุว่าระบบอนุญาตให้ใช้วันธรรมดาในช่วงวันที่ อักขระที่ใช้ได้มีดังนี้ `M` สำหรับวันจันทร์ `T` สำหรับวันอังคาร `W` สำหรับวันพุธ `H` สำหรับวันพฤหัสบดี `F` สำหรับวันศุกร์ `S` สำหรับวันเสาร์ `U` สำหรับวันอาทิตย์ คุณจะระบุชุดค่าผสมของอักขระแบบใดก็ได้
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow	0..1	BookingWindow	ระบุระยะเวลาที่ต้องมีการจองโดยสัมพันธ์กับวันที่เช็คอิน (ตามเขตเวลาของที่พัก) เช่น อาจกำหนดกรอบเวลาการจองเป็น 7 วันเป็นอย่างน้อย แต่ไม่เกิน 180 วันก่อนเช็คอิน
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow / @min	0..1	integer	จำนวนวันขั้นต่ำก่อนเช็คอินเมื่อต้องจองเพื่อให้การปรับราคามีผล หากไม่ได้ระบุ จะถือว่าไม่มีจำนวนขั้นต่ำ
RateModifications / HotelRateModifications / ItineraryRateModification / BookingWindow / @max	0..1	integer	จำนวนวันสูงสุดก่อนเช็คอินเมื่อจะทำการจองเพื่อให้การปรับราคามีผล หากไม่ได้ระบุ จะถือว่าไม่มีจำนวนสูงสุด
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates	0..1	CheckinDates	คอนเทนเนอร์สำหรับช่วงวันที่อย่างน้อย 1 ช่วงซึ่งกำหนดเมื่อต้องเลือกวันเช็คอินเพื่อให้การแก้ไขราคามีผล
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange	1..99	DateRange	ช่วงวันที่ที่ระบุเมื่อต้องเช็คอินเพื่อให้การแก้ไขราคามีผล ไม่จำเป็นต้องใช้องค์ประกอบนี้หากลบการปรับราคาอย่างน้อย 1 รายการ
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @start	0..1	Date	วันที่เริ่มต้น (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่ก่อนหน้าหรือวันที่เดียวกับ `end` หากไม่มีการระบุ `start` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่เริ่มต้น
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @end	0..1	Date	วันที่สิ้นสุด (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่เดียวกันหรือหลังจาก `start` หากไม่มีการระบุ `end` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่สิ้นสุด
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange / @days_of_week	0..1	string	วันของสัปดาห์ที่อนุญาตให้ใช้ในช่วงวันที่ หากไม่ระบุ ระบบจะอนุญาตให้ใช้ทุกวันในช่วงวันที่ อักขระแต่ละตัวในสตริงจะระบุวัน เช่น "MTWHF" จะระบุว่าระบบอนุญาตให้ใช้วันธรรมดาในช่วงวันที่ อักขระที่ใช้ได้มีดังนี้ `M` สำหรับวันจันทร์ `T` สำหรับวันอังคาร `W` สำหรับวันพุธ `H` สำหรับวันพฤหัสบดี `F` สำหรับวันศุกร์ `S` สำหรับวันเสาร์ `U` สำหรับวันอาทิตย์ คุณจะระบุชุดค่าผสมของอักขระแบบใดก็ได้
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates	0..1	CheckoutDates	คอนเทนเนอร์สำหรับช่วงวันที่อย่างน้อย 1 ช่วงซึ่งกำหนดเมื่อต้องเลือกวันเช็คเอาต์เพื่อให้การแก้ไขราคามีผล
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange	1..99	DateRange	ช่วงวันที่ที่ระบุเมื่อต้องเช็คเอาต์เพื่อให้การแก้ไขราคามีผล ไม่จำเป็นต้องใช้องค์ประกอบนี้หากลบการปรับราคาอย่างน้อย 1 รายการ
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @start	0..1	Date	วันที่เริ่มต้น (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่ก่อนหน้าหรือวันที่เดียวกับ `end` หากไม่มีการระบุ `start` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่เริ่มต้น
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @end	0..1	Date	วันที่สิ้นสุด (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่เดียวกันหรือหลังจาก `start` หากไม่มีการระบุ `end` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่สิ้นสุด
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange / @days_of_week	0..1	string	วันของสัปดาห์ที่อนุญาตให้ใช้ในช่วงวันที่ หากไม่ระบุ ระบบจะอนุญาตให้ใช้ทุกวันในช่วงวันที่ อักขระแต่ละตัวในสตริงจะระบุวัน เช่น "MTWHF" จะระบุว่าระบบอนุญาตให้ใช้วันธรรมดาในช่วงวันที่ อักขระที่ใช้ได้มีดังนี้ `M` สำหรับวันจันทร์ `T` สำหรับวันอังคาร `W` สำหรับวันพุธ `H` สำหรับวันพฤหัสบดี `F` สำหรับวันศุกร์ `S` สำหรับวันเสาร์ `U` สำหรับวันอาทิตย์ คุณจะระบุชุดค่าผสมของอักขระแบบใดก็ได้
RateModifications / HotelRateModifications / ItineraryRateModification / Devices	0..1	Devices	คอนเทนเนอร์สำหรับแสดงอุปกรณ์ของผู้ใช้ที่มีสิทธิ์แก้ไขราคา หากระบุไว้ ระบบจะใช้การปรับราคาในกรณีที่ผู้ใช้ตรงกับอุปกรณ์ในรายการที่ระบุไว้เท่านั้น หากไม่ระบุ จะไม่จำกัดการบังคับใช้การปรับราคา
RateModifications / HotelRateModifications / ItineraryRateModification / Devices / Device	1..3	Device	กำหนดอุปกรณ์ของผู้ใช้ 1 ประเภทที่มีสิทธิ์สำหรับการปรับราคา
RateModifications / HotelRateModifications / ItineraryRateModification / Devices / Device / @type	1	enum	ประเภทอุปกรณ์ ค่าต้องเป็น `desktop`, `tablet` หรือ `mobile`
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions	1	ModificationActions	การดำเนินการที่นำไปใช้กับราคาหากเป็นไปตามเงื่อนไขที่ระบุทั้งหมด
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / PriceAdjustment	0..1	PriceAdjustment	แก้ไขอัตราโดยการคูณทั้ง `AmountBeforeTax` และ `AmountAfterTax` ด้วยตัวคูณที่ระบุ
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / PriceAdjustment / @multiplier	1	float	ทั้ง `AmountBeforeTax` และ `AmountAfterTax` จะคูณด้วยค่านี้
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / RateRule	0..1	RateRule	แก้ไขอัตราโดยใช้รหัสกฎเกี่ยวกับอัตราที่ระบุกับอัตราดังกล่าว
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / RateRule / @id	1	string	รหัสนี้จะจับคู่ราคากับคำจำกัดความในไฟล์คำจำกัดความกฎเกี่ยวกับอัตรา หมายเหตุ: จำนวนอักขระสูงสุดสำหรับฟิลด์นี้คือ 40 ตัว แต่ละอัตราจะเชื่อมโยงกับกฎเกี่ยวกับอัตราได้เพียง 1 ข้อเท่านั้น หากมีการแก้ไขหลายรายการที่ใช้รหัสกฎเกี่ยวกับอัตรา ระบบจะกำหนดรหัสกฎเกี่ยวกับอัตราที่มีขนาดเล็กที่สุดเป็นพจนานุกรมให้กับราคา หากรหัสนี้ไม่ตรงกับกฎเกี่ยวกับอัตราในไฟล์คำจำกัดความของกฎเกี่ยวกับอัตรา ระบบจะถือว่าไม่มีสิทธิ์ ดูข้อมูลเกี่ยวกับตัวเลือก UI ของอัตราส่วนลดเฉพาะบุคคลได้ที่ บทความนี้
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable	0..1	Refundable	เขียนทับการคืนเงินของอัตราเป็นค่าที่ระบุ โปรดคำนึงถึงสิ่งต่อไปนี้เมื่อตั้งค่าแอตทริบิวต์ การดำเนินการแก้ไขนี้จะเขียนการตั้งค่า "ขอเงินคืนได้" ของราคาที่เข้าเกณฑ์โดยสมบูรณ์ ไม่ใช่แค่ในช่องที่ป้อนข้อมูล หากไม่ได้ตั้งค่า `available` หรือ `refundable_until_days` ไว้ ระบบจะไม่แสดงราคาห้องพักเป็นขอเงินคืนได้ หาก `available` คือ `0` หรือ `false` ระบบจะละเว้นแอตทริบิวต์อื่นๆ ราคาห้องพักจะไม่แสดงเป็นขอเงินคืนได้แม้จะมีการตั้งค่าแอตทริบิวต์อื่นๆ อย่างน้อย 1 รายการหรือทั้ง 2 รายการก็ตาม ขอแนะนำให้ตั้งค่า `refundable_until_time` หากไม่ได้ตั้งค่าไว้ ระบบจะใช้เวลาที่เร็วที่สุด (เที่ยงคืน)
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @available	1	boolean	(ต้องระบุ) ตั้งค่าเป็น `1` หรือ `true` เพื่อระบุว่าราคาห้องพักนี้ขอเงินคืนเต็มจำนวนได้หรือไม่ มิเช่นนั้นให้ตั้งค่าเป็น `0` หรือ `false`
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_days	0..1	integer	(ต้องระบุหาก `available` คือ `true`) ระบุจำนวนวันก่อนเช็คอินที่จะขอเงินคืนเต็มจำนวนได้ ค่าของ `refundable_until_days` ต้องเป็นจำนวนเต็มตั้งแต่ 0 ถึง 330
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable / @refundable_until_time	0..1	Time	(แนะนำหาก `available` คือ `true`) ระบุเวลาล่าสุดของวันตามเวลาท้องถิ่นของโรงแรมที่ผู้ใช้ขอเงินคืนเต็มจำนวนได้ คุณใช้ค่านี้ร่วมกับ `refundable_until_days` ได้ เช่น เพื่อระบุว่า "ขอเงินคืนได้จนถึงเวลา 16:00 น. ก่อนเช็คอิน 2 วัน" หากไม่ได้ตั้งค่า `refundable_until_time` ไว้ ค่าเริ่มต้นจะเป็นเที่ยงคืน
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Availability	0..1	Availability	เขียนทับความพร้อมให้บริการของราคาเป็นค่าที่ระบุ เรารองรับการตั้งอัตราเป็น `unavailable` เท่านั้น
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Availability / @status	1	enum	หากเป็น `status="unavailable"` ระบบจะพิจารณาราคาเสมือนว่าไม่พร้อมใช้งาน ไม่ว่าจะมีราคาที่ถูกต้องหรือไม่ก็ตาม
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay	0..1	LengthOfStay	กำหนดขีดจำกัดระยะเวลาในการเข้าพักที่จะใช้การปรับอัตรานี้ได้ การปรับราคาจะไม่มีผลเมื่อระยะเวลาในการเข้าพักอยู่นอกเหนือขีดจำกัดขั้นต่ำและสูงสุด
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @min	0..1	integer	จำนวนคืนขั้นต่ำที่เข้าพักซึ่งอนุญาตให้เข้าพักได้สำหรับการปรับราคา หากไม่ได้ระบุ จะถือว่าไม่มีจำนวนขั้นต่ำ
RateModifications / HotelRateModifications / ItineraryRateModification / LengthOfStay / @max	0..1	integer	จำนวนคืนสูงสุดที่อนุญาตที่เข้าพักเพื่อให้การปรับราคามีผล หากไม่ได้ระบุ จะถือว่าไม่มีจำนวนสูงสุด
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount	0..1	MinimumAmount	ระบุผลรวมขั้นต่ำของราคาห้องพักรายวัน (โดยใช้ `AmountBeforeTax` หรือ `AmountAfterTax` ที่สูงกว่า) ซึ่งต้องเกินเพื่อให้การปรับราคามีผล
RateModifications / HotelRateModifications / ItineraryRateModification / MinimumAmount / @before_discount	1	integer	ค่าที่ต้องจ่ายเพื่อให้ใช้การปรับอัตราได้
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans	0..1	RatePlans	คอนเทนเนอร์สำหรับรายการแพ็กเกจราคาที่ใช้การปรับราคา หากไม่มีการระบุ `<RatePlans>` การปรับราคาจะมีผลกับแพ็กเกจราคาทั้งหมด
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan	1..n	RatePlan	ระบุแพ็กเกจราคา แพ็กเกจราคาจะกำหนดโดยการรวมแพ็กเกจ ราคา และจำนวนห้องว่างตามที่ระบุไว้ในข้อความ Transaction (Property Data), OTA_HotelRateAmountNotifRQ และ OTA_HotelAvailNotifRQ รวมถึงตามที่ระบุโดย PackageID
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan / @id	1	string	ตัวระบุที่ไม่ซ้ำกันสำหรับแพ็กเกจราคา ค่านี้จะแมปกับค่า PackageID ใน `<PackageData>` ในข้อความ Transaction (Property Data) และในแอตทริบิวต์ `RatePlanCode` ของ `<StatusApplicationControl>` ทั้งในข้อความ `<OTA_HotelRateAmountNotifRQ>` และ `<OTA_HotelAvailNotifRQ>` จำนวนอักขระสูงสุดที่อนุญาตคือ 50 ตัว
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes	0..1	RoomTypes	คอนเทนเนอร์สำหรับรายการประเภทห้องพักที่ใช้การปรับราคา การปรับราคาจะมีผลกับ `<RoomType>` แต่ละรายการที่ระบุ หากไม่มีการระบุ `<RoomTypes>` การปรับราคาจะมีผลกับทุกห้อง
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType	1..n	RoomType	ระบุประเภทห้อง ประเภทห้องพักจะกำหนดไว้ในองค์ประกอบ `<RoomData>` ของข้อความ Transaction (Property Data) และมีการอ้างอิงโดยใช้ค่า `<RoomID>` (นอกจากนี้ ค่า `<RoomID>` ยังอ้างอิงโดยแอตทริบิวต์ `InvTypeCode` ในข้อความ OTA_HotelRateAmountNotifRQ)
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType / @id	1	string	ตัวระบุที่ไม่ซ้ำกันสำหรับห้องพัก (ประเภทห้องพัก) ค่านี้จะแมปกับ `<RoomID>` ในข้อความ Transaction (Property Data) จำนวนอักขระสูงสุดที่อนุญาตคือ 50 ตัว
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates	0..1	StayDates	คอนเทนเนอร์สำหรับช่วงวันที่อย่างน้อย 1 ช่วงซึ่งกำหนดวิธีใช้การแก้ไขราคา เช่น เพื่อรองรับราคาตามฤดูกาล
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / @application	1	enum	อธิบายว่าควรใช้การปรับราคาอย่างไร ค่าที่ใช้ได้มีดังนี้ `all`: ใช้การแก้ไขราคากับแต่ละคืนในแผนการเดินทาง หากวันที่ทั้งหมดในแผนการเดินทางทับซ้อนกับวันที่เข้าพัก `any`: ใช้การแก้ไขราคากับทุกคืนในแผนการเดินทาง หากวันที่ในแผนการเดินทางซ้อนทับกับวันที่ในช่วงวันที่เข้าพัก คุณต้องระบุแอตทริบิวต์นี้เสมอ
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange	1..99	DateRange	ช่วงวันที่ที่ระบุวันที่ที่จะใช้การแก้ไขราคา
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @start	0..1	Date	วันที่เริ่มต้น (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่ก่อนหน้าหรือวันที่เดียวกับ `end` หากไม่มีการระบุ `start` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่เริ่มต้น
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @end	0..1	Date	วันที่สิ้นสุด (ตามเขตเวลาของที่พัก) ของช่วงวันที่เข้าพัก โดยนับรวมวันที่ดังกล่าวด้วย วันที่นี้ต้องเป็นวันที่เดียวกันหรือหลังจาก `start` หากไม่มีการระบุ `end` ระบบจะถือว่าช่วงวันที่ดังกล่าวไม่มีขอบเขตวันที่สิ้นสุด
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates / DateRange / @days_of_week	0..1	string	วันของสัปดาห์ที่อนุญาตให้ใช้ในช่วงวันที่ หากไม่ระบุ ระบบจะอนุญาตให้ใช้ทุกวันในช่วงวันที่ อักขระแต่ละตัวในสตริงจะระบุวัน เช่น "MTWHF" จะระบุว่าระบบอนุญาตให้ใช้วันธรรมดาในช่วงวันที่ อักขระที่ใช้ได้มีดังนี้ `M` สำหรับวันจันทร์ `T` สำหรับวันอังคาร `W` สำหรับวันพุธ `H` สำหรับวันพฤหัสบดี `F` สำหรับวันศุกร์ `S` สำหรับวันเสาร์ `U` สำหรับวันอาทิตย์ คุณจะระบุชุดค่าผสมของอักขระแบบใดก็ได้
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries	0..1	UserCountries	หากระบุไว้ ระบบจะใช้การปรับราคาในกรณีที่ผู้ใช้อยู่ในประเทศที่ระบุเท่านั้น หากไม่ได้ระบุ ระบบจะใช้การปรับราคาโดยไม่คำนึงถึงสถานที่ตั้งของผู้ใช้
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / @type	0..1	enum	ประเภทของข้อกำหนด UserCountry ค่าที่ถูกต้องคือ `include` และ `exclude` หากตั้งค่า User countries `type` เป็น `include` การปรับราคาจะมีผลกับผู้ใช้จากประเทศที่ระบุไว้ หาก `type` User countries คือ `exclude` การปรับราคาจะมีผลกับผู้ใช้ที่อยู่นอกประเทศที่ระบุไว้ หากไม่ได้ตั้งค่า User countries `type` ระบบจะถือว่าเป็น `include` และการปรับราคาจะมีผลกับผู้ใช้จากประเทศที่ระบุไว้
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country	1..300	Country	ระบุประเทศของผู้ใช้ที่ได้รับอนุญาตให้ปรับราคา
RateModifications / HotelRateModifications / ItineraryRateModification / UserCountries / Country / @code	1	string	รหัสประเทศ CLDR เช่น `DE` หรือ `FR` โปรดทราบว่าในบางประเทศ รหัสประเทศ CLDR จะไม่เหมือนกับรหัสประเทศ 2 ตัวอักษรตามมาตรฐาน ISO รวมถึงไม่รองรับรหัสภูมิภาค CLDR

ตัวอย่าง

ข้อความพื้นฐาน

ตัวอย่างต่อไปนี้แสดงข้อความ RateModifications` พื้นฐาน

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-07-01" end="2023-07-31" days_of_week="MTWHF"/>
         <DateRange start="2023-09-01" end="2023-09-30"/>
      </BookingDates>
      <BookingWindow min="7" max="330"/>
      <CheckinDates>
         <DateRange start="2023-10-01" end="2023-10-31" days_of_week="FSU"/>
      </CheckinDates>
      <CheckoutDates>
         <DateRange start="2023-10-08" end="2023-11-07" days_of_week="FSU"/>
      </CheckoutDates>
      <Devices>
        <Device type="mobile"/>
        <Device type="tablet"/>
      </Devices>
      <LengthOfStay min="2" max="14"/>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <UserCountries>
        <Country code="US"/>
        <Country code="GB"/>
      </UserCountries>
      <ModificationActions>
        <PriceAdjustment multiplier="1.2"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

ลบการปรับราคา 1 รายการ

ตัวอย่างต่อไปนี้แสดงวิธีลบการปรับราคา 1 รายการสำหรับที่พัก

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1" action="delete"/>
  </HotelRateModifications>
</RateModifications>

ลบการปรับราคาทั้งหมด

ตัวอย่างต่อไปนี้แสดงวิธีลบการปรับราคาทั้งหมดสําหรับพร็อพเพอร์ตี้

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1" action="overlay"/>
</RateModifications>

วางซ้อนการแก้ไขอัตราทั้งหมด

ตัวอย่างต่อไปนี้แสดงวิธีวางซ้อน <HotelRateModifications> สำหรับพร็อพเพอร์ตี้ที่มีการปรับราคาใหม่อย่างน้อย 1 รายการ เมื่อ action="overlay" ระบบจะลบการแก้ไขอัตราที่จัดเก็บไว้ทั้งหมดก่อนที่จะจัดเก็บการปรับราคาที่ระบุไว้ในข้อความปัจจุบัน

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1" action="overlay"/>
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-09-01" end="2023-09-30"/>
      </BookingDates>
      <ModificationActions>
        <PriceAdjustment multiplier="1.2"/>
      </ModificationActions>
      <RoomTypes>
         <RoomType id="123"/>
         <RoomType id="456"/>
      </RoomTypes>
      <RatePlans>
         <RatePlan id="234"/>
         <RatePlan id="567"/>
      </RatePlans>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

การดำเนินการแก้ไขหลายรายการ

ตัวอย่างต่อไปนี้แสดงวิธีดําเนินการแก้ไขหลายรายการพร้อมกัน

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <BookingDates>
         <DateRange start="2023-01-01" end="2023-02-28"/>
      </BookingDates>
      <ModificationActions>
        <PriceAdjustment multiplier=".95"/>
        <Refundable available="true"
                    refundable_until_days="1"
                    refundable_until_time="12:00:00"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

ปิดแพ็กเกจราคาสำหรับประเทศของผู้ใช้

ตัวอย่างต่อไปนี้แสดงวิธีจำกัดแพ็กเกจราคาสำหรับผู้ใช้ชาวญี่ปุ่น (JP) เท่านั้น

<?xml version="1.0" encoding="UTF-8"?>
<RateModifications partner="account_xyz"
                   id="123_abc"
                   timestamp="2023-05-22T16:20:00-04:00">
  <HotelRateModifications hotel_id="Property_1">
    <ItineraryRateModification id="1">
      <RatePlans>
         <RatePlan id="jp_only"/>
      </RatePlans>
      <UserCountries type="exclude">
        <Country code="JP"/>
      </UserCountries>
      <ModificationActions>
        <Availability status="unavailable"/>
      </ModificationActions>
    </ItineraryRateModification>
  </HotelRateModifications>
</RateModifications>

การตอบกลับ

ไวยากรณ์

ข้อความ RateModificationsResponse ใช้ไวยากรณ์ต่อไปนี้

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="timestamp"
                    id="message_ID"
                    partner="partner_key">
  <!-- Either Success or Issues will be populated. -->
  <Success/>
  <Issues>
    <Issue code="issue_code" status="issue_type"><var>issue_description</var></Issue>
  </Issues>
</RateModificationsResponse>

องค์ประกอบและแอตทริบิวต์

ข้อความ RateModificationsResponse มีองค์ประกอบและแอตทริบิวต์ต่อไปนี้

องค์ประกอบ / @แอตทริบิวต์	จำนวนข้อผิดพลาด	ประเภท	คำอธิบาย
RateModifications	1	Complex element	องค์ประกอบรูทที่ระบุความสำเร็จหรือปัญหาของข้อความคำขอ RateModifications ที่ได้รับ
RateModificationsResponse / @timestamp	1	DateTime	วันที่และเวลาที่สร้างข้อความนี้
RateModificationsResponse / @id	1	string	ตัวระบุที่ไม่ซ้ำกันจากข้อความ RateModifications ที่เกี่ยวข้อง
RateModificationsResponse / @partner	1	string	บัญชีพาร์ทเนอร์สำหรับข้อความนี้
RateModificationsResponse / Success	0..1	Success	บ่งบอกว่าข้อความ RateModifications ได้รับการประมวลผลเรียบร้อยแล้วโดยไม่มีคำเตือน ข้อผิดพลาด หรือความล้มเหลว แต่ละข้อความจะมี `<Success>` หรือ `<Issues>` ปรากฏอยู่
RateModificationsResponse / Issues	0..1	Issues	คอนเทนเนอร์สำหรับปัญหาอย่างน้อย 1 รายการที่พบขณะประมวลผลข้อความ RateModifications แต่ละข้อความจะมี `<Success>` หรือ `<Issues>` ปรากฏอยู่
RateModificationsResponse / Issues / Issue	1..n	Issue	คำอธิบายของคำเตือน ข้อผิดพลาด หรือความล้มเหลวที่พบขณะประมวลผลข้อความ RateModifications ดูรายละเอียดเกี่ยวกับปัญหาเหล่านี้ได้ในข้อความแสดงข้อผิดพลาดของสถานะฟีด
RateModificationsResponse / Issues / Issue / @code	1	integer	ตัวระบุสำหรับปัญหา
RateModificationsResponse / Issues / Issue / @status	1	enum	ประเภทของปัญหาที่พบ ค่าที่ถูกต้องคือ `warning`, `error` และ `failure`

ตัวอย่าง

Success

การตอบกลับข้อความ RateModifications ที่ประมวลผลสำเร็จ

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="2023-05-22T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Success/>
</RateModificationsResponse>

ปัญหา

การตอบกลับข้อความ RateModifications ที่ยังไม่ได้ประมวลผลเนื่องจากพบข้อผิดพลาดมีดังนี้

<?xml version="1.0" encoding="UTF-8"?>
<RateModificationsResponse timestamp="2023-05-22T16:20:00-04:00"
                    id="12345678"
                    partner="partner_key">
  <Issues>
    <Issue code="1001" status="error">Example</Issue>
  </Issues>
</RateModificationsResponse>