オーダー REST API v2(レガシー)

!重要このREST APIの新しいバージョン(v2.1)が利用可能です。このREST APIが初めてなら、新しいバージョンを使いましょう。あるいは、すでに古いバージョンを使っているなら、v2とv2.1の違いについて調 べてアップグレードしてみてください。

orderオブジェクトは他のすべてのオブジェクトの親オブジェクトであり、順序全体に共通する属性を含みます。

航空会社にとって、注文は予約と1対1の対応です。この注文REST APIは、乗客番号記録(PNR)のように同じreferenceId値を持ち、2日以内にorderedAtの価値(購入日)を持つ注文とマッチングします。

以下の表はorderオブジェクトの属性を説明します。

属性

種類

概要

例

referenceId

ストリング

あなたの組織が発行する唯一のIDで、その注文を参照します。フライトオーダーの場合は、多くの場合PNRです。

"B94TXY-1"

channel

ストリング

注文で使用されたチャネル。

"AIRPORT_KIOSK", "BRANCH", "CALL_CENTER", "GDS", "KIOSK", "MOBILE_APP", "MOBILE_WEB", "OFFLINE", "OTA", "OTHER", "WEB"

pointOfSale

文字列(クライアントによって事前定義)

注文で使われた販売時点(POS)。

"spinflight.com", "spinair.com"

status

文字列(大文字)

命令の状況。

"RESERVED", "PAYMENT_PENDING", "DECLINED", "PURCHASED", "PENDING", "CONFIRMED", "PARTIALY_CONFIRMED", "CANCELLED", "REFUNDED", "PARTIALY_REFUNDED", "UNKNOWN"

orderedAt

ISO 8601 日付/時刻 UTC

注文が行われた日時。

"2026-01-01T16:17

currencyCode

3文字 ISO 4217

ゲストが購入を完了するために使った通貨。これを組織のデフォルト通貨に設定してください。

"EUR", "NZD","USD"

price

数字(通貨)

注文代金の金額です。

50, 30.6

paymentType

ストリング(タイトルケース推奨)

注文の支払い方法。

"Card", "Paypal", "Voucher", "ATM", "Cash", "Other"

cardType

ストリング(タイトルケース推奨)

注文の支払いに使われたカードの種類です。

"Mastercard", "Visa", "Diners", "American Express"

contact

JSON オブジェクト

その命令に関連する接触。

該当なし

consumers

JSON JSONオブジェクトの配列

注文に関連する消費者のリスト。

該当なし

orderItems

JSON JSONオブジェクトの配列

注文の中の1つ以上のアイテムのリスト。

該当なし

以下は標準的な応答属性です:

属性

概要

種類

例

href

リソース完全限定の位置情報 Uniform Resource Identifier(URI)。

ストリング

"https://{apiEndpoint}/v2/{resourceName}/{resourceRef}"

ref

リソースの参照。

文字列UUID

"9d94ee11-7043-4b71-980c-a777d00a7b46"

createdAt

リソースがSitecore CDPで作成された日時。

ISO 8601 日付/時刻 UTC

"2026-01-01T16:17

modifiedAt

リソースがSitecore CDPで更新された日時。

ISO 8601 日付/時刻 UTC

"2026-01-01T16:17