লেনদেন (সম্পত্তি ডেটা)

অনুরোধ

বাক্য গঠন

Transaction (Property Data) বার্তাটি নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="timestamp"
             id="message_ID"
             partner="partner_key">
  <PropertyDataSet action="[overlay|delta]">
    <!-- (Required) ID that matches the Hotel List Feed -->
    <Property>HotelID</Property>
    <RoomData>
      <!-- (Required) One room ID per RoomData element -->
      <RoomID>RoomID</RoomID>
      <Name>
        <Text text="room_name" language="language_code"/>
      </Name>
      <Description>
        <Text text="room_description" language="language_code"/>
      </Description>
      <!-- (Optional) Restricts the rate plans allowed for this room type to
        those listed here. If specified, don't specify AllowableRoomIDs. -->
      <AllowablePackageIDs>
        <AllowablePackageID>PackageID</AllowablePackageID>
      </AllowablePackageIDs>
      <Capacity>max_number_of_occupants</Capacity>
      <AdultCapacity>max_number_of_adult_occupants</AdultCapacity>
      <ChildCapacity>max_number_of_child_occupants</ChildCapacity>
      <OccupancySettings>
        <MinOccupancy>min_number_of_occupants</MinOccupancy>
        <MinAge>min_age_of_occupants</MinAge>
      </OccupancySettings>
      <PhotoURL>
        <Caption>
          <Text text="photo_description" language="language_code"/>
        </Caption>
        <URL>photo_location</URL>
      </PhotoURL>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>[western|japanese|japanese_western]</JapaneseHotelRoomStyle>
        <Beds>
           <Bed size="[single|semi_double|double|queen|king]">
             <Width unit="cm" number="bed_width"/>
             <Length unit="cm" number="bed_length"/>
           </Bed>
           <!-- Include with any additional beds. -->
        </Beds>
        <Suite/>
        <Capsule/>
        <Roomsharing>[shared|private]</Roomsharing>
        <Outdoor/>
        <MobilityAccessible/>
        <Smoking>[smoking|non_smoking]</Smoking>
        <BathAndToilet relation="[together|separate]">
          <Bath bathtub="[false|true]" shower="[false|true]"/>
          <Toilet electronic_bidet="[false|true]" mobility_accessible="[false|true]"/>
        </BathAndToilet>
        <OpenAirBath/>
        <AirConditioning/>
        <Balcony/>
        <Views>
          <!-- (Optional) Defines the type of views from the room. -->
          <!-- Example: <OceanView/> -->
        </Views>
      </RoomFeatures>
    </RoomData>
    <PackageData>
      <!-- (Required) One package ID per PackageData element -->
      <PackageID>PackageID</PackageID>
      <Name>
        <Text text="package_name" language="language_code"/>
      </Name>
      <Description>
        <Text text="package_description" language="language_code"/>
      </Description>
      <!-- (Optional) Restricts the room types allowed for this rate plan to
        those listed here. If specified, don't specify AllowablePackageIDs. -->
      <AllowableRoomIDs>
        <AllowableRoomID>RoomID</AllowableRoomID>
      </AllowableRoomIDs>
      <Refundable available="[false|true]" refundable_until_days="number_of_days"
        refundable_until_time="time"/>
      <!-- For these next 3 elements, boolean_value can be 0/1 or true/false -->
      <BreakfastIncluded>boolean_value</BreakfastIncluded>
      <InternetIncluded>boolean_value</InternetIncluded>
      <ParkingIncluded>boolean_value</ParkingIncluded>
      <PhotoURL>
        <Caption>
          <Text text="photo_description" language="language_code"/>
          ...
        </Caption>
        <URL>photo_location</URL>
      </PhotoURL>
      ...
      <Meals>
        <Breakfast
          included="[true|false]" buffet="[true|false]"
          in_room="[true|false]" in_private_space="[true|false]"/>
        <Dinner
          included="[true|false]" buffet="[true|false]"
          in_room="[true|false]" in_private_space="[true|false]"/>
      </Meals>
      <CheckinTime>checkin_time</CheckinTime>
      <CheckoutTime>checkout_time</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

উপাদান এবং বৈশিষ্ট্য

লেনদেন (সম্পত্তি ডেটা) বার্তায় নিম্নলিখিত উপাদান এবং বৈশিষ্ট্য রয়েছে:

উপাদান / @Attribute ঘটনা টাইপ বর্ণনা
Transaction 1 Complex element একটি ARI বাস্তবায়নে, এটি একটি বার্তার মূল উপাদান যা একটি একক সম্পত্তির জন্য রুমের ধরন এবং প্যাকেজ নির্ধারণ করে।
Transaction / @timestamp 1 DateTime এই বার্তা তৈরির তারিখ এবং সময়।
Transaction / @id 1 string এই অনুরোধ বার্তার জন্য একটি অনন্য শনাক্তকারী৷ এই মান প্রতিক্রিয়া বার্তা ফেরত দেওয়া হয়. অনুমোদিত অক্ষর হল az, AZ, 0-9, _ (আন্ডারস্কোর), এবং - (ড্যাশ)।
Transaction / @partner 1 string এই বার্তার জন্য অংশীদার অ্যাকাউন্ট. এই স্ট্রিং মান হল হোটেল সেন্টারের অ্যাকাউন্ট সেটিংস পৃষ্ঠায় তালিকাভুক্ত "অংশীদার কী" মান।

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

Transaction / PropertyDataSet 1.. PropertyDataSet একটি একক সম্পত্তির জন্য রুমের ধরন এবং প্যাকেজগুলি সংজ্ঞায়িত করার জন্য একটি ধারক৷
Transaction / PropertyDataSet / @action 0..1 enum

রুম রেট সংজ্ঞায় প্রযোজ্য আপডেটের ধরন।

বৈধ মান হল:

  • overlay : সম্পত্তির জন্য পূর্বে সংজ্ঞায়িত সমস্ত <RoomData> এবং <PackageData> প্রতিস্থাপন করে। বর্তমান বার্তায় শুধুমাত্র <RoomData> এবং <PackageData> বৈধ।
  • delta : পূর্বে অনির্ধারিত <RoomData> এবং <PackageData> যোগ করে বা বিদ্যমানগুলিকে সংশোধন করে।

