File-based旅程表の配送
パートナーポータル内の「旅程API」の標準レポートには、transaction-levelの予約（宿泊のみ、または複数の事業分野（LOB）にわたるもの）が含まれています。当社の標準レポートをご利用いただければ、追加の開発時間をかけずに、迅速にデータを入手することができます。
Itineraries APIのレポートはトランザクション単位で作成され、宿泊施設については60以上のフィールドから選択できる厳選されたリストが提供されるほか、multi-LOBのレポートについては100以上のフィールドが用意されています。フィールドの選択肢には、以下のものがあります：
- 旅行日程、旅程、旅行代金などの基本的な予約情報
- 旅行者および購入者（異なる場合）の顧客情報
- 確認番号、ベンダーや拠点、使用されたLOBの数、費用などの製品情報
>> ファイル配信の設定について詳しくはこちら
>> ファイル取り込みのベストプラクティス
標準レポートのデフォルトフィールド
レポートをカスタマイズする際には、選択できるフィールドが多数あります。これらは標準レポートにデフォルトで含まれています。
| フィールド名 | データタイプ | 説明 | 例 |
|---|---|---|---|
book_date | 日 | 予約が最初に作成された日付を、ISO 8601日付形式で表したものです（YYYY-MM-DD). | 2023-02-05 |
transaction_date | 日 | 予約が最後に変更された日付です。予約内容が一切更新されない場合、これはbook_dateと同じになります。日付は、ISO 8601の日付形式で表記されています（YYYY-MM-DD). | 2023-02-05 |
begin_use_date | 日 | 旅行の開始日：出発日、check-inの日付、pick-upの日付など。これらはISO 8601日付形式で表記されます（YYYY-MM-DD). | 2023-04-05 |
end_use_date | 日 | 旅行終了日：到着日、check-outの日付、drop-offの日付など。これらはISO 8601日付形式で表記されます（YYYY-MM-DD). | 2023-04-06 |
transaction_type | varchar(200) | 記録された取引の種類。 | 取り得る値：購入、付与、変更、キャンセル。 |
product_line_name | varchar(200) | その予約項目が該当する事業の種類です。 | 取り得る値：航空、自動車、クルーズ、現地サービス、保険、宿泊、パッケージ、不明 |
package_indicator | varchar(100) | その予約項目がパッケージ（航空券＋ホテルなど）の一部であるかどうか。 | 取り得る値：パッケージの一部、単体、不明 |
product_component | varchar(200) | パッケージ購入に含まれる製品。購入内容がパッケージ商品でない場合は、1つの製品ライン名のみが表示されます。 | 飛行機、車 |
itinerary_number | varchar(50) | 旅程番号または POS 注文参照番号。 | 12345678910111 |
booking_item_id | varchar(50) | 旅程の一部として予約された特定の要素の識別子。このフィールドの値は、正でも負でも可能です。 | 1400882912 |
currency_code | char(3) | 予約の支払いに使用された通貨で、国際銀行口座番号（IBAN）の通貨コード形式で表記されたものです。 | JPY |
gbv_local | decimal(18,4) | 総予約額（GBV）、すなわち、支払いに使用された通貨建ての、税金および手数料を含む予約総額です。 | 694.89 |
order_count | smallint | パッケージ購入における注文数（商品数ではありません）。 | 1 |
その他のオプション項目
注： 以下の表は、レポートにフィールドが表示される順序とは異なります。フィールドの順序は、作成・編集時にフィールドが有効化される順序によって決まりま す。
| フィールド名 | データタイプ | 説明 | 例 |
|---|---|---|---|
transaction_datetime | タイムスタンプ | 予約が最後に更新（変更）された日時です。予約内容が一度も変更されていない場合、これは予約日と同じになります。 | 2023-02-05 06:05:00 |
booking_window | 整数 | 予約日とcheck-in日の間の日数です。 | 32 |
booking_status | varchar(50) | 「公開中」、「進行中」、「完了」、「落札」、「中止」のいずれかです。 | 処理中 |
online_offline_indicator | varchar(100) | 予約がオンラインで行われたか、それとも旅行代理店を通じてオフラインで行われたかの表示。 | オンライン |
point_of_sale_country | char(3) | お客様が予約を行っている販売拠点。 | JPY |
payment_type | varchar(50) | ご利用いただいたお支払い方法（クレジットカード、ポイント、分割払いなど）。旅行代理店による「後払い」の予約（車やホテル）の場合、この欄は空欄となります。 | 分割払い |
coupon_code | varchar(100) | クーポンのコードを使用しました。 | ABCD |
coupon_name | varchar(200) | クーポンの名称。 | PRIME |
coupon_description | varchar(510) | 使用したクーポンの詳細です。 | BoGo 5% |
coupon_price_amount_usd | decimal(18,4) | クーポン金額（米ドル）。 | -58.6877 |
gbv_usd | decimal(18,4) | 米ドル建ての予約総額です。 | 694.8941 |
gbv_tpid | decimal(18,4) | TPID通貨建てのGBV総額を示します。 | 694.8941 |
taxes_and_fees_local | decimal(18,4) | 現地通貨建ての税金および手数料の合計額です。 | 144.77 |
taxes_and_fees_usd | decimal(18,4) | 税金および手数料の合計（米ドル）。 | 144.77 |
taxes_and_fees_tpid | decimal(18,4) | TPID通貨建ての税金および手数料の合計額です。 | 144.77 |
insurance_gbv_local | decimal(18,4) | 現地通貨建ての保険金額。 | 80.4 |
insurance_gbv_usd | decimal(18,4) | 保険金額（米ドル建て）。 | 80.4 |
air_supplier_pnr | varchar(100) | サプライヤーの航空旅客名簿（PNR）。 | ABCDEF |
air_carrier_pnr | varchar(100) | 航空便 航空会社 の旅客名簿。 | BCDEFG |
air_business_model | varchar(200) | 予約サービスにおける航空部門のビジネスモデル。 | 旅行会社 |
air_trip_type | varchar(200) | 航空旅行の種類。 | 片道 |
air_fare_class | varchar(200) | 購入された航空運賃のクラス。 | ビジネスクラス |
air_plating_carrier | varchar(200) | フライト名 航空会社。 | Air Canada |
airport_origin_code | char(3) | フライトの出発地となる空港のコードです。 | YYZ |
airport_origin_location | varchar(406) | フライトの出発地／出発空港です。 | カナダ・オンタリオ州トロント |
airport_destination_code | char(3) | フライトが到着する空港のコード／目的地。 | FLL |
airport_destination_location | varchar(406) | フライトの到着地／目的地。 | 米国フロリダ州フォートローダーデール |
air_ticket_number | varchar(100) | 航空券の番号。 | 123456789101 |
air_ticket_count | smallint | 予約に含まれる航空券の数（予約項目ID（通常は0または1）を含む詳細ファイル）。 | 1 |
air_segment_count | smallint | 航空便の区間数（予約項目IDレベルより上位で集計された場合、その予約に含まれる全乗客のすべての区間の合計となります）。 | 2 |
air_gbv_local | decimal(18,4) | 現地通貨建ての予約のうち、航空券部分の総予約金額です。 | 694.8941 |
air_gbv_usd | decimal(18,4) | 予約のうち航空券部分の総予約金額（米ドル）。 | 694.8941 |
air_gbv_tpid | decimal(18,4) | TPID通貨建ての予約のうち、航空便部分の総予約金額です。 | 694.8941 |
air_tpid_currency_code | char(3) | TPIDの予約通貨は、標準的な国際銀行口座番号（IBAN）の通貨コード形式で表記されています。 | JPY |
total_person_count | 整数 | ご予約に含まれる総人数（宿泊分のみ）。 | 3 |
adult_count | smallint | ご予約に含まれる大人の人数（宿泊分のみ）。 | 2 |
child_count | smallint | ご予約に含まれるお子様の人数（宿泊分のみ）。 | 1 |
lodging_supplier_confirmation_code | varchar(100) | ご予約時に 施設 から提供された確認コードです。 | 1516171819 |
lodging_business_model | varchar(200) | Bookingの宿泊事業部門のビジネスモデル。 | マーチャント |
lodging_chain_independent | varchar(200) | 施設 が独立したものか、あるいはチェーンの一部であるかを示す指標です。 | Independent |
lodging_chain_name | varchar(200) | ご予約いただいた施設のチェーン（ブランド）名。 | Independent |
lodging_property_name | varchar(200) | 施設 様の予約が確定しました | ホテル・コーデリア |
lodging_star_rating | float | 施設 の予約に対する星評価です。 | 3 |
lodging_property_city | varchar(40) | 予約された 施設 が所在する都市です。 | パリ |
lodging_property_market_name | varchar(80) | 予約番号 施設 の物件が所在する市場です。 | IDF - フランス、パリ |
lodging_property_state_province | varchar(40) | 予約番号 施設 が該当する州・県です。 | パリ |
lodging_property_country | varchar(80) | 予約番号 施設 が該当する国の国コードです。 | フランス |
lodging_refundable_rate_indicator | varchar(100) | ご予約いただいた料金が払い戻し可能か、払い戻し不可かについて の表示です。 | 返金可能なキャンセル料の料率。 |
lodging_rate_plan_name | varchar(200) | ご予約いただいた料金プラン名。 | パッケージ |
lodging_rate_type_name | varchar(200) | 予約された料金タイプの名称。 | パッケージ |
lodging_room_type_name | varchar(200) | ご予約いただいた客室タイプ名。 | 快適なダブルルーム、専用バスルーム付き |
lodging_length_of_stay | 整数 | ご予約いただいた 施設 での滞在日数（泊数）です。 | 5 |
lodging_room_count | smallint | 施設 での予約室数。 | 1 |
lodging_room_night_count | smallint | 予約における宿泊日数（滞在日数 × 客室数）。 | 5 |
lodging_gbv_local | decimal(18,4) | 予約のうち宿泊分の総予約額（現地通貨建て）。 | 1379.8 |
lodging_gbv_usd | decimal(18,4) | 予約のうち宿泊分の総予約額（米ドル）。 | 1029.9317 |
lodging_gbv_tpid | decimal(18,4) | TPID通貨建ての予約のうち、宿泊分の 総予約額です。 | 1029.9317 |
lodging_average_daily_rate_local | decimal(18,4) | 施設 の予約における1日あたりの平均料金（GBV／滞在日数）を現地通貨で表示します。 | 275.96 |
lodging_average_daily_rate_usd | decimal(18,4) | 施設 の予約における1日あたりの平均料金（GBV／滞在日数）を米ドルで表示します。 | 205.9863 |
lodging_tpid_currency_code | char(3) | 宿泊施設のTPID予約通貨は、標準的な国際銀行口座番号（IBAN）の通貨コード形式で表記されています。 | JPY |
car_supplier_confirmation_code | varchar(100) | 予約時にレンタカー会社から提供された確認コードです。 | ABC1234 |
car_business_model | varchar(200) | 自動車部品の予約に関するビジネスモデル。 | 該当なし |
car_vendor_name | varchar(200) | 予約したレンタカー会社の名称。 | Hertz |
car_type | varchar(200) | ご予約いただいた車種。 | 2/4 door compact |
car_pickup_location_code | char(3) | 予約した車をピックアップする場所のコード（通常は空港コード）です。 | YDF |
car_pickup_location | varchar(200) | 予約した車をピックアップする場所です。 | Deer Lake, NL (YDF-Deer Lake Regional) |
car_dropoff_location_code | char(3) | 予約した車を返却する場所のコード（通常は空港コード）です。 | YDF |
car_dropoff_location | varchar(200) | 予約した車を 返却する場所です。 | Deer Lake, NL (YDF-Deer Lake Regional) |
car_trip_type | varchar(200) | 往復で予約するか、片道で予約するか。 | 往復 |
car_rental_day_count | smallint | 車の予約日数。 | 7 |
car_count | smallint | 予約された車両の数。 | 1 |
car_gbv_local | decimal(18,4) | 現地通貨建ての予約のうち、自動車関連部分の総予約額です。 | 310.8 |
car_gbv_usd | decimal(18,4) | 予約のうち自動車関連部分の総予約額（米ドル）。 | 231.9919 |
car_gbv_tpid | decimal(18,4) | TPID通貨建ての予約のうち、自動車関連部分の総予約額です。 | 1029.9317 |
car_tpid_currency_code | char(3) | Car TPIDの予約通貨は、国際銀行口座番号（IBAN）の通貨コード形式で表記されています。 | JPY |
activity_offering_name | varchar(200) | 予約されたデスティネーション・サービスのアクティビティ名。 | Passions of Paradise Great Barrier Reef |
activity_vendor_name | varchar(200) | 予約したデスティネーション・サービスのベンダー名。 | Viator（サードパーティ） |
activity_vendor_city | varchar(200) | ベンダーの支店が所在する都市。 | 不明 |
activity_vendor_country_code | char(3) | ベンダーの支店が所在する国のコードです。 | NZL |
activity_ticket_count | smallint | そのアクティビティの予約チケット数です。 | 1 |
activity_gbv_local | decimal(18,4) | 予約のうち、デスティネーション・サービス部分の現地通貨建て総予約額です。 | 204.02 |
activity_gbv_usd | decimal(18,4) | 予約のうち「デスティネーション・サービス」部分の総予約額（米ドル）。 | 152.2878 |
activity_gbv_tpid | decimal(18,4) | TPID通貨建ての予約のうち、アクティビティ部分の総予約額です。 | 1029.9317 |
activity_tpid_currency_code | char(3) | アクティビティのTPID予約通貨を、国際銀行口座番号（IBAN）の通貨コード形式で表記したものです。 | JPY |
loyalty_id | varchar(200) | ロイヤルティ / 会員番号。 | 12345678 |
program_id | varchar(200) | ティア情報を表しています | 6549 |
passenger_name | varchar(200) | 予約に登録されている方の氏名（通常は購入者と同じですが、航空会社の予約の場合は、搭乗券が発行されたすべての乗客が記載されます）。 | ジェームズ・スミス |
purchaser_first_name | varchar(200) | ご予約をされた方の名前。 | ジェームス |
purchaser_last_name | varchar(200) | ご予約をされた方の姓。 | Smith |
purchaser_email_address | varchar(200) | ご予約をご購入される方のメールアドレス。 | james.smith@email.com |
billing_address | varchar(200) | 予約を購入される方の住所（通り名、市、州／県、国、郵便番号を含みます）。 | ニューヨーク州ニューヨーク市、1st Street 123 |
billing_phone_number | varchar(200) | ご予約をされた方の電話番号。 | 10111213141 |
promotional_mail_indicator | char(3) | その個人がプロモーションメールの配信登録をしているかどうかの指標です。 | 0 |