Developer Hub
これは自動生成された翻訳です。

旅程に関するAPIの提供

「旅程」機能を使えば、お客様の予約情報を表示したり、booking-relatedのツアーや体験などの商品・サービスをお客様が探しやすくしたりすることができます。また、このデータを活用して予約の傾向を分析したり、関係者の皆様向けのレポートを作成したりすることも可能です。

配送方法

旅程データのAPI配信には、プッシュ方式またはプル方式のいずれかをご利用いただけます。

プッシュ方式

プッシュサービスは、旅程の変更が発生するたびに、その最新情報を送信します。取引完了後、数分以内に主要な予約フィールドが利用可能となり、付随フィールドおよび詳細フィールドは2～4時間以内に利用可能になります。このオプションを使用すると、以下のことができます：

  • ウェブサイトやアプリに、お客様の予約情報を表示する
  • 旅行者に、旅行中に購入できる追加の商品やサービスを提供します

プッシュイベントは、Webhookを介して、ご指定いただいたURL宛てに、HTTP POST メッセージの形式で配信されます。これらのメッセージは順不同で届く場合がありますので、順序を特定するには、creation_date およびupdate_date_time 要素をご参照ください。

>> APIの設定に関する詳細はこちらをご覧ください

プッシュイベントの扱い

旅程データは入手可能になり次第配信されるため、同じ旅程に対して複数のイベントが届く場合があります。具体的には、主要なフィールドを含む最初のイベントに続き、付随データが充実したり旅程が更新されたりした際に、追加のイベントが届くことがあります。

>> フィールドのタイミングに関する詳細な内訳については、「利用可能なフィールド」のセクションをご覧ください

すべきこと：

  • 旅程ごとに複数のイベントが発生することが予想されます：itinerary_id を使用してイベントを関連付け、常に最新のupdate_date_time にあるイベントを基準として扱ってください
  • 更新の処理方法を選択してください：既存の旅程に対して新しいイベントを受信した際、以前のレコードを最新のデータで上書きするか、各イベントを追加して変更履歴を維持するかを選択できます
  • 欠落しているフィールドに適切に対処する: 初期のイベントでは補助フィールドが存在しない場合があります。処理を行う前に、フィールドが存在するかどうかを確認してください

してはいけないこと

  • 最初のイベントに完全なペイロードが含まれているものと仮定します： 補助フィールドは、その後のイベントで続きます
  • 同じ旅程に対する複数のイベントをエラーとして扱うようにしてください： これは想定された動作です
  • real-timeの財務数値は確定値として扱ってください：。24時間以内に修正される可能性があります。

プル方式

Checkmark

注意

プル配信は、ホワイトレーベル・トラベル・プラットフォームのパートナー様のみご利用いただけます。

プルサービスは、以下の機能をサポートするための詳細な旅程データを提供します：

  • データ分析
  • 予約記録とExpedia Groupのデータを照合する
  • プッシュ配信に失敗した時間枠のデータ取得
  • ヘルプデスクの調査

プッシュ配信と同様に、プル配信においても旅程データは2段階に分けて提供されます。コアフィールド（itinerary_ID、status、gross_booking_value、checkin_date、checkout_date）は、予約または更新から数分以内に利用可能となり、付加情報および拡張フィールドはその後2～4時間以内に利用可能となります。

>> フィールドごとの詳細な内訳については、「利用可能なフィールド」をご覧ください

このサービスは、2つのHTTP GET エンドポイントで構成されており、これらを利用することで以下のことが可能になります：

  • creation_date_start、creation_date_end、update_date_time_start、およびupdate_date_time_end の各変数を使用して、指定された期間内に作成または更新された旅程のリストを作成します。
  • 特定の旅程を、その itinerary_id

>> 認証プロセスの詳細については、APIの設定をご覧ください

時間枠ごとの旅程データの取得

指定された時間枠の旅程データを取得するには、GET /itineraries およびupdate_date_time_start をクエリの時間枠として指定し、update_date_time_end エンドポイントに対してポーリングを行ってください。

