船会社
提携船会社
提携船 · 7泊
- 乗船日
- 2027-05-15
- 下船日
- 2027-05-22
日程
- D1サウサンプトン--:-- · 17:00
- D2終日航海
- D3ブルージュ(ゼーブルージュ)08:00 · 18:00
- D4アムステルダム09:00 · 19:00
- D5終日航海
- D6コペンハーゲン07:00 · 17:00
- D7オスロ09:00 · 16:00
- D8サウサンプトン07:00 · --:--
説明用のレコードであり、特定の船会社の形式ではありません。
クルーズ予約API
クルーズAPIを使えば、自社サイトにリアルタイムの出航便を表示し、キャビンカテゴリーの料金を算出し、船会社に対してクルーズ予約を作成できます。このページでは、データの中身、キャビンと支払いの仕組み、そしてPHPTRAVELSサイトにクルーズ在庫を載せる2つの方法を解説します。
クルーズAPIが返すもの
クルーズは出航便という単位で販売されます。1隻の船、1つの日程、1つの出発日です。形式が違っても、すべてのクルーズAPIはこの単位を軸に作られています。
検索では、地域、月または日付範囲、日数、乗船人数を送信します。レスポンスは出航便の一覧で、各便には船名、船会社、乗船日と下船日、寄港地とその時刻、終日航海の日数、そして空きのあるキャビンカテゴリーごとの1人あたりの代表料金が含まれます。
その後は、選んだカテゴリーを実際の乗船者で価格計算し、選択可能なキャビンを一覧し、予約を確定し、その予約に対する支払いを受け付ける、という呼び出しが続きます。船会社ごとに名称も形式も違うため、プラットフォームはゲストに見せる前に、あらゆるソースを共通の出航便・キャビン・予約モデルに変換します。
船会社
提携船会社
提携船 · 7泊
日程
説明用のレコードであり、特定の船会社の形式ではありません。

