হোটেল ও ফ্লাইট বুকিং API: এক ট্রিপ, দুই বুকিং

টিকিটে লেখা আছে: "ফ্লাইট বুকিং ফ্লোতে হোটেল যোগ করো, একটাই চেকআউট, একটাই মোট দাম।" একজন প্রোডাক্ট ম্যানেজারের কাছ থেকে এটা যুক্তিসঙ্গত অনুরোধ, আর শুনতে এক দিনের কাজ মনে হয়, কারণ ফ্লাইট সার্চ আপনার আগে থেকেই আছে, পেমেন্ট পেজও আছে। তিন সপ্তাহ পরে দেখা যায় টিম তর্ক করছে, এয়ারলাইন নিশ্চিত করল কিন্তু হোটেল করল না, তখন কী হবে। হোটেল ও ফ্লাইট বুকিং API দুই ধরনের ফলাফলওয়ালা একটা ইন্টিগ্রেশন নয়। এটা দুটো ইন্টিগ্রেশন, যারা একটা ঝুড়ি ভাগ করে নেয়।
কোড যত তাড়াতাড়ি এটা মেনে নেয়, তত কম কোড নতুন করে লিখতে হয়। এরপর যা আসছে তা সেই অংশ যেটা ইন্টিগ্রেশন গাইডগুলো এড়িয়ে যায়: দুই অর্ধেক কীভাবে আলাদা, কোনটা আগে নিশ্চিত করবেন, আর আপনার ডেটা মডেলে একটা ট্রিপ আসলে কী হওয়া উচিত।
দুই অর্ধেক একইভাবে আচরণ করে না
দুটোই দাম আর একটা রেফারেন্সসহ JSON হিসেবে ফেরে, তাই নেটওয়ার্কে এদের একরকম দেখায়। কিন্তু রেফারেন্স হাতে পাওয়ার পর তারা আপনাকে যা প্রতিশ্রুতি দেয়, তাতে এদের মধ্যে কোনো মিল নেই।
| প্রশ্ন | ফ্লাইট | হোটেল |
|---|---|---|
| বুকিংয়ের পর হাতে কী থাকে | একটা রিজার্ভেশন (PNR), যা এখনো টিকিট হয়নি | একটা কনফার্মেশন, যা সাধারণত আপনি যা বিক্রি করেছেন সেটাই |
| দাম কতক্ষণ বহাল থাকে | বুকিংয়ের সময় ভাড়া আবার হিসাব না হওয়া পর্যন্ত, যা সার্চের দামের থেকে আলাদা হতে পারে | রেট মেয়াদ শেষ না হওয়া পর্যন্ত, আর অ্যাভেইলেবিলিটি দেখা আর বুকিংয়ের মাঝে রেট বদলে যেতে পারে |
| কী দিয়ে নিশ্চিত হয় | টিকিট ইস্যু, প্রায়ই একটা সময়সীমার মধ্যে | সাপ্লায়ারের কনফার্মেশন, কখনো সঙ্গে সঙ্গে, কখনো অপেক্ষমাণ |
| কীভাবে বাতিল হয় | দ্রুত ধরা পড়লে void, নইলে ভাড়ার নিয়ম মেনে রিফান্ড, প্রায়ই জরিমানাসহ | রেটের নিজস্ব নীতি মেনে ক্যানসেলেশন, অনেক রেটে একটা নির্দিষ্ট সময় পর্যন্ত বিনামূল্যে |
| শেষ মুহূর্তে সংখ্যা বদলায় কী | ভাড়া, ট্যাক্স, কখনো ভাড়ার মুদ্রা | হোটেলে পরিশোধযোগ্য ট্যাক্স ও ফি, খাবারের ধরন, আসলে যে রুম বরাদ্দ হয় |
সাপ্লায়ারভেদে পার্থক্য থাকে বলে কোনো একটা সারির সঙ্গে আপনি দ্বিমত করতে পারেন, কিন্তু পুরো আকৃতির সঙ্গে নয়: এক অর্ধেকে টিকিট ইস্যুর ধাপ আছে, আরেক অর্ধেকে ক্যানসেলেশনের সময়সীমা, আর সময়ের হিসাবে এরা মেলে না। ফ্লাইটের দিকের ক্রম নিয়ে আমরা লিখেছি ফ্লাইট বুকিং API ইন্টিগ্রেশন-এ, আর হোটেলের দিকের ধীর সাপ্লায়ারের সমস্যা নিয়ে হোটেল অ্যাভেইলেবিলিটি API ক্লায়েন্ট ডিজাইন-এ। এই লেখা শুরু হচ্ছে সেখান থেকে, যেখানে ওগুলো শেষ হয়েছে: জোড়ার জায়গায়।
কোনটা আগে বুক করবেন?
কেউ আপনাকে বলে না যে এটা একটা ডিজাইন সিদ্ধান্ত, অথচ এই সিদ্ধান্তই ঠিক করে একটা ব্যর্থতার দাম কত।
ধরা যাক একজন গ্রাহক একই তারিখের জন্য ফ্লাইট আর হোটেল কিনছেন। আপনি একটা বুকিং পাঠান, তারপর অন্যটা। তিনটে জিনিস ঘটতে পারে: দুটোই সফল হয়, অথবা একটা ব্যর্থ হয়, অথবা অন্যটা সফল হওয়ার পরে একটা ব্যর্থ হয়। প্রথমটা একটা ভালো দিন। বাকি দুটোই ঠিক করে আপনার সাপোর্টের সারি কত লম্বা হবে।
আপনি যদি আগে ফ্লাইটের টিকিট ইস্যু করেন আর তারপর হোটেল প্রত্যাখ্যান করে, তাহলে আপনার হাতে এমন এক গ্রাহক যাঁর একটা শহরে যাওয়ার সিট আছে কিন্তু থাকার রুম নেই, যাঁর টাকা আগেই কাটা হয়ে গেছে, আর এমন একটা টিকিটের রিফান্ড যার সঙ্গে জরিমানা আছে। আপনি যদি আগে হোটেল বুক করেন আর তারপর ফ্লাইট ব্যর্থ হয়, তাহলে আপনার হাতে এমন একটা রুম যেটা প্রায়ই বিনামূল্যে বাতিল করা যায়, তাই মেরামত সস্তা। উল্টো ঝুঁকিও সত্যি, কারণ যে হোটেল রেট বাতিল করা যায় না সেটা হাতে রাখা আরও খারাপ, তাই হোটেলকে আগে যেতে দেওয়ার আগে রেটের ক্যানসেলেশন শর্ত পড়ে নিন।
এটা একটা মোটা দাগের নিয়ম, আইন নয়, আর মূল কথা হলো ক্রমটা ভেবেচিন্তে বেছে নিতে হবে। যে অর্ধেক বাতিল করা সহজ, সেটা কঠিনটার আগে নিশ্চিত করুন, যেকোনোটা নিশ্চিত হওয়ার ঠিক আগে দুটোরই দাম আবার যাচাই করুন, আর তিনটে ফলাফলের প্রতিটির জন্য কী করবেন তা লিখে রাখুন। কোড রিভিউয়াররা কদাচিৎ জিজ্ঞেস করেন। গ্রাহকেরা সবসময় টের পান।
এক ট্রিপ, দুই বুকিং
যে কাঠামো টেকে তা হলো একটা ট্রিপ রেকর্ড, যার অধীনে দুটো বুকিং, প্রত্যেকটার নিজস্ব রেফারেন্স, নিজস্ব স্ট্যাটাস আর নিজস্ব শর্ত। গ্রাহক একটা মোট দাম দেখেন। আপনার ডেটাবেস দেখে দুটো সারি, আর মোট দামটা আপনার হিসাব করা একটা যোগফল, সাপ্লায়ারের কাছে থাকা কোনো জিনিস নয়।
দুটো স্ট্যাটাস আলাদা রাখুন। হোটেলের "কনফার্মড" আর ফ্লাইটের "টিকিটেড" একই অবস্থা নয়, আর যে একটা স্ট্যাটাস কলাম এদের এক করে দেয়, সেটা আজ হোক কাল হোক অর্ধেক-বুক-হওয়া ট্রিপের ওপর লিখবে "বুকড"।
দুই সেট পরিবর্তনের শর্তও আলাদা রাখুন, আর সেগুলো দেখান। দেখানো মোট দাম লুকিয়ে রাখে যে তারিখ বদলানো এক অর্ধেকে বিনামূল্যে আর অন্য অর্ধেকে ফি লাগে। আপনার ফ্রন্ট এন্ড যদি "তারিখ বদলান" একটা বোতাম হিসেবে দেখায়, তাহলে শুধু এক অর্ধেক সরানো গেলে সেই বোতাম কী করবে, তা গ্রাহক আপনার হয়ে আবিষ্কার করার আগেই ঠিক করুন। মার্কআপের ক্ষেত্রেও একই কথা: বেশিরভাগ বিক্রেতার মতো আপনি যদি প্রতিটি সার্ভিসে আলাদা মার্কআপ যোগ করেন, তাহলে ট্রিপের মোট দামে দুটো মার্কআপ থাকে, আর এক অর্ধেকের রিফান্ডকে জানতে হবে কোন মার্কআপ ফেরত দিচ্ছে। জোড়া লাগানো ট্রিপ ব্যয়বহুল হয়ে ওঠে টাকার জায়গায়, কারণ প্রতিটা লাইন আলাদা সময়সূচিতে সেটল হয়, আর ফ্লাইটের রিফান্ড হোটেলের ক্যানসেলেশনের সঙ্গে একই সময়ে আসে না।
এই প্ল্যাটফর্ম কোথায় দাঁড়িয়ে
সোজাসুজি বলি: এই প্ল্যাটফর্ম ফ্লাইট ও হোটেল API দেয়, আর অ্যাক্সেস শুরু হয় একটা আলোচনা দিয়ে, সেলফ-সার্ভ কী দিয়ে নয়। সার্ভিসগুলো প্রতিটি টেন্যান্টের জন্য আলাদাভাবে চালু হয়, তাই যে টেন্যান্ট হোটেল বিক্রি করে কিন্তু ট্যুর নয়, তাকে ট্যুরের অংশ বইতে হয় না। এখানে এমন কোনো একক কলের প্রতিশ্রুতি নেই যা দুই অর্ধেককে অ্যাটমিকভাবে একসঙ্গে বুক করে, আর এমন কিছু আছে ধরে নিয়ে ডিজাইন করাও উচিত নয়। এদের যা আছে তা-ই ধরুন: দুটো বুকিং, আপনার নিজের মালিকানার একটা ট্রিপের অধীনে।
এর ওপর কিছু বানানোর আগে আসল কল আর শর্তগুলো দেখতে চাইলে ট্রাভেল API পেজ থেকে শুরু করুন, আর কোন ক্রমে বুক করতে চান সেটা সঙ্গে আনুন। ফ্রি অ্যাক্সেস আপনাকে কী দেয় তা নিয়ে এখনো ভাবছেন? ফ্রি হোটেল বুকিং API "ফ্রি"-এর ধরনগুলো সাজিয়ে বলেছে।
ভুল হলে দাম কত
সবচেয়ে ব্যয়বহুল রূপটা নিঃশব্দ। একজন গ্রাহকের একটা শহরের টিকিট ইস্যু হয়ে গেছে আর রুমটা নেই, আর আপনি প্রথম খবর পান রাতে, কোনো বিমানবন্দর থেকে আসা একটা মেসেজে। তার চেয়ে সস্তা কিন্তু তবুও বাস্তব: এমন চেকআউট যা একটা আশ্বস্ত করা মোট দাম দেখায় আর তারপর, দাম আবার যাচাইয়ের পর, এমন একটা দ্বিতীয় সংখ্যা দেখায় যাতে গ্রাহক রাজি হননি; এমন রিফান্ড যা ফ্লাইট ফেরত দেয় আর হোটেল ভুলে যায়; আর এমন স্ট্যাটাস যা বলে "বুকড" অথচ সাপ্লায়ার অন্য কথা বলছে।
এর কোনোটার জন্যই চতুর সমাধান লাগে না। লাগে এটুকু যে ট্রিপ একটা আসল অবজেক্ট হবে, বুকিংয়ের ক্রম হবে এমন একটা সিদ্ধান্ত যা কেউ লিখে রেখেছে, আর যেকোনো একটা নিশ্চিত হওয়ার ঠিক আগে দুটো দামই শেষবার আবার যাচাই হবে। এটা একবার বানান, তারপর চেকআউট দেখতে ঠিক ততটাই সহজ হতে পারে যতটা টিকিটে চাওয়া হয়েছিল।