バッチAPIオフライン注文

注文品目データモデル

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

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

バッチファイルを作成する際は、以下の表の属性に加えて、必要なすべての属性を含めてください。

::::タブ:::tab{title="2.1"}

属性

概要

種類

例

挿入

アップサート

移住

type

注文項目の種類。受け入れられた値はスキーマ内で組織ごとにあらかじめ定義されている必要があります。

文字列(大文字)

"FLIGHT"

必須

サポートされていません

productId

商品コードのID。

ストリング

"DUB-LAS"

必須

サポートされていません

name

注文品名。注文品名のフリーテキスト値。最大制限

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

"flight"

必須

サポートされていません

description

注文品の説明。

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

"individualSegments"

必須

サポートされていません

vendor

注文品を販売している組織です。

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

"Company ABC"

必須

サポートされていません

orderedAt

注文品が作られた日付と時間。

ISO 8601 日付/時刻 UTC

"2026-03-07T16:15

.000Z"

オプション

サポートされていません

quantity

注文品の数や数量。

番号

オプション

サポートされていません

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

`.000Z", "currencyCode":"EUR", "price"

, "paymentType":"Card", "cardType":"Visa", "contact":{ "title":"Mr", "firstName":"John", "lastName":"Doe", "gender":"male", "dateOfBirth":"1985-12-24T00

", "email":"[email protected]", "phoneNumbers": "+353161123345", "+353861123311" }, "orderItems": { "type":"FLIGHT", "productId":"DUB-LAS", "name":"flight", "description":"individualSegments", "vendor":"Company ABC", "orderedAt":"2026-03-07T16:`15

`.000Z", "quantity"

, "price"

.00, "currencyCode":"EUR", "originalPrice"

.00, "originalCurrencyCode":"EUR", "referenceId":"B94TXY-1", "status":"PURCHASED", "consumerTypeCode":"ADT", "flightSegments": { "id":"1234", "origin":"DUB", "destination":"LHR", "departureDateTime":"2026-08-15T16

", "arrivalDateTime":"2026-08-15T17

", "flightNumber":"459", "fareClass":"Economy", "fareFamily":"Plus", "carrier":"FR", "originDestination":"DUB-LHR" }, { "id":"1235", "origin":"LHR", "destination":"LAS", "departureDateTime":"2026-08-15T20

", "arrivalDateTime":"2026-08-15T22

", "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

`.000Z", "currencyCode":"EUR", "price"

, "paymentType":"Card", "cardType":"Visa", "contact":{ "identifiers": { "provider":"IDENTITY_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:`17

`.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

`.000Z", "quantity"

, "price"

.00, "currencyCode":"EUR", "originalPrice"

.00, "originalCurrencyCode":"EUR", "referenceId":"BET_001-1", "status":"PURCHASED" }

} }

属性

概要

種類

例

挿入

アップサート

移住

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

注文品の数や数量。

番号

オプション

サポートされていません

orderedAt

注文品が作られた日付と時間。

ISO 8601 日付/時刻 UTC

"2026-01-01T16:17

.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

注文品名。注文品名のフリーテキスト値。最大制限

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

"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

`.000Z", "currencyCode":"EUR", "price"

, "paymentType":"Card", "cardType":"Visa", "contact":{ "title":"Mr", "firstName":"John", "lastName":"Doe", "gender":"male", "dateOfBirth":"1985-12-24T00

", "email":"[email protected]", "phoneNumbers": "+353161123345", "+353861123311" , "identifiers": { "provider":"IDENTITY_SYSTEM", "id":"B7524AE6-CF1C-440F-B1A2-0C9D42F5CB41", "expiryDate":"2025-08-23T16:`17

`.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

`.000Z" } , "orderItems": { "referenceId":"B94TXY-1-item001" }

} , "orderItems": { "type":"FLIGHT", "productId":"DUB-LAS", "orderedAt":"2026-01-01T16:`17

`.000Z", "quantity"

, "price"

.00, "currencyCode":"EUR", "originalPrice"

.00, "originalCurrencyCode":"EUR", "referenceId":"B94TXY-1-item001", "status":"PURCHASED", "consumerTypeCode":"ADT", "flightSegments": { "id":"1234", "origin":"DUB", "destination":"LHR", "departureDateTime":"2026-08-15T16

", "arrivalDateTime":"2026-08-15T17

", "arrivalDateTime":"2026-08-15T22

", "flightNumber":"460", "fareClass":"Economy", "fareFamily":"Plus", "carrier":"FR", "originDestination":"LHR-LAS" }

}

} }

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