دموی زنده

API رزرو کروز

API کروز برای آژانس‌ها: سفرهای دریایی، کابین‌ها و برنامهٔ پرداخت

API کروز به وب‌سایت شما اجازه می‌دهد سفرهای دریایی را زنده نشان دهد، کلاس‌های کابین را قیمت‌گذاری کند و رزرو کروز را نزد شرکت کشتیرانی ثبت کند. این صفحه توضیح می‌دهد داده‌ها چه شکلی دارند، کابین و پرداخت چگونه کار می‌کنند و دو راه قرار دادن موجودی کروز در سایت PHPTRAVELS خودتان کدام است.

  • سفرها و برنامهٔ مسیر
  • کلاس‌های کابین و نقشهٔ عرشه
  • پیش‌پرداخت و پرداخت نهایی
  • یکپارچه‌سازی سفارشی کروز

API کروز چه برمی‌گرداند

یک سفر دریایی، توصیف‌شده با داده

کروز به‌صورت یک سفر فروخته می‌شود: یک کشتی، یک برنامهٔ مسیر، یک تاریخ حرکت. هر API کروز، با هر قالبی، حول همین واحد ساخته شده است.

جست‌وجو یک منطقه، یک ماه یا بازهٔ تاریخ، مدت سفر و تعداد مسافران را می‌فرستد. پاسخ فهرستی از سفرهاست و هر کدام کشتی، شرکت کشتیرانی، تاریخ سوار شدن و بازگشت، بنادر توقف با ساعت‌هایشان، روزهای دریانوردی و قیمت پایه برای هر نفر در هر کلاس کابینِ باز را دارد.

سپس درخواست‌های بعدی کلاس انتخاب‌شده را برای مسافران واقعی قیمت می‌زنند، کابین‌های قابل انتخاب را فهرست می‌کنند، رزرو ثبت می‌کنند و پرداخت‌ها را روی آن دریافت می‌کنند. نام و قالب شرکت‌ها فرق دارد، پس پلتفرم پیش از دیدن مسافر، هر منبع را به همان مدل سفر، کابین و رزرو تبدیل می‌کند.

شرکت کشتیرانی

شرکت همکار شما

کشتی همکار · ۷ شب

باز
سوار شدن
2027-05-15
بازگشت
2027-05-22

برنامهٔ مسیر

  1. D1ساوت‌همپتون--:-- · 17:00
  2. D2در دریا
  3. D3بروژ (زیبروگه)08:00 · 18:00
  4. D4آمستردام09:00 · 19:00
  5. D5در دریا
  6. D6کپنهاگ07:00 · 17:00
  7. D7اسلو09:00 · 16:00
  8. D8ساوت‌همپتون07:00 · --:--
قیمت پایهبرای هر نفر، دو نفر در کابینEUR 899

رکوردی نمایشی، نه قالب یک شرکت کشتیرانی مشخص.

یک پلتفرم رزرو کروز که سفرها، کلاس‌های کابین و قیمت‌ها را از سامانهٔ شرکت کشتیرانی دریافت می‌کند

کلاس‌های کابین

چهار پله در کشتی: داخلی، مشرف به دریا، بالکن‌دار، سوئیت

زیر هر سفر، API کروز کلاس‌های کابین را فهرست می‌کند. این کلاس‌ها عامل اصلی قیمت‌اند و هر کدام چند چیز را هم‌زمان تغییر می‌دهند.

  1. 01داخلیبدون پنجره

    قیمت ورودی سفر. شرکت‌ها اغلب آن را بر اساس عرشه و موقعیت به چند کلاس تقسیم می‌کنند که هر کدام کد خودشان را دارند.

    سطح قیمت
  2. 02مشرف به دریاپنجره یا دریچه

    یک پله بالاتر برای نور طبیعی. برخی کلاس‌ها دید محدود دارند که API در توضیح کلاس مشخص می‌کند.

    سطح قیمت
  3. 03بالکن‌داربالکن خصوصی

    فضای بیرونی خصوصی، با کلاس‌هایی که بسته به ارتفاع عرشه و موقعیت میانهٔ کشتی یا عقب تغییر می‌کنند.

    سطح قیمت
  4. 04سوئیتبالکن و نشیمن

    اوج فهرست قیمت، اغلب با امکانات اضافه در بهای بلیت، و کلاس‌هایی که بیشتر احتمال دارد به‌صورت کابین مشخص فروخته شوند.

    سطح قیمت