推奨されるアプローチ：

  1. クエリウィンドウには、update_date_timeのフィールドをご利用ください： 指定した期間内に作成または更新された旅程を取得するには、update_date_time_start およびupdate_date_time_end をクエリウィンドウとしてご利用ください。creation_dateのみを使用すると、旅程の更新情報を見逃してしまいます。
  2. 最後に正常に実行されたポーリングのタイムスタンプを保存してください： これを次の update_date_time_start として使用し、ウィンドウを段階的に進めてください。
  3. 重複排除： クエリでは、itinerary_id およびupdate_date_time を使用してください。補助フィールドの情報が充実するにつれて、同じ旅程が複数の投票期間にまたがって表示される場合があります。常に、最新のupdate_date_time の記録を正式なものとして扱ってください。

ご利用の用途において、最も網羅的で最新の旅程データが必要な場合は、プッシュ配信をお勧めします。

利用可能なフィールド

以下の表に、プッシュとプルの配信方法を通じて利用可能なフィールド (ネストされたオブジェクトを含む) の一覧を示します。「利用可能時期」の列は、予約の発生または更新後、各フィールドが通常いつから利用可能になるかを示しています：

  • リアルタイムの：予約や更新から数分以内に利用可能
  • Near-real-time: ご予約または情報の更新から2～4時間以内に利用可能となります

名前の後にピリオドが続くフィールド名 (例 : <変数>.<ネストされた変数>) はネスト関係を示しています。

ホワイトレーベル トラベル プラットフォーム

フィールド名定義例在庫
itinerary_id旅程番号または POS 注文参照番号。72622069245694リアルタイム
status旅程とその各項目のステータス。取り得る値：
confirmed
cancelled		リアルタイム
creation_date*予約が最初に作成された日付で、ISO 8601の日付形式で表記されています（YYYY-MM-DD).2023-02-05リアルタイム
update_date_time*旅程の最終更新日時を、ISO 8601日付形式（YYYY-MM-dd'T"HH:mm:ss.SSSZ）で表したものです。2023-10-21T00:00:00.000Zリアルタイム
onlineその旅程がオンラインで予約されたか（true）、それとも旅行代理店を通じて予約されたか（false）を示します。ブール値で表されます。trueNear-real-time
packageその旅程がパッケージツアーの一部であるか、それとも単独の予約であるかを示します。ブール値で表されます。falseNear-real-time
payment_typeチェックアウト時に使用されたお支払い方法。取り得る値 :
credit card
points
split pay		リアルタイム
point_of_sale_country_codeお客様が予約を行った販売サイトの国コード。2 文字の ISO 3166-1 alpha-2 形式で表されます。GBNear-real-time
purchaser予約者の識別情報。ネストされた項目の一覧は purchaser の表を参照してください。  
property_booking_items旅程の一部として予約された宿泊施設の構成要素。ネストされた項目の一覧は property_booking_items の表を参照してください。  
flight_booking_items旅程の一部として予約された航空券の構成要素。ネストされた項目の一覧は flight_booking_items の表を参照してください。  
car_booking_items旅程の一部として予約されたレンタカーの構成要素。ネストされた項目の一覧は car_booking_items の表を参照してください。  
activity_booking_items旅程の一部として予約された現地ツアーの構成要素。ネストされた項目の一覧は activity_booking_items の表を参照してください。  
insurance_booking_items旅程の一部として予約された保険の構成要素。ネストされた項目の一覧は insurance_booking_items の表を参照してください。  
rate予約項目または旅程全体の料金と価格設定の詳細。ネストされた項目の一覧は rate の表を参照してください。  
coupon旅程に適用されるクーポン (該当する場合)。ネストされた項目の一覧は coupon の表を参照してください。  
|

purchaser

以下の各フィールドは、予約者の識別情報です。

フィールド名定義例在庫
purchaser.email**予約者のEメールアドレス。smith@example.comリアルタイム
purchaser.loyalty_id**ロイヤリティ プログラムのメンバーシップ識別子。12345678Near-real-time
purchaser.first_name**ご予約をされた方の名前です。ジェーンリアルタイム
purchaser.last_name**ご予約をされた方の苗字です。Smithリアルタイム

property_booking_items

以下の各フィールドは、旅程の一部として予約された宿泊施設の構成要素です。

