注文データモデル
このページの翻訳は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":{ "identifiers":[ { "provider":"IDENTITY_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:17:16.000Z" }, { "provider":"CRM", "id":"123456789t" } ] }, "orderItems":[ { "type":"BET_EXACT_90", "productId":"CORRECT_SCORE", "name":"Exact score after 90 minutes", "description":"footballBets", "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" } ] } }
|
属性 |
形容 |
種類 |
使用例 |
挿入する |
アップサート |
移動 |
|---|---|---|---|---|---|---|
|
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" } ] } ] } }