এই বৈশিষ্ট্যটি ঐচ্ছিক এবং নির্দিষ্ট না থাকলে delta ডিফল্ট।

Transaction / PropertyDataSet / Property 1 string সম্পত্তির অনন্য শনাক্তকারী। এই মানটি অবশ্যই হোটেল তালিকা ফিডে <listing> এলিমেন্টে <id> ব্যবহার করে নির্দিষ্ট হোটেল আইডির সাথে মিলতে হবে। হোটেল আইডিটি হোটেল সেন্টারেও তালিকাভুক্ত করা হয়েছে।
Transaction / PropertyDataSet / RoomData 0..n RoomData

একটি ঘরের বর্ণনা দেয়।

দ্রষ্টব্য: অন্তত একটি <RoomData> বা <PackageData> প্রয়োজন।

Transaction / PropertyDataSet / RoomData / RoomID 1 RoomID এক ধরনের রুমের জন্য একটি অনন্য শনাক্তকারী। এই মানটি <OTA_HotelAvailNotifRQ> এবং <OTA_HotelRateAmountNotifRQ> বার্তাগুলিতে <StatusApplicationControl> উপাদানের InvTypeCode বৈশিষ্ট্য ব্যবহার করে উল্লেখ করা হয়েছে।
Transaction / PropertyDataSet / RoomData / Name 1 Name এক বা একাধিক ভাষায় রুমের বিভাগের নামের জন্য ধারক।
Transaction / PropertyDataSet / RoomData / Name / Text 1..n Text একটি ভাষায় রুমের বিভাগের নাম উল্লেখ করে।
Transaction / PropertyDataSet / RoomData / Name / Text / @text 1..n string language বৈশিষ্ট্য দ্বারা নির্দিষ্ট ভাষায় রুমের বিভাগের নাম।
Transaction / PropertyDataSet / RoomData / Description 1 Name এক বা একাধিক ভাষায় রুমের শ্রেণীবিভাগের বর্ণনার জন্য ধারক।
Transaction / PropertyDataSet / RoomData / Description / Text 1..n Text একটি ভাষায় ঘরের বিভাগের বিবরণ নির্দিষ্ট করে।
Transaction / PropertyDataSet / RoomData / Description / Text / @text 1..n string language বৈশিষ্ট্য দ্বারা নির্দিষ্ট ভাষায় রুমের বিভাগের বিবরণ।
Transaction / PropertyDataSet / RoomData / Description / Text / @language 1..n string একটি দুই-অক্ষরের ভাষা কোড ।
Transaction / PropertyDataSet / RoomData / AllowablePackageIDs 0..1 AllowablePackageIDs <AllowablePackageID> উপাদানগুলির জন্য একটি ধারক।

যদি <AllowablePackageIDs> নির্দিষ্ট করা থাকে, তাহলে প্যারেন্ট <RoomData> এলিমেন্টে <RoomID> দ্বারা চিহ্নিত রুমের ধরন শুধুমাত্র <AllowablePackageID> উপাদান দ্বারা নির্ধারিত হার পরিকল্পনার সাথে একত্রিত করা যেতে পারে।

যদি <AllowablePackageIDs> নির্দিষ্ট করা না থাকে, তাহলে প্যারেন্ট <RoomData> এলিমেন্টে <RoomID> দ্বারা চিহ্নিত রুমের ধরন যেকোন রেট প্ল্যানের সাথে একত্রিত করা যেতে পারে।

<AllowablePackageIDs> বা <AllowableRoomIDs> ব্যবহার করুন, কিন্তু উভয়ই নয়।

Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID 1..n AllowablePackageID একটি রেট প্ল্যানের প্যাকেজআইডি নির্দিষ্ট করে যা এই রুমের প্রকারের সাথে একত্রিত করা যেতে পারে। একটি হার পরিকল্পনা প্যাকেজ, হার এবং প্রাপ্যতার সংমিশ্রণ দ্বারা সংজ্ঞায়িত করা হয়। PackageID OTA_HotelRateAmountNotifRQ এবং OTA_HotelAvailNotifRQ বার্তাগুলির RatePlanCode এর সাথে মিলে যায়৷
Transaction / PropertyDataSet / RoomData / Capacity 0..1 integer একটি কক্ষ শারীরিকভাবে মিটমাট করতে পারে এমন সর্বাধিক সংখ্যক প্রাপ্তবয়স্ক এবং শিশুদের। এটি আপনার রেট সহ যেকোন NumberOfGuests মানের চেয়ে বেশি বা সমান হওয়া উচিত।

<Capacity> এর মান অবশ্যই 1 এবং 99 মধ্যে একটি ধনাত্মক পূর্ণসংখ্যা হতে হবে, অন্তর্ভুক্ত। একটি উদাহরণের জন্য এখানে দেখুন.

দ্রষ্টব্য: যদি <Capacity> সেট করা না থাকে, তাহলে অনুমোদিত ব্যক্তিদের সংখ্যা সীমাহীন বলে বিবেচিত হবে। যদি এই ক্ষেত্রটি সেট করা না থাকে এবং ExtraGuestCharges বা AdditionalGuestAmounts সংজ্ঞায়িত করা হয়, তাহলে যেকোন সংখ্যক লোকের জন্য মূল্য তৈরি করা যেতে পারে। আমরা সুপারিশ করি যে আপনি <Capacity> সেট করুন যদি ExtraGuestCharges বা AdditionalGuestAmounts সংজ্ঞায়িত করা হয় যাতে অবৈধ দখলের বিকল্পগুলির জন্য দামগুলি প্রদর্শিত না হয়।

Transaction / PropertyDataSet / RoomData / AdultCapacity 0..1 integer একটি কক্ষ শারীরিকভাবে মিটমাট করতে পারে এমন সর্বাধিক সংখ্যক প্রাপ্তবয়স্ক। এটি আপনার রেট সহ যেকোন NumberOfGuests মানের চেয়ে বেশি বা সমান হওয়া উচিত।