フィールド名定義例在庫
booking_item_id旅程の一部として予約された特定の要素の識別子。1400882912リアルタイム
status特定の宿泊施設要素のステータス。取り得る値：
confirmed
cancelled		リアルタイム
checkin_date*対応する宿泊施設要素のチェックイン日。ISO 8601の日付形式で表されると（YYYY-MM-DD).2023-02-01リアルタイム
checkout_date*対応する宿泊施設要素のチェックアウト日。ISO 8601の日付形式で表されると（YYYY-MM-DD).2023-02-05リアルタイム
property.idExpedia Group'sホテルまたはバケーションレンタル固有の識別子 施設。1400882912Near-real-time
property.chain_nameその施設が属するホテルチェーンの名称 (該当する場合)。IndependentNear-real-time
property.brand_nameその施設が属するブランドの名称 (該当する場合)。1 つのホテルチェーンに複数のブランドがある場合があります。Savoy SignatureNear-real-time
property.nameホテルまたはバケーションレンタルの名称Hotel 1リアルタイム
property.city施設が所在する都市の名称。Torontoリアルタイム
property.state_province_name施設が所在する州または都道府県の名称。OntarioNear-real-time
property.country_code施設が所在する国のコード。2 文字の ISO 3166-1 alpha-2 形式で表されます。CAリアルタイム
property.star_rating施設の星評価。3.0Near-real-time
room_nameホテルまたはバケーションレンタル会社が定める、ご予約いただいたお部屋の種類です。専用バスルーム付きの快適なダブルルームNear-real-time
adult_count対応する予約に含まれる大人の人数。2リアルタイム
child_count対応する予約に含まれる子供の人数。0リアルタイム
expedia_collect予約についてお支払いページで支払われているか (true)、プロバイダーに直接支払わなければならないか (false) を表すブール値。trueNear-real-time
property_confirmation_idホテルまたはバケーションレンタル会社から提供された予約確認番号です。1516171819Near-real-time
rate宿泊施設予約の料金と価格設定の詳細。ネストされた項目の一覧は rate の表を参照してください。  

flight_booking_items

以下の各フィールドは、旅程の一部として予約された航空券の構成要素です。

フィールド名定義例在庫
booking_item_id旅程の一部として予約された特定の要素の識別子。1400882911リアルタイム
status特定の航空券要素のステータス。取り得る値：
確認済み
キャンセル済み		リアルタイム
departure_date*対応する航空券要素の開始日。ISO 8601の日付形式で表されると（YYYY-MM-DD).2023-02-01リアルタイム
arrival_date*対応する航空券要素の終了日。ISO 8601日付形式で表されると（YYYY-MM-DD).2023-02-02リアルタイム
airline.plating_carrier_name航空券を発行した航空会社の名称です。Air CanadaNear-real-time
airline.plating_carrier_code国際航空運送協会（IATA)）が定める、航空券を発行した航空会社のコードです。ACリアルタイム
carrier_pnr航空券を発行した航空会社に登録されている旅客氏名です。SMITHNear-real-time
trip_type予約区間のタイプ。取り得る値 :
one way
round trip
multiple destinations		Near-real-time
fare_class航空券の運賃クラス。EconomyNear-real-time
airport_origin_code出発空港のIATAコードです。LHRリアルタイム
airport_origin_location出発空港の場所。London, GB (LHR-Heathrow)Near-real-time
airport_destination_code出発空港のコード。IATA 形式で表されます。YYZリアルタイム
airport_destination_location出発空港の場所。Toronto, ON (YYZ-Lester B. Pearson Intl.)Near-real-time
ticket_number航空券番号。123456789Near-real-time
expedia_collect予約についてお支払いページで支払われているか (true)、プロバイダーに直接支払わなければならないか (false) を表すブール値。trueNear-real-time
segment_count航空券のフライト区間数。1Near-real-time
rate航空券予約の料金と価格設定の詳細。ネストされた項目の一覧は rate の表を参照してください。  

car_booking_items

以下の各フィールドは、旅程の一部として予約されたレンタカーの構成要素です。

