File-based旅程の配送
Partner Portal のItineraries APIの標準レポートには、宿泊のみ、または複数のビジネスライン（LOB）のtransaction-level予約が含まれます。当社の標準レポートを使用することで、追加の開発時間をかけることなく、迅速にデータを取得することができます。
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) | パッケージ購入に含まれる製品。購入がパッケージでない場合は、単一の製品ライン名のみが表示されます。 | 空気、車 |
itinerary_number | varchar(50) | 旅程番号または POS 注文参照番号。 | 12345678910111 |
booking_item_id | varchar(50) | 旅程の一部として予約された特定の要素の識別子。フィールドの値は、プラスでもマイナスでもかまいません。 | 1400882912 |
currency_code | char(3) | 標準的な国際銀行口座番号（IBAN）の通貨コード形式で表された予約の支払通貨。 | JPY |
gbv_local | 十進(18,4) | グロス・ブッキング・バリュー（GBV）、つまり税金や手数料を含む予約総額を、支払いに使用される通貨で表示します。 | 694.89 |
order_count | スモールミント | パッケージ購入の注文数（アイテム数ではありません）。 | 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 | 十進(18,4) | クーポンの金額（米ドル | -58.6877 |
gbv_usd | 十進(18,4) | 予約総額は米ドル建てです。 | 694.8941 |
gbv_tpid | 十進(18,4) | TPID通貨建てのGBV総額。 | 694.8941 |
taxes_and_fees_local | 十進(18,4) | 現地通貨での税金と手数料の合計。 | 144.77 |
taxes_and_fees_usd | 十進(18,4) | 税金と手数料の合計は米ドルで表示されます。 | 144.77 |
taxes_and_fees_tpid | 十進(18,4) | TPID通貨での税金と手数料の合計。 | 144.77 |
insurance_gbv_local | 十進(18,4) | 現地通貨建ての保険金額。 | 80.4 |
insurance_gbv_usd | 十進(18,4) | 保険金額（米ドル | 80.4 |
air_supplier_pnr | varchar(100) | サプライヤー航空旅客名記録。 | ABCDEF |
air_carrier_pnr | varchar(100) | 航空 航空会社旅客名記録。 | ビーシーディーエフジー |
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 | スモールミント | 予約中の航空券の数（予約アイテムIDを含む詳細ファイル（通常は0または1）。 | 1 |
air_segment_count | スモールミント | 航空旅行のセグメント数（予約項目IDレベル以上に集計される場合は、予約に含まれるすべての旅客のすべてのセグメントの合計となります）。 | 2 |
air_gbv_local | 十進(18,4) | 現地通貨での航空券の予約総額。 | 694.8941 |
air_gbv_usd | 十進(18,4) | 航空券の予約総額（USドル）。 | 694.8941 |
air_gbv_tpid | 十進(18,4) | TPID通貨での航空券の予約総額。 | 694.8941 |
air_tpid_currency_code | char(3) | TPIDの予約通貨は、標準的な国際銀行口座番号（IBAN）の通貨コード形式で表されます。 | JPY |
total_person_count | 整数 | 予約人数の合計（宿泊部分のみ）。 | 3 |
adult_count | スモールミント | 予約に含まれる大人の人数（宿泊部分のみ）。 | 2 |
child_count | スモールミント | 予約に含まれるお子様の人数（宿泊部分のみ）。 | 1 |
lodging_supplier_confirmation_code | varchar(100) | 予約時に施設から提供される確認コード。 | 1516171819 |
lodging_business_model | varchar(200) | 宿泊予約のビジネスモデル。 | マーチャント |
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 | スモールミント | 施設の予約室数です。 | 1 |
lodging_room_night_count | スモールミント | 予約の宿泊数（滞在期間 * 部屋数）。 | 5 |
lodging_gbv_local | 十進(18,4) | 現地通貨での宿泊予約部分の予約総額。 | 1379.8 |
lodging_gbv_usd | 十進(18,4) | 予約の宿泊部分の総予約金額を米ドルで表示。 | 1029.9317 |
lodging_gbv_tpid | 十進(18,4) | TPID通貨での予約の宿泊部分の総予約金額。 | 1029.9317 |
lodging_average_daily_rate_local | 十進(18,4) | 予約された施設の1日あたりの平均料金（GBV / 滞在期間）を現地通貨で表示。 | 275.96 |
lodging_average_daily_rate_usd | 十進(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) | 予約された車がピックアップされる場所コード（通常は空港コード）。 | ワイディーエフ |
car_pickup_location | varchar(200) | ご予約のお車をお引取りいただく場所。 | Deer Lake, NL (YDF-Deer Lake Regional) |
car_dropoff_location_code | char(3) | 予約された車をお預けになる場所コード（通常は空港コード）。 | ワイディーエフ |
car_dropoff_location | varchar(200) | ご予約のお車をお預かりする場所。 | Deer Lake, NL (YDF-Deer Lake Regional) |
car_trip_type | varchar(200) | 往復、片道どちらのご予約も承ります。 | 往復 |
car_rental_day_count | スモールミント | 車の予約日数 | 7 |
car_count | スモールミント | 予約した車の数 | 1 |
car_gbv_local | 十進(18,4) | 現地通貨建ての予約の自動車部分の総予約金額。 | 310.8 |
car_gbv_usd | 十進(18,4) | 予約車両部分の予約総額（USドル）。 | 231.9919 |
car_gbv_tpid | 十進(18,4) | TPID通貨での予約の自動車部分の総予約金額。 | 1029.9317 |
car_tpid_currency_code | char(3) | 標準的な国際銀行口座番号（IBAN）通貨コード形式で表される車のTPID予約通貨。 | JPY |
activity_offering_name | varchar(200) | 予約されたデスティネーション・サービスのアクティビティ名 | Passions of Paradise Great Barrier Reef |
activity_vendor_name | varchar(200) | 予約されたデスティネーション・サービス業者名 | ヴィアトール (3P) |
activity_vendor_city | varchar(200) | ベンダーの支店がある都市 | 不明 |
activity_vendor_country_code | char(3) | ベンダーの支店がある国コード。 | NZL |
activity_ticket_count | スモールミント | アクティビティのチケット予約数 | 1 |
activity_gbv_local | 十進(18,4) | 現地通貨での予約のデスティネーション・サービス部分の総予約金額。 | 204.02 |
activity_gbv_usd | 十進(18,4) | 予約のデスティネーション・サービス部分の予約総額（米ドル）。 | 152.2878 |
activity_gbv_tpid | 十進(18,4) | TPID通貨でのアクティビティ部分の予約総額。 | 1029.9317 |
activity_tpid_currency_code | char(3) | 標準的な国際銀行口座番号（IBAN）通貨コード形式で表されるアクティビティTPID予約通貨。 | JPY |
loyalty_id | varchar(200) | ロイヤルティ／会員ID番号。 | 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) | 予約購入者のEメールアドレス | james.smith@email.com |
billing_address | varchar(200) | 予約購入者の住所（通り、市町村、都道府県、国、郵便番号を含む）。 | 123 1st Street, New York, NY |
billing_phone_number | varchar(200) | 予約購入者の電話番号 | 10111213141 |
promotional_mail_indicator | char(3) | 個人がプロモーションメールの受信に登録しているかどうかの指標。 | 0 |