注文品目REST API v2 (レガシー)
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
このREST APIの新しいバージョン(v2.1)が利用可能です。このREST APIを初めて使用する場合は、新しいバージョンを使用してください。または、すでに古いバージョンを使用している場合は、v2とv2.1の違いについて読んで アップグレードできるようにしてください。
orderItemsオブジェクトは、注文の一部として購入されたものを表します。航空会社の予約の場合、注文商品は通常、1つ以上のフライト区間、またはフライトに加えて購入された付帯商品(超過手荷物許容量や優先搭乗など)です。
次の表では、オーダーアイテムの属性について説明します。
|
属性 |
種類 |
形容 |
使用例 |
|---|---|---|---|
|
type |
string enum (複数の単語がある場合は大文字でアンダースコア) |
注文品目のタイプ。 |
次のいずれかである必要があります。 "FLIGHT", "HOTEL", "CAR", "BAG", "INSURANCE", "CAR_SEAT", "MEAL", "FEE", "LOUNGE_ACCESS", "HOTEL_WIFI", "HOTEL_BREAKFAST", "SEAT_UPGRADE", "TAXI", "PARKING", "SEAT", "UPGRADE", "TRANSPORT", "OTHER", "INFLIGHT_ENTERTAINMENT", "ACTIVITY", "CARBON_OFFSET", "PAID_SUBSCRIPTION", "COMFORT_PACK", "INFLIGHT_VOUCHER", "PACKAGE", "SMS_ITINERARY", "SPECIAL_ASSISTANCE", "CHARITY_DONATION", "TRANSFER" *Deprecated:"BAGGAGE", "FEES", "SEAT_UPGRADES", "INFLIGHT_VOUCHERS" |
|
productId |
糸 |
製品のID。 |
"DUB-LAS" |
|
quantity |
数 |
注文品目の数または数量。 |
2 |
|
orderedAt |
ISO 8601日付/時刻UTC |
注文した商品が作成された日時。 |
"2025-01-01T16:17:16.000Z" |
|
price |
数値 (通貨) |
注文品目の組織の価格。 |
50, 30.6, -45 |
|
currencyCode |
3文字のISO 4217 |
注文品目の組織の通貨コード。 |
"EUR", "NZD", "USD" |
|
originalPrice |
数値 (通貨) |
組織の通貨に換算する前の注文品目の単価。 |
50 |
|
originalCurrencyCode |
3文字のISO 4217 |
注文品目の元の通貨コード。 |
"EUR", "NZD", "USD" |
|
referenceId |
糸 |
注文品目を参照するためにクライアントによって生成されるID。 |
"B94TXY-1" |
|
vendor |
string (タイトルケースを推奨) |
注文品目を販売している組織。 |
"Company ABC" |
|
status |
string (大文字) |
オーダーアイテムのステータス。 |
"RESERVED", "PENDING", "DECLINED", "CONFIRMED", "CANCELLED", "REFUNDED", "PURCHASED", "UNKNOWN" |
|
channel |
string (大文字) |
注文で使用されるチャネル。 |
"AIRPORT_KIOSK", "BRANCH", "CALL_CENTER", "GDS", "KIOSK", "MOBILE_APP", "MOBILE_WEB", "OFFLINE", "OTA", "OTHER", "WEB" |
|
language |
2文字のISO 639言語コード (大文字) |
注文時に使用した言語。 |
"EN", "FR", "DE" |
|
name |
string (タイトルケースを推奨) |
注文品目の名前。注文品目の名前のフリー テキスト値。最大制限:128 |
"Insurance" |
|
description |
string (タイトルケースを推奨) |
注文明細の説明。 |
"Family Insurance" |
|
flightSegments |
JSONオブジェクトのJSON配列 |
注文品目に関連付けられているフライト セグメントの一覧。フライトの注文にのみ適用されます。 |
該当なし |
フライト セグメントの属性:
|
属性 |
形容 |
種類 |
使用例 |
必須/オプション |
|---|---|---|---|---|
|
id |
フライト区間を識別するためのID。 |
糸 |
"1234" |
必須 |
|
origin |
フライト区間のIATA空港または都市の出発地コード。 |
IATA空港または市内局番(大文字) |
"DUB", "LHR", "BCN" |
必須 |
|
destination |
フライト区間のIATA空港または都市目的地コード。 |
IATA空港または市内局番(大文字) |
"DUB", "LHR", "BCN" |
必須 |
|
departureDateTime |
フライト区間の現地出発日時。この値は、現地の出発日/時刻として渡し、UTC時間でなくても末尾にZを含める必要があります。 |
ISO 8601日付/時刻 |
"2025-08-23T16:17Z" |
必須 |
|
arrivalDateTime |
フライト区間の現地到着日時。この値は、現地の出発日/時刻として渡し、UTC時間でなくても末尾にZを含める必要があります。 |
ISO 8601日付/時刻 |
"2025-08-23T16:17Z" |
必須 |
|
flightNumber |
フライト区間のマーケティング便名。 |
糸 |
"12345" |
必須 |
|
fareClass |
フライト区間の運賃クラス。 |
string (タイトルケースを推奨) |
"Economy", "Business", "First Class" |
必須 |
|
fareFamily |
フライト区間の運賃ファミリー。 |
string (タイトルケースを推奨) |
"Economy Plus" |
随意 |
|
bookingClass |
フライト区間の予約クラス。 |
string (大文字) |
"Y7 K5 M4 T6 E3" |
随意 |
|
equipmentType |
フライト セグメントの機材の種類。 |
string (大文字) |
"BOEING 777" |
随意 |
|
carrier |
フライト区間のマーケティング航空会社コード。 |
IATA航空会社コード(大文字) |
"EI", "FR", "BA" |
必須 |
|
originDestination |
フライト区間の出発地と目的地。 |
string (大文字) |
"DUB-JFK" |
随意 |
|
operatingCarrier |
フライト区間の運航航空会社コード。 |
IATA航空会社コード(大文字) |
"EI", "FR", "BA" |
随意 |
|
operatingFlightNumber |
フライト区間の運航航空会社の便名。 |
糸 |
"5678" |
随意 |