フィールド名定義例在庫
booking_item_id旅程の一部として予約された特定の要素の識別子。1400882910リアルタイム
status特定のレンタカー要素のステータス。取り得る値：
confirmed
cancelled		リアルタイム
pickup_date*レンタカー要素の開始日。ISO 8601の日付形式で表されると（YYYY-MM-DD).2023-02-02リアルタイム
return_date*レンタカー要素の終了日。ISO 8601の日付形式で表されると（YYYY-MM-DD).2023-02-05リアルタイム
rental_company.nameレンタカー会社名。Hertzリアルタイム
car_type借りるレンタカーのタイプ。2/4 door compactNear-real-time
pickup_locationレンタカーの乗車場所。Deer Lake, NL (YDF-Deer Lake Regional)リアルタイム
pickup_country_codeレンタカー乗車場所の国コード。2 文字の ISO 3166-1 alpha-2 形式で表されます。CAリアルタイム
return_locationレンタカーの返却場所。Deer Lake, NL (YDF-Deer Lake Regional)リアルタイム
return_country_codeレンタカー返却場所の国コード。2 文字の ISO 3166-1 alpha-2 形式で表されます。CAリアルタイム
trip_type予約区間のタイプ。取り得る値 :
one way
round trip
multiple destinations		Near-real-time
rental_company_confirmation_idレンタカー会社から発行された予約番号です。ABC1234Near-real-time
expedia_collect予約についてお支払いページで支払われているか (true)、プロバイダーに直接支払わなければならないか (false) を表すブール値。falseNear-real-time
rateレンタカー予約の料金と価格設定の詳細。ネストされた項目の一覧は rate の表を参照してください。  

activity_booking_items

以下の各フィールドは、旅程の一部として予約された現地ツアーの構成要素です。

フィールド名定義例在庫
booking_item_id旅程の一部として予約された特定の要素の識別子。1400882910リアルタイム
status特定の現地ツアーのステータス。取り得る値：
確認済み
キャンセル済み		リアルタイム
activity_start_date*現地ツアーの開始日。ISO 8601の日付形式で表されると（YYYY-MM-DD).2023-02-03リアルタイム
activity_end_date*現地ツアーの終了日。ISO 8601の日付形式で表されると（YYYY-MM-DD).2023-02-03リアルタイム
vendor.name現地ツアーを提供するサプライヤーの名称。オリビアのツアーリアルタイム
activity_cityその活動が行われる都市です。聖ジュードリアルタイム
activity_country_code活動が行われる国の国コードです。2 文字の ISO 3166-1 alpha-2 形式で表されます。CAリアルタイム
offering_name現地ツアーの名称。Passions of Paradise Great Barrier ReefNear-real-time
expedia_collect予約についてお支払いページで支払われているか (true)、プロバイダーに直接支払わなければならないか (false) を表すブール値。trueNear-real-time
rate現地ツアー予約の料金と価格設定の詳細。ネストされた項目の一覧は rate の表を参照してください。  

insurance_booking_items

以下の各フィールドは、旅程の一部として予約された保険の構成要素です。

フィールド名定義例在庫
booking_item_id旅程の一部として予約された特定の要素の識別子。1400882610リアルタイム
status選択された特定の保険のステータス。取り得る値：
confirmed
cancelled		リアルタイム
rate選択された保険の料金と価格設定の詳細。ネストされた項目の一覧は rate の表を参照してください。  

rate

以下の各フィールドは、予約項目または旅程全体の料金と価格設定の詳細です。これらには、予約の金銭的価値を示すネストされた値が含まれており、総予約額、税金、手数料ごとに内訳が示されています。

フィールド名定義例在庫
rate_plan_name項目の価格設定に使用される料金プランの名称。施設 の予約対象商品のみご利用いただけます。Room onlyNear-real-time
rate_plan_type予約に使用された料金のタイプ。施設 の予約対象商品のみご利用いただけます。Distribution rateNear-real-time
refundable対応する予約コンポーネントが払い戻し可能（true）か、そうでないか（false）かを示します。trueNear-real-time
pricing予約の金銭的価値を反映する項目で、予約総額、税金、手数料ごとに内訳が示されています。  
pricing.gross_booking_value予約の金銭的価値を保持するオブジェクトです。  
pricing.gross_booking_value.billable_currency支払いに使用される通貨で、予約の金額を表すオブジェクトです。  
pricing.gross_booking_value.billable_currency.currency予約のお支払いにお客様が使用する通貨。ISO 4217 形式で表されます。GBPリアルタイム
pricing.gross_booking_value.billable_currency.value予約総額です。2520.80リアルタイム
pricing.taxes_and_fees予約にかかる税金および手数料の金額と通貨。  
pricing.taxes_and_fees.billable_currency予約にかかる税金および手数料の、お支払いに使用する通貨での金額。  
pricing.taxes_and_fees.billable_currency.currency予約のお支払いにお客様が使用する通貨。ISO 4217 形式で表されます。GBPリアルタイム
pricing.taxes_and_fees.billable.currency.value予約の総予約売上 (GBV)。491.10リアルタイム

