予約(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ブッキングリファレンス