予約確認(CheckBooking)

 

API情報

予約確認レスポンス(CheckBooking)は予約の作成が成功しているかどうかを確認する為のAPIです。

 

リクエストサンプル

 選択<CommandList>
	<CheckBooking>
		<XmlLoginId>XXXXXXXXXXXXXXXX</XmlLoginId>
		<LoginId>XXXXXXXXXXXXXXXX</LoginId>
		<TFBookingReference>61W2WII45</TFBookingReference>
	</CheckBooking>
</CommandList>​

レスポンスサンプル

 選択<CommandList>
	<CheckBooking millis="121">
		<LoginId>XXXXXXXXXXXXXXXX</LoginId>
		<TFBookingReference>61W2WII45</TFBookingReference>
		<Status>Succeeded</Status>
		<SupplierReference>V0OY8IG</SupplierReference>
	</CheckBooking>
	<GeneralInfoItemList>
		<GeneralInfoItem>
			<Name>ServerAddress</Name>
			<Value>10.30.50.114</Value>
		</GeneralInfoItem>
		<GeneralInfoItem>
			<Name>ClientAddress</Name>
			<Value>10.30.50.106</Value>
		</GeneralInfoItem>
		<GeneralInfoItem>
			<Name>StartTime</Name>
			<Value>06/04/15-10:16:03</Value>
		</GeneralInfoItem>
		<GeneralInfoItem>
			<Name>EndTime</Name>
			<Value>06/04/15-10:16:03</Value>
		</GeneralInfoItem>
	</GeneralInfoItemList>
</CommandList>
 
XML Field 階層 M/O 説明
CommandList     コマンドリストタグ
-CheckBooking 1 M コマンドタグ
--XmlLoginId 2 M XMLログインID
詳細は接続仕様 参照
--LoginId 2 M ログインID
詳細は接続仕様 参照
--TFBookingReference 2 M Travelfusionブッキングリファレンス
旅客情報レスポンス(ProcessTerms)のリファレンス
 
XML Field 階層 M/O 説明
CommandList     コマンドリストタグ
-CheckBooking 1 M コマンドタグ
--Status 2 M ステイタス
"Succeeded" :成功

"BookingInProgress" :予約処理中
※予約処理が完了していないため、5秒後に
再度"CheckBooking"リクエストを行ってください。


"Failed" :予約失敗
"Unconfirmed" :予約処理中
"UnconfirmedBySupplier" :予約処理中
"BookingNotLaunched" :予約失敗
"Duplicate" :同一予約が存在しているため未予約 

ステイタスが"Unconfirmed"の場合、Travelfusion側で予約処理が不明の状態。
ステイタス詳細は予約時のご注意を参照のこと。
--CardVerificationRequired 2 O "ture" : 本人予約認証処理が必要

この場合は、本人認証処理が完了するまでは、再度予約確認リクエスト(CheckBooking)を行わないでください。
詳細は、クレジットカード認証 を参照のこと。
--SupplierReference 2 O サプライヤーリファレンス
サプライヤーから返却されるリファレンス。
"Status"のレスポンス結果によって値が異なる。
 
Status SupplierReference
Succeeded サプライヤーリファレンス番号が表示
BookingInProgress 非表示
Failed "eCode"が返却され、エラー詳細を確認可。
エラー詳細は"error handling guide参照。
Unconfirmed 非表示
UnconfirmedBySupplier 非表示
サプライヤーによってはリファレンス番号が返却されるが、予約は完了していない状態。
BookingNotLaunched 非表示
Duplicate 非表示

 
--SupplierConfirmationDataItemList 2 O サプライヤーから返却されるmiscellaneous(さまざまな)情報。 サプライヤーから何も情報がない場合は当該タグは省略される。
---SupplierConfirmationDataItem 3 M サプライヤーより返却された予約情報
----Name 4 M データ項目の名称
----Value 4 M データの値