হার পরিবর্তন

ওভারভিউ

এই এপিআই আপনাকে যখনই শর্তগুলি পূরণ করা হয়, যেমন মূল্য সামঞ্জস্য করা বা ফেরতযোগ্যতা সক্ষম করার মতো একটি হারে গতিশীলভাবে অ্যাকশন প্রয়োগ করার উপায়গুলি সংজ্ঞায়িত করতে দেয়৷ প্রচার API এর বিপরীতে, যেটি শুধুমাত্র গভীরতম ছাড়ের সাথে যোগ্য প্রচারগুলি প্রয়োগ করতে পারে, এই 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 বার্তাটিতে নিম্নলিখিত উপাদান এবং বৈশিষ্ট্য রয়েছে:

উপাদান / @Attribute ঘটনা টাইপ বর্ণনা
RateModifications 1 Complex element একটি হার পরিবর্তন বার্তার মূল উপাদান।
RateModifications / @partner 1 string এই বার্তার জন্য অংশীদার অ্যাকাউন্ট. এই স্ট্রিং মান হল হোটেল সেন্টারের অ্যাকাউন্ট সেটিংস পৃষ্ঠায় তালিকাভুক্ত "অংশীদার কী" মান।

দ্রষ্টব্য: আপনার যদি একটি ব্যাকএন্ড থাকে যা একাধিক অ্যাকাউন্টের জন্য ফিড প্রদান করে, তাহলে এই মানটিকে একই অ্যাকাউন্টের জন্য আপনার <OTA_HotelRateAmountNotifRQ> এবং <OTA_HotelAvailNotifRQ> বার্তাগুলির <RequestorID> এলিমেন্টে উল্লেখ করা ID অ্যাট্রিবিউট মানের সাথে মিলতে হবে।

RateModifications / @id 1 string এই অনুরোধ বার্তার জন্য একটি অনন্য শনাক্তকারী৷ এই মান প্রতিক্রিয়া বার্তা ফেরত দেওয়া হয়. অনুমোদিত অক্ষর হল az, AZ, 0-9, _ (আন্ডারস্কোর), এবং - (ড্যাশ)।
RateModifications / @timestamp 1 DateTime এই বার্তা তৈরির তারিখ এবং সময়।
RateModifications / HotelRateModifications 0..n HotelRateModifications

একটি সম্পত্তি জন্য হার পরিবর্তন. প্রতিটি হার পরিবর্তন একটি একক সম্পত্তি প্রযোজ্য.

দ্রষ্টব্য: যদি একই হারে একাধিক হারের পরিবর্তন প্রয়োগ করা যায়, তবে সমস্ত পরিবর্তন প্রয়োগ করা হয়। কোন নির্দিষ্ট আদেশ নিশ্চিত করা হয়.

RateModifications / HotelRateModifications / @hotel_id 1 string সম্পত্তির অনন্য শনাক্তকারী। এই মানটি অবশ্যই হোটেল তালিকা ফিডে <listing> এলিমেন্টে <id> ব্যবহার করে নির্দিষ্ট হোটেল আইডির সাথে মিলতে হবে। হোটেল আইডিটি হোটেল সেন্টারেও তালিকাভুক্ত করা হয়েছে।
RateModifications / HotelRateModifications / @action 0..1 enum

যদি action নির্দিষ্ট করা না থাকে, তাহলে এই উপাদানের মধ্যে পরিবর্তনগুলি এই হোটেলের জন্য যোগ বা আপডেট করা হয়। যদি action="overlay" নির্দিষ্ট করা থাকে, তাহলে এই হোটেলের জন্য পূর্বে সংজ্ঞায়িত সমস্ত পরিবর্তনগুলি প্রথমে মুছে ফেলা হবে৷ তারপর, এখানে উল্লেখিত পরিবর্তনগুলি লেখা হয়। যদি action="overlay" ব্যবহার করা হয় এবং এই উপাদানের মধ্যে কোন পরিবর্তন নির্দিষ্ট করা না থাকে, তাহলে এই হোটেলের সমস্ত পরিবর্তন মুছে ফেলা হবে।

RateModifications / HotelRateModifications / ItineraryRateModification 0..200 ItineraryRateModification

একটি সম্পত্তি জন্য একটি একক হার পরিবর্তন.

দ্রষ্টব্য: হার পরিবর্তনগুলি ডিবাগ করা কঠিন এবং আমরা সেগুলিকে অল্প ব্যবহার করার পরামর্শ দিই৷ আপনার টেকনিক্যাল অ্যাকাউন্ট ম্যানেজার (TAM)-এর সাথে যোগাযোগ করুন যে ক্ষেত্রে 200 টির বেশি হার পরিবর্তনের প্রয়োজন।

