フライトの注文データモデル

日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

バッチ・ファイルを作成するときは、フォーマット要件に従い、次の表の属性を含めてください。

属性	形容	種類	使用例	挿入する	アップサート	移動
referenceId	注文を参照するために組織によって生成される一意のID。	糸	"B94TXY-1"	必須	必須	サポート対象外
channel	注文で使用されるチャネル。	糸	"AIRPORT_KIOSK", "BRANCH", "CALL_CENTER", "GDS", "KIOSK", "MOBILE_APP", "MOBILE_WEB", "OFFLINE", "OTA", "OTHER", "WEB"	必須	必須	サポート対象外
pointOfSale	注文に使用された販売時点情報。	文字列 (クライアントによって事前定義済み)	"myretailsite.com", "retailsite.co.uk"	必須	必須	サポート対象外
status	注文のステータス。	string (大文字)	"PURCHASED", "PAYMENT_PENDING", "CONFIRMED", "CANCELLED", "REFUNDED"	必須	随意	サポート対象外
orderedAt	注文が行われた日時。	ISO 8601日付/時刻UTC	"2025-03-07T16:15:11.000Z"	必須	Orderがまだ存在しない場合は必須	サポート対象外
currencyCode	ゲストが購入を完了するために使用した通貨。これを組織の既定の通貨に設定します。	3文字のISO 4217	"EUR", "NZD","USD"	必須	随意	サポート対象外
price	注文に対して支払われた金額。	数値 (通貨)	50, 30.6	必須	随意	サポート対象外
paymentType	注文の支払い方法。	string (タイトルケースを推奨)	"Card", "Paypal", "Voucher", "ATM", "Cash", "Other"	必須	随意	サポート対象外
cardType	注文の支払いに使用されたカードの種類。	string (タイトルケースを推奨)	"Mastercard", "Visa", "Diners", "American Express"	paymentType次の場合は必須です"Card"	随意	サポート対象外
contact	注文に関連付けられている連絡先。	JSONオブジェクト	該当なし	必須	必須	サポート対象外
orderItems	注文内の1つ以上の項目の一覧。	JSONオブジェクトのJSON配列	該当なし	必須	必須	サポート対象外

{
   "ref":"056621C2-C955-492D-B7EE-C77C6BDDFDEE",
   "schema":"order",
   "mode":"insert",
   "value":{
      "referenceId":"B94TXY-1",
      "channel":"WEB",
      "pointOfSale":"myretailsite.com",
      "status":"PURCHASED",
      "orderedAt":"2025-03-07T16:15:11.000Z",
      "currencyCode":"EUR",
      "price":100,
      "paymentType":"Card",
      "cardType":"Visa",
      "contact":{
         "title":"Mr",
         "firstName":"John",
         "lastName":"Doe",
         "gender":"male",
         "dateOfBirth":"1985-12-24T00:00Z",
         "email":"[email protected]",
         "phoneNumbers":[
            "+353161123345",
            "+353861123311"
         ]
      },
      "orderItems":[
         {
            "type":"FLIGHT",
            "productId":"DUB-LAS",
            "name":"flight",
            "description":"individualSegments",
            "vendor":"Company ABC",
            "orderedAt":"2025-03-07T16:15:11.000Z",
            "quantity":1,
            "price":100.00,
            "currencyCode":"EUR",
            "originalPrice":100.00,
            "originalCurrencyCode":"EUR",
            "referenceId":"B94TXY-1",
            "status":"PURCHASED",
            "consumerTypeCode":"ADT",
            "flightSegments":[
               {
                  "id":"1234",
                  "origin":"DUB",
                  "destination":"LHR",
                  "departureDateTime":"2025-08-15T16:00Z",
                  "arrivalDateTime":"2025-08-15T17:20Z",
                  "flightNumber":"459",
                  "fareClass":"Economy",
                  "fareFamily":"Plus",
                  "carrier":"FR",
                  "originDestination":"DUB-LHR"
               },
               {
                  "id":"1235",
                  "origin":"LHR",
                  "destination":"LAS",
                  "departureDateTime":"2025-08-15T20:00Z",
                  "arrivalDateTime":"2025-08-15T22:30Z",
                  "flightNumber":"460",
                  "fareClass":"Economy",
                  "fareFamily":"Plus",
                  "carrier":"FR",
                  "originDestination":"LHR-LAS"
               }
            ]
         }
      ]
   }
}