کد کلاس و کد نرخ

هر کلاس یک کد دارد و هر سفر را می‌توان با چند کد نرخ فروخت: نرخ عادی، تبلیغاتی و نرخ گروه یا آژانس. یک کابین یکسان بسته به کد نرخ می‌تواند قیمت و شرایط متفاوتی داشته باشد.

تضمینی یا کابین مشخص

در رزرو تضمینی، مسافر یک کلاس می‌خرد و شرکت بعداً کابین را در همان کلاس یا بالاتر اختصاص می‌دهد. رزرو کابین مشخص، شمارهٔ کابین را همان لحظهٔ رزرو ثابت می‌کند. بسیاری از شرکت‌ها این دو را متفاوت قیمت‌گذاری می‌کنند.

انتخاب کابین

کابین را روی نقشهٔ عرشه انتخاب کنید

وقتی شرکت رزرو کابین مشخص را اجازه دهد، API کابین‌های آزاد کلاس انتخاب‌شده را با عرشه، موقعیت و ظرفیت هر کدام برمی‌گرداند.

عرشهٔ ۹

یک کابین را انتخاب کنید

جلوعقب
0814
242636
29
011119
  • داخلی
  • مشرف به دریا
  • بالکن‌دار
  • سوئیت
  • در دسترس نیست

کابین 9110

داخلی

کابین داخلی، کمترین قیمت در این عرشه. به‌صورت کابین مشخص یا تضمینی فروخته می‌شود.

مشرف به دریا

کابین پنجره‌دار در دماغهٔ کشتی که بدنه خمیده است. API توضیح دید را همراه کلاس برمی‌گرداند.

بالکن‌دار

کابین بالکن‌دار در میانهٔ کشتی. موقعیت روی عرشه اغلب کلاس جداگانه‌ای با قیمت خودش است.

سوئیت

سوئیت رو به عقب با بالکن بزرگ‌تر. معمولاً به‌صورت کابین مشخص رزرو می‌شود، نه تضمینی.

  1. 1.فهرست کابین‌هاپس از انتخاب کلاس توسط مسافر، پلتفرم از شرکت کابین‌های آزاد آن کلاس را می‌پرسد و روی عرشه نشان می‌دهد.
  2. 2.نگه داشتن کابینبسیاری از API‌های کروز اجازه می‌دهند کابین انتخاب‌شده تا زمانی که مسافر نام‌ها را وارد و پرداخت می‌کند، مدتی کوتاه نگه داشته شود.
  3. 3.رزرورزرو شمارهٔ کابین، مسافران و کد نرخ را تأیید می‌کند و شرکت شمارهٔ رزرو خود را برمی‌گرداند.

در کروز PHPTRAVELS، کشتی‌ها عرشه‌ها و کلاس‌های کابین خود را دارند و مسافر با اطلاعات کامل انتخاب می‌کند، چه کابین‌ها مال شما باشند چه از یک شرکت متصل بیایند.

برنامهٔ پرداخت

الان پیش‌پرداخت، بقیه پیش از حرکت

کروز ماه‌ها زودتر رزرو و مرحله‌ای پرداخت می‌شود. شرکت کشتیرانی تاریخ و مبلغ هر مرحله را برای هر سفر و نرخ تعیین می‌کند و API آن‌ها را همراه رزرو برمی‌گرداند.

  1. 01

    رزرو و پیش‌پرداخت

    مسافر برای تأیید کابین، پیش‌پرداختی را که شرکت تعیین کرده، به‌ازای هر نفر یا هر رزرو می‌پردازد.

  2. 02

    سررسید پرداخت نهایی

    مانده تا تاریخی که شرکت پیش از حرکت تعیین می‌کند باید پرداخت شود. شرکت می‌تواند رزروهای پرداخت‌نشده را پس از آن لغو کند.

  3. 03

    مدارک

    پس از پرداخت کامل، شرکت مدارک کروز را صادر می‌کند و مسافر اطلاعات ورود به کشتی را تکمیل می‌کند.

  4. 04

    روز حرکت

    مسافر سوار می‌شود. تغییرات پس از این مرحله روی کشتی یا طبق قوانین شرکت انجام می‌شود.

جریمهٔ لغو بر اساس بازهٔ زمانی