RateModifications / HotelRateModifications / ItineraryRateModification / @id 1 string হার পরিবর্তনের জন্য একটি অনন্য শনাক্তকারী। অনুমোদিত অক্ষরের সর্বাধিক সংখ্যা 40। অনুমোদিত অক্ষর হল az, AZ, 0-9, _ (আন্ডারস্কোর), - (ড্যাশ), এবং। (সময়কাল)।
RateModifications / HotelRateModifications / ItineraryRateModification / @action 0..1 enum

যদি নির্দিষ্ট করা না থাকে এবং একই id সহ একটি হার পরিবর্তন সংরক্ষণ করা না হয়, তাহলে এই হার পরিবর্তন সংরক্ষণ করা হয়। অন্যথায়, যদি নির্দিষ্ট না করা হয় এবং একই id সহ একটি হার পরিবর্তন সংরক্ষণ করা হয়, তাহলে বিদ্যমান হার পরিবর্তন আপডেট করা হয়।

নির্দিষ্ট করা হলে, মান অবশ্যই "delete" হতে হবে। যদি "delete" নির্দিষ্ট করা থাকে, একই id সহ সঞ্চিত হার পরিবর্তন মুছে ফেলা হয়। "delete" ব্যবহার করার সময়, <ItineraryRateModification> এ কোনো চাইল্ড উপাদান অন্তর্ভুক্ত করবেন না। এছাড়াও, <HotelRateModifications action="overlay"/> এর সাথে একত্রে "delete" অনুমোদিত নয়।

RateModifications / HotelRateModifications / ItineraryRateModification / BookingDates 0..1 BookingDates এক বা একাধিক তারিখের সীমার জন্য একটি ধারক যা নির্ধারণ করে যে কখন বুকিং হতে হবে যাতে রেট পরিবর্তন প্রয়োগ করা যায়।
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 এক বা একাধিক তারিখের সীমার জন্য একটি কন্টেইনার যা নির্ধারণ করে কখন চেক-ইন করতে হবে রেট পরিবর্তনের জন্য।
RateModifications / HotelRateModifications / ItineraryRateModification / CheckinDates / DateRange 1..99 DateRange একটি তারিখ ব্যাপ্তি নির্দিষ্ট করে যে কখন চেক-ইন করতে হবে রেট পরিবর্তন প্রয়োগ করার জন্য। আপনি যদি এক বা একাধিক হার পরিবর্তন মুছে ফেলছেন তবে এই উপাদানটির প্রয়োজন নেই৷
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 এক বা একাধিক তারিখের সীমার জন্য একটি ধারক যা নির্ধারণ করে যে কখন চেক-আউট করতে হবে রেট পরিবর্তনের জন্য।
RateModifications / HotelRateModifications / ItineraryRateModification / CheckoutDates / DateRange 1..99 DateRange একটি তারিখ ব্যাপ্তি নির্দিষ্ট করে যে কখন চেক-আউট করতে হবে রেট পরিবর্তন প্রয়োগ করার জন্য। আপনি যদি এক বা একাধিক হার পরিবর্তন মুছে ফেলছেন তবে এই উপাদানটির প্রয়োজন নেই৷
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 এক ধরনের ব্যবহারকারী ডিভাইস সংজ্ঞায়িত করে যা হার পরিবর্তনের জন্য যোগ্য।
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 অক্ষর।
  • প্রতিটি হার শুধুমাত্র একটি একক হার নিয়মের সাথে যুক্ত হতে পারে।
  • যদি একটি রেট রুল আইডি প্রয়োগ করার জন্য একাধিক পরিবর্তন করা হয়, তবে রেট রুল আইডি যেটি অভিধানগতভাবে সবচেয়ে ছোট সেটিকে হারে বরাদ্দ করা হয়।
  • যদি এই আইডিটি আপনার হারের নিয়মের সংজ্ঞা ফাইলে একটি রেট নিয়মের সাথে মেলে না, তাহলে এটি অযোগ্য বলে বিবেচিত হবে।
বিভিন্ন ব্যক্তিগত হার UI চিকিত্সা সম্পর্কে তথ্যের জন্য এই নিবন্ধটি দেখুন।
RateModifications / HotelRateModifications / ItineraryRateModification / ModificationActions / Refundable 0..1 Refundable নির্দিষ্ট মানের সাথে হারের ফেরতযোগ্যতা ওভাররাইট করে।