coupon

フィールド名定義例在庫
code予約に使用されたクーポンコード。ABCDNear-real-time
nameクーポンの名称。PRIMENear-real-time
descriptionクーポンの説明。BoGo 5%Near-real-time
currencyクーポンの金額に適用されている通貨。ISO 4217 形式で表されます。GBPNear-real-time
valueクーポンの金額。126.04Near-real-time

ホワイトラベル旅行プラットフォームの全フィールドに関する注意事項

  • 日付フィールドは協定世界時（UTC）で表示されています。
    ** これは、個人を特定できる情報（PII）に該当します。必ず、御社のガイドラインに従って適切に対処してください。どうしても必要な場合のみ含めてください。

旅行代理店アフィリエイトプログラム（TAAP）

フィールド名定義例在庫
itinerary_id旅程番号または POS 注文参照番号。72622069245694リアルタイム
agency_reference_codeチェックアウト時に旅行代理店から提供される、お客様専用の旅程表です。86549B_GBリアルタイム
status旅程とその各項目のステータス。取り得る値：
confirmed
cancelled		Near-real-time
creation_date*予約が最初に作成された日付を、ISO 8601日付形式で表したものです（YYYY-MM-DD).2023-02-05リアルタイム
update_date_time*旅程の最終更新日時を、ISO 8601日付形式で表したものです（YYYY-MM-dd'T"HH:mm:ss.SSSZ).2023-10-21T00:00:00.000Zリアルタイム
onlineその旅程がオンラインで予約されたか（true）、それとも旅行代理店を通じて予約されたか（false）を示します。ブール値で表されます。trueNear-real-time
point_of_sale_country_codeお客様が予約を行った国のコードです。2 文字の ISO 3166-1 alpha-2 形式で表されます。GBNear-real-time
purchaser予約者の識別情報。ネストされた項目の一覧は purchaser の表を参照してください。  
agency予約を行ったTAAP代理店および担当者の特定。ネストされた項目の一覧は agency の表を参照してください。  
payment旅程に関するお支払い情報です。ネストされた項目の一覧は payment の表を参照してください。  
property_booking_items旅程の一部として予約された宿泊施設の構成要素。ネストされた項目の一覧は property_booking_items の表を参照してください。  
flight_booking_items旅程の一部として予約された航空券の構成要素。ネストされた項目の一覧は flight_booking_items の表を参照してください。  
car_booking_items旅程の一部として予約されたレンタカーの構成要素。ネストされた項目の一覧は car_booking_items の表を参照してください。  
activity_booking_items旅程の一部として予約された現地ツアーの構成要素。ネストされた項目の一覧は activity_booking_items の表を参照してください。  
rate予約項目または旅程全体の料金と価格設定の詳細。ネストされた項目の一覧は rate の表を参照してください。  
earnings予約項目または旅程全体の手数料の詳細です。ネストされた項目の一覧は earnings の表を参照してください。  
|

purchaser

これらの欄には、ご旅行される方の情報をご記入ください。

フィールド名定義例在庫
purchaser.email**旅行者のメールアドレス。smith@example.comリアルタイム
purchaser.first_name**旅行者の名前。ジェーンリアルタイム
purchaser.last_name**旅行者の姓。Smithリアルタイム

エージェンシー

これらの欄には、予約を行ったTAAPの機関および担当者が記載されています。

フィールド名定義例在庫
agency.name予約を行ったTAAP代理店の名称。世界の旅Near-real-time
agency.id予約を行ったTAAP代理店の追跡コードです。WS02555リアルタイム
agency.agent.first_name**予約を行ったTAAP担当者の名前。Bobリアルタイム
agency.agent.last_name**予約を行ったTAAP担当者の姓です。Jonesリアルタイム
agency.agent.email**予約を行ったTAAP担当者のメールアドレスです。bjones@worldtravel.comリアルタイム