بازهٔ پیش‌پرداختجریمه افزایش می‌یابدبیشترین جریمه

هرچه به زمان حرکت نزدیک‌تر شوید، سهم بیشتری از بها هنگام لغو نگه داشته می‌شود. بازه‌ها و درصدها به هر شرکت و نرخ مربوط‌اند، پس API کروز آن‌ها را همراه رزرو می‌فرستد و پلتفرم شما پیش از پرداخت به مسافر نشان می‌دهد.

وقتی سفرهای قراردادیِ خودتان را می‌فروشید، کروز همین‌طور کار می‌کند: پیش‌پرداخت و تاریخ سررسید مانده را برای هر سفر تعیین می‌کنید و مانده‌های پرداخت‌نشده تا زمان پرداخت در مدیریت پیگیری می‌شوند.

قیمت‌گذاری در کروز

قیمت کروز چگونه ساخته می‌شود

قیمت کروز با قیمت هتل یا پرواز فرق دارد. API کروز اجزا را جدا برمی‌گرداند و موتور رزرو شما باید آن‌ها را همان‌طور که شرکت می‌کند کنار هم بگذارد.

PHPTRAVELS روی قیمت شرکت، مارکاپ و کمیسیون شما را بر اساس کشتی، سفر یا کانال اعمال می‌کند و نمایندگان در پورتال سفر B2B نرخ خالص خودشان را می‌بینند.

  • به‌ازای هر نفر، نه هر کابین

    نرخ کروز برای هر مسافر اعلام می‌شود. کابین دونفره دو برابر نرخ یک نفر است و API هر مسافر را بر اساس سن و جایگاهش در کابین قیمت می‌زند.

  • بر پایهٔ دو نفر در کابین

    قیمت پایه دو مسافر در یک کابین را فرض می‌کند. نفر سوم و چهارم معمولاً نرخ کمتری می‌پردازند و مسافر تنها هزینهٔ اضافهٔ تک‌نفره می‌دهد.

  • مالیات، کارمزد و عوارض بندری

    مالیات دولتی، کارمزدها و عوارض بندری به‌ازای هر نفر روی نرخ کروز اضافه می‌شوند. آن‌ها را در ردیف‌های جدا نشان دهید تا جمع کل غافلگیری نداشته باشد.

  • اعتبار روی کشتی و موارد اضافه

    برخی نرخ‌ها اعتبار خرج روی کشتی، بستهٔ نوشیدنی یا انعام را شامل می‌شوند. API اینها را به‌عنوان موارد شامل نرخ برمی‌گرداند و یکی از دلایل تفاوت دو نرخ برای یک کابین است.

چگونه موجودی کروز بگیریم

قراردادهای خودتان یا API شرکت کشتیرانی

برای آوردن کروز به سایتتان دو راه هست. بسیاری از آژانس‌ها از راه اول شروع می‌کنند و وقتی حجم کار توجیه کرد، دومی را اضافه می‌کنند.

آماده در ماژول کروز

قراردادهای کروز خودتان را بارگذاری کنید

سفرهایی را که قرارداد می‌بندید در مدیریت وارد کنید: کشتی‌ها، عرشه‌ها، کلاس‌های کابین، برنامهٔ مسیر بندر به بندر، تاریخ حرکت، نرخ هر نفر، فصل‌ها، پیش‌پرداخت‌ها و تاریخ مانده. به شرکای کروز می‌توان ورود تأمین‌کننده داد تا سفرهای خودشان را به‌روز نگه دارند.

  • فضای گروهی و سهمیه‌هایی که نگه می‌دارید
  • کمیسیون برای هر شرکت کشتیرانی
  • نرخ خالص برای نمایندگان B2B
  • از روز نصب فعال است
یکپارچه‌سازی سفارشی

به API شرکت کشتیرانی یا تجمیع‌کننده وصل شوید

در فهرست یکپارچه‌سازی‌های PHPTRAVELS کانکتور آمادهٔ کروز وجود ندارد. چون هر طرح سورس‌کد کامل را شامل می‌شود، API شرکت کشتیرانی یا تجمیع‌کنندهٔ کروز به‌صورت یکپارچه‌سازی API سفارشی وصل و با همان سفرها، کابین‌ها و رزروهایی که ماژول نشان می‌دهد تطبیق داده می‌شود.

  • شما با شرکت کشتیرانی یا تجمیع‌کننده قرارداد می‌بندید
  • اطلاعات دسترسی API را خودتان دریافت و نگهداری می‌کنید
  • کانکتور سفرها، کلاس‌ها و کابین‌ها را تطبیق می‌دهد
  • رزرو، پرداخت و لغو از قوانین شرکت پیروی می‌کند