属性	形容	種類	使用例	挿入する	アップサート	移動
referenceId	注文を参照するために組織によって生成される一意のID。	糸	"B94TXY-1"	必須	必須	サポート対象外
channel	注文で使用されるチャネル。	糸	"AIRPORT_KIOSK", "BRANCH", "CALL_CENTER", "GDS", "KIOSK", "MOBILE_APP", "MOBILE_WEB", "OFFLINE", "OTA", "OTHER", "WEB"	随意	随意	サポート対象外
pointOfSale	注文に使用された販売時点情報。	文字列 (クライアントによって事前定義済み)	"spinflight.com", "spinair.com"	随意	随意	サポート対象外
status	注文のステータス。	string (大文字)	"RESERVED", "PAYMENT_PENDING", "DECLINED", "PURCHASED", "PENDING", "CONFIRMED", "PARTIALY_CONFIRMED", "CANCELLED", "REFUNDED", "PARTIALY_REFUNDED", "UNKNOWN"	必須	随意	サポート対象外
orderedAt	注文が行われた日時。	ISO 8601日付/時刻UTC	"2025-03-07T16:15:11.000Z"	必須	Orderがまだ存在しない場合は必須	サポート対象外
currencyCode	ゲストが購入を完了するために使用した通貨。これを組織の既定の通貨に設定します。	3文字のISO 4217	"EUR", "NZD","USD"	必須	随意	サポート対象外
price	注文に対して支払われた金額。	数値 (通貨)	50, 30.6	必須	随意	サポート対象外
paymentType	注文の支払い方法。	string (タイトルケースを推奨)	"Card", "Paypal", "Voucher", "ATM", "Cash", "Other"	必須	随意	サポート対象外
cardType	注文の支払いに使用されたカードの種類。	string (タイトルケースを推奨)	"Mastercard", "Visa", "Diners", "American Express"	paymentType次の場合は必須です"Card"	随意	サポート対象外
contact	注文に関連付けられている連絡先。	JSONオブジェクト	該当なし	必須	必須	サポート対象外
consumers	注文に関連付けられているコンシューマーの一覧。	JSONオブジェクトのJSON配列	該当なし	随意	随意	サポート対象外
orderItems	注文内の1つ以上の項目の一覧。	JSONオブジェクトのJSON配列	該当なし	必須	必須	サポート対象外
extensions	注文に関連付けられているデータエクステンションのリスト。この機能は、Sitecoreの担当者にリクエストする必要があります。	JSONオブジェクトのJSON配列	該当なし	随意	随意	サポート対象外

バッチAPIは、乗客番号レコード(PNR)など、同じreferenceId値を持ち、別の注文から24時間以内にorderedAt値(購入日)を持つ注文を照合します。

{
   "ref":"056621C2-C955-492D-B7EE-C77C6BDDFDEE",
   "schema":"order",
   "mode":"insert",
   "value":{
      "referenceId":"B94TXY-1",
      "channel":"WEB",
      "pointOfSale":"spinair.com",
      "status":"PURCHASED",
      "orderedAt":"2025-03-07T16:15:11.000Z",
      "currencyCode":"EUR",
      "price":100,
      "paymentType":"Card",
      "cardType":"Visa",
      "contact":{
         "title":"Mr",
         "firstName":"John",
         "lastName":"Doe",
         "gender":"male",
         "dateOfBirth":"1985-12-24T00:00Z",
         "email":"[email protected]",
         "phoneNumbers":[
            "+353161123345",
            "+353861123311"
         ],
         "identifiers":[
            {
               "provider":"IDENTITY_SYSTEM",
               "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41",
               "expiryDate":"2025-08-23T16:17:16.000Z"
            },
            {
               "provider":"Loyalty Program",
               "id":"123456789t"
            }
         ]
      },
      "consumers":[
         {
            "title":"Mr",
            "firstName":"John",
            "lastName":"Doe",
            "identifiers":[
               {
                  "provider":"IDENTITY_SYSTEM",
                  "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41",
                  "expiryDate":"2025-08-23T16:17:16.000Z"
               }
            ],
            "orderItems":[
               {
                  "referenceId":"B94TXY-1"
               }
            ]
         }
      ],
      "orderItems":[
         {
            "type":"FLIGHT",
            "productId":"DUB-LAS",
            "orderedAt":"2025-03-07T16:15:11.000Z",
            "quantity":1,
            "price":100.00,
            "currencyCode":"EUR",
            "originalPrice":100.00,
            "originalCurrencyCode":"EUR",
            "referenceId":"B94TXY-1",
            "status":"PURCHASED",
            "consumerTypeCode":"ADT",
            "flightSegments":[
               {
                  "id":"1234",
                  "origin":"DUB",
                  "destination":"LHR",
                  "departureDateTime":"2025-08-15T16:00Z",
                  "arrivalDateTime":"2025-08-15T17:20Z",
                  "flightNumber":"459",
                  "fareClass":"Economy",
                  "fareFamily":"Plus",
                  "carrier":"FR",
                  "originDestination":"DUB-LHR"
               },
               {
                  "id":"1235",
                  "origin":"LHR",
                  "destination":"LAS",
                  "departureDateTime":"2025-08-15T20:00Z",
                  "arrivalDateTime":"2025-08-15T22:30Z",
                  "flightNumber":"460",
                  "fareClass":"Economy",
                  "fareFamily":"Plus",
                  "carrier":"FR",
                  "originDestination":"LHR-LAS"
               }
            ]
         }
      ]
   }
}

この記事を改善するための提案がある場合は、お知らせください!