お支払い

これらの欄には、旅程の支払い詳細が記載されています。

フィールド名定義例在庫
payment_typeチェックアウト時に使用されたお支払い方法。指定可能な値 :
クレジット カード
ポイント
分割払い		リアルタイム
status旅程の支払いが完了しているかどうかを示します。指定可能な値 :
支払済み
未払い		Near-real-time
deferredその旅程の支払いが延期されたか（true）、それとも支払われたか（false）。ブール値で表されます。trueNear-real-time
payment_due_date支払期日のISO 8601日付形式（YYYY-MM-DD). これは、支払いの延期の場合にのみ適用されます。2023-02-05Near-real-time
payee旅程代金の支払いの責任者が誰であるかを示します。指定可能な値 :
エージェンシー
お客様		Near-real-time

property_booking_items

以下の各フィールドは、旅程の一部として予約された宿泊施設の構成要素です。

フィールド名定義例在庫
booking_item_id旅程の一部として予約された特定の要素の識別子。1400882912リアルタイム
status特定の宿泊施設要素のステータス。指定可能な値 :
完了しました
中止となりました		リアルタイム
checkin_date*対応する宿泊施設要素のチェックイン日。ISO 8601の日付形式で表すと（YYYY-MM-DD).2023-02-01リアルタイム
checkout_date*対応する宿泊施設要素のチェックアウト日。ISO 8601の日付形式で表すと（YYYY-MM-DD).2023-02-05リアルタイム
property.idExpedia Group'sホテルまたはバケーションレンタルの一意の識別子 施設1400882912Near-real-time
property.chain_nameその施設が属するホテルチェーンの名称 (該当する場合)。IndependentNear-real-time
property.brand_nameその施設が属するブランドの名称 (該当する場合)。1 つのホテルチェーンに複数のブランドがある場合があります。Savoy SignatureNear-real-time
property.nameホテルまたはバケーションレンタルの名称Hotel 1リアルタイム
property.city施設が所在する都市の名称。Torontoリアルタイム
property.state_province_name施設が所在する州または都道府県の名称。OntarioNear-real-time
property.country_code施設が所在する国のコード。2 文字の ISO 3166-1 alpha-2 形式で表されます。CAリアルタイム
property.star_rating施設の星評価。3.0Near-real-time
room_nameホテルまたはバケーションレンタル会社が定める、予約された客室のタイプです。専用バスルーム付きの快適なダブルルームNear-real-time
adult_countご予約に含まれる大人の人数。2リアルタイム
child_countご予約に含まれるお子様の人数です。0リアルタイム
expedia_collect予約についてお支払いページで支払われているか (true)、プロバイダーに直接支払わなければならないか (false) を表すブール値。trueNear-real-time
property_confirmation_idホテルまたはバケーションレンタル会社から提供された予約確認番号です。1516171819Near-real-time
rate宿泊施設予約の料金と価格設定の詳細。ネストされた項目の一覧は rate の表を参照してください。  
earnings宿泊予約の手数料の詳細です。ネストされた項目の一覧は earnings の表を参照してください。  

flight_booking_items

以下の各フィールドは、旅程の一部として予約された航空券の構成要素です。

