航空券API連携
旅行会社のためのDuffel API連携
Duffelの航空券コンテンツをPHPTRAVELSの予約プラットフォームに取り込みます。Duffelはお客様のアカウントで利用できるオファーと注文を提供し、PHPTRAVELSはサイト、決済、マークアップ、代理店管理を担います。
- 既存のDuffel航空券モジュール
- NDC、GDS、LCCのコンテンツ
- 代理店マークアップ設定
- 本番前のテストモード
仕組み
予約プラットフォームをDuffelの航空券に接続
Duffel API連携では、二つの判断を分けて考えます。お客様が使う予約プラットフォームと、航空券の検索結果を支えるサプライヤーアカウントです。PHPTRAVELSは航空券カテゴリーにAPI認証情報とマークアップ設定を備えたDuffelモジュールを用意しており、APIアクセスと最初の検索を解説したセットアップガイドがdocs.phptravels.comにあります。まずこの接続から始め、ローンチに必要な予約とアフターサービスの範囲をチームで決めてください。
- Duffelアカウントを作成し、販売市場とコンテンツへのアクセスを確認
- 試験設定用にDuffelのテスト用アクセストークンを準備
- PHPTRAVELS管理画面のモジュールからDuffel設定を開き、認証情報を入力
- マークアップを設定し、検索、旅客情報、決済、注文確認を検証
- Duffelの有効化要件を満たし、本番用の認証情報に切り替え
- 環境
- テストモード
- エンドポイント
- Duffel API · api.duffel.com
- アクセストークン
- duffel_test_••••••••
- マークアップ
- Duffel運賃に8%
オファーと注文
検索にはDuffelのオファー、管理画面には注文
DuffelのAPIはオファーと注文で動きます。各結果には、お客様が比較する運賃の詳細と、予約プロセスが依存するステータスが表示されます。
- NDC08:25 LHR → 11:30 JFK直行便 · エコノミー · 受託手荷物1個$486合計
- GDS12:10 LHR → 15:20 JFK直行便 · プレミアムエコノミー · 座席指定$912合計
- 17:40 LHR → 23:55 JFKDUB経由1回乗継 · エコノミー · 機内持込のみ$455合計
航空券オファー検索
旅程と旅客の条件をDuffelに送り、アカウントで利用できるオファーが検索結果に戻ります。
決済前のオファー確認
検索後に空席や価格が変わることがあるため、選択したオファーを決済前に再取得します。
旅客情報
決済画面でDuffelの注文作成に必要な旅客情報を集め、合意した決済プロセスに進みます。
注文と予約番号
返された注文と航空会社の予約番号を確認してから、お客様に確認を送ります。
モジュールのマークアップ
Duffelモジュール設定でマークアップを設定し、表示される販売価格に利益を含めます。
テストと本番を分離
Duffelのテストモードはサンドボックスのコンテンツとテスト用認証情報を使い、本番リソースとは分かれています。
予約の流れ
Duffelでの検索から確定した注文まで
お客様の決済からサプライヤーの確認への引き継ぎを含め、設定した接続を評価するためにこの流れを使ってください。
検索
旅程と旅客をDuffelに送り、航空券のオファーを受け取ります。
確認
選んだオファーを再取得し、価格と空席を最新に保ちます。
予約
旅客情報と支払いを受け、Duffelで注文を作成します。
確定
注文と航空会社の予約番号を確認し、お客様に通知します。
アフター
変更と取消は航空会社の規則と合意した範囲に従います。
役割分担
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の航空券サプライヤーモジュールをPHPTRAVELSの予約プラットフォームに接続するものです。Duffelアカウントが対象となる航空券コンテンツへのアクセスを提供し、PHPTRAVELSが顧客向けサイトと代理店管理を提供します。
はい。PHPTRAVELSは航空券カテゴリーにDuffelモジュールを掲載し、APIアクセスと最初の検索を解説したセットアップガイドを公開しています。ローンチ前に、導入済みのバージョンとの互換性と必要な予約操作を確認してください。
Duffelアカウントを作成してAPI認証情報を取得し、PHPTRAVELS管理画面のDuffelモジュール設定に入力します。マークアップを設定し、本番に移る前にテストモードで連携を検証してください。
Duffelは自社の認可と発券権限を使うManaged Contentを提供しており、アカウントの有効化と利用可能なコンテンツが条件です。対象かどうかはDuffelに確認してください。PHPTRAVELSに接続しても、御社がIATA認可を得るわけではありません。
完全に同等とは考えないでください。座席指定、有料手荷物、変更、取消などのアフターサービスは、PHPTRAVELSモジュールのバージョン、航空会社の対応、合意した連携範囲に照らして確認が必要です。
いいえ。Duffelのテストモードはサンドボックスのコンテンツとテスト用認証情報を使います。動作の検証には役立ちますが、テスト結果は実際の空席や商用の運賃見積もりではありません。