دنبال تأمین‌کننده می‌گردید؟ فهرست تأمین‌کنندگان travel XML API شرکت‌های کروزی را فهرست می‌کند که از طریق API توزیع می‌کنند و یکپارچه‌سازی API چیست توضیح می‌دهد چنین اتصالی چگونه ساخته می‌شود.

جریان رزرو کروز را در عمل ببینید

دموی زنده را باز کنید تا سفرها را جست‌وجو کنید، کلاس‌های کابین را مقایسه کنید و با پیش‌پرداخت رزرو کنید، سپس طرح‌ها را در قیمت‌ها مقایسه کنید.

پرسش‌های متداول

پرسش‌های API کروز

گفتگو با فروش

API کروز مجموعه‌ای از وب‌سرویس‌هاست که شرکت کشتیرانی یا تجمیع‌کنندهٔ کروز در اختیار فروشندگان سفر می‌گذارد. سامانهٔ شما با آن سفرها را جست‌وجو می‌کند، برنامهٔ مسیر را می‌خواند، کلاس‌های کابین را قیمت می‌زند، کابین‌های آزاد را فهرست می‌کند، رزرو ثبت می‌کند و پیش‌پرداخت و پرداخت نهایی را دریافت می‌کند.

خیر. ماژول کروز حول موجودی ساخته شده که خودتان مدیریت می‌کنید: کشتی‌ها، کلاس‌های کابین و سفرهایی که قرارداد می‌بندید. اتصال به یک شرکت کشتیرانی یا تجمیع‌کنندهٔ مشخص، به‌صورت یکپارچه‌سازی سفارشی روی سورس‌کد همراه توسعه داده می‌شود.

به‌عنوان فروشندهٔ سفر از شرکت کشتیرانی یا یک تجمیع‌کنندهٔ کروز درخواست می‌دهید. شرایط دسترسی بسته به شرکت و بازار فرق دارد. قرارداد را خودتان امضا و اطلاعات دسترسی را خودتان دریافت می‌کنید؛ PHPTRAVELS هرگز اطلاعات دسترسی تأمین‌کننده نمی‌دهد.

رزرو تضمینی یک کلاس کابین را با قیمت مشخص تضمین می‌کند و شرکت کشتیرانی کابین واقعی را بعداً در همان کلاس یا بالاتر اختصاص می‌دهد. رزرو کابین مشخص، شمارهٔ کابین را در زمان رزرو ثابت می‌کند.

شرکت کشتیرانی برای هر سفر و نرخ تعیین می‌کند و API آن‌ها را همراه رزرو برمی‌گرداند. برای سفرهایی که خودتان بارگذاری می‌کنید، پیش‌پرداخت و تاریخ سررسید مانده را برای هر سفر در مدیریت تعیین می‌کنید.

نرخ کروز برای هر مسافر اعلام می‌شود، معمولاً بر پایهٔ دو نفر در یک کابین. نفر سوم و چهارم نرخ خودشان را می‌پردازند، مسافر تنها هزینهٔ اضافهٔ تک‌نفره می‌دهد و مالیات، کارمزد و عوارض بندری به‌ازای هر نفر اضافه می‌شود.

بله. نمایندگان در پورتال B2B با نرخ خالص و کمیسیون خودشان رزرو می‌کنند و از کیف پول نماینده می‌پردازند، روی همان نصبی که سایت عمومی شما را اجرا می‌کند.

طرح Enterprise شامل PHPTRAVELS REST API و وب‌هوک‌ها همراه مستندات است و هر طرح سورس‌کد کامل را دارد، پس توسعه‌دهندگان شما می‌توانند موتور رزرو کروز را گسترش دهند یا به سامانه‌های دیگر وصل کنند.

از سفرهایی شروع کنید که همین حالا قرارداد دارید، آن‌ها را در ماژول کروز بارگذاری کنید و فروششان را ببینید. وقتی همکاری با یک شرکت کشتیرانی یا حجم فروش توجیه کرد، API آن شرکت را با یکپارچه‌سازی سفارشی اضافه کنید.