ライブデモ

クルーズ予約API

旅行会社向けクルーズAPI:出航便、キャビン、支払スケジュール

クルーズAPIを使えば、自社サイトにリアルタイムの出航便を表示し、キャビンカテゴリーの料金を算出し、船会社に対してクルーズ予約を作成できます。このページでは、データの中身、キャビンと支払いの仕組み、そしてPHPTRAVELSサイトにクルーズ在庫を載せる2つの方法を解説します。

  • 出航便と寄港地日程
  • キャビンカテゴリーとデッキプラン
  • デポジットと最終支払い
  • クルーズのカスタム連携

クルーズAPIが返すもの

1つの出航便をデータで表す

クルーズは出航便という単位で販売されます。1隻の船、1つの日程、1つの出発日です。形式が違っても、すべてのクルーズAPIはこの単位を軸に作られています。

検索では、地域、月または日付範囲、日数、乗船人数を送信します。レスポンスは出航便の一覧で、各便には船名、船会社、乗船日と下船日、寄港地とその時刻、終日航海の日数、そして空きのあるキャビンカテゴリーごとの1人あたりの代表料金が含まれます。

その後は、選んだカテゴリーを実際の乗船者で価格計算し、選択可能なキャビンを一覧し、予約を確定し、その予約に対する支払いを受け付ける、という呼び出しが続きます。船会社ごとに名称も形式も違うため、プラットフォームはゲストに見せる前に、あらゆるソースを共通の出航便・キャビン・予約モデルに変換します。

船会社

提携船会社

提携船 · 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 · --:--
代表料金1名あたり、2名1室利用EUR 899

説明用のレコードであり、特定の船会社の形式ではありません。

船会社のシステムから出航便、キャビンカテゴリー、料金を受け取る1つのクルーズ予約プラットフォーム

キャビンカテゴリー

船内の4段階:内側、オーシャンビュー、バルコニー、スイート

クルーズAPIは、各出航便の下にキャビンカテゴリーを一覧します。カテゴリーは価格を左右する最大の要素で、それぞれが複数の条件を同時に変えます。

  1. 01内側窓なし

    その出航便の入口となる価格です。船会社はデッキや位置によって複数のカテゴリーに分け、それぞれにコードを付けることがよくあります。

    価格帯
  2. 02オーシャンビュー窓または丸窓

    自然光が入る一段上のキャビンです。眺望が遮られるカテゴリーもあり、APIはカテゴリーの説明にその旨を記します。

    価格帯
  3. 03バルコニー専用バルコニー

    専用の屋外スペースがあります。デッキの高さや、船体中央か船尾かによってカテゴリーが分かれます。

    価格帯
  4. 04スイートバルコニーとリビング

    料金表の最上位で、運賃に特典が付くことが多く、特定のキャビンとして販売されやすいカテゴリーです。

    価格帯

カテゴリーコードと運賃コード

各カテゴリーにはコードがあり、1つの出航便は複数の運賃コードで販売されます。通常運賃、プロモーション運賃、団体・代理店向け料金などです。同じキャビンでも、運賃コードによって価格と条件が変わります。

保証予約か、キャビン指定か

保証予約では、ゲストがカテゴリーを購入し、船会社が後から同カテゴリーかそれ以上のキャビンを割り当てます。キャビン指定の予約では、予約時にキャビン番号が確定します。多くの船会社は両者の料金を変えています。

キャビン選択

デッキプランからキャビンを選ぶ

船会社がキャビン指定の予約を認めている場合、APIは選んだカテゴリーで空いているキャビンを、デッキ、位置、定員とともに返します。

デッキ9

キャビンを選択

船首側船尾側
0814
242636
29
011119
  • 内側
  • オーシャンビュー
  • バルコニー
  • スイート
  • 利用不可

キャビン 9110

内側

内側キャビンで、このデッキで最も安い価格です。キャビン指定または保証予約で販売されます。

オーシャンビュー

船首の船体が絞り込まれる位置にある窓付きキャビンです。APIはカテゴリーとともに眺望の注記を返します。

バルコニー

船体中央のバルコニーキャビンです。デッキ上の位置が、独自の価格を持つ別カテゴリーになっていることもよくあります。

スイート

船尾向きで広いバルコニー付きのスイートです。通常は保証予約ではなく、キャビン指定で予約されます。

  1. 1.キャビンを一覧するゲストがカテゴリーを選ぶと、プラットフォームが船会社に空きキャビンを問い合わせ、デッキ上に表示します。
  2. 2.キャビンを仮押さえする多くのクルーズAPIでは、ゲストが氏名を入力して支払う間、選んだキャビンを短時間だけ確保できます。
  3. 3.予約する予約でキャビン番号、ゲスト、運賃コードが確定し、船会社が予約番号を返します。

PHPTRAVELSのクルーズでは、船ごとにデッキとキャビンカテゴリーを持たせられ、キャビンが自社のものでも提携船会社から取得したものでも、ゲストは事実を確認しながら選べます。

支払スケジュール

まずデポジット、残りは出航前に

クルーズは数か月前に予約し、段階的に支払います。日付と金額は出航便と運賃ごとに船会社が定め、APIが予約とともに返します。

  1. 01

    予約とデポジット

    ゲストは、船会社が定めたデポジットを1人あたり、または1予約あたりで支払い、キャビンを確定します。

  2. 02

    最終支払い期限

    残金は、船会社が出発前に定める期日までに支払います。未払いの予約は、期日後に船会社が取り消すことがあります。

  3. 03

    書類

    全額支払いが済むと、船会社がクルーズ書類を発行し、ゲストは乗船手続きの情報を入力します。

  4. 04

    出航日

    ゲストが乗船します。これ以降の変更は、船内または船会社の規則に従って対応します。