フィールド名定義例在庫
booking_item_id旅程の一部として予約された特定の要素の識別子。1400882911リアルタイム
status特定の航空券要素のステータス。取り得る値：
confirmed
cancelled		リアルタイム
departure_date*対応する航空券要素の開始日。ISO 8601の日付形式で表されると（YYYY-MM-DD).2023-02-01リアルタイム
arrival_date*対応する航空券要素の終了日。ISO 8601の日付形式で表すと（YYYY-MM-DD).2023-02-02リアルタイム
airline.plating_carrier_name航空券を発行した航空会社の名称です。Air CanadaNear-real-time
airline.plating_carrier_codeIATA航空券を発行した航空会社のコード。ACリアルタイム
carrier_pnr航空券を発行した航空会社に登録されている搭乗者のお名前です。SMITHNear-real-time
trip_type予約区間のタイプ。取り得る値 :
one way
round trip
multiple destinations		Near-real-time
fare_class航空券の運賃クラス。EconomyNear-real-time
airport_origin_code出発空港のIATAコードです。LHRリアルタイム
airport_origin_location出発空港の場所。London, GB (LHR-Heathrow)Near-real-time
airport_destination_code出発空港のコード。IATA 形式で表されます。YYZリアルタイム
airport_destination_location出発空港の場所。Toronto, ON (YYZ-Lester B. Pearson Intl.)Near-real-time
ticket_number航空券番号。123456789101Near-real-time
expedia_collect予約についてお支払いページで支払われているか (true)、プロバイダーに直接支払わなければならないか (false) を表すブール値。trueNear-real-time
segment_countその航空券のフライト区間の数です。1Near-real-time
rate航空券予約の料金と価格設定の詳細。ネストされた項目の一覧は rate の表を参照してください。  
earningsそのフライト予約に関する手数料の詳細です。ネストされた項目の一覧は earnings の表を参照してください。  

car_booking_items

以下の各フィールドは、旅程の一部として予約されたレンタカーの構成要素です。

フィールド名定義例在庫
booking_item_id旅程の一部として予約された特定の要素の識別子。1400882910リアルタイム
status特定のレンタカー要素のステータス。取り得る値：
confirmed
cancelled		リアルタイム
pickup_date*レンタカー要素の開始日。ISO 8601の日付形式で表されると（YYYY-MM-DD).2023-02-02リアルタイム
return_date*レンタカー要素の終了日。ISO 8601の日付形式で表されると（YYYY-MM-DD).2023-02-05リアルタイム
rental_company.nameレンタカー会社名。Hertzリアルタイム
car_type借りるレンタカーのタイプ。2/4 door compactNear-real-time
pickup_locationレンタカーの乗車場所。Deer Lake, NL (YDF-Deer Lake Regional)リアルタイム
pickup_country_codeレンタカー乗車場所の国コード。2 文字の ISO 3166-1 alpha-2 形式で表されます。CAリアルタイム
return_locationレンタカーの返却場所。Deer Lake, NL (YDF-Deer Lake Regional)リアルタイム
return_country_codeレンタカー返却場所の国コード。2 文字の ISO 3166-1 alpha-2 形式で表されます。CAリアルタイム
trip_type予約区間のタイプ。取り得る値 :
one way
round trip
multiple destinations		Near-real-time
rental_company_confirmation_idレンタカー会社から発行された予約確認番号です。ABC1234Near-real-time
expedia_collect予約についてお支払いページで支払われているか (true)、プロバイダーに直接支払わなければならないか (false) を表すブール値。falseNear-real-time
rateレンタカー予約の料金と価格設定の詳細。ネストされた項目の一覧は rate の表を参照してください。  
earnings車の予約に関する手数料の詳細です。ネストされた項目の一覧は earnings の表を参照してください。  

activity_booking_items

以下の各フィールドは、旅程の一部として予約された現地ツアーの構成要素です。

フィールド名定義例在庫
booking_item_id旅程の一部として予約された特定の要素の識別子。1400882910リアルタイム
status特定の現地ツアーのステータス。取り得る値：
確認済み
キャンセル済み		リアルタイム
activity_start_date*現地ツアーの開始日。ISO 8601の日付形式で表すと（YYYY-MM-DD).2023-02-03リアルタイム
activity_end_date*現地ツアーの終了日。ISO 8601日付形式で表されるとおり（YYYY-MM-DD).2023-02-03リアルタイム
vendor.name現地ツアーを提供するサプライヤーの名称。オリビアのツアーリアルタイム
activity_cityその活動が行われる都市です。聖ジュードリアルタイム
activity_country_code活動が行われる国の国コードです。2 文字の ISO 3166-1 alpha-2 形式で表されます。CAリアルタイム
offering_name現地ツアーの名称。ハンバー・リバー・トレイルのハイキングNear-real-time
expedia_collect予約についてお支払いページで支払われているか (true)、プロバイダーに直接支払わなければならないか (false) を表すブール値。trueNear-real-time
rate現地ツアー予約の料金と価格設定の詳細。ネストされた項目の一覧は rate の表を参照してください。  
earningsアクティビティ予約項目の手数料の詳細です。ネストされた項目の一覧は earnings の表を参照してください。  

