عرض تجريبي مباشر

API حجز الرحلات البحرية

API الرحلات البحرية للوكالات: الإبحارات والكبائن وجداول الدفع

يتيح API الرحلات البحرية لموقعكم عرض الإبحارات الحية وتسعير فئات الكبائن وإنشاء حجوزات الكروز لدى الخط الملاحي. تشرح هذه الصفحة شكل البيانات، وكيف تعمل الكبائن والدفعات، والطريقتين لوضع مخزون الرحلات البحرية على موقعكم الخاص بـ PHPTRAVELS.

  • الإبحارات وخطوط السير
  • فئات الكبائن ومخططات الطوابق
  • العربون والدفعة النهائية
  • تكاملات كروز مخصصة

ما الذي يعيده API الرحلات البحرية

إبحار واحد موصوف بالبيانات

تُباع الرحلة البحرية على شكل إبحار: سفينة واحدة وخط سير واحد وتاريخ مغادرة واحد. وكل API رحلات بحرية، أياً كان تنسيقه، مبني حول هذه الوحدة.

يرسل البحث منطقة وشهراً أو نطاق تواريخ ومدة وعدد الضيوف. والاستجابة قائمة بالإبحارات، لكل منها السفينة والخط الملاحي وتاريخا الصعود والعودة وموانئ التوقف بأوقاتها وأيام البحر وسعر أساسي للفرد لكل فئة كبائن ما زالت متاحة.

بعد ذلك تقوم طلبات أخرى بتسعير الفئة المختارة للضيوف الفعليين، وعرض الكبائن التي يمكن اختيارها، وإنشاء الحجز، وتحصيل الدفعات عليه. تختلف أسماء الخطوط وتنسيقاتها، لذا تحوّل المنصة كل مصدر إلى نموذج موحّد للإبحار والكابينة والحجز قبل أن يراه الضيف.

الخط الملاحي

الخط الشريك لديكم

السفينة الشريكة · 7 ليالٍ

متاح
الصعود
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 الكبائن المتاحة في الفئة المختارة مع الطابق والموقع وعدد الضيوف الذين تتسع لهم كل كابينة.

الطابق 9

اختر كابينة

المقدمةالمؤخرة
0814
242636
29
011119
  • داخلية
  • مطلة على البحر
  • بشرفة
  • جناح
  • غير متاحة

كابينة 9110

داخلية

كابينة داخلية بأقل سعر في هذا الطابق. تُباع ككابينة محددة أو بحجز مضمون.

مطلة على البحر

كابينة بنافذة في المقدمة حيث يتقوس الهيكل. يعيد API ملاحظة الإطلالة مع الفئة.

بشرفة

كابينة بشرفة في منتصف السفينة. وغالباً يكون الموقع على الطابق فئة مستقلة بسعرها.

جناح

جناح باتجاه المؤخرة بشرفة أكبر. يُحجز عادةً ككابينة محددة لا بحجز مضمون.

  1. 1.عرض الكبائنبعد أن يختار الضيف الفئة، تسأل المنصة الخط عن الكبائن المتاحة فيها وترسمها على الطابق.
  2. 2.تثبيت الكابينةتتيح كثير من واجهات الرحلات البحرية تثبيت الكابينة المختارة لوقت قصير ريثما يدخل الضيف الأسماء ويدفع.
  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 وتحتفظون بها
  • يطابق الموصّل الإبحارات والفئات والكبائن
  • تتبع الحجوزات والدفعات والإلغاءات قواعد الخط

تبحثون عن موردين؟ يسرد قائمة موردي XML API للسفر خطوط الرحلات البحرية التي توزّع عبر واجهات API، ويشرح ما هو تكامل API كيف يُبنى ربط كهذا.

شاهدوا تدفق حجز الرحلات البحرية يعمل

افتحوا العرض المباشر لتبحثوا عن الإبحارات وتقارنوا فئات الكبائن وتحجزوا بعربون، ثم قارنوا الخطط في الأسعار.

الأسئلة الشائعة

أسئلة عن API الرحلات البحرية

تحدّث مع المبيعات

هو مجموعة خدمات ويب يفتحها خط ملاحي أو موحّد رحلات بحرية لبائعي السفر. يستخدمه نظامكم للبحث عن الإبحارات وقراءة خطوط السير وتسعير فئات الكبائن وعرض الكبائن المتاحة وإنشاء الحجوزات وتحصيل العربون والدفعة النهائية.

لا. وحدة الرحلات البحرية مبنية حول مخزون تديرونه بأنفسكم: السفن وفئات الكبائن والإبحارات التي تتعاقدون عليها. أما الربط بخط ملاحي أو موحّد محدد فيُطوَّر كتكامل مخصص على الكود المصدري المرفق.

تتقدمون بطلب إلى الخط الملاحي أو إلى موحّد رحلات بحرية بصفتكم بائع سفر. تختلف شروط الوصول باختلاف الخط والسوق. وتوقّعون الاتفاقية وتستلمون بيانات الاعتماد بأنفسكم؛ ولا تقدّم PHPTRAVELS أبداً بيانات اعتماد الموردين.

الحجز المضمون يؤمّن فئة كابينة بسعر محدد، ويخصص الخط الملاحي الكابينة الفعلية لاحقاً، من الفئة نفسها أو أعلى. أما حجز الكابينة المحددة فيثبّت رقم الكابينة وقت الحجز.

يحددهما الخط الملاحي لكل إبحار وتعرفة، ويعيدهما API مع الحجز. أما في الإبحارات التي تحمّلونها بأنفسكم فتحددون العربون وتاريخ استحقاق الرصيد لكل إبحار في لوحة الإدارة.

تُسعَّر الكروز لكل ضيف، وغالباً على أساس ضيفين في الكابينة. يدفع الضيف الثالث والرابع تعرفتهما، ويدفع المسافر المنفرد رسماً إضافياً، وتُضاف الضرائب والرسوم ورسوم الموانئ للفرد.

نعم. يحجز الوكلاء في بوابة B2B بتعرفاتهم الصافية وعمولاتهم الخاصة ويدفعون من محفظة الوكيل، ومن التثبيت نفسه الذي يشغّل موقعكم العام.

تتضمن خطة Enterprise واجهة PHPTRAVELS REST API وخطافات الويب مع التوثيق، وتتضمن كل خطة الكود المصدري كاملاً، فيمكن لمطوريكم توسيع محرك حجز الرحلات البحرية أو ربطه بأنظمة أخرى.

ابدؤوا بالإبحارات التي تتعاقدون عليها أصلاً، وحمّلوها في وحدة الرحلات البحرية، وراقبوا مبيعاتها. وعندما تبرر شراكة مع خط ملاحي أو حجم المبيعات ذلك، أضيفوا API ذلك الخط عبر تكامل مخصص.