期間ごとのキャンセル料

デポジット期間キャンセル料が増加最高額のキャンセル料

出航が近いほど、キャンセル時に差し引かれる運賃の割合が大きくなります。期間と割合は船会社と運賃ごとに異なるため、クルーズAPIが予約とともに送信し、プラットフォームが支払い前にゲストへ表示します。

自社で契約した出航便を販売する場合も、クルーズの仕組みは同じです。出航便ごとにデポジットと残金の期日を設定し、未払い残高は支払われるまで管理画面で追跡されます。

クルーズの料金

クルーズ料金の成り立ち

クルーズの料金は、ホテルや航空券とは見え方が違います。クルーズAPIは構成要素を別々に返すため、予約エンジンは船会社と同じ方法でそれらを組み合わせる必要があります。

船会社の価格に加えて、PHPTRAVELSは船、出航便、チャネルごとにマークアップと手数料を適用し、B2B 旅行ポータルのエージェントには各自のネット運賃が表示されます。

  • 1室ではなく1名あたり

    クルーズ運賃はゲスト1名ごとに提示されます。2名用キャビンは1名運賃の2倍で、APIは年齢とキャビン内の位置に応じて各ゲストの料金を算出します。

  • 2名1室が基準

    代表料金は2名1室利用が前提です。3人目と4人目は通常、低めの運賃となり、1人で乗船するゲストには1人部屋追加料金がかかります。

  • 税金、手数料、港湾使用料

    政府税、手数料、港湾使用料は、クルーズ運賃に加えて1名ごとに上乗せされます。合計金額に想定外の費用が出ないよう、別々の行で表示してください。

  • 船内クレジットと特典

    運賃に船内クレジット、ドリンクパッケージ、チップが含まれる場合があります。APIはこれらを運賃の含まれる内容として返し、同じキャビンでも運賃が異なる理由になります。

クルーズ在庫の入手方法

自社契約か、船会社のAPIか

サイトにクルーズを載せる方法は2つあります。多くの旅行会社はまず1つ目から始め、取扱量が増えたら2つ目を追加します。

クルーズモジュールで利用可能

自社のクルーズ契約を登録する

契約している出航便を管理画面で入力します。船、デッキ、キャビンカテゴリー、寄港地ごとの日程、出発日、1人あたりの運賃、シーズン、デポジット、残金期日を登録できます。クルーズのパートナーにはサプライヤー用ログインを発行し、自社の出航便を自分で最新に保ってもらえます。

  • 確保しているグループ枠と割り当て
  • 船会社ごとの手数料
  • B2Bエージェント向けネット運賃
  • インストールした日から利用可能
カスタム連携

船会社またはコンソリデーターのAPIに接続する

PHPTRAVELSの連携リストに、すぐ使えるクルーズ用コネクターはありません。すべてのプランにソースコード一式が含まれるため、船会社やクルーズコンソリデーターのAPIはカスタムAPI連携として接続し、モジュールがすでに表示している出航便、キャビン、予約に対応付けます。

  • 船会社またはコンソリデーターと契約を結ぶ
  • APIの認証情報を受け取り、ご自身で管理する
  • コネクターが出航便、カテゴリー、キャビンを対応付ける
  • 予約、支払い、キャンセルは船会社の規則に従う

サプライヤーをお探しですか?旅行XML APIサプライヤー一覧には、APIで販売している船会社が掲載されており、API連携とはでは、こうした接続の作り方を解説しています。

クルーズ予約の流れを実際にご覧ください

ライブデモで出航便を検索し、キャビンカテゴリーを比較して、デポジットで予約してみましょう。プランの比較は料金をご覧ください。

よくある質問

クルーズAPIに関するよくある質問

営業に相談

クルーズAPIとは、船会社やクルーズコンソリデーターが旅行販売事業者に公開するWebサービス群です。システムから出航便の検索、日程の取得、キャビンカテゴリーの価格計算、空きキャビンの一覧、予約、デポジットと最終支払いの受け付けができます。

いいえ。クルーズモジュールは、ご自身が管理する在庫、つまり契約した船、キャビンカテゴリー、出航便を中心に作られています。特定の船会社やコンソリデーターとの接続は、付属のソースコードをもとにカスタム連携として開発します。

旅行販売事業者として、船会社またはクルーズコンソリデーターに申し込みます。利用条件は船会社や市場によって異なります。契約の締結と認証情報の受け取りはご自身で行います。PHPTRAVELSがサプライヤーの認証情報を提供することはありません。

保証予約は、決まった価格でキャビンカテゴリーを確保するもので、実際のキャビンは後から船会社が同カテゴリーかそれ以上で割り当てます。キャビン指定の予約では、予約時にキャビン番号が確定します。

船会社が出航便と運賃ごとに定め、APIが予約とともに返します。ご自身で登録した出航便については、管理画面で出航便ごとにデポジットと残金の期日を設定します。

クルーズ運賃はゲスト1名ごとに提示され、通常は2名1室が基準です。3人目と4人目はそれぞれの運賃を支払い、1人利用のゲストには1人部屋追加料金がかかり、税金、手数料、港湾使用料は1名ごとに加算されます。

はい。エージェントはB2Bポータルで、各自のネット運賃と手数料を使って予約し、エージェントウォレットから支払います。一般公開サイトと同じインストールで運用できます。

EnterpriseプランにはPHPTRAVELS REST APIとWebhook、およびドキュメントが含まれ、すべてのプランにソースコード一式が含まれるため、開発者はクルーズ予約エンジンを拡張したり、他のシステムと接続したりできます。

まず、すでに契約している出航便をクルーズモジュールに登録し、売れ行きを確かめましょう。船会社との提携や取扱量が見合う段階になったら、カスタム連携でその船会社のAPIを追加します。