注文品目データモデル

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

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

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

属性	形容	種類	使用例	挿入する	アップサート	移動
type	注文品目のタイプ。受け入れられる値は、スキーマで組織に対して事前定義されている必要があります。	string (大文字)	"FLIGHT"	必須	サポート対象外	サポート対象外
productId	製品コードのID。	糸	"DUB-LAS"	必須	サポート対象外	サポート対象外
name	注文品目の名前。注文品目の名前のフリーテキスト値。最大制限:128	string (タイトルケースを推奨)	"flight"	必須	サポート対象外	サポート対象外
description	注文明細の説明。	string (タイトルケースを推奨)	"individualSegments"	必須	サポート対象外	サポート対象外
vendor	注文品目を販売している組織。	string (タイトルケースを推奨)	"Company ABC"	必須	サポート対象外	サポート対象外
orderedAt	注文した商品が作成された日時。	ISO 8601日付/時刻UTC	"2025-03-07T16:15:11.000Z"	随意	サポート対象外	サポート対象外
quantity	注文品目の数または数量。	数	2	随意	サポート対象外	サポート対象外
price	注文品目の組織の価格。	数値 (通貨)	50, 30.6, -45	必須	サポート対象外	サポート対象外
currencyCode	注文品目の組織の通貨コード。	3文字のISO 4217	"EUR", "NZD", "USD"	必須	サポート対象外	サポート対象外
originalPrice	組織の通貨に換算する前の注文品目の単価。	数値 (通貨)	100	随意	サポート対象外	サポート対象外
originalCurrencyCode	注文品目の元の通貨コード。	3文字のISO 4217	"EUR", "NZD", "USD"	随意	サポート対象外	サポート対象外
referenceId	注文品目を参照するためにクライアントによって生成されるID。	糸	"B94TXY-1"	必須	サポート対象外	サポート対象外
status	オーダーアイテムのステータス。	string (大文字)	"PURCHASED", "CONFIRMED", "REFUNDED", "CANCELLED"	必須	随意	サポート対象外
channel	注文で使用されるチャネル。	string (大文字)	"AIRPORT_KIOSK", "BRANCH", "CALL_CENTER", "GDS", "KIOSK", "MOBILE_APP", "MOBILE_WEB", "OFFLINE", "OTA", "OTHER", "WEB"	随意	サポート対象外	サポート対象外
language	注文時に使用した言語。	2文字のISO 639言語コード (大文字)	"EN", "FR", "DE"	随意	サポート対象外	サポート対象外

以下は、個人を特定できる情報(PII)を含み、フライト注文アイテムにinsertモードを使用するJSON例です。

{
   "ref":"056621C2-C955-492D-B7EE-C77C6BDDFDEE",
   "schema":"order",
   "mode":"insert",
   "value":{
      "referenceId":"BXTOF9",
      "channel":"WEB",
      "pointOfSale":"spinair.com",
      "status":"PURCHASED",
      "orderedAt":"2025-03-07T16:15:11.000Z",
      "currencyCode":"EUR",
      "price":50,
      "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":50.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"
                  }
               ]
            }
         ]
      }
   }

次に示すのは、identifiers属性を含み、注文品目にinsertモードを使用するJSON例です。

{
   "ref":"056621C2-C955-492D-B7EE-C77C6BDDFDEE",
   "schema":"order",
   "mode":"insert",
   "value":{
      "referenceId":"BET_001-1",
      "channel":"WEB",
      "pointOfSale":"spinbet.com",
      "status":"PURCHASED",
      "orderedAt":"2025-03-07T16:15:11.000Z",
      "currencyCode":"EUR",
      "price":50,
      "paymentType":"Card",
      "cardType":"Visa",
      "contact":{
         "identifiers":[
            {
               "provider":"IDENTITY_SYSTEM",
               "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41",
               "expiryDate":"2025-08-23T16:17:16.000Z"
            },
            {
               "provider":"CRM",
               "id":"123456789t"
            }
         ]
      },
      "orderItems":[
         {
            "type":"BET_001-1",
            "productId":"CORRECT_SCORE",
            "name":"Exact score after 90 minutes",
            "description":"footballBets",
            "vendor":"Company ABC",
            "orderedAt":"2025-03-07T16:15:11.000Z",
            "quantity":1,
            "price":50.00,
            "currencyCode":"EUR",
            "originalPrice":100.00,
            "originalCurrencyCode":"EUR",
            "referenceId":"BET_001-1",
            "status":"PURCHASED"
         }
      ]
   }
}

属性	形容	種類	使用例	挿入する	アップサート	移動
type	注文品目のタイプ。	string (複数の単語がある場合は大文字でアンダースコア)	"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	組織の通貨に換算する前の注文品目の単価。	数値 (通貨)	100	随意	サポート対象外	サポート対象外
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	注文品目の名前。注文品目の名前のフリーテキスト値。最大制限:128	string (タイトルケースを推奨)	"Insurance"	随意	サポート対象外	サポート対象外
description	注文明細の説明。	string (タイトルケースを推奨)	"Family Insurance"	随意	サポート対象外	サポート対象外
consumerTypeCode	乗客のタイプを表すために使用されるコード。フライトにのみ適用されます。	string (大文字)	"ADT", "CHD", "INF", "INS"	オプション/製品カテゴリに応じて必須	サポート対象外	サポート対象外
flightSegments	注文品目に関連付けられているフライトセグメントの一覧。フライトの注文にのみ適用されます。	JSONオブジェクトのJSON配列	該当なし	随意	サポート対象外	サポート対象外
tripType (非推奨)	ゲストが利用する旅行の種類。	string (大文字)	"OW", "RT"	廃止	廃止	廃止

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

{
   "ref":"056621C2-C955-492D-B7EE-C77C6BDDFDEE",
   "schema":"order",
   "mode":"insert",
   "value":{
      "referenceId":"B94TXY",
      "channel":"WEB",
      "pointOfSale":"spinair.com",
      "status":"PURCHASED",
      "orderedAt":"2025-08-23T16:17:16.000Z",
      "currencyCode":"EUR",
      "price":50,
      "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-01-01T16:17:16.000Z",
            "quantity":1,
            "price":50.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"
               }
            ]
         }
      ]
   }
}

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