キャビンカテゴリー
クルーズAPIは、各出航便の下にキャビンカテゴリーを一覧します。カテゴリーは価格を左右する最大の要素で、それぞれが複数の条件を同時に変えます。
その出航便の入口となる価格です。船会社はデッキや位置によって複数のカテゴリーに分け、それぞれにコードを付けることがよくあります。
自然光が入る一段上のキャビンです。眺望が遮られるカテゴリーもあり、APIはカテゴリーの説明にその旨を記します。
専用の屋外スペースがあります。デッキの高さや、船体中央か船尾かによってカテゴリーが分かれます。
料金表の最上位で、運賃に特典が付くことが多く、特定のキャビンとして販売されやすいカテゴリーです。
各カテゴリーにはコードがあり、1つの出航便は複数の運賃コードで販売されます。通常運賃、プロモーション運賃、団体・代理店向け料金などです。同じキャビンでも、運賃コードによって価格と条件が変わります。
保証予約では、ゲストがカテゴリーを購入し、船会社が後から同カテゴリーかそれ以上のキャビンを割り当てます。キャビン指定の予約では、予約時にキャビン番号が確定します。多くの船会社は両者の料金を変えています。
キャビン選択
船会社がキャビン指定の予約を認めている場合、APIは選んだカテゴリーで空いているキャビンを、デッキ、位置、定員とともに返します。
デッキ9
キャビンを選択
キャビン 9110
内側
内側キャビンで、このデッキで最も安い価格です。キャビン指定または保証予約で販売されます。
オーシャンビュー
船首の船体が絞り込まれる位置にある窓付きキャビンです。APIはカテゴリーとともに眺望の注記を返します。
バルコニー
船体中央のバルコニーキャビンです。デッキ上の位置が、独自の価格を持つ別カテゴリーになっていることもよくあります。
スイート
船尾向きで広いバルコニー付きのスイートです。通常は保証予約ではなく、キャビン指定で予約されます。
PHPTRAVELSのクルーズでは、船ごとにデッキとキャビンカテゴリーを持たせられ、キャビンが自社のものでも提携船会社から取得したものでも、ゲストは事実を確認しながら選べます。
支払スケジュール
クルーズは数か月前に予約し、段階的に支払います。日付と金額は出航便と運賃ごとに船会社が定め、APIが予約とともに返します。
ゲストは、船会社が定めたデポジットを1人あたり、または1予約あたりで支払い、キャビンを確定します。
残金は、船会社が出発前に定める期日までに支払います。未払いの予約は、期日後に船会社が取り消すことがあります。
全額支払いが済むと、船会社がクルーズ書類を発行し、ゲストは乗船手続きの情報を入力します。
ゲストが乗船します。これ以降の変更は、船内または船会社の規則に従って対応します。
出航が近いほど、キャンセル時に差し引かれる運賃の割合が大きくなります。期間と割合は船会社と運賃ごとに異なるため、クルーズAPIが予約とともに送信し、プラットフォームが支払い前にゲストへ表示します。
自社で契約した出航便を販売する場合も、クルーズの仕組みは同じです。出航便ごとにデポジットと残金の期日を設定し、未払い残高は支払われるまで管理画面で追跡されます。
クルーズの料金
クルーズの料金は、ホテルや航空券とは見え方が違います。クルーズAPIは構成要素を別々に返すため、予約エンジンは船会社と同じ方法でそれらを組み合わせる必要があります。
船会社の価格に加えて、PHPTRAVELSは船、出航便、チャネルごとにマークアップと手数料を適用し、B2B 旅行ポータルのエージェントには各自のネット運賃が表示されます。
クルーズ運賃はゲスト1名ごとに提示されます。2名用キャビンは1名運賃の2倍で、APIは年齢とキャビン内の位置に応じて各ゲストの料金を算出します。
代表料金は2名1室利用が前提です。3人目と4人目は通常、低めの運賃となり、1人で乗船するゲストには1人部屋追加料金がかかります。
政府税、手数料、港湾使用料は、クルーズ運賃に加えて1名ごとに上乗せされます。合計金額に想定外の費用が出ないよう、別々の行で表示してください。
運賃に船内クレジット、ドリンクパッケージ、チップが含まれる場合があります。APIはこれらを運賃の含まれる内容として返し、同じキャビンでも運賃が異なる理由になります。
クルーズ在庫の入手方法
サイトにクルーズを載せる方法は2つあります。多くの旅行会社はまず1つ目から始め、取扱量が増えたら2つ目を追加します。
契約している出航便を管理画面で入力します。船、デッキ、キャビンカテゴリー、寄港地ごとの日程、出発日、1人あたりの運賃、シーズン、デポジット、残金期日を登録できます。クルーズのパートナーにはサプライヤー用ログインを発行し、自社の出航便を自分で最新に保ってもらえます。
PHPTRAVELSの連携リストに、すぐ使えるクルーズ用コネクターはありません。すべてのプランにソースコード一式が含まれるため、船会社やクルーズコンソリデーターのAPIはカスタムAPI連携として接続し、モジュールがすでに表示している出航便、キャビン、予約に対応付けます。
サプライヤーをお探しですか?旅行XML APIサプライヤー一覧には、APIで販売している船会社が掲載されており、API連携とはでは、こうした接続の作り方を解説しています。
クルーズAPIとは、船会社やクルーズコンソリデーターが旅行販売事業者に公開するWebサービス群です。システムから出航便の検索、日程の取得、キャビンカテゴリーの価格計算、空きキャビンの一覧、予約、デポジットと最終支払いの受け付けができます。
いいえ。クルーズモジュールは、ご自身が管理する在庫、つまり契約した船、キャビンカテゴリー、出航便を中心に作られています。特定の船会社やコンソリデーターとの接続は、付属のソースコードをもとにカスタム連携として開発します。
旅行販売事業者として、船会社またはクルーズコンソリデーターに申し込みます。利用条件は船会社や市場によって異なります。契約の締結と認証情報の受け取りはご自身で行います。PHPTRAVELSがサプライヤーの認証情報を提供することはありません。
保証予約は、決まった価格でキャビンカテゴリーを確保するもので、実際のキャビンは後から船会社が同カテゴリーかそれ以上で割り当てます。キャビン指定の予約では、予約時にキャビン番号が確定します。
船会社が出航便と運賃ごとに定め、APIが予約とともに返します。ご自身で登録した出航便については、管理画面で出航便ごとにデポジットと残金の期日を設定します。
クルーズ運賃はゲスト1名ごとに提示され、通常は2名1室が基準です。3人目と4人目はそれぞれの運賃を支払い、1人利用のゲストには1人部屋追加料金がかかり、税金、手数料、港湾使用料は1名ごとに加算されます。
はい。エージェントはB2Bポータルで、各自のネット運賃と手数料を使って予約し、エージェントウォレットから支払います。一般公開サイトと同じインストールで運用できます。
EnterpriseプランにはPHPTRAVELS REST APIとWebhook、およびドキュメントが含まれ、すべてのプランにソースコード一式が含まれるため、開発者はクルーズ予約エンジンを拡張したり、他のシステムと接続したりできます。
まず、すでに契約している出航便をクルーズモジュールに登録し、売れ行きを確かめましょう。船会社との提携や取扱量が見合う段階になったら、カスタム連携でその船会社のAPIを追加します。
広告効果測定のための Cookie
当サイトでは、どの広告が訪問やお問い合わせにつながったかを測定し、関連性の高い広告を表示するために Google の Cookie を使用しています。許可する場合は「同意する」を、サイトの動作に必要な Cookie のみを使用する場合は「拒否する」を選択してください。 プライバシーに関する声明