<AdultCapacity> এর মান অবশ্যই 1 এবং 99 মধ্যে একটি ধনাত্মক পূর্ণসংখ্যা হতে হবে, অন্তর্ভুক্ত। একটি উদাহরণের জন্য এখানে দেখুন.

Transaction / PropertyDataSet / RoomData / ChildCapacity 0..1 integer একটি রুম শারীরিকভাবে মিটমাট করতে পারে যে সর্বাধিক সংখ্যক শিশু।

<ChildCapacity> এর মান অবশ্যই 1 এবং 99 এর মধ্যে একটি ধনাত্মক পূর্ণসংখ্যা হতে হবে, অন্তর্ভুক্ত। একটি উদাহরণের জন্য এখানে দেখুন.

Transaction / PropertyDataSet / RoomData / OccupancySettings 0..1 OccupancySettings সেটিংস যা একটি রুমের দখলের প্রয়োজনীয়তা সীমাবদ্ধ বা পরিবর্তন করতে পারে।

<OccupancySettings> এলিমেন্ট নিম্নলিখিত চাইল্ড এলিমেন্টগুলি নেয়:

  • <MinOccupancy> : একটি রুমে থাকতে পারে এমন ন্যূনতম সংখ্যক অতিথি। উদাহরণস্বরূপ, যদি এটি 2 তে সেট করা থাকে, তাহলে এই রুমটি একক অতিথির জন্য বুক করা যাবে না৷

    <MinOccupancy> এর মান অবশ্যই 1 এবং 99 এর মধ্যে একটি ধনাত্মক পূর্ণসংখ্যা হতে হবে, অন্তর্ভুক্ত।

  • <MinAge> : একটি রুমে থাকা সমস্ত অতিথিদের জন্য সর্বনিম্ন বয়স। উদাহরণস্বরূপ, যদি এটি 18 তে সেট করা হয়, এই রুমটি শুধুমাত্র সেই গোষ্ঠীগুলির জন্য বুক করা যেতে পারে যেখানে সমস্ত অতিথিদের বয়স 18 বা তার বেশি৷

    <MinAge> এর মান অবশ্যই 0 এবং 99 এর মধ্যে একটি ধনাত্মক পূর্ণসংখ্যা হতে হবে, অন্তর্ভুক্ত।

<OccupancySettings>
  <MinOccupancy>2</MinOccupancy>
  <MinAge>16</MinAge>
</OccupancySettings>

সমস্ত শিশু উপাদান অন্তর্ভুক্ত করার প্রয়োজন নেই।

Transaction / PropertyDataSet / RoomData / PhotoURL 0..n PhotoURL প্রদত্ত রুম বা রুম বান্ডেলের একটি ছবির জন্য একটি URL এবং ঐচ্ছিক ক্যাপশন৷ আপনি একটি রুম বা রুম বান্ডেলের জন্য একাধিক <PhotoURL> নির্দিষ্ট করতে পারেন।

