航空券API連携

旅行会社のためのDuffel API連携

Duffelの航空券コンテンツをPHPTRAVELSの予約プラットフォームに取り込みます。Duffelはお客様のアカウントで利用できるオファーと注文を提供し、PHPTRAVELSはサイト、決済、マークアップ、代理店管理を担います。

  • 既存のDuffel航空券モジュール
  • NDC、GDS、LCCのコンテンツ
  • 代理店マークアップ設定
  • 本番前のテストモード

仕組み

予約プラットフォームをDuffelの航空券に接続

Duffel API連携では、二つの判断を分けて考えます。お客様が使う予約プラットフォームと、航空券の検索結果を支えるサプライヤーアカウントです。PHPTRAVELSは航空券カテゴリーにAPI認証情報とマークアップ設定を備えたDuffelモジュールを用意しており、APIアクセスと最初の検索を解説したセットアップガイドがdocs.phptravels.comにあります。まずこの接続から始め、ローンチに必要な予約とアフターサービスの範囲をチームで決めてください。

  1. Duffelアカウントを作成し、販売市場とコンテンツへのアクセスを確認
  2. 試験設定用にDuffelのテスト用アクセストークンを準備
  3. PHPTRAVELS管理画面のモジュールからDuffel設定を開き、認証情報を入力
  4. マークアップを設定し、検索、旅客情報、決済、注文確認を検証
  5. Duffelの有効化要件を満たし、本番用の認証情報に切り替え
環境
テストモード
エンドポイント
Duffel API · api.duffel.com
アクセストークン
duffel_test_••••••••
マークアップ
Duffel運賃に8%

予約の流れ

Duffelでの検索から確定した注文まで

お客様の決済からサプライヤーの確認への引き継ぎを含め、設定した接続を評価するためにこの流れを使ってください。

  1. 検索

    旅程と旅客をDuffelに送り、航空券のオファーを受け取ります。

  2. 確認

    選んだオファーを再取得し、価格と空席を最新に保ちます。

  3. 予約

    旅客情報と支払いを受け、Duffelで注文を作成します。

  4. 確定

    注文と航空会社の予約番号を確認し、お客様に通知します。

  5. アフター

    変更と取消は航空会社の規則と合意した範囲に従います。

役割分担

Duffel連携でそれぞれが担う役割

実際に機能する接続には、プラットフォーム、承認済みのサプライヤーアカウント、代理店の運用プロセスが必要です。ローンチ日を決める前に三つを定めてください。

  • PHPTRAVELS:予約プラットフォーム

    サイト、Duffelモジュール設定、マークアップ設定、予約管理。プランによって利用できるB2B・B2Cツールが決まります。

  • Duffel:航空券の接続先

    APIを通じて航空会社のオファーと注文サービスを提供。航空会社、コンテンツ、予約後の操作はDuffel、航空会社、アカウントによって異なります。

  • 代理店:商業的な業務フロー

    サプライヤーとの契約、販売価格、顧客の支払い、サポート。保留中の予約や旅行者の依頼を誰が担当するかも含みます。

接続できる航空券サプライヤー:

  • Seeru
  • Amadeus
  • Duffel
  • Google Flights
  • Kayak
  • Kiwi
  • Mystifly
  • PKfare
  • Sabre
  • TBO Holidays
  • Travelport
すべての連携を見る

バックオフィス

管理画面からDuffelの航空券販売を運用

Duffel予約の設定、価格、運用ルールを、旅行事業のほかの業務と同じダッシュボードで管理します。

  • モジュール設定

    モジュール画面でDuffel APIの認証情報を入力し、テストと本番の設定を分けて保持します。

  • マークアップと販売価格

    代理店のマークアップを保存し、最終価格をサプライヤー手数料、通貨、決済コストと照らし合わせます。

  • B2CとB2Bチャネル

    Duffelを最初にどのチャネルで使うか決め、エージェントのアクセス、価格、決済を検証します。

  • 未確定の注文

    未確認のサプライヤー注文をスタッフが見つけられる明確な手順を用意し、支払いを発券済みと扱わないようにします。

  • 費用項目の分離

    ライセンス、ホスティング、決済処理、カスタム開発、Duffelの手数料を別々の予算項目として計画します。

  • 追加のワークフロー

    モジュールを超える座席指定、有料手荷物、アフターサービスは連携カスタマイズとして範囲を決められます。