rate

以下の各フィールドは、予約項目または旅程全体の料金と価格設定の詳細です。これらには、予約の金額を表すネストされた値が含まれており、予約総額、税金、手数料ごとに内訳が示されています。

フィールド名定義例在庫
refundable対応する予約コンポーネントが払い戻し可能（true）か、そうでないか（false）です。trueNear-real-time
pricing予約の金銭的価値を反映するオブジェクトで、予約総額、税金、手数料ごとに内訳が示されています。  
pricing.gross_booking_value税金および手数料を含む予約金額。  
pricing.gross_booking_value.billable_currencyお支払いに使用する通貨での予約金額。  
pricing.gross_booking_value.billable_currency.currency予約のお支払いにお客様が使用する通貨。ISO 4217 形式で表されます。GBPリアルタイム
pricing.gross_booking_value.billable_currency.value予約総額です。2520.80リアルタイム
pricing.taxes_and_fees予約にかかる税金および手数料の金額と通貨。  
pricing.taxes_and_fees.billable_currency予約にかかる税金および手数料の、お支払いに使用する通貨での金額。  
pricing.taxes_and_fees.billable_currency.currency予約のお支払いにお客様が使用する通貨。ISO 4217 形式で表されます。GBPリアルタイム
pricing.taxes_and_fees.billable.currency.value予約の総予約売上 (GBV)。491.10リアルタイム

収益

フィールド名定義例在庫
commission予約または商品に対する手数料額を表すオブジェクトで、予約総額に含まれます。  
commission.billable_currency支払通貨で表示された手数料額を表すオブジェクトです。  
commission.billable_currency.currency手数料額の通貨（ISO 4217形式で表記）JPYリアルタイム
commission.billable_currency.value手数料の金額。100.25リアルタイム
service_chargeTAAP機関が旅程に適用するサービス手数料を表すオブジェクトです。  
service_charge.amountTAAP機関が旅程に適用するサービス手数料の金額を表すオブジェクトです。  
service_charge.amount.billable_currency支払い通貨でのサービス手数料の金額を表すオブジェクトです。  
service_charge.amount.billable_currency.currencyサービス料金の通貨単位を、ISO 4217形式で表記したものです。JPYリアルタイム
service_charge.amount.billable_currency.valueTAAP代理店が当該旅程に適用するサービス手数料の金額です。代理店が負担する税金や手数料が含まれています。50.50リアルタイム
service_charge.taxes_and_feesサービス料金にかかる税金および手数料の金額と通貨を表すオブジェクトです。  
service_charge.taxes_and_fees.billable_currencyサービス料にかかる税金および手数料として、お客様が請求通貨で支払った金額です。この値は、エクスペディアTAAP「クマの手」が税金や手数料を処理する場合にのみ設定されます。  
service_charge.taxes_and_fees.billable_currency.currencyISO 4217形式で表記された支払通貨です。JPYリアルタイム
service_charge.taxes_and_fees.billable_currency.valueお客様が税金および手数料に支払った、使用する通貨での金額。5.25リアルタイム

すべてのTAAPフィールドに関する注意事項

  • 日付フィールドは協定世界時（UTC）で表示されています。
    ** これは、個人を特定できる情報（PII）に該当します。必ず、御社のガイドラインに従って適切に対処してください。どうしても必要な場合のみ含めてください。

API の詳細

貴社のビジネスにおける「旅程API」データの活用方法に基づき、APIスキーマおよび設定の概要をご用意いたしました。OpenAPI仕様書をダウンロードし、APIテストツールを使用して、サンプルやスキーマ定義が実際の出力とどのように一致しているかを確認することができます。

ホワイトレーベル トラベル プラットフォーム

当社のホワイトラベル旅行プラットフォームのパートナー様が、プッシュおよびプル方式を通じてご利用いただけるフィールド（ネストされたオブジェクトを含む）は以下の通りです：




タープ

当社のプッシュ配信方式を通じてTAAPパートナーが利用可能なフィールド（ネストされたオブジェクトを含む）は、以下の通りです：




このページは役に立ちましたか ?
このコンテンツに改善が必要な点があれば、
サービス向上にご協力いただきありがとうございます。