অনুরোধ
বাক্য গঠন
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>
<!-- Add Loyalty point information -->
<MilesIncluded>
<LoyaltyCampaignID>campaign-ID</LoyaltyCampaignID>
<!-- (Optional) Use <NumberOfMiles> if the rate plan earns fixed loyalty rewards-->
<NumberOfMiles>integer</NumberOfMiles>
</MilesIncluded>
<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>
উপাদান এবং বৈশিষ্ট্য
লেনদেন (সম্পত্তি তথ্য) বার্তাটিতে নিম্নলিখিত উপাদান এবং বৈশিষ্ট্য রয়েছে:
| এলিমেন্ট / @অ্যাট্রিবিউট | ঘটনা | আদর্শ | বিবরণ |
|---|---|---|---|
| Transaction | 1 | Complex element | একটি ARI বাস্তবায়নে, এটি একটি বার্তার মূল উপাদান যা একটি একক সম্পত্তির জন্য রুমের ধরণ এবং প্যাকেজ নির্ধারণ করে। |
| Transaction / @timestamp | 1 | DateTime | এই বার্তাটি তৈরির তারিখ এবং সময়। |
| Transaction / @id | 1 | string | এই অনুরোধ বার্তার জন্য একটি অনন্য শনাক্তকারী। এই মানটি প্রতিক্রিয়া বার্তায় ফেরত পাঠানো হয়। অনুমোদিত অক্ষরগুলি হল az, AZ, 0-9, _ (আন্ডারস্কোর), এবং - (ড্যাশ)। |
| Transaction / @partner | 1 | string | এই বার্তার জন্য পার্টনার অ্যাকাউন্ট। এই স্ট্রিং মানটি হল হোটেল সেন্টারের অ্যাকাউন্ট সেটিংস পৃষ্ঠায় তালিকাভুক্ত "পার্টনার কী" মান। দ্রষ্টব্য: যদি আপনার এমন একটি ব্যাকএন্ড থাকে যা একাধিক অ্যাকাউন্টের জন্য ফিড সরবরাহ করে, তাহলে এই মানটি আপনার |
| Transaction / PropertyDataSet | 1.. | PropertyDataSet | একটি একক সম্পত্তির জন্য ঘরের ধরণ এবং প্যাকেজ নির্ধারণের জন্য একটি ধারক। আপনাকে শুধুমাত্র একবার |
| Transaction / PropertyDataSet / @action | 0..1 | enum | রুম রেটের সংজ্ঞায় প্রয়োগ করার জন্য আপডেটের ধরণ। বৈধ মানগুলি হল:
এই বৈশিষ্ট্যটি ঐচ্ছিক এবং নির্দিষ্ট না করা থাকলে ডিফল্টভাবে |
| Transaction / PropertyDataSet / Property | 1 | string | প্রপার্টির জন্য অনন্য শনাক্তকারী। এই মানটি হোটেল তালিকা ফিডে <listing> উপাদানে <id> ব্যবহার করে নির্দিষ্ট করা হোটেল আইডির সাথে মিলতে হবে। হোটেল আইডিটি হোটেল সেন্টারেও তালিকাভুক্ত। |
| Transaction / PropertyDataSet / RoomData | 0..n | RoomData | একটি ঘরের বর্ণনা দেয়। দ্রষ্টব্য: |
| Transaction / PropertyDataSet / RoomData / RoomID | 1 | RoomID | এক ধরণের ঘরের জন্য একটি অনন্য শনাক্তকারী। <OTA_HotelAvailNotifRQ> , <OTA_HotelRateAmountNotifRQ> এবং <OTA_HotelInvCountNotifRQ> বার্তাগুলিতে <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> উপাদানের জন্য একটি ধারক। যদি যদি |
| Transaction / PropertyDataSet / RoomData / AllowablePackageIDs / AllowablePackageID | 1..n | AllowablePackageID | এই ধরণের রুমের সাথে মিলিত হতে পারে এমন একটি রেট প্ল্যানের প্যাকেজআইডি নির্দিষ্ট করে। প্যাকেজ, রেট এবং প্রাপ্যতার সংমিশ্রণ দ্বারা একটি রেট প্ল্যান সংজ্ঞায়িত করা হয়। PackageID OTA_HotelRateAmountNotifRQ এবং OTA_HotelAvailNotifRQ বার্তাগুলিতে RatePlanCode এর সাথে সম্পর্কিত। |
| Transaction / PropertyDataSet / RoomData / Capacity | 0..1 | integer | একটি ঘরে সর্বাধিক কতজন প্রাপ্তবয়স্ক এবং শিশু থাকতে পারে। এটি আপনার রেটের সাথে পাঠানো যেকোনো NumberOfGuests মানের চেয়ে বেশি বা সমান হওয়া উচিত। দ্রষ্টব্য: যদি |
| Transaction / PropertyDataSet / RoomData / AdultCapacity | 0..1 | integer | একটি ঘরে সর্বাধিক কতজন প্রাপ্তবয়স্ক ব্যক্তি থাকতে পারবেন। এটি আপনার রেটের সাথে পাঠানো যেকোনো NumberOfGuests মানের চেয়ে বেশি বা সমান হওয়া উচিত। |
| Transaction / PropertyDataSet / RoomData / ChildCapacity | 0..1 | integer | একটি কক্ষে সর্বোচ্চ কত সংখ্যক শিশু শারীরিকভাবে থাকতে পারে। |
| Transaction / PropertyDataSet / RoomData / OccupancySettings | 0..1 | OccupancySettings | কোনও ঘরের ধারণক্ষমতার প্রয়োজনীয়তা সীমাবদ্ধ বা পরিবর্তন করতে পারে এমন সেটিংস।
<OccupancySettings> <MinOccupancy>2</MinOccupancy> <MinAge>16</MinAge> </OccupancySettings> সকল শিশু উপাদান অন্তর্ভুক্ত করার প্রয়োজন নেই। |
| Transaction / PropertyDataSet / RoomData / PhotoURL | 0..n | PhotoURL | প্রদত্ত রুম বা রুম বান্ডেলের ছবির জন্য একটি URL এবং ঐচ্ছিক ক্যাপশন। আপনি একটি রুম বা রুম বান্ডেলের জন্য একাধিক <PhotoURL> নির্দিষ্ট করতে পারেন।এই উপাদানটি নিম্নলিখিত চাইল্ড উপাদানগুলি গ্রহণ করে:
<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 | জাপানি হোটেল রুমের স্টাইল নির্দেশ করে। বৈধ মানগুলি হল:
|
| Transaction / PropertyDataSet / RoomData / RoomFeatures / Beds | 0..1 | Object | ঘরে যতগুলি <Bed> আছে ততগুলিই আছে। দয়া করে মনে রাখবেন যে জাপানি ফিউটন এখানে গণনা করা উচিত নয়। প্রতিটি
<Bed> এ নিম্নলিখিত চাইল্ড এলিমেন্ট থাকে:
<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 | ঘরে একটি স্নান এবং টয়লেট সম্পর্কে তথ্য রয়েছে। বৈশিষ্ট্যটি হল:
ঐচ্ছিকভাবে, উপাদানটি নিম্নলিখিত চাইল্ড উপাদানগুলি গ্রহণ করে:
উদাহরণ: <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 | বৈধ বিকল্পগুলির মধ্যে রয়েছে: |
| Transaction / PropertyDataSet / PackageData | 0..n | 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> এলিমেন্টের জন্য একটি কন্টেইনার। যদি যদি |
| Transaction / PropertyDataSet / PackageData / AllowableRoomIDs / AllowableRoomID | 1..n | AllowableRoomID | এই রেট প্ল্যানের সাথে মিলিত হতে পারে এমন একটি রুম টাইপের RoomID নির্দিষ্ট করে। একটি রুম টাইপ একটি <RoomData> এলিমেন্টে সংজ্ঞায়িত করা হয়। |
| Transaction / PropertyDataSet / PackageData / MilesIncluded | 0..1 | MilesIncluded | রেট প্ল্যান বা প্যাকেজগুলি কীভাবে সংজ্ঞায়িত করা হয় তার উপর ভিত্তি করে প্যাকেজগুলিতে লয়্যালটি পয়েন্টের তথ্য যোগ করুন। রেট প্ল্যান সংজ্ঞায়িত করে এমন <PackageData> উপাদানের মধ্যে <MilesIncluded> উপাদানটি নির্দিষ্ট করুন। <MilesIncluded> নিম্নলিখিত চাইল্ড উপাদান রয়েছে:
|
| Transaction / PropertyDataSet / PackageData / Refundable | 0..1 | Refundable | সম্পূর্ণরূপে ফেরতযোগ্য বা বাতিলযোগ্য হিসাবে একটি হার তালিকাভুক্ত করতে সক্ষম করে। যদি প্রদান না করা হয়, তাহলে ফেরত সম্পর্কে কোনও তথ্য প্রদর্শিত হবে না। দ্রষ্টব্য: আমরা সমস্ত বৈশিষ্ট্য সেট করার পরামর্শ দিচ্ছি। এক বা একাধিক বৈশিষ্ট্য সেট না থাকলে একটি ফিড স্ট্যাটাস সতর্কতা বার্তা তৈরি হয়। যদি আপনি কোনও বৈশিষ্ট্য সেট না করেন, তাহলে হার ফেরতযোগ্য হিসাবে প্রদর্শিত হবে না। বৈশিষ্ট্যগুলি সেট করার সময়, নিম্নলিখিতগুলি লক্ষ্য করুন:
|
| 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 এর সাথে একত্রিত করে উল্লেখ করা যেতে পারে, উদাহরণস্বরূপ, "চেক-ইন করার দুই দিন আগে বিকাল ৪:০০ টা পর্যন্ত অর্থ ফেরত পাওয়া যাবে"। যদি refundable_until_time সেট না করা থাকে, তাহলে মানটি ডিফল্টভাবে মধ্যরাতে নির্ধারিত হয়। |
| Transaction / PropertyDataSet / PackageData / BreakfastIncluded | 0..1 | boolean | এই ধরণের রুমে ব্রেকফাস্ট অন্তর্ভুক্ত কিনা তা নির্দিষ্ট করে। বৈধ মান হল 0 (অথবা false ) এবং 1 (অথবা true )। |
| Transaction / PropertyDataSet / PackageData / CheckinTime | 0..1 | Time | হোটেলের স্থানীয় সময় অনুসারে যত তাড়াতাড়ি সম্ভব চেক-ইন সময়। সময় অবশ্যই রাত ১২:০০ এর কম হতে হবে। |
| 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 | এই প্যাকেজে খাবার সম্পর্কে তথ্য রয়েছে।
ঐচ্ছিক বৈশিষ্ট্যগুলি শুধুমাত্র তখনই ব্যবহৃত হয় যখন খাবারের ফিল্টারগুলি ( |
| 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>
<MilesIncluded>
<LoyaltyCampaignID>my_campaign</LoyaltyCampaignID>
</MilesIncluded>
<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 রুমের ধরণগুলি আর বিদ্যমান থাকবে না। মনে রাখবেন যে প্যাকেজ ডেটা অপসারণ করলে Transaction (Property Data), 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 ) শুধুমাত্র প্যাকেজ এবং রেট প্ল্যানের সাথে একত্রিত করা যেতে পারে যা PackageID_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) তে মোট ৪ জন পর্যন্ত অতিথি থাকতে পারে। এছাড়াও, এতে ৪ জন প্রাপ্তবয়স্ক এবং ৩ জন পর্যন্ত শিশু থাকতে পারে। এই রুমটি বুক করার জন্য তিনটি ধারণক্ষমতার প্রয়োজনীয়তা পূরণ করতে হবে। এই কনফিগারেশনটি একটি সাধারণ কক্ষের প্রতিনিধিত্ব করে যেখানে দুটি বিছানা থাকে এবং প্রতিটিতে দুজন করে বসতে পারে। শিশু ধারণক্ষমতা মোট ধারণক্ষমতার চেয়ে একটি কম কারণ ঘরে কমপক্ষে একজন প্রাপ্তবয়স্ক উপস্থিত থাকতে হবে।
<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) বার্তাটিতে নিম্নলিখিত উপাদান এবং বৈশিষ্ট্য রয়েছে:
| এলিমেন্ট / @অ্যাট্রিবিউট | ঘটনা | আদর্শ | বিবরণ |
|---|---|---|---|
| TransactionResponse | 1 | Complex element | প্রাপ্ত লেনদেনের অনুরোধ বার্তার সাফল্য বা সমস্যা নির্দেশ করে এমন মূল উপাদান। |
| TransactionResponse / @timestamp | 1 | DateTime | এই বার্তাটি তৈরির তারিখ এবং সময়। |
| TransactionResponse / @id | 1 | string | সংশ্লিষ্ট লেনদেন বার্তা থেকে অনন্য শনাক্তকারী। |
| TransactionResponse / @partner | 1 | string | এই বার্তার জন্য অংশীদার অ্যাকাউন্ট। |
| TransactionResponse / Success | 0..1 | Success | নির্দেশ করে যে লেনদেনের বার্তাটি সতর্কতা, ত্রুটি বা ব্যর্থতা ছাড়াই সফলভাবে প্রক্রিয়া করা হয়েছে। প্রতিটি বার্তায় |
| TransactionResponse / Issues | 0..1 | Issues | লেনদেন বার্তা প্রক্রিয়াকরণের সময় সম্মুখীন হওয়া এক বা একাধিক সমস্যার জন্য একটি ধারক। প্রতিটি বার্তায় |
| TransactionResponse / Issues / Issue | 1..n | Issue | লেনদেন বার্তা প্রক্রিয়াকরণের সময় একটি সতর্কতা, ত্রুটি, বা ব্যর্থতার বর্ণনা। এই সমস্যাগুলির বিশদ বিবরণ ফিড স্ট্যাটাস ত্রুটি বার্তাগুলিতে পাওয়া যাবে। |
| TransactionResponse / Issues / Issue / @code | 1 | integer | সমস্যার শনাক্তকারী। |
| TransactionResponse / Issues / Issue / @status | 1 | enum | যে ধরণের সমস্যার সম্মুখীন হয়েছেন। বৈধ মানগুলি হল |
উদাহরণ
সাফল্য
নিচে একটি সফলভাবে প্রক্রিয়াকৃত লেনদেন বার্তার প্রতিক্রিয়া দেওয়া হল।
<?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>