比較

Duffel APIで自社開発する場合とPHPTRAVELS

Duffelは航空券APIを提供しますが、その周りの予約プロダクトは別に必要です。自社開発で一般的に必要になる作業をPHPTRAVELSと比べました。

項目Duffelでの自社開発PHPTRAVELS
顧客向けサイトDuffelでの自社開発検索、結果、決済をゼロから設計・開発PHPTRAVELS自社ブランドの航空券検索、結果、決済が用意済み
Duffel接続Duffelでの自社開発オファーと注文の呼び出しを開発者が実装・テストPHPTRAVELS認証情報とマークアップ設定を備えた既存のDuffelモジュール
管理とマークアップDuffelでの自社開発予約管理画面と価格ルールはこれから開発PHPTRAVELS予約管理とモジュールのマークアップを一つのダッシュボードで
エージェントチャネルDuffelでの自社開発B2Bポータルは別プロジェクトPHPTRAVELSプランに応じてB2B・B2Cツールをプラットフォームに搭載
ほかの商品Duffelでの自社開発新しいサプライヤーや商品ごとに追加開発PHPTRAVELSホテル、ツアー、レンタカーなどのサプライヤーモジュールを同じ環境で

活用例

DuffelをPHPTRAVELSに接続する事業者

  • 新しいオンライン旅行会社

    初日からDuffelのコンテンツで自社ブランドの航空券予約サイトを立ち上げ、後から商品を追加できます。

  • IATA認可のない代理店

    対象となる事業者は、Duffelの承認を条件に、Duffelの認可と発券権限のもとでDuffel Managed Contentを利用できます。

  • B2Bエージェントネットワーク

    パートナーエージェントに独自のアクセスと価格ルールでDuffelの航空券を提供できます。内容はプランに応じて決めます。

PHPTRAVELSを選ぶ理由

自社のDuffelアカウント、自社のプラットフォーム、自社のコード

  • ソースコード付き

    商用ライセンスのセルフホスト型で、開発者がDuffelのフローを拡張できます。

  • 自社のDuffel認証情報

    Duffelアカウントとアクセストークンはお客様が保有し、自社の環境に保存されます。

  • ドキュメント化されたセットアップ

    docs.phptravels.comのDuffelセットアップガイドがAPIアクセスと最初の検索を解説します。

  • B2CとB2B

    公開サイトとエージェントポータルを一つの環境で、24言語に対応。

よくある質問

Duffel API連携に関する質問

モジュール、サプライヤーへのアクセス、ローンチ要件を検討する代理店からの質問です。

営業に相談

Duffelの航空券サプライヤーモジュールをPHPTRAVELSの予約プラットフォームに接続するものです。Duffelアカウントが対象となる航空券コンテンツへのアクセスを提供し、PHPTRAVELSが顧客向けサイトと代理店管理を提供します。

はい。PHPTRAVELSは航空券カテゴリーにDuffelモジュールを掲載し、APIアクセスと最初の検索を解説したセットアップガイドを公開しています。ローンチ前に、導入済みのバージョンとの互換性と必要な予約操作を確認してください。

Duffelアカウントを作成してAPI認証情報を取得し、PHPTRAVELS管理画面のDuffelモジュール設定に入力します。マークアップを設定し、本番に移る前にテストモードで連携を検証してください。

Duffelは自社の認可と発券権限を使うManaged Contentを提供しており、アカウントの有効化と利用可能なコンテンツが条件です。対象かどうかはDuffelに確認してください。PHPTRAVELSに接続しても、御社がIATA認可を得るわけではありません。

完全に同等とは考えないでください。座席指定、有料手荷物、変更、取消などのアフターサービスは、PHPTRAVELSモジュールのバージョン、航空会社の対応、合意した連携範囲に照らして確認が必要です。

いいえ。Duffelのテストモードはサンドボックスのコンテンツとテスト用認証情報を使います。動作の検証には役立ちますが、テスト結果は実際の空席や商用の運賃見積もりではありません。