বৈশিষ্ট্যগুলি সেট করার সময়, নিম্নলিখিতগুলি নোট করুন:

  • এই পরিবর্তন ক্রিয়াটি শুধুমাত্র জনবহুল ক্ষেত্র নয়, একটি যোগ্যতা হারের ফেরতযোগ্য সেটিংকে সম্পূর্ণরূপে পুনর্লিখন করে।
  • যদি available বা refundable_until_days সেট করা না থাকে, তাহলে হার ফেরতযোগ্য হিসাবে প্রদর্শিত হবে না।
  • available 0 বা false হলে, অন্যান্য বৈশিষ্ট্য উপেক্ষা করা হয়. একটি বা উভয় অন্যান্য বৈশিষ্ট্য সেট করা থাকলেও হার ফেরতযোগ্য হিসাবে প্রদর্শিত হয় না।
  • 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 এর সাথে একত্রিত করা যেতে পারে, উদাহরণস্বরূপ, "চেক-ইন করার দুই দিন আগে 4:00PM পর্যন্ত ফেরত পাওয়া যায়"। যদি 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 একটি হার পরিকল্পনা নির্দিষ্ট করে। লেনদেন (সম্পত্তি ডেটা), OTA_HotelRateAmountNotifRQ এবং OTA_HotelAvailNotifRQ বার্তাগুলিতে সংজ্ঞায়িত প্যাকেজ, হার এবং উপলব্ধতার সংমিশ্রণ দ্বারা একটি রেট প্ল্যান সংজ্ঞায়িত করা হয় এবং প্যাকেজআইডি দ্বারা চিহ্নিত করা হয়৷
RateModifications / HotelRateModifications / ItineraryRateModification / RatePlans / RatePlan / @id 1 string রেট প্ল্যানের অনন্য শনাক্তকারী। এই মানটি একটি লেনদেন (সম্পত্তি ডেটা) বার্তায় <PackageData> এ PackageID মান এবং <OTA_HotelRateAmountNotifRQ> এবং <OTA_HotelAvailNotifRQ> উভয় বার্তায় <StatusApplicationControl> RatePlanCode অ্যাট্রিবিউটে ম্যাপ করে। অনুমোদিত অক্ষরের সর্বাধিক সংখ্যা 50।
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes 0..1 RoomTypes রুমের প্রকারের একটি তালিকার জন্য ধারক যেখানে রেট পরিবর্তন প্রযোজ্য। রেট পরিবর্তন প্রতিটি <RoomType> নির্দিষ্ট করা হয়. যদি <RoomTypes> নির্দিষ্ট করা না থাকে, তাহলে রেট পরিবর্তন সব কক্ষের জন্য প্রযোজ্য।
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType 1..n RoomType একটি রুমের ধরন নির্দিষ্ট করে। একটি লেনদেন (সম্পত্তি ডেটা) বার্তার একটি <RoomData> উপাদানে একটি রুমের ধরন সংজ্ঞায়িত করা হয় এবং এটির <RoomID> মান ব্যবহার করে উল্লেখ করা হয়। (এর <RoomID> মানটি OTA_HotelRateAmountNotifRQ বার্তাগুলিতে InvTypeCode বৈশিষ্ট্য দ্বারাও উল্লেখ করা হয়েছে।)
RateModifications / HotelRateModifications / ItineraryRateModification / RoomTypes / RoomType / @id 1 string ইনভেন্টরির জন্য অনন্য শনাক্তকারী (রুমের ধরন)। এই মানটি একটি লেনদেন (সম্পত্তি ডেটা) বার্তায় <RoomID> এ ম্যাপ করে। অনুমোদিত অক্ষরের সর্বাধিক সংখ্যা 50।
RateModifications / HotelRateModifications / ItineraryRateModification / StayDates 0..1 StayDates এক বা একাধিক তারিখের সীমার জন্য একটি ধারক যা নির্ধারণ করে যে কীভাবে হার পরিবর্তন প্রয়োগ করা হয়, যেমন মৌসুমী মূল্য নির্ধারণ করা।
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 UserCountries স্পেসিফিকেশনের ধরন।

বৈধ মান include এবং exclude ।

যদি UserCountries type include হিসাবে সেট করা হয়, তাহলে তালিকাভুক্ত দেশগুলির ব্যবহারকারীদের জন্য হারের পরিবর্তন প্রযোজ্য হবে।

যদি UserCountries type exclude হয়, তাহলে তালিকাভুক্ত দেশের বাইরের ব্যবহারকারীদের জন্য হারের পরিবর্তন প্রযোজ্য হবে।

যদি UserCountries 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>

একটি হার পরিবর্তন মুছুন

নিম্নলিখিত উদাহরণ দেখায় কিভাবে একটি সম্পত্তির জন্য একটি হার পরিবর্তন মুছে ফেলতে হয়:

<?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> ওভারলে করা যায়। যখন 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 বার্তাটিতে নিম্নলিখিত উপাদান এবং বৈশিষ্ট্য রয়েছে:

উপাদান / @Attribute ঘটনা টাইপ বর্ণনা
RateModifications 1 Complex element একটি প্রাপ্ত হার পরিবর্তন অনুরোধ বার্তার সাফল্য বা সমস্যা নির্দেশ করে মূল উপাদান।
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 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 ।

উদাহরণ

সফলতা

নিম্নলিখিত একটি সফলভাবে প্রক্রিয়াকৃত 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>