এই উপাদানটি নিম্নলিখিত শিশু উপাদান গ্রহণ করে:

  • <URL> : ছবির অবস্থান নির্দিষ্ট করে। অবস্থানটি সর্বজনীন হওয়া উচিত (ফায়ারওয়ালের পিছনে নয়) এবং প্রোটোকল ( http:// ) অন্তর্ভুক্ত করা উচিত।
  • <Caption> : ছবির ক্যাপশন সংজ্ঞায়িত করে। এই উপাদানটি একটি একক শিশু উপাদান নেয়, <Text> , যার দুটি প্রয়োজনীয় বৈশিষ্ট্য রয়েছে, Text এবং language । Text অ্যাট্রিবিউট হল ক্যাপশন, এবং language অ্যাট্রিবিউট একটি দুই-অক্ষরের ভাষা কোড নির্দিষ্ট করে যেমন en .
<PhotoURL>
 <URL>http://www.example.com/image1.jpg</URL>
 <Caption>
  <Text text="A bright way to enjoy your
   mornin' cuppa tea." language="en"/>
  <Text text="Une façon lumineuse pour profiter
   de votre tasse de thé." language="fr"/>
 </Caption>
</PhotoURL>
Transaction / PropertyDataSet / RoomData / RoomFeatures 0..1 <RoomFeatures> রুম বৈশিষ্ট্য সম্পর্কে তথ্য রয়েছে.
Transaction / PropertyDataSet / RoomData / RoomFeatures / JapaneseHotelRoomStyle 0..1 enum

একটি জাপানি হোটেল রুমের শৈলী নির্দেশ করে।

বৈধ মান হল:

  • western : বিছানা সহ একটি পশ্চিমা শৈলীর ঘর।
  • japanese : ফুটন বিছানা সহ একটি জাপানি স্টাইলের ঘর।
  • japanese_western : একটি জাপানি পশ্চিমা শৈলীর ঘর যেখানে পশ্চিমা শৈলীর বিছানা এবং জাপানি স্টাইলের ফুটন উভয়ই রয়েছে।
Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds 0..1 Object ঘরে যতগুলি <Bed> আছে ততগুলি রয়েছে। অনুগ্রহ করে মনে রাখবেন যে জাপানি ফুটন এখানে গণনা করা উচিত নয়।

প্রতিটি <Bed> নিম্নলিখিত বৈশিষ্ট্য রয়েছে:

  • size (ঐচ্ছিক): বৈধ মান হল single , semi_double , double , queen এবং king ।
প্রতিটি <Bed> নিম্নলিখিত শিশু উপাদান রয়েছে:
  • <Width> (ঐচ্ছিক): বিছানার প্রস্থ নির্দিষ্ট করে। মান cm সহ বৈশিষ্ট্য unit এবং পূর্ণসংখ্যা সেন্টিমিটারে বিছানার প্রস্থ সহ বৈশিষ্ট্য number থাকতে হবে।
  • <Length> (ঐচ্ছিক): বিছানার দৈর্ঘ্য নির্দিষ্ট করে। মান cm সহ বৈশিষ্ট্য unit এবং পূর্ণসংখ্যা সেন্টিমিটারে বিছানার দৈর্ঘ্য সহ বৈশিষ্ট্য number থাকতে হবে।
উদাহরণ: 
<Beds>
  <Bed size="double">
    <Width unit="cm" number="140"/>
    <Length unit="cm" number="195"/>
  </Bed>
  <Bed/> <!-- Size unknown -->
</Beds>
Transaction / PropertyDataSet / RoomData / RoomFeatures / Suite 0.. enum এই রুম একটি স্যুট হলে এই উপাদান প্রদান করুন.
Transaction / PropertyDataSet / RoomData / RoomFeatures / Capsule 0..1 enum এই রুমটি একটি ক্যাপসুল রুম হলে এই উপাদানটি প্রদান করুন।
Transaction / PropertyDataSet / RoomData / RoomFeatures / Roomsharing 0..1 enum এই রুমটি অন্য বাসিন্দা যেমন মালিক বা অন্য অতিথিদের সাথে শেয়ার করা হয়েছে কিনা। বৈধ মানগুলি shared এবং private ।
Transaction / PropertyDataSet / RoomData / RoomFeatures / Outdoor 0..1 enum এই উপাদানটি প্রদান করুন যখন এই ঘরটি বাইরে থাকার জায়গা যেখানে নির্দিষ্ট দেয়াল, প্লাম্বিং এবং জলবায়ু নিয়ন্ত্রণ নেই। উদাহরণ স্বরূপ, হোটেলের কক্ষগুলি আউটডোর লজিং নয় যেখানে ক্যাম্পসাইটগুলি যেখানে অতিথিরা তাঁবুতে থাকেন এবং আরভি পার্ক যেখানে অতিথিরা তাদের নিজস্ব আরভি নিয়ে আসেন তা হল আউটডোর লজিং৷
Transaction / PropertyDataSet / RoomData / RoomFeatures / MobileAccessible 0..1 enum এই উপাদানটি প্রদান করুন যখন এই রুমটি চলাফেরার জন্য অ্যাক্সেসযোগ্য হয়।
Transaction / PropertyDataSet / RoomData / RoomFeatures / Smoking 0..1 enum এই রুমটি একটি ধূমপানমুক্ত রুম বা একটি ধূমপান রুম কিনা। বৈধ মান হল non_smoking এবং smoking ।
Transaction / PropertyDataSet / RoomData / RoomFeatures / BathAndToilet 0..1 Object রুমে একটি স্নান এবং টয়লেট সম্পর্কে তথ্য রয়েছে।

বৈশিষ্ট্য হল:

  • relation (ঐচ্ছিক): স্নান এবং টয়লেট একে অপরের সাথে কীভাবে স্থাপন করা হয় তা নির্দেশ করে। বৈধ মানগুলি together , উদাহরণস্বরূপ, একটি বাথরুম যেখানে স্নান এবং টয়লেট উভয়ই একই ঘরে একসাথে অবস্থিত; এবং separate , যেখানে স্নান এবং টয়লেট প্রত্যেকের জন্য নির্দিষ্ট স্থান রয়েছে। রুমে গোসল এবং টয়লেট উভয়ই না থাকলে এই বৈশিষ্ট্যটি সেট করা উচিত নয়।

উপাদানটি ঐচ্ছিকভাবে নিম্নলিখিত শিশু উপাদানগুলি গ্রহণ করে:

  • <Bath> > (ঐচ্ছিক): এই উপাদানটির অস্তিত্ব নির্দেশ করে যে ঘরে একটি স্নান আছে।

    গুণাবলী হল:

    • bathtub (ঐচ্ছিক): স্নানের বাথরুমে একটি বাথটাব আছে তা নির্দেশ করে। বৈধ মান হল 0 (বা false ) এবং 1 (বা true )।
    • shower (ঐচ্ছিক): স্নান একটি ঝরনা আছে নির্দেশ করে. বৈধ মান হল 0 (বা false ) এবং 1 (বা true )।
  • <Toilet> (ঐচ্ছিক): এই উপাদানটির অস্তিত্ব নির্দেশ করে যে এই ঘরে একটি টয়লেট আছে।

    গুণাবলী হল:

    • electronic_bidet (ঐচ্ছিক): ইঙ্গিত করে যে টয়লেটে একটি ইলেকট্রনিক বিডেট আছে। বৈধ মান হল 0 (বা false ) এবং 1 (বা true )।
    • mobility_accessible (ঐচ্ছিক): ইঙ্গিত করে যে টয়লেটটি গতিশীল-অভিগম্য। বৈধ মান হল 0 (বা false ) এবং 1 (বা true )।

উদাহরণ:

<BathAndToilet relation="separate">
  <Bath bathtub="1" shower="1"/>
  <Toilet
    electronic_bidet="1"
    mobility_accessible="1"/>
</BathAndToilet>
Transaction / PropertyDataSet / RoomData / RoomFeatures / OpenAirBath 0..1 enum যখন এই রুমে একটি ব্যক্তিগত ওপেন-এয়ার স্নান থাকে তখন এই উপাদানটি প্রদান করুন।
Transaction / PropertyDataSet / RoomData / RoomFeatures / AirConditioning 0..1 enum এই রুমে এয়ার কন্ডিশনার থাকলে এই উপাদানটি প্রদান করুন।
Transaction / PropertyDataSet / RoomData / RoomFeatures / Balcony 0..1 enum যখন এই রুমে একটি বারান্দা বা লানাই থাকে তখন এই উপাদানটি প্রদান করুন।
Transaction / PropertyDataSet / RoomData / RoomFeatures / Views 0..1 Object বৈধ বিকল্প অন্তর্ভুক্ত:

<AirportView/>
<BayView/>
<BeachView>/>
<CastleView/>
<CityView/>
<CountrysideView/>
<CourtyardView/>
<DuneView/>
<ForestView/>
<GardenView/>
<GolfCourseView/>
<HarborView/>
<LagoonView/>
<LakeView/>
<MarinaView/>
<MountainView/>
<NatureView/>
<OceanView/>
<ParkView/>
<PartialOceanView/>
<PisteView/>
<PoolView/>
<PyramidView/>
<RiverView/>
<StreetView/>

Transaction / PropertyDataSet / PackageData 0..n PackageData

রেট বৈশিষ্ট্য এবং শর্তাবলী বর্ণনা করে এমন উপাদানগুলির জন্য কন্টেইনার যা শারীরিক কক্ষের বিবরণের অংশ নয়।

দ্রষ্টব্য: অন্তত একটি <RoomData> বা <PackageData> প্রয়োজন।

Transaction / PropertyDataSet / PackageData / PackageID 1 string এই বার্তাগুলির PackageID OTA_HotelRateAmountNotifRQ এবং OTA_HotelAvailNotifRQ বার্তাগুলির RatePlanCode এর সাথে মিলে যায়৷
Transaction / PropertyDataSet / PackageData / Name 1 Name এক বা একাধিক ভাষায় প্যাকেজের নামের জন্য ধারক।
Transaction / PropertyDataSet / PackageData / Name / Text 1..n Text একটি ভাষায় প্যাকেজের নাম উল্লেখ করে।
Transaction / PropertyDataSet / PackageData / Name / Text / @text 1..n string language বৈশিষ্ট্য দ্বারা নির্দিষ্ট ভাষায় প্যাকেজের নাম।
Transaction / PropertyDataSet / PackageData / Description 1 Description এক বা একাধিক ভাষায় প্যাকেজের বর্ণনার জন্য ধারক।
Transaction / PropertyDataSet / PackageData / Description / Text 1..n Text একটি ভাষায় প্যাকেজের বর্ণনা নির্দিষ্ট করে।
Transaction / PropertyDataSet / PackageData / Description / Text / @text 1..n string language বৈশিষ্ট্য দ্বারা নির্দিষ্ট ভাষায় প্যাকেজের বর্ণনা।
Transaction / PropertyDataSet / PackageData / Description / Text / @language 1..n string একটি দুই-অক্ষরের ভাষা কোড ।
Transaction / PropertyDataSet / PackageData / AllowableRoomIDs 0..1 AllowableRoomIDs <AllowableRoomID> উপাদানগুলির জন্য একটি ধারক।

<AllowableRoomIDs> নির্দিষ্ট করা থাকলে, অভিভাবক <PackageData> এলিমেন্টে <PackageID> দ্বারা চিহ্নিত রেট প্ল্যান শুধুমাত্র <AllowableRoomID> উপাদান দ্বারা সংজ্ঞায়িত রুম প্রকারের সাথে একত্রিত করা যেতে পারে।

যদি <AllowableRoomIDs> নির্দিষ্ট করা না থাকে, তাহলে অভিভাবক <PackageData> এলিমেন্টে <PackageID> দ্বারা চিহ্নিত রেট প্ল্যান যেকোন রুমের সাথে একত্রিত করা যেতে পারে।

<AllowablePackageIDs> বা <AllowableRoomIDs> ব্যবহার করুন, কিন্তু উভয়ই নয়।

Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID 1..n AllowableRoomID এই রেট প্ল্যানের সাথে একত্রিত করা যেতে পারে এমন একটি রুম টাইপের RoomID নির্দিষ্ট করে। <RoomData> এলিমেন্টে রুমের ধরন সংজ্ঞায়িত করা হয়েছে।
Transaction / PropertyDataSet / PackageData / Refundable 0..1 Refundable একটি হারকে সম্পূর্ণরূপে ফেরতযোগ্য বা বাতিলযোগ্য হিসাবে তালিকাভুক্ত করতে সক্ষম করে৷ প্রদান করা না হলে, একটি ফেরত সম্পর্কে কোন তথ্য প্রদর্শিত হয়.

দ্রষ্টব্য: আমরা সমস্ত বৈশিষ্ট্য সেট করার পরামর্শ দিই। যখন এক বা একাধিক বৈশিষ্ট্য সেট করা না থাকে তখন একটি ফিড স্ট্যাটাস সতর্কতা বার্তা তৈরি হয়।

আপনি কোনো বৈশিষ্ট্য সেট না করলে, হার ফেরতযোগ্য হিসাবে প্রদর্শিত হবে না।

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

  • যদি available বা refundable_until_days সেট করা না থাকে, তাহলে হার ফেরতযোগ্য হিসাবে প্রদর্শিত হয় না।
  • available 0 বা false হলে, অন্যান্য বৈশিষ্ট্য উপেক্ষা করা হয়. একটি বা উভয় অন্যান্য বৈশিষ্ট্য সেট করা থাকলেও হার ফেরতযোগ্য হিসাবে প্রদর্শিত হয় না।
Transaction / PropertyDataSet / PackageData / 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 এর মধ্যে একটি পূর্ণসংখ্যা হতে হবে, অন্তর্ভুক্ত।
Transaction / PropertyDataSet / PackageData / Refundable / @refundable_until_time 0.. Time ( available true হলে অত্যন্ত প্রস্তাবিত) হোটেলের স্থানীয় সময়ে দিনের সর্বশেষ সময় নির্দিষ্ট করে, যে একটি সম্পূর্ণ ফেরতের অনুরোধকে সম্মানিত করা হবে। এটি নির্দিষ্ট করার জন্য refundable_until_days এর সাথে একত্রিত করা যেতে পারে, উদাহরণস্বরূপ, "চেক-ইন করার দুই দিন আগে 4:00PM পর্যন্ত ফেরত পাওয়া যায়"। যদি refundable_until_time সেট করা না থাকে, মানটি মধ্যরাত পর্যন্ত ডিফল্ট হয়।
Transaction / PropertyDataSet / PackageData / BreakfastIncluded 0..1 boolean এই রুমের প্রকারে প্রাতঃরাশ অন্তর্ভুক্ত কিনা তা নির্দিষ্ট করে। বৈধ মান হল 0 (বা false ) এবং 1 (বা true )।

আপনি <BreakfastIncluded> এর পরিবর্তে <Meals> ব্যবহার করা পছন্দনীয়।

Transaction / PropertyDataSet / PackageData / CheckinTime 0..1 Time হোটেলের স্থানীয় সময় যত তাড়াতাড়ি সম্ভব চেক-ইন সময়। সময় 24:00 এর কম হতে হবে।
Transaction / PropertyDataSet / PackageData / CheckoutTime 0..1 Time হোটেলের স্থানীয় সময়ে সর্বশেষ সম্ভাব্য চেক-আউট সময়।
Transaction / PropertyDataSet / PackageData / InternetIncluded 0..1 boolean রুমটিতে বিনামূল্যে ইন্টারনেট অ্যাক্সেস রয়েছে কিনা তা নির্দিষ্ট করে যখন অন্যান্য রুমে এই সুবিধা অন্তর্ভুক্ত নয়। এই উপাদানটি এমন কোনও হোটেলে সেট করবেন না যা সমস্ত রুমে বিনামূল্যে ইন্টারনেট সরবরাহ করে। এই উপাদানটি ঘরের মধ্যে তারযুক্ত ইন্টারনেট বা গেস্ট রুমে উপলব্ধ নয় এমন বেতার ইন্টারনেটের ক্ষেত্রে প্রযোজ্য নয়। বৈধ মান হল 0 (বা false ) এবং 1 (বা true )।
Transaction / PropertyDataSet / PackageData / Meals 0..1 Object এই প্যাকেজে খাবার সম্পর্কে তথ্য রয়েছে।

<Meals> উপাদানটি দুটি ঐচ্ছিক শিশু উপাদান নেয়, <Breakfast> এবং <Dinner> , যার নিম্নলিখিত বৈশিষ্ট্য রয়েছে:

  • included (প্রয়োজনীয়): রেট 1 (বা true ) সেট করুন যদি প্রাতঃরাশ/রাতের খাবার অন্তর্ভুক্ত থাকে; অন্যথায় 0 বা false সেট করুন।
  • in_room (ঐচ্ছিক): অতিথিরা যে রুমে থাকেন সেখানে সকালের নাস্তা/রাতের খাবার খাওয়ার বিকল্প থাকলে 1 (বা true ) সেট করুন; অন্যথায় 0 (বা false ) এ সেট করুন।
  • in_private_space (ঐচ্ছিক): 1 (অথবা true ) সেট করুন যদি অতিথিদের এমন একটি স্থানে প্রাতঃরাশ/ডিনার করার বিকল্প থাকে (যে ঘরটিতে তারা থাকে তা ছাড়া) যেখানে তারা অন্য অতিথিদের সাথে যোগাযোগ এড়াতে পারে; অন্যথায় 0 (বা false ) এ সেট করুন।
  • buffet (ঐচ্ছিক): সকালের নাস্তা/রাতের খাবার বুফে হিসাবে পরিবেশন করা হলে 1 (বা true ) সেট করুন; অন্যথায় 0 (বা false ) এ সেট করুন।

ঐচ্ছিক বৈশিষ্ট্যগুলি ব্যবহার করা হয় শুধুমাত্র যখন included সত্য হয়।

খাবারের ফিল্টারগুলির জন্য ( no meals , breakfast only , dinner only এবং breakfast and dinner ) কাজ করার জন্য, <Breakfast> এবং <Dinner> উভয়ই included বৈশিষ্ট্যের সাথে সরবরাহ করতে হবে।

Transaction / PropertyDataSet / PackageData / ParkingIncluded 0..1 boolean কোনও রুমে কোনও চার্জ ছাড়াই পার্কিং অন্তর্ভুক্ত আছে কিনা, যেখানে পার্কিং অন্যথায় এই হোটেলে একটি অর্থপ্রদানের পরিষেবা হবে। বিনামূল্যে পার্কিং অফার করে এমন হোটেলের জন্য এই উপাদানটির জন্য একটি মান নির্দিষ্ট করবেন না। বৈধ মান হল 0 (বা false ) এবং 1 (বা true )। ডিফল্ট মান false .
Transaction / PropertyDataSet / PackageData / PhotoURL 0..1 Object ( <RoomData> -এ <PhotoURL> এর মতোই, কিন্তু প্যাকেজের জন্য (যেমন খাবারের ছবি)।

উদাহরণ

রুম এবং প্যাকেজ ডেটা

একটি লেনদেন (সম্পত্তি ডেটা) বার্তায় একটি সম্পত্তির রুম এবং প্যাকেজ ডেটা কীভাবে সংজ্ঞায়িত করা যায় তার একটি প্রাথমিক উদাহরণ নিম্নলিখিত। overlay অ্যাট্রিবিউটটি নিশ্চিত করতে ব্যবহার করা হয় যে, যদি কোনো ডেটা অপ্রত্যাশিতভাবে ইতিমধ্যেই বিদ্যমান থাকে, তাহলে বিদ্যমান সমস্ত ডেটা মুছে ফেলা হবে এবং এই বার্তার ডেটা দিয়ে প্রতিস্থাপিত হবে:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-05-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <Description>
        <Text text="Room with a king bed" language="en"/>
      </Description>
      <Capacity>2</Capacity>
      <PhotoURL>
        <URL>http://www.foo.com/static/bar/image.jpg</URL>
        <Caption>
          <Text text="Room with a king bed" language="en"/>
        </Caption>
      </PhotoURL>
    </RoomData>
    <RoomData>
      <RoomID>RoomID_2</RoomID>
      <Name>
        <Text text="Double" language="en"/>
      </Name>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <Description>
        <Text text="Standard rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
    <PackageData>
      <PackageID>PackageID_2</PackageID>
      <Name>
        <Text text="Free Breakfast" language="en"/>
      </Name>
      <Description>
        <Text text="Free breakfast rate" language="en"/>
      </Description>
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

একটি রুমের ধরন যোগ করুন

বিদ্যমান <Transaction> ডেটাতে কীভাবে একটি রুমের ধরন এবং প্যাকেজ যোগ করতে হয় তার একটি উদাহরণ নিচে দেওয়া হল:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-07-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="delta">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_3</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
    <PackageData>
      <PackageID>PackageID_3</PackageID>
      <Name>
        <Text text="Non-Refundable" language="en"/>
      </Name>
      <!-- Additional PackageData child elements omitted. -->
      <Refundable available="false"/>
    </PackageData>
  </PropertyDataSet>
</Transaction>

রুমের প্রকারগুলি সরান

বিদ্যমান রুমের ধরন এবং প্যাকেজগুলি কীভাবে সরানো যায় তার একটি উদাহরণ নিচে দেওয়া হল। এই পরিস্থিতিতে, "রুম এবং প্যাকেজ ডেটা" এবং "একটি রুমের ধরন যোগ করুন" এর মেসেজগুলি আগে Google-এ পাঠানো হলে, Google দেখানো মেসেজ পাওয়ার পরে King এবং Double রুমের ধরন আর থাকবে না। মনে রাখবেন যে প্যাকেজ ডেটা অপসারণ লেনদেন (সম্পত্তি ডেটা), OTA_HotelRateAmountNotifRQ, এবং OTA_HotelAvailNotifRQ বার্তাগুলি (একই PackageID মান উল্লেখ করে) জুড়ে সংজ্ঞায়িত সামগ্রিক হার পরিকল্পনাকে প্রভাবিত করে এবং এইভাবে অন্যান্য বার্তার প্রকারগুলি ব্যবহার করে সংশ্লিষ্ট আপডেটগুলিকে প্রতিফলিত করার জন্য PackageID_2 প্রয়োজন হতে পারে। PackageID_3 এখানে আর সংজ্ঞায়িত করা হয়নি৷

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-08-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <!-- Additional RoomData child elements omitted. -->
      <Capacity>2</Capacity>
      <PhotoURL>
        <URL>http://www.foo.com/static/bar/image.jpg</URL>
        <Caption>
          <Text text="Room with a queen bed" language="en"/>
        </Caption>
      </PhotoURL>
    </RoomData>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Refundable" language="en"/>
      </Name>
      <!-- Additional PackageData child elements omitted. -->
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>


হার পরিকল্পনা সীমাবদ্ধ

নিচের একটি উদাহরণ হল কিভাবে <AllowablePackageIDs> উপাদান ব্যবহার করে রুমের প্রকারের জন্য অনুমোদিত রেট প্ল্যানগুলিকে সীমাবদ্ধ করতে। এই উদাহরণে, Queen রুমের ধরন ( RoomID_2 ) শুধুমাত্র প্যাকেজ ID_1 হিসাবে চিহ্নিত প্যাকেজ এবং রেট প্ল্যানের সাথে মিলিত হতে পারে৷

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-12-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <Name>
        <Text text="King" language="en"/>
      </Name>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
    <RoomData>
      <RoomID>RoomID_2</RoomID>
      <Name>
        <Text text="Queen" language="en"/>
      </Name>
      <AllowablePackageIDs>
        <AllowablePackageID>PackageID_1</AllowablePackageID>
      </AllowablePackageIDs>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Standard" language="en"/>
      </Name>
      <!-- Additional PackageData child elements omitted. -->
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>0</BreakfastIncluded>
    </PackageData>
    <PackageData>
      <PackageID>PackageID_2</PackageID>
      <Name>
        <Text text="Free Breakfast" language="en"/>
      </Name>
      <!-- Additional PackageData child elements omitted. -->
      <Refundable available="true" refundable_until_days="7" refundable_until_time="18:00:00"/>
      <BreakfastIncluded>1</BreakfastIncluded>
    </PackageData>
  </PropertyDataSet>
</Transaction>

রুম ক্ষমতা সীমিত

নিচের একটি উদাহরণ হল কিভাবে <Capacity> , <AdultCapacity> , <ChildCapacity> উপাদানগুলি রুমের ক্ষমতার উপর সীমাবদ্ধতা সেট করতে ব্যবহার করতে হয়।

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2020-12-18T16:20:00-04:00"
             id="12345678"
             partner="partner_key">
  <PropertyDataSet action="overlay">
    <Property>Property_1</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <Name>
        <Text text="Double" language="en"/>
      </Name>
      <Capacity>4</Capacity>
      <AdultCapacity>4</AdultCapacity>
      <ChildCapacity>3</ChildCapacity>
      <!-- Additional RoomData child elements omitted. -->
    </RoomData>
  </PropertyDataSet>
</Transaction>

ডাবল রুমের প্রকারে (RoomID_1) মোট 4 জন অতিথি থাকতে পারে৷ উপরন্তু, এটি 4 প্রাপ্তবয়স্ক এবং 3 পর্যন্ত শিশু থাকতে পারে। এই রুম বুক করার জন্য তিনটি ক্ষমতার প্রয়োজনীয়তা অবশ্যই সন্তুষ্ট হতে হবে। এই কনফিগারেশনটি দুটি শয্যা সহ একটি সাধারণ ঘরের প্রতিনিধি যা প্রতিটিতে দুটি লোকের জন্য উপযুক্ত। শিশুর ধারণক্ষমতা মোট ক্ষমতার চেয়ে এক কম কারণ ঘরে অন্তত একজন প্রাপ্তবয়স্ক থাকতে হবে।

<RoomFeatures> এবং খাবার সহ বর্ধিত উদাহরণ

JapaneseHotelRoomStyle কোনো ডিফল্ট মান নেই। একটি মান বাদ দিলে একটি XML ত্রুটি হয় না, কিন্তু ব্যবহারকারী যখন ঘরের শৈলী বা বিছানা দ্বারা ফিল্টার করে তখন আপনার তালিকা অনুসন্ধান ফলাফলে দেখানো হয় না।

দুটি একক বিছানা

নিম্নলিখিত উদাহরণ দেখায় কিভাবে <RoomFeatures> ব্যবহার করতে হয়:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
        <Beds> <!-- Two single beds -->
          <Bed size="single">
            <Width unit="cm" number="97"/>
            <Length unit="cm" number="195"/>
          </Bed>
          <Bed size="single">
            <Width unit="cm" number="97"/>
            <Length unit="cm" number="195"/>
          </Bed>
        </Beds>
        <Suite/>
        <Capsule/>
        <Roomsharing>private</Roomsharing>
        <Outdoor/>
        <MobilityAccessible/>
        <Smoking>non_smoking</Smoking>
        <BathAndToilet relation="separate">
          <Bath bathtub="1" shower="1"/>
          <Toilet electronic_bidet="1" mobility_accessible="1"/>
        </BathAndToilet>
        <OpenAirBath/>
        <AirConditioning/>
        <Balcony/>
        <Views>
          <LakeView/>
          <MarinaView/>
          <BeachView/>
          <ForestView/>
          <MountainView/>
          <NatureView/>
        </Views>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

দুটি ডাবল বেড

নিচে দুটি double বেড সহ western শৈলীর ঘরের একটি উদাহরণ।

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>western</JapaneseHotelRoomStyle>
        <Beds> <!-- Two double beds-->
          <Bed size="double"></Bed>
          <Bed size="double"></Bed>
        </Beds>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

বিছানা ছাড়া জাপানি শৈলী

নীচে বিছানা ছাড়া জাপানি শৈলী ঘরের একটি উদাহরণ। japanese শৈলী রুম জন্য বিছানা তথ্য প্রয়োজন হয় না.

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese</JapaneseHotelRoomStyle>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

বিছানার সাথে জাপানি পশ্চিম

নীচে একটি japanese_western শৈলীর কক্ষের উদাহরণ রয়েছে যেখানে king আকারের বিছানা রয়েছে।

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
        <Beds>
          <Bed size="king"></Bed>
        </Beds>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>

japanese_western রুমে যদি অংশীদারের কাছে বিছানার সংখ্যার তথ্য না থাকে, তাহলে নিম্নলিখিত উদাহরণটি পড়ুন:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2023-07-23T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <RoomData>
      <RoomID>RoomID_1</RoomID>
      <RoomFeatures>
        <JapaneseHotelRoomStyle>japanese_western</JapaneseHotelRoomStyle>
      </RoomFeatures>
    </RoomData>
  </PropertyDataSet>
</Transaction>


খাবার

নিম্নলিখিত উদাহরণটি খাবার, ফটো এবং চেক-ইন এবং চেক-আউট সময়ের জন্য রুম এবং প্যাকেজ মেটাডেটা সংজ্ঞায়িত করে:

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Meals Included" language="en"/>
      </Name>
      <PhotoURL>
        <Caption>
          <Text text="Breakfast" language="en"/>
          <Text text="朝食" language="ja"/>
        </Caption>
        <URL>http://example.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Meals>
        <!-- Guests can choose to have breakfast in their room or in another
        space to avoid contact with other guests. -->
        <Breakfast included="1" in_room="1" in_private_space="1"/>
        <Dinner included="1" buffet="1"/>
      </Meals>
      <CheckinTime>15:00</CheckinTime>
      <CheckoutTime>11:00</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

শুধু সকালের নাস্তা

<?xml version="1.0" encoding="UTF-8"?>
<Transaction timestamp="2017-07-18T16:20:00-04:00" id="42">
  <PropertyDataSet>
    <Property>1234</Property>
    <PackageData>
      <PackageID>PackageID_1</PackageID>
      <Name>
        <Text text="Breakfast Included" language="en"/>
      </Name>
      <PhotoURL>
        <Caption>
          <Text text="Breakfast" language="en"/>
          <Text text="朝食" language="ja"/>
        </Caption>
        <URL>http://example.com/static/bar/image1234.jpg</URL>
      </PhotoURL>
      <Meals>
        <Breakfast included="true"/>
        <!-- Dinner not included needs to be explicitly specified -->
        <Dinner included="false"/>
      </Meals>
      <CheckinTime>15:00</CheckinTime>
      <CheckoutTime>11:00</CheckoutTime>
    </PackageData>
  </PropertyDataSet>
</Transaction>

প্রতিক্রিয়া

বাক্য গঠন

TransactionResponse (Property Data) বার্তাটি নিম্নলিখিত সিনট্যাক্স ব্যবহার করে:

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

উপাদান এবং বৈশিষ্ট্য

TransactionResponse (Property Data) বার্তায় নিম্নলিখিত উপাদান এবং বৈশিষ্ট্য রয়েছে:

উপাদান / @Attribute ঘটনা টাইপ বর্ণনা
TransactionResponse 1 Complex element একটি প্রাপ্ত লেনদেনের অনুরোধ বার্তার সফলতা বা সমস্যা নির্দেশ করে মূল উপাদান।
TransactionResponse / @timestamp 1 DateTime এই বার্তা তৈরির তারিখ এবং সময়।
TransactionResponse / @id 1 string সংশ্লিষ্ট লেনদেন বার্তা থেকে অনন্য শনাক্তকারী।
TransactionResponse / @partner 1 string এই বার্তার জন্য অংশীদার অ্যাকাউন্ট.
TransactionResponse / Success 0..1 Success নির্দেশ করে যে লেনদেন বার্তাটি সতর্কতা, ত্রুটি বা ব্যর্থতা ছাড়াই সফলভাবে প্রক্রিয়া করা হয়েছে।

হয় <Success> বা <Issues> প্রতিটি বার্তায় উপস্থিত থাকে।

TransactionResponse / Issues 0..1 Issues লেনদেন বার্তা প্রক্রিয়া করার সময় এক বা একাধিক সমস্যার সম্মুখীন হওয়ার জন্য একটি ধারক।

হয় <Success> বা <Issues> প্রতিটি বার্তায় উপস্থিত থাকে।

TransactionResponse / Issues / Issue 1..n Issue লেনদেন বার্তা প্রক্রিয়া করার সময় একটি সতর্কতা, ত্রুটি বা ব্যর্থতার বর্ণনা। এই বিষয়গুলির বিশদ বিবরণ ফিড স্ট্যাটাস ত্রুটি বার্তাগুলিতে পাওয়া যাবে।
TransactionResponse / Issues / Issue / @code 1 integer সমস্যাটির শনাক্তকারী।
TransactionResponse / Issues / Issue / @status 1 enum

যে ধরনের সমস্যার সম্মুখীন হয়েছে।

বৈধ মান হল warning , error এবং failure ।

উদাহরণ

সফলতা

নিম্নলিখিতটি একটি সফলভাবে প্রক্রিয়াকৃত লেনদেন বার্তার প্রতিক্রিয়া।

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

ইস্যু

নিম্নলিখিত একটি লেনদেন বার্তার একটি প্রতিক্রিয়া যা ত্রুটির কারণে প্রক্রিয়া করা হয়নি৷

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