Canlı demo

Gemi turu rezervasyon API'si

Acenteler için Gemi turu API: seferler, kabinler ve ödeme planları

Gemi turu API'si, web sitenizde canlı seferleri göstermenizi, kabin kategorilerini fiyatlandırmanızı ve gemi şirketinde rezervasyon oluşturmanızı sağlar. Bu sayfada verinin nasıl göründüğü, kabinlerin ve ödemelerin nasıl işlediği ve gemi turu envanterini kendi PHPTRAVELS sitenize koymanın iki yolu anlatılıyor.

  • Seferler ve güzergahlar
  • Kabin kategorileri ve güverte planları
  • Kapora ve son ödeme
  • Özel gemi turu entegrasyonları

Gemi turu API'si ne döndürür

Tek bir sefer, veri olarak

Gemi turu bir sefer olarak satılır: tek gemi, tek güzergah, tek kalkış tarihi. Biçimi ne olursa olsun her gemi turu API'si bu birimin etrafında kurulur.

Arama; bölge, ay veya tarih aralığı, süre ve misafir sayısını gönderir. Yanıt, seferlerin listesidir: her birinde gemi, gemi şirketi, biniş ve dönüş tarihleri, uğranan limanlar ve saatleri, denizde geçen günler ve müsait her kabin kategorisi için kişi başı başlangıç fiyatı bulunur.

Sonrasında diğer çağrılar seçilen kategoriyi gerçek misafirler için fiyatlandırır, seçilebilecek kabinleri listeler, rezervasyonu oluşturur ve bu rezervasyon için ödeme alır. Şirketlerin adları ve biçimleri farklı olduğundan, platform her kaynağı misafir görmeden önce aynı sefer, kabin ve rezervasyon modeline eşler.

Gemi şirketi

Partner şirketiniz

Partner gemi · 7 gece

Müsait
Biniş
2027-05-15
Dönüş
2027-05-22

Güzergah

  1. D1Southampton--:-- · 17:00
  2. D2Denizde
  3. D3Brugge (Zeebrugge)08:00 · 18:00
  4. D4Amsterdam09:00 · 19:00
  5. D5Denizde
  6. D6Kopenhag07:00 · 17:00
  7. D7Oslo09:00 · 16:00
  8. D8Southampton07:00 · --:--
Başlangıç fiyatıkişi başı, iki kişi aynı kabindeEUR 899

Örnek bir kayıttır, belirli bir gemi şirketinin biçimi değildir.

Bir gemi şirketinin sisteminden seferleri, kabin kategorilerini ve fiyatları alan tek bir gemi turu rezervasyon platformu

Kabin kategorileri

Geminin dört basamağı: iç kabin, deniz manzaralı, balkonlu, süit

Gemi turu API'si her seferin altında kabin kategorilerini listeler. Fiyatı en çok belirleyen unsur kabin kategorisidir ve her biri aynı anda birkaç şeyi değiştirir.

  1. 01İç kabinPencere yok

    Seferin giriş fiyatı. Şirketler bunu çoğu zaman güverteye ve konuma göre birkaç kategoriye böler; her birinin kendi kodu vardır.

    Fiyat seviyesi
  2. 02Deniz manzaralıPencere veya lombar

    Doğal ışık için bir üst basamak. Bazı kategorilerde manzara kısmen kapalıdır ve API bunu kategori açıklamasında belirtir.

    Fiyat seviyesi
  3. 03BalkonluÖzel balkon

    Özel bir açık hava alanı sunar. Kategoriler güverte yüksekliğine ve geminin ortasında ya da kıçında olmasına göre değişir.

    Fiyat seviyesi
  4. 04SüitBalkon ve oturma alanı

    Fiyat listesinin en üstü; ücrete çoğu zaman ek avantajlar eklenir ve en sık belirli bir kabin olarak satılan kategoridir.

    Fiyat seviyesi

Kategori kodları ve ücret kodları

Her kategorinin bir kodu vardır ve her sefer birkaç ücret koduyla satılabilir: standart ücretler, kampanyalı ücretler, grup veya acente fiyatları. Aynı kabin, ücret koduna göre farklı fiyat ve koşullar taşıyabilir.

Garantili ya da belirli kabin

Garantili rezervasyonda misafir bir kategori satın alır, şirket kabini sonradan o kategoriden veya daha üstünden atar. Belirli kabin rezervasyonunda kabin numarası rezervasyon anında sabitlenir. Birçok şirket ikisini farklı fiyatlandırır.

Kabin seçimi

Kabini güverte planından seçin

Şirket belirli kabin rezervasyonuna izin veriyorsa API, seçilen kategoride müsait kabinleri güverte, konum ve kaç kişilik olduğu bilgisiyle döndürür.

Güverte 9

Bir kabin seçin

BaşKıç
0814
242636
29
011119
  • İç kabin
  • Deniz manzaralı
  • Balkonlu
  • Süit
  • Müsait değil

Kabin 9110

İç kabin

Bu güvertedeki en düşük fiyatlı iç kabin. Belirli kabin olarak veya garantili satılır.

Deniz manzaralı

Geminin gövdesinin daraldığı baş tarafta, pencereli kabin. API, manzara notunu kategoriyle birlikte döndürür.

Balkonlu

Geminin ortasında balkonlu kabin. Güvertedeki konum çoğu zaman kendi fiyatı olan ayrı bir kategoridir.

Süit

Kıça bakan, geniş balkonlu süit. Genellikle garantili değil, belirli kabin olarak rezerve edilir.

  1. 1.Kabinleri listeleyinMisafir kategoriyi seçtikten sonra platform şirketten o kategorideki boş kabinleri ister ve güverte üzerinde çizer.
  2. 2.Kabini tutunBirçok gemi turu API'si, misafir isimleri girip ödeme yaparken seçilen kabini kısa süre tutmanıza izin verir.
  3. 3.Rezervasyonu yapınRezervasyon kabin numarasını, misafirleri ve ücret kodunu doğrular; şirket kendi rezervasyon numarasını döndürür.

PHPTRAVELS Gemi turları içinde gemiler güvertelerini ve kabin kategorilerini taşır; kabinler size ait de olsa bağlı bir şirketten de gelse misafirler gerçekleri görerek seçim yapar.

Ödeme planı

Şimdi kapora, kalanı seferden önce

Gemi turları aylar önceden rezerve edilir ve aşamalı ödenir. Her sefer ve ücret için tarihleri ve tutarları gemi şirketi belirler, API de bunları rezervasyonla birlikte döndürür.

  1. 01

    Rezervasyon ve kapora

    Misafir, kabini onaylamak için şirketin belirlediği kaporayı kişi başı veya rezervasyon başına öder.

  2. 02

    Son ödeme tarihi

    Bakiye, şirketin kalkıştan önce belirlediği tarihe kadar ödenir. Ödenmeyen rezervasyonları şirket bu tarihten sonra iptal edebilir.

  3. 03

    Belgeler

    Ödeme tamamlandığında şirket gemi turu belgelerini verir, misafir de check-in bilgilerini girer.

  4. 04

    Sefer günü

    Misafir gemiye biner. Bu andan sonraki değişiklikler gemide veya şirketin kurallarına göre yapılır.

Döneme göre iptal cezaları

Kapora dönemiCeza artıyorEn yüksek ceza

Sefere yaklaştıkça iptal durumunda ücretin daha büyük kısmı alıkonur. Dönemler ve yüzdeler her şirkete ve ücrete göre değiştiğinden, gemi turu API'si bunları rezervasyonla birlikte gönderir, platformunuz da ödemeden önce misafire gösterir.

Kendi sözleşmeli seferlerinizi satarken Gemi turları aynı şekilde çalışır: her sefer için kaporayı ve bakiye tarihini siz belirlersiniz, ödenmemiş bakiyeler ödenene kadar yönetim panelinde izlenir.

Gemi turunda fiyatlandırma

Gemi turu fiyatı nasıl oluşur

Gemi turu fiyatları otel veya uçuş fiyatlarından farklı okunur. Gemi turu API'si bileşenleri ayrı ayrı döndürür ve rezervasyon motorunuzun bunları şirketin yaptığı gibi birleştirmesi gerekir.

Şirketin fiyatının üzerine PHPTRAVELS, gemi, sefer veya kanal bazında kâr marjlarınızı ve komisyonlarınızı uygular; B2B seyahat portalı içindeki acenteler ise kendi net ücretlerini görür.

  • Kabin başına değil, kişi başına

    Gemi turu ücretleri misafir başına belirtilir. İki kişilik kabin, kişi başı ücretin iki katıdır; API her misafiri yaşına ve kabindeki sırasına göre fiyatlandırır.

  • İki kişilik doluluk esas alınır

    Başlangıç fiyatları iki misafirin aynı kabini paylaştığını varsayar. Üçüncü ve dördüncü misafirler genellikle daha düşük ücret öder, tek başına seyahat eden misafir ise tek kişi farkı öder.

  • Vergiler, harçlar ve liman ücretleri

    Devlet vergileri, harçlar ve liman ücretleri gemi turu ücretinin üzerine kişi başı eklenir. Toplamda sürpriz olmaması için bunları ayrı satırlar olarak gösterin.

  • Gemi içi kredi ve ekstralar

    Bazı ücretlere gemi içi kredi, içecek paketi veya bahşişler dahildir. API bunları ücrete dahil olanlar olarak döndürür; aynı kabin için iki ücretin farklı olmasının nedenlerinden biri budur.

Gemi turu envanteri nasıl alınır

Kendi sözleşmeleriniz ya da bir gemi şirketi API'si

Sitenize gemi turu eklemenin iki yolu vardır. Birçok acente ilkiyle başlar, hacim gerektirdiğinde ikincisini ekler.

Gemi Turları modülünde hazır

Kendi gemi turu sözleşmelerinizi yükleyin

Sözleşmeli seferlerinizi yönetim panelinden girin: gemiler, güverteler, kabin kategorileri, liman liman güzergahlar, kalkış tarihleri, kişi başı ücretler, sezonlar, kaporalar ve bakiye tarihleri. Gemi turu partnerlerine tedarikçi girişi verilerek kendi seferlerini güncel tutmaları sağlanabilir.

  • Elinizde tuttuğunuz grup yerleri ve kontenjanlar
  • Gemi şirketi başına komisyon
  • B2B acenteler için net ücretler
  • Kurduğunuz günden itibaren canlı
Özel entegrasyon

Bir gemi şirketi veya konsolidatör API'sine bağlanın

PHPTRAVELS entegrasyon listesinde hazır bir gemi turu bağlayıcısı yok. Her pakette kaynak kodun tamamı yer aldığından, bir gemi şirketi veya gemi turu konsolidatörü API'si Özel API entegrasyonu olarak bağlanır ve modülün zaten gösterdiği seferlere, kabinlere ve rezervasyonlara eşlenir.

  • Gemi şirketi veya konsolidatörle siz anlaşırsınız
  • API kimlik bilgilerini siz alır ve saklarsınız
  • Bağlayıcı seferleri, kategorileri ve kabinleri eşler
  • Rezervasyonlar, ödemeler ve iptaller şirketin kurallarına uyar

Tedarikçi mi arıyorsunuz? Seyahat XML API tedarikçi listesi sayfasında API üzerinden dağıtım yapan gemi şirketleri listelenir, API entegrasyonu nedir ise böyle bir bağlantının nasıl kurulduğunu anlatır.

Gemi turu rezervasyon akışını çalışırken görün

Canlı demoyu açıp seferleri arayın, kabin kategorilerini karşılaştırın ve kaporayla rezervasyon yapın; ardından paketleri Fiyatlandırma sayfasında karşılaştırın.

SSS

Gemi turu API'si hakkında sorular

Satış ekibiyle görüşün

Gemi turu API'si, bir gemi şirketinin veya gemi turu konsolidatörünün seyahat satıcılarına açtığı web servisleri kümesidir. Sisteminiz bunu seferleri aramak, güzergahları okumak, kabin kategorilerini fiyatlandırmak, müsait kabinleri listelemek, rezervasyon oluşturmak ve kapora ile son ödemeyi almak için kullanır.

Hayır. Gemi Turları modülü, kendi yönettiğiniz envanter etrafında kurulmuştur: sözleşme yaptığınız gemiler, kabin kategorileri ve seferler. Belirli bir gemi şirketine veya konsolidatöre bağlantı, pakete dahil kaynak kod üzerinde özel entegrasyon olarak geliştirilir.

Seyahat satıcısı olarak gemi şirketine veya bir gemi turu konsolidatörüne başvurursunuz. Erişim koşulları şirkete ve pazara göre değişir. Sözleşmeyi siz imzalar, kimlik bilgilerini siz alırsınız; PHPTRAVELS tedarikçi kimlik bilgisi sağlamaz.

Garantili rezervasyon, belirli bir fiyata bir kabin kategorisini güvence altına alır; gerçek kabini gemi şirketi sonradan o kategoriden veya daha üstünden atar. Belirli kabin rezervasyonu ise kabin numarasını rezervasyon anında sabitler.

Her sefer ve ücret için gemi şirketi belirler, API de bunları rezervasyonla birlikte döndürür. Kendiniz yüklediğiniz seferlerde kaporayı ve bakiye tarihini yönetim panelinde sefer bazında siz belirlersiniz.

Gemi turu ücretleri misafir başına, genellikle iki misafirin bir kabini paylaştığı varsayımıyla belirtilir. Üçüncü ve dördüncü misafirler kendi ücretlerini öder, tek başına seyahat eden tek kişi farkı öder; vergiler, harçlar ve liman ücretleri kişi başı eklenir.

Evet. Acenteler B2B portalında kendi net ücretleri ve komisyonlarıyla rezervasyon yapar ve acente cüzdanından öder; hepsi herkese açık sitenizle aynı kurulumdan çalışır.

Enterprise paketi, belgeleriyle birlikte PHPTRAVELS REST API'sini ve webhook'ları içerir; her pakette ise kaynak kodun tamamı yer alır. Böylece geliştiricileriniz gemi turu rezervasyon motorunu genişletebilir veya başka sistemlere bağlayabilir.

Zaten sözleşme yaptığınız seferlerle başlayın, bunları Gemi Turları modülüne yükleyin ve nasıl sattıklarına bakın. Bir gemi şirketiyle ortaklık veya hacim buna değdiğinde, o şirketin API'sini özel entegrasyonla ekleyin.