予約(StartBooking)
API情報
予約リクエスト(StartBooking)のレスポンス返却に時間がかかりる場合があります。その場合も予約リクエストが成功している可能性があります。"Unconfirmed"のレスポンスが返却されるため適切に処理を行い、"Failed Booking"として処理しないようお願いいたします。
また、Travelfusionサーバーからのレスポンスが予期しないものだった場合やスキーマの整合チェックに失敗した場合でも、予約レスポンス(StartBooking)の内容に関わらず予約処理が行われるよう貴社システムにて構築するようお願いいたします。
予約リクエスト(StartBooking)以降の処理は処理フロー図をご参考ください。
リクエストサンプル
選択<CommandList>
<StartBooking>
<XmlLoginId>XXXXXXXXXXXXXXXX</XmlLoginId>
<LoginId>XXXXXXXXXXXXXXXX</LoginId>
<TFBookingReference>61W2WII45</TFBookingReference>
<ExpectedPrice>
<Amount>18709.00</Amount>
<Currency>JPY</Currency>
</ExpectedPrice>
<FakeBooking>
<EnableFakeBooking>true</EnableFakeBooking>
<FakeBookingSimulatedDelaySeconds>0</FakeBookingSimulatedDelaySeconds>
<FakeBookingStatus>Succeeded</FakeBookingStatus>
</FakeBooking>
</StartBooking>
</CommandList>
レスポンスサンプル
選択<CommandList>
<StartBooking millis="462">
<LoginId>XXXXXXXXXXXXXXXX</LoginId>
<TFBookingReference>61W2WII45</TFBookingReference>
</StartBooking>
<GeneralInfoItemList>
<GeneralInfoItem>
<Name>ServerAddress</Name>
<Value>10.30.50.114</Value>
</GeneralInfoItem>
<GeneralInfoItem>
<Name>ClientAddress</Name>
<Value>10.30.50.112</Value>
</GeneralInfoItem>
<GeneralInfoItem>
<Name>StartTime</Name>
<Value>06/04/15-10:13:19</Value>
</GeneralInfoItem>
<GeneralInfoItem>
<Name>EndTime</Name>
<Value>06/04/15-10:13:19</Value>
</GeneralInfoItem>
</GeneralInfoItemList>
</CommandList>
XML Field | 階層 | M/O | 説明 |
---|---|---|---|
CommandList | コマンドリストタグ | ||
-StartBooking | 1 | M | コマンドタグ |
--XmlLoginId | 2 | M | XMLログインID 詳細は接続仕様 参照 |
--LoginId | 2 | M | ログインID 詳細は接続仕様 参照 |
--TFBookingReference | 2 | M | Travelfusion ブッキングリファレンス 旅客情報レスポンス(ProcessTerms)で返却されたリファレンス |
--ExpectedPrice | 2 | M | 支払額 当該エレメントのフォーマットは 空席照会レスポンス(CheckRouting)仕様参照。 Travelfusionでは当該エレメントの金額と実際の支払料金の チェックを行う。違っていた場合、予約処理に進まずエラーとなる。 |
--FakeBooking | 2 | O | FakeBookingタグ 尚、開発時のテスト予約は必ず「Fake Booking」で行うこと。 実予約を行う場合は同タグは省略する。 「Fake Booking」設定漏れによる実予約実施については、 INFINIでは責任を負いかねます。 |
---EnableFakeBooking | 3 | O | FakeBooking "true" :FakeBookingとして仮の予約完了画面を表示する。 この場合、旅客情報レスポンス(ProcessTerms)で表示された料金と異なる料金が返却される。 "false" : 実際にサプライヤーに予約がリクエストされ、実予約が行われる。 |
---FakeBookingSimulatedDelaySeconds | O | FakeBookingの処理時間設定 当該エレメントの値が"30"だった場合、リクエスト後の30秒間は 後続の予約確認レスポンス(CheckBooking)が "BookingInProgres"となる。 30秒後に(次のエレメントの"FakeBookingStatusでステイタスを指定していた場合その)ステイタスレスポンスを返す。 尚、"EnableFakeBooking"が"false"の場合、当該エレメントは無視される。 |
|
---FakeBookingStatus | 3 | O | FakeBookingステイタス 予約確認レスポンス(CheckBooking)のステイタスを指定する。デフォルトは"Succeeded."。"BookingInProgress"を除く他のステイタスも指定可能。 尚、"EnableFakeBooking"が"false"の場合、当該エレメントは無視される。 |
---EnableFakeCardVerification | 3 | O | FakeCardバリデーション Fakeのカードバリデーションプロセスのリクエストを行う。 詳細は クレジットカード認証 参照 |
--SupplierVisualAuthorisationText | 2 | O | 未使用 |
XML Field | 階層 | M/O | 説明 |
---|---|---|---|
CommandList | コマンドリストタグ | ||
-StartBooking | 1 | M | コマンドタグ |
--TFBookingReference | 2 | M | Travelfusionブッキングリファレンス |