--- title: "注文品目データモデル" slug: "order-item-data-model" abstract: "注文項目の標準データモデル(Sitecore CDPバッチAPI)を記述します。" --- # 注文品目データモデル バッチファイルを作成する際は、以下の表の属性に加えて [、必要なすべての属性](https://doc.sitecore.com/cdp/ja/developers/api/batch-api/batch-api-offline-orders/batch-file-formatting-requirements.html#UUID-4499e082-be7d-9ebb-4936-c178936c1e06_para-idm1903351877649584) を含めてください。 ::::タブ:::tab{title="2.1"} 属性 概要 種類 例 挿入 アップサート 移住 type 注文項目の種類。受け入れられた値はスキーマ内で組織ごとにあらかじめ定義されている必要があります。 文字列(大文字) "FLIGHT" 必須 サポートされていません サポートされていません productId 商品コードのID。 ストリング "DUB-LAS" 必須 サポートされていません サポートされていません name 注文品名。注文品名のフリーテキスト値。最大制限:128 ストリング(タイトルケース推奨) "flight" 必須 サポートされていません サポートされていません description 注文品の説明。 ストリング(タイトルケース推奨) "individualSegments" 必須 サポートされていません サポートされていません vendor 注文品を販売している組織です。 ストリング(タイトルケース推奨) "Company ABC" 必須 サポートされていません サポートされていません orderedAt 注文品が作られた日付と時間。 ISO 8601 日付/時刻 UTC "2026-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 注文品の状況。 文字列(大文字) "PURCHASED", "CONFIRMED", "REFUNDED", "CANCELLED" 必須 オプション サポートされていません channel 注文で使用されたチャネル。 文字列(大文字) "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":"2026-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":"john.doe@sitecore.com", "phoneNumbers": "+353161123345", "+353861123311" }, "orderItems": { "type":"FLIGHT", "productId":"DUB-LAS", "name":"flight", "description":"individualSegments", "vendor":"Company ABC", "orderedAt":"2026-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":"2026-08-15T16:00Z", "arrivalDateTime":"2026-08-15T17:20Z", "flightNumber":"459", "fareClass":"Economy", "fareFamily":"Plus", "carrier":"FR", "originDestination":"DUB-LHR" }, { "id":"1235", "origin":"LHR", "destination":"LAS", "departureDateTime":"2026-08-15T20:00Z", "arrivalDateTime":"2026-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":"2026-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":"2026-03-07T16:\`15:11\`.000Z", "quantity":1, "price":50.00, "currencyCode":"EUR", "originalPrice":100.00, "originalCurrencyCode":"EUR", "referenceId":"BET\_001-1", "status":"PURCHASED" } } } ::::::tab{title="2.0"} 属性 概要 種類 例 挿入 アップサート 移住 type 注文品の種類。 文字列(複数語の場合は大文字で下線付き) "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 "2026-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 注文品を販売している組織です。 ストリング(タイトルケース推奨) "Company ABC" オプション サポートされていません サポートされていません status 注文品の状況。 文字列(大文字) "RESERVED", "PENDING", "DECLINED", "CONFIRMED", "CANCELLED", "REFUNDED", "PURCHASED", "UNKNOWN" 必須 サポートされていません サポートされていません channel 注文で使用されたチャネル。 文字列(大文字) "AIRPORT\_KIOSK", "BRANCH", "CALL\_CENTER", "GDS", "KIOSK", "MOBILE\_APP", "MOBILE\_WEB", "OFFLINE", "OTA", "OTHER", "WEB" オプション サポートされていません サポートされていません language 注文を出す際に使われる言葉遣い。 2文字のISO 639言語コード(大文字) "EN", "FR", "DE" オプション サポートされていません サポートされていません name 注文品名。注文品名のフリーテキスト値。最大制限:128 ストリング(タイトルケース推奨) "Insurance" オプション サポートされていません サポートされていません description 注文品の説明。 ストリング(タイトルケース推奨) "Family Insurance" オプション サポートされていません サポートされていません consumerTypeCode 乗客の種類を表すコード。フライトのみ適用。 文字列(大文字) "ADT", "CHD", "INF", "INS" 製品カテゴリによってオプション/必須 サポートされていません サポートされていません flightSegments 注文品に関連するフライトセグメントの一覧。フライトオーダーにのみ適用されます。 JSON JSONオブジェクトの配列 該当なし オプション サポートされていません サポートされていません tripType (非推奨) ゲストがどんな種類の旅行をするか。 文字列(大文字) "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":"2026-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":"john.doe@sitecore.com", "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-item001" } } , "orderItems": { "type":"FLIGHT", "productId":"DUB-LAS", "orderedAt":"2026-01-01T16:\`17:16\`.000Z", "quantity":1, "price":50.00, "currencyCode":"EUR", "originalPrice":100.00, "originalCurrencyCode":"EUR", "referenceId":"B94TXY-1-item001", "status":"PURCHASED", "consumerTypeCode":"ADT", "flightSegments": { "id":"1234", "origin":"DUB", "destination":"LHR", "departureDateTime":"2026-08-15T16:00Z", "arrivalDateTime":"2026-08-15T17:20Z", "flightNumber":"459", "fareClass":"Economy", "fareFamily":"Plus", "carrier":"FR", "originDestination":"DUB-LHR" }, { "id":"1235", "origin":"LHR", "destination":"LAS", "departureDateTime":"2026-08-15T20:00Z", "arrivalDateTime":"2026-08-15T22:30Z", "flightNumber":"460", "fareClass":"Economy", "fareFamily":"Plus", "carrier":"FR", "originDestination":"LHR-LAS" } } } } :::::::