GET AN API KEY AND AUTHENTIFICATION

Transcription

1 Contents API キーを認証... 4 API キーを登録... 4 認証... 5 X - 署名を取得する方法... 6 予約 API Hotelbeds プライシングモデル 料金チェックと予約メソッドにおけるプライシング属性 空室状況の応答 JSON の例 XML の例 JSON 共同宿泊の空室状況 XML 共同宿泊の空室状況 JSON 追加検索オプションと情報 XML 追加検索オプションと情報 ホテルの料金チェックリクエスト GET リクエストパラメータ エンドポイント POST エンドポイント リクエストパラメータ ホテル料金チェックの応答 JSON の例 シングルレートのチェック リクエスト 応答 アップセリングの応答例 XML の例 シングルレートのチェック リクエスト 応答 アップセリングの応答例

2 ホテル確認リクエスト リクエストパラメータ リクエストの例 応答の例 ホテル確認応答 XML の例 単一の客室の確認 リクエスト 応答 複数の客室の確認 リクエスト 応答 JSON の例 シングルレートの確認 リクエスト 応答 マルチレートの確認 リクエスト 応答 予約リストと詳細のリクエスト ご予約を検索する エンドポイント リクエストの例 ご予約の詳細を取得 エンドポイント リクエストの例 予約リストの応答 XML の例 JSON の例 予約詳細の応答 XML の例 JSON の例 予約キャンセルのリクエスト

3 リクエストパラメータ JSON の例 * リクエスト リクエストヘッダー 応答 XML の例 リクエストヘッダー XML 応答 予約キャンセルの応答 認証プロセス 検索エンジン 空室状況 ホテル詳細 予約を確認する前 確認バウチャー 確認バウチャー 評価コメント詳細リクエスト ご自分の評価コメント詳細を取得 エンドポイント リクエストパラメータ エンドポイントとヘッダー エンドポイント リクエストのヘッダー 応答のヘッダー

4 API キーを認証 API キーを登録 テストに使用される API キーを取得するには極めて便利です API のすべてのリクエストを行うためには API キーが必要とされます ステップ 1 登録ログインし Mashery ID を取得して 我々の開発者ポータルにアクセスします ステップ 2 登録後 確認メールが届きます メール内のリンクをクリックして 次の簡単な手順に従ってください 4

5 ステップ 3 呼び出しを行うためにご自分の API キーを生成します このステップでは API パッケージを選択し サービス約款に同意する必要があります ステップ 4 ご自分の API キーを受け取った後 ドキュメントを閲覧し 当社の API で予約する方法 サンドボックスでリクエストを行う方法と当社システムを統合するために準備する方法を把握することを確認してください この時点で Postman を使用して当社のワークフローの例を実行することができます : Postman において実行する 実行した後 Postman においてグローバル環境を編集し ご自分の API キーと API シークレットを追加する必要があります そして 我々の空室状況をテストし リクエストをチェックと確認することができます 認証 認証する時 以下のヘッダーを送信してください : 5

6 ヘッダーの名称 値 Api-Key 登録済み API キー X-Signature SHA256 エンコーディング署名 X - 署名を取得する方法 X- 署名を取得するには ご自分の API キー 共有シークレットと現在タイムスタンプで数秒で一つの Hex フォーマットの SHA256 ハッシュを生成します sha256hex(apikey + sharedsecret + System.currentTimeMillis() / 1000) Java コード package test; import java.io.bufferedreader; import java.io.inputstream; import java.io.inputstreamreader; import java.net.url; import javax.net.ssl.httpsurlconnection; public class Test public static void main([] args) try // Your API Key and secret apikey = "yourapikey"; sharedsecret = "yoursharedsecret"; // Signature is generated by SHA256 (Api-Key + Shared Secret + // Timestamp (in seconds)) signature = org.apache.commons.codec.digest.digestutils.sha256hex(apikey + sharedsecret + System.currentTimeMillis() / 1000); // Example of call to the API endpoint = " URL url = new URL(endpoint); HttpsURLConnection connection = (HttpsURLConnection) url.openconnection(); connection.setrequestproperty("x-signature", signature); connection.setrequestproperty("api-key", apikey); connection.setrequestproperty("accept", "application/xml"); InputStream ins = connection.getinputstream(); InputStreamReader isr = new InputStreamReader(ins); BufferedReader in = new BufferedReader(isr); inputline; while ((inputline = in.readline())!= null) System.out.println(inputLine); in.close(); catch (Exception e) e.printstacktrace(); 6

7 PHP 5.5.x コード <?php // Your API Key and secret $apikey = "yourapikey"; $sharedsecret = "yoursharedsecret"; // Signature is generated by SHA256 (Api-Key + Shared Secret + Timestamp (in seconds)) $signature = hash("sha256", $apikey.$sharedsecret.time()); // Example of call to the API $endpoint = " $request = new http\client\request("get", $endpoint, [ "Api-Key" => $apikey, "X-Signature" => $signature, "Accept" => "application/xml" ]); try $client = new http\client; $client->enqueue($request)->send(); // pop the last retrieved response $response = $client->getresponse(); if ($response->getresponsecode()!= 200) printf("%s returned '%s' (%d)\n", $response->gettransferinfo("effective_url"), $response->getinfo(), $response->getresponsecode() ); else printf($response->getbody()); catch (Exception $ex) printf("error while sending request, reason: %s\n",$ex->getmessage());?>.net C# コード using System; using System.Diagnostics; using System.Net; using System.Security.Cryptography; using System.Text; namespace Examples class Program public static void Main() const string apikey = "gfhpht2ffsfejd88g7pcnexe"; const string sharedsecret = "e7af9xbetm"; const string endpoint = " // Compute the signature to be used in the API call (combined key + secret + timestamp in seconds) string signature; using (var sha = SHA256.Create()) long ts = (long)(datetime.utcnow - new DateTime(1970, 1, 1, 0, 0, 0, DateTimeKind.Utc)).TotalMilliseconds / 1000; Console.WriteLine("Timestamp: " + ts); var computedhash = sha.computehash(encoding.utf8.getbytes(apikey + sharedsecret + ts)); signature = BitConverter.To(computedHash).Replace("-", ""); Console.WriteLine("Signature: " + signature); using (var client = new WebClient()) // Request configuration client.headers.add("x-signature", signature); client.headers.add("api-key", apikey); client.headers.add("accept", "application/xml"); // Request execution string response = client.download(endpoint); Debug.WriteLine(response); 7

8 Go コード package main import ( "fmt" "time" "crypto/sha256" "encoding/hex" "io/ioutil" "net/http" ) func main() // Your API Key and secret apikey := "yourapikey" sharedsecret := "yoursharedsecret" // Signature is generated by SHA256 (Api-Key + Shared Secret + Timestamp (in seconds)) hasher := sha256.new() hasher.write([]byte(fmt.sprintf("%s%s%d",apikey,sharedsecret,time.now().unix()))) signature := hex.encodeto(hasher.sum(nil)) // Example of call to the API endpoint := " // Creating GET Request with headers req, _ := http.newrequest("get", endpoint, nil) req.header.add("x-signature", signature) req.header.add("api-key", apikey) req.header.add("accept", "application/xml") client := &http.client res, err := client.do(req) if err!= nil fmt.printf("error sending request: %s\n",err) return defer res.body.close() body, err := ioutil.readall(res.body) if err!= nil fmt.printf("error reading response: %s\n", err) return fmt.println(string(body)) Python コード # # Simple python client example # Using Python 2.7 and urrlib2 library # import time, hashlib import urllib2 # Your API Key and secret apikey = "yourapikey" sharedsecret = "yoursharedsecret" 8

9 # Signature is generated by SHA256 (Api-Key + Shared Secret + Timestamp (in seconds)) sigstr = "%s%s%d" % (apikey,sharedsecret,int(time.time())) signature = hashlib.sha256(sigstr).hexdigest() endpoint = " try: # Create http request and add headers req = urllib2.request(url=endpoint) req.add_header("x-signature", signature) req.add_header("api-key", apikey) req.add_header("accept", "application/xml") # Reading response and print-out file = urllib2.urlopen(req) print file.read() except urllib2.httperror, e: # Reading body of response httpresonponse = e.read() print "%s, reason: %s " % (str(e), httpresonponse) except urllib2.urlerror, e: print "Client error: %s" % e.reason except Exception, e: print "General exception: %s " % str(e) Objective-c // // main.m // TestAPI // // #import <Foundation/Foundation.h> #include <CommonCrypto/CommonDigest.h> // Compute signature function, calculate SHA256 and returns HEX signature string NS *computesignature(ns *apikey, NS *sharedsecret) NSData *sigdata = [[NS apikey, sharedsecret, time(null)] datausingencoding:nsutf8encoding]; // Calculate SHA256 in hash buffer and convert to HEX string unsigned char hash[cc_sha256_digest_length]; if ( CC_SHA256([sigData bytes], (CC_LONG)[sigData length], hash) ) NSData *sha256 = [NSData datawithbytes:hash length:cc_sha256_digest_length]; // Convert NSData bytes into HEX string NSMutable *hexsignature = [NSMutable stringwithcapacity: sha256.length * 2]; const unsigned char *buf = sha256.bytes; for (NSInteger i=0; i<sha256.length; ++i) [hexsignature appendformat:@"%02lx", (unsigned long)buf[i]]; return hexsignature; return nil; int main(int argc, const char * // Your API Key and secret 9

10 NS *apikey NS *sharedsecret // Signature is generated by SHA256 (Api-Key + Shared Secret + Timestamp (in seconds)) NS *signature = computesignature(apikey, sharedsecret); // Example of call to the API NS *endpoint NSMutableURLRequest *request = [[NSMutableURLRequest alloc] init]; [request seturl: [NSURL URLWith: endpoint]]; [request sethttpmethod:@"get" ]; // Define mandatory headers (Signature, Api-Key and Accept) [request setvalue:signature forhttpheaderfield:@"x-signature"]; [request setvalue:apikey forhttpheaderfield:@"api-key"]; [request setvalue:@"application/xml" forhttpheaderfield:@"accept"]; // Send request NSHTTPURLResponse* urlresponse = nil; NSError *errorrequest = nil; NSData *responsedata = [NSURLConnection sendsynchronousrequest:request returningresponse:&urlresponse error: &errorrequest]; if (errorrequest) NSLog(@"Error sending request: %@", [errorrequest localizeddescription]); return -1; // Check response status code if ([urlresponse statuscode]!= 200) NSLog(@"HTTP error %ld", [urlresponse statuscode]); return -2; // Get response NSLog(@"%@", [NS stringwithutf8:[responsedata bytes]]); return 0; 10

11 予約 API コンテンツ予約 API メソッドホテル料金チェック予約状況 API 予約は 以下の二つのステップのようにリアルタイムにホテルを予約するように設計されています それは完全な予約プロセスをカバーします ; それは ホテルリストを生成 予約を確認 予約リストを取得 予約をキャンセルおよび予約情報を取得することができます 予約 API とコンテンツ API を併用することで ホテルからコンテンツ情報 ( 例えば 写真 ディスクリプション 施設 サービスなど ) を取得することができます 関連情報は コンテンツ API ドキュメントおよび IO/DOCS を参照してください 予約 API メソッド 予約 API は 4 つの異なる方法を使用して予約機能を管理します : ホテル 料金チェック 状況および予約 予約 API は 二つのステップの確認に設計されていますが クライアントとプロバイダシステムの複雑さによる第三の方法は 設計されています 図に参照してください : / ホテル 本方法は 空室状況をリクエストするために使用されます 一部のフィルタと特別な機能は 空室状況リクエストを送信する前に適用することができます 11

12 柔軟なチェックイン日付検索により お客様はチェックイン前と後に指定した日数内の空室料金を取得することができます 生成された応答は ホテルリストであり 異なる客室タイプ 食事タイプと空室料金が含まれています ; ただし 選択された日付に限定されません 予約 API の価格は最終的なものです 我々の料金には 追加料金と割引が含まれており 追加の価格計算は必要ありません また 予約の最初のステップでの金額と日付を提供し 空室状況応答にキャンセル料を返すことができます / 料金チェック / 予約 ホテルの大半は 2 つのステップで予約可能です ただし うちのいくつかは 最新の空室状況と料金を取得する必要があります これらのホテルは 料金タイプ属性に RECHECK 値を有します ; 料金チェック方法は 最新の空室状況と価格を返します この方法はまた アップセーリングオプションと料金を返します ( 適用な場合 ) 一つのタグで リクエストされた料金と提供されたアップセーリング料金との差額を表示します この方式は 4 つの異なる目的に使用することができます : 1. 予約リストを取得する 2. ある具体的な予約の詳細を取得する 3. キャンセル条件の詳細を取得または予約をキャンセルする 4. 予約を確認する / 状態 このメソッドは API の現在の状態を提供します 12

13 Hotelbeds プライシングモデル コンテンツ通貨プライシングモデルネット価格コミッションおすすめのネット価格 Liberate( 現地決済 ) 空室状況メソッドにおけるプライシング属性キャンセルポリシーにおけるプライシング属性料金チェックと予約メソッドにおけるプライシング属性 予約 API では いくつかのプライシングノードと属性を有します そのうちの一部は ある特定のプライシングモデルと一致するものであるため メソッドの応答に表示されない場合があります 当社プライシングモデルに関する詳細については Hotelbeds 担当セールスマネージャーにお問い合わせください セールスマネージャーにより お客様のニーズに応じて最適なソリューションをおすすめいたします 通貨 異なるプライシングモデルに対して すべての目的地において同じ通貨を使用しても可能です または目的地によって最大 3 つの異なる通貨 ( ユーロダラー ドル ポンド ) が提供されます ホテルでのお支払いモデル (Liberate) は クライアント通貨とホテル通貨 ( ホテルに到着時に支払うのに使用される ) で示されます プライシングモデル ネット価格 提供された価格は正味価格であり クライアントはご自分のマークアップを追加できます ただし 販売価格がホテル側のおすすめであか (hotelmandatory 属性で示される ) または Liberate ( ホテルでのお支払い ) 価格において 正味価格にくわえて さらに一つの販売価格が提供されるということになります それが hotelmandatory である場合 販売価格属性を適用することを推奨します コミッション 13

14 このモデルにおいて コミッションはすでに提供した最終的価格に含まれています 価格はつねに最終的な価格です Liberate( 現地決済 ) 価格は最終的な価格です このモデルは 上記 2 つのモデル ( ネット価格またはコミッションモデル ) のうちの任意の一つと併用することができます 空室状況メソッドにおけるプライシング属性 属性 正味価格モデルコミッションモデル Liberate モデル net Yes Yes Yes discount No No No comission No Yes No sellingrate hotelmandatory の場合 = 真 Yes Yes hotelmandatory* 販売価格が必須である場合 ホテルによって決定される 販売価格が必須である場合 ホテルによって決定される dailynet Yes No No dailysellingrate hotelmandatory の場合 = 真 Yes Yes hotelsellingrate** No No Yes hotelcurrency** No No Yes 販売価格が必須である場合 ホテルによって決定される * 値が 真 である場合のみ hotelmandatory 属性が返されます ** Liberate モデルはすべてのモデルと混合することができます キャンセルポリシーにおけるプライシング属性 属性 正味価格モデル コミッションモデル amount Yes Yes Yes Liberate モデル 14

15 from Yes Yes Yes hotelamount No No Yes hotelcurrency No No Yes <rate ratekey=" H STU.C1 CG-TODOS SC 1~1~0 N# " rateclass="nor" ratetype="bookable" net=" " comission="10.00" sellingrate=" " hotelsellingrate=" " hotelcurrency="eur" hotelmandatory="true" allotment="2" paymenttype="at_hotel" packaging="false" boardcode="sc" boardname="self CATERING" rooms="1" adults="1" children="0"> <cancellationpolicies> <cancellationpolicy amount="57.000" hotelamount="57.000" hotelcurrency="eur" from=" t23:59:00+02:00"/> </cancellationpolicies> </rate> <rate ratekey=" H STU.C1 CG-TODOS SC 1~1~0 N# "rateClass="NOR"rateType="BOOKABLE"net=" "comission="10.00"sellingRate=" "hotelSellingRate=" "hotelCurrency="EUR"hotelMandatory="true"allotment="2"paymentType="AT_HOTEL"packaging="false"boardCode="SC" boardname="self CATERING"rooms="1"adults="1"children="0"> <cancellationpolicies> <cancellationpolicy amount="57.000"hotelamount="57.000"hotelcurrency="eur"from=" t23:59:00+02:00"/> </cancellationpolicies> </rate> 料金チェックと予約メソッドにおけるプライシング属性 ネット価格モデルコミッションモデル Liberate モデル 属性 totalnet Yes Yes Yes totalsellingrate No Yes Yes pendingamount Yes Yes No 15

16 空室状況の応答 コンテンツプロモーションと割引返金不可料金 (NRF) XML フィードまたは JSON フィードのウェイトを減少させる (falta título de tabla) (separamos por grupos de atributos?) XML の例 JSON の例 ホテル空室状況の応答は 予約を確認するか特定のホテルの空室状況を再度チェックするのに必要なすべての情報を含みます それは ホテル 異なる料金 客室タイプと食事タイプの情報を含んだホテルノードで分布されます プロモーションと割引 一部料金は プロモーション価格または割引適用価格であり 空室状況の応答に含まれており 特典としてマークすることができます 返金不可料金 (NRF) (rateclass) 属性値である NRF でマークされた返金不可料金に特別な注意を払ってください 返金不可の価格は すでに追加料金と割引を含みます XML フィードまたは JSON フィードのウェイトを減少させる XML 応答または JSON 応答のウェイトを減少させるため 空室状況の応答は カスタマイズすることが可能です そしてノードのディスクリプションに加えて いくつかのノードを除却することができます 三つの応答オプションがあります : 完全型 中型と節約型 XML または JSON フィードを減らす最善の方法については リンク をクリックして詳細に参照するか 当社のサポート担当にお問い合わせください 応答パラメータ ノード / 属性 タイプ ディスクリプション availabilityrs Element トップ要素 16

17 availabilityrs/auditdata Element 関連する内部情報 availabilityrs/hotels Date Array of hotel elements サーバの処理時間をミリ秒単位で表示 リクエストが処理される日付 / 時刻 ( 常にスペインの時間で表示 ) サーバコードまたは ID( 内部用 ) リクエストが送信と処理された環境 空室のあるホテルリスト availabilityrs/hotels/@total Int 返されるホテルの数 チェックイン日付 availabilityrs/hotels/@checkin Date フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) チェックアウト日付 availabilityrs/hotels/@checkout availabilityrs/hotels/hotel availabilityrs/hotels/hotel/keywords availabilityrs/hotels/hotel/keywords/keyword Date Element Array of keyword elements Element フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) ホテル及び関連料金についての情報を含む要素 キーワード要素リスト キーワードに関する情報を含む要素 availabilityrs/hotels/hotel/keywords/keyword/@code Int キーワードコード availabilityrs/hotels/hotel/keywords/keyword/@rating Int キーワード評価 availabilityrs/hotels/hotel/@name ホテルの名称 availabilityrs/hotels/hotel/@code Int Hotelbeds 内部ホテルコード availabilityrs/hotels/hotel/@address ホテルの住所 availabilityrs/hotels/hotel/@categorycode ホテルのカテゴリコード 17

18 カテゴリの名称 Int ホテルの位置の目的地コード ホテルの位置の目的地名称 ホテルの位置の区域名称 ホテルの位置の区域コード 地理的位置の緯度データ 地理的位置の経度データ クライアント通貨 最大のホテル客室の価格 最小のホテル客室の価格 Int Giata ホテルコード クライアント通貨 availabilityrs/hotels/hotels/creditcards availabilityrs/hotels/hotels/creditcards/creditcard Array of credit cards Element Int Liberate( ホテルでお支払い ) モデルにおいて使用可能なクレジットカードのリスト クレジットカードに関する情報を含む要素 クレジットカードコード クレジットカード名称 お払いのタイプ availabilityrs/hotels/hotels/creditdards/creditcard/@payme nttype availabilityrs/hotels/hotel/rooms 18 Array of room elements 現地決済 オンラインカード決済 特定ホテルの空室リスト

19 availabilityrs/hotels/hotel/rooms/room/ Element 客室および関連料金についての情報を含む要素 Int 内部客室コード availabilityrs/hotels/hotel/rooms/room/rates Array of rates 料金リスト availabilityrs/hotels/hotel/rooms/room/rates/rate Element 料金要素 mentsid Type g Int de me この料金に関連したコメント 確認に使用される内部価格キー 内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 予約は 以下の 2 つのステップ (BOOKABLE) または 3 つのステップ (RECHECK) で確認することができます ホテルでのお支払いモデルであるかまたはマーチャントモデルであるかを識別します 料金はパッケージ商品に対するものであるかどうかを識別する 内部食事コード 食事の名称 availabilityrs/hotels/hotel/rooms/room/rates/rate/@net 客室の正味価格 availabilityrs/hotels/hotel/rooms/room/rates/rate/@sellingr ate availabilityrs/hotels/hotel/rooms/room/rates/rate/@comissio n 客室の総価 ( 含まれている場合 ) コミッションモデルに対するコミッション 19

20 nvat npct ingrate rency ndatory t availabilityrs/hotels/hotel/rooms/room/rates/rate/@adults Int Ages availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift Rate availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift Boolean Int Int Int Array of shift elements Element Date Date コミッション増値税 コミッションの割合 ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 価格が推奨されているかどうかを識別 特定客室タイプの空室の数 同じ宿泊人数のリクエストされた空室の数 客室における宿泊可能な大人の数 リクエストされた子供の人数 子供の年齢 コンマで区切られる チェックイン日付が柔軟な空室の料金リスト チェックイン日付が柔軟な空室と料金に関する情報を含む要素 チェックイン日付 フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) チェックアウト日付 フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) 確認に使用される内部価格キー 20

21 availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift Boolean Int 内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 値が BOOKABLE である場合 すぐにご予約することができます 値が RECHECK である場合 まずは 料金チェック メソッドで再確認する必要があります ホテルでのお支払いモデルであるかまたはマーチャントモデルであるかを識別します 料金はパッケージ商品に対するものであるかどうかを識別する 内部食事コード 客室の正味価格 客室の販売価格 ( 含まれている場合 ) コミッション ( コミッションモデルである場合 ) ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 価格が推奨されているかどうかを識別 特定客室タイプの空室の数 21

22 22 availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift Int このタイプのリクエストされた客室の数 availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift Int 客室における宿泊可能な大人の数 availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift Int リクエストされた子供の人数 availabilityrs/hotels/hotel/rooms/room/rates/rate/cancellatio npolicies Array of policies elements キャンセルポリシーのリスト availabilityrs/hotels/hotel/rooms/room/rates/rate/cancellatio npolicies/cancellationpolicy Element availabilityrs/hotels/hotel/rooms/room/rates/rate/cancellatio 特定の日付以降に課金される料金 availabilityrs/hotels/hotel/rooms/room/rates/rate/cancellatio Date 料金が課金される開始日付 availabilityrs/hotels/hotel/rooms/room/rates/rate/cancellatio 特定の日付以降にホテル通貨で課金される料金 ( ホテルでのお支払いモデル向け ) availabilityrs/hotels/hotel/rooms/room/rates/rate/dailyprices /dailyprice/@offset Int 検索期限内の日数 availabilityrs/hotels/hotel/rooms/room/rates/rate/dailyprices /dailyprice/@dailysellingrate 客室の毎日の販売価格 availabilityrs/hotels/hotel/rooms/room/rates/rate/dailyprices /dailyprice/@dailynet 毎日の正味価格 availabilityrs/hotels/hotel/rooms/room/rates/rate/offers Array of offer elements 特典リスト availabilityrs/hotels/hotel/rooms/room/rates/rate/offers/offer Element 特典情報を含む要素 availabilityrs/hotels/hotel/rooms/room/rates/rate/offers/offer /@code Int 特典コード availabilityrs/hotels/hotel/rooms/room/rates/rate/offers/offer /@amount 特典の金額 availabilityrs/hotels/hotel/rooms/room/rates/rate/offers/offer /@name 特典の名称 availabilityrs/hotels/hotel/rooms/room/rates/rate/promotions Array of promotion elements 特定価格のプロモーションリスト availabilityrs/hotels/hotel/rooms/room/rates/rate/promotions /promotion Element プロモーション情報を含む要素

23 availabilityrs/hotels/hotel/rooms/room/rates/rate/promotions availabilityrs/hotels/hotel/rooms/room/rates/rate/promotions availabilityrs/hotels/hotel/rooms/room/rates/rate/promotions availabilityrs/hotels/hotel/rooms/room/rates/rate/taxes Int Array of tax elements プロモーションコード プロモーションの名称 プロモーション備考 税込みまたは税抜き価格のリスト XML の例 <?xml version="1.0" encoding="utf-8" standalone="yes"?> <availabilityrs xmlns:xsi=" xmlns=" schemalocation=" <auditdata processtime="144" timestamp=" :01:35.568" serverid="ws3xmi01" environment="[itest, iset_a, ehcache]" release="4726" internal=" ,38,100 1"/> <hotels checkin=" " checkout=" " total="14"> <hotel code="6914" name="bellevue Vistanova" categorycode="3est" categoryname="3 STARS" destinationcode="pmi" destinationname="majorca" zonecode="29" zonename="palmanova" latitude=" " longitude=" " currency="eur" minrate=" " maxrate=" "> <rooms> <room code="dus.st" name="double SINGLE USE"> <rates> <rate paymenttype="at_web" packaging="false" boardcode="bb" boardname="bed AND BREAKFAST" rooms="1" adults="1" children="0" ratekey="6914 DUS.ST CG-TODOS1 1 BB 1~1~ W N# " rateclass="nor" ratetype="bookable" net=" " allotment="20"/> <rate paymenttype="at_web" packaging="false" boardcode="hb" boardname="half BOARD" rooms="1" adults="1" children="0" ratekey="6914 DUS.ST CG- TODOS1 1 HB 1~1~ W N# " rateclass="nor" ratetype="bookable" net=" " allotment="20"/> </rates> </room> </rooms> </hotel> </hotels> </availabilityrs> JSON の例 23

24 "auditdata": "processtime": "94", "timestamp": " :45:48.316", "serverid": "ws3xmi01", "environment": "[itest, iset_a, ehcache]", "release": "4838", "internal": " null,null 1", "hotels": "hotels": [ "code": 2643, "name": "Club Marthas", "categorycode": "4EST", "categoryname": "4 STARS", "destinationcode": "PMI", "destinationname": "Majorca", "zonecode": 90, "zonename": "Cala d'or", "latitude": " ", "longitude": " ", "rooms": [ "code": "STU.C2", "name": "STUDIO", "rates": [ "ratekey": "2643 STU.C2 REP- OPACO 1 FB 1~1~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 90, "paymenttype": "AT_WEB", "packaging": false, "boardcode": "FB", "boardname": "FULL BOARD", "cancellationpolicies": [ "amount": "79.010", "from": " T00:00:00+02:00" ], "rooms": 1, "adults": 1, "children": 1, "childrenages": "8", "offers": [ "code": "9002", "name": "Early Booking discount", "amount": " " ] ] "minrate": "86.320", "maxrate": " ", "currency": "EUR" ], "checkin": " ", "checkout": " ", "total": 2 24

25 JSON の例 目的地で検索 "stay": "checkin": " ", "checkout": " ", "shiftdays": "1", "occupancies": [ "rooms": 1, "adults": 2, "children": 2, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30, "type": "CH", "age": 8, "type": "CH", "age": 8 ], "rooms": 1, "adults": 1, "children": 1, "paxes": [ "type": "AD", "age": 30, "type": "CH", "age": 8 ] ], "destination": "code": "PMI", "zone": "90" GPS 座標で検索 25

26 "stay": "checkin": " ", "checkout": " ", "shiftdays": "1", "occupancies": [ "rooms": 1, "adults": 2, "children": 2, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30, "type": "CH", "age": 8, "type": "CH", "age": 8 ], "rooms": 1, "adults": 1, "children": 1, "paxes": [ "type": "AD", "age": 30, "type": "CH", "age": 8 ] ], "geolocation": "longitude": , "latitude": , "radius": 200, "unit": "km" ホテルリストで検索 "stay": 26

27 "checkin": " ", "checkout": " ", "shiftdays": "1", "occupancies": [ "rooms": 1, "adults": 2, "children": 2, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30, "type": "CH", "age": 8, "type": "CH", "age": 8 ], "rooms": 1, "adults": 1, "children": 1, "paxes": [ "type": "AD", "age": 30, "type": "CH", "age": 8 ] ], "hotels": "hotel": [ 2643, 7896 ] 子供を含む検索 "stay": "checkin": " ", "checkout": " ", "shiftdays": "1" 27

28 , "occupancies": [ "rooms": 1, "adults": 2, "children": 1, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30, "type": "CH", "age": 8, ] ], "hotels": "hotel": [ 2643, 7896 ] 子供を含む応答 "auditdata": "processtime": "2036", "timestamp": " :17:44.218", "serverid": "ws3xmi02", "environment": "[itest, iset_b, ehcache]", "release": "4838", "internal": " 03 HA 1 4 null,null 1", "hotels": "hotels": [ "code": 2643, "name": "Club Marthas", "categorycode": "4EST", "categoryname": "4 STARS", "destinationcode": "PMI", "destinationname": "Majorca", "zonecode": 90, "zonename": "Cala d'or", "latitude": " ", "longitude": " ", "rooms": [ "code": "STU.C2", "name": "STUDIO", "rates": [ 28

29 "ratekey": "2643 STU.C2 REP- OPACO 1 SC 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": "76.920", "allotment": 90, "paymenttype": "AT_WEB", "packaging": false, "boardcode": "SC", "boardname": "SELF CATERING", "cancellationpolicies": [ "amount": "38.460", "from": " T00:00:00+02:00" ], "rooms": 1, "adults": 2, "children": 1, "childrenages": "8", "offers": [ "code": "9002", "name": "Early Booking discount", "amount": " ", "code": "9001", "name": "Child discount", "amount": " " ], "shiftrates": [ "ratekey": "2643 STU.C2 REP- OPACO 1 SC 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": "76.920", "allotment": 90, "checkin": " ", "checkout": " ", "ratekey": "2643 STU.C2 REP- OPACO 1 SC 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": "76.920", "allotment": 90, "checkin": " ", "checkout": " ", "ratekey": "2643 STU.C2 REP- OPACO 1 SC 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": "76.920", "allotment": 90, "checkin": " ", "checkout": " ", "ratekey": "2643 STU.C2 REP- OPACO 1 SC 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": "76.920", "allotment": 91, 29

30 "checkin": " ", "checkout": " " ], "ratekey": "2643 STU.C2 REP- OPACO 1 AI 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 90, "paymenttype": "AT_WEB", "packaging": false, "boardcode": "AI", "boardname": "ALL INCLUSIVE", "cancellationpolicies": [ "amount": " ", "from": " T00:00:00+02:00" ], "rooms": 1, "adults": 2, "children": 1, "childrenages": "8", "offers": [ "code": "9002", "name": "Early Booking discount", "amount": " ", "code": "9001", "name": "Child discount", "amount": " " ], "shiftrates": [ "ratekey": "2643 STU.C2 REP- OPACO 1 AI 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 90, "checkin": " ", "checkout": " ", "ratekey": "2643 STU.C2 REP- OPACO 1 AI 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 90, "checkin": " ", "checkout": " ", "ratekey": "2643 STU.C2 REP- OPACO 1 AI 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 90, "checkin": " ", "checkout": " ", "ratekey": "2643 STU.C2 REP- OPACO 1 AI 1~2~ W N# ", 30

31 "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 91, "checkin": " ", "checkout": " " ] ], "code": "APT.1B-C4", "name": "APARTMENT", "rates": [ "ratekey": "2643 APT.1B-C4 REP- OPACO 1 BB 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 83, "paymenttype": "AT_WEB", "packaging": false, "boardcode": "BB", "boardname": "BED AND BREAKFAST", "cancellationpolicies": [ "amount": "67.960", "from": " T00:00:00+02:00" ], "rooms": 1, "adults": 2, "children": 1, "childrenages": "8", "offers": [ "code": "9002", "name": "Early Booking discount", "amount": " ", "code": "9001", "name": "Child discount", "amount": " " ], "shiftrates": [ "ratekey": "2643 APT.1B-C4 REP- OPACO 1 BB 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 83, "checkin": " ", "checkout": " ", "ratekey": "2643 APT.1B-C4 REP- OPACO 1 BB 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 75, "checkin": " ", "checkout": " ", "ratekey": "2643 APT.1B-C4 REP- OPACO 1 BB 1~2~ W N# ", "rateclass": "NOR", 31

32 "ratetype": "BOOKABLE", "net": " ", "allotment": 77, "checkin": " ", "checkout": " ", "ratekey": "2643 APT.1B-C4 REP- OPACO 1 BB 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 86, "checkin": " ", "checkout": " " ], "ratekey": "2643 APT.1B-C4 REP- OPACO 1 AI 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 83, "paymenttype": "AT_WEB", "packaging": false, "boardcode": "AI", "boardname": "ALL INCLUSIVE", "cancellationpolicies": [ "amount": " ", "from": " T00:00:00+02:00" ], "rooms": 1, "adults": 2, "children": 1, "childrenages": "8", "offers": [ "code": "9002", "name": "Early Booking discount", "amount": " ", "code": "9001", "name": "Child discount", "amount": " " ], "shiftrates": [ "ratekey": "2643 APT.1B-C4 REP- OPACO 1 AI 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 83, "checkin": " ", "checkout": " ", "ratekey": "2643 APT.1B-C4 REP- OPACO 1 AI 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 75, "checkin": " ", "checkout": " " 32

33 , "ratekey": "2643 APT.1B-C4 REP- OPACO 1 AI 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 77, "checkin": " ", "checkout": " ", "ratekey": "2643 APT.1B-C4 REP- OPACO 1 AI 1~2~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 86, "checkin": " ", "checkout": " " ] ] ], "minrate": "76.920", "maxrate": " ", "currency": "EUR" ], "checkin": " ", "checkout": " ", "total": 1 共同宿泊のリクエストに対する応答 "auditdata": "processtime": "2078", "timestamp": " :20:25.986", "serverid": "ws3xmi02", "environment": "[itest, iset_b, ehcache]", "release": "4838", "internal": " null,null 1", "hotels": "hotels": [ "code": 2643, "name": "Club Marthas", "categorycode": "4EST", "categoryname": "4 STARS", "destinationcode": "PMI", "destinationname": "Majorca", "zonecode": 90, "zonename": "Cala d'or", "latitude": " ", "longitude": " ", "rooms": [ "code": "STU.C2", "name": "STUDIO", "rates": [ 33

34 "ratekey": "2643 STU.C2 REP- OPACO 1 FB 1~1~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 90, "paymenttype": "AT_WEB", "packaging": false, "boardcode": "FB", "boardname": "FULL BOARD", "cancellationpolicies": [ "amount": "79.010", "from": " T00:00:00+02:00" ], "rooms": 1, "adults": 1, "children": 1, "childrenages": "8", "offers": [ "code": "9002", "name": "Early Booking discount", "amount": " " ], "shiftrates": [ "ratekey": "2643 STU.C2 REP- OPACO 1 FB 1~1~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 90, "checkin": " ", "checkout": " ", "ratekey": "2643 STU.C2 REP- OPACO 1 FB 1~1~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 91, "checkin": " ", "checkout": " ", "ratekey": "2643 STU.C2 REP- OPACO 1 FB 1~1~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 90, "checkin": " ", "checkout": " ", "ratekey": "2643 STU.C2 REP- OPACO 1 FB 1~1~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "allotment": 90, "checkin": " ", "checkout": " " ] ] 34

35 ], "minrate": " ", "maxrate": " ", "currency": "EUR" ], "checkin": " ", "checkout": " ", "total": 1 重要事項 : この例において 一つの大人 2 名様がご宿泊できる客室は二つの異なる客室タイプ ( ファミリールームとダブルルーム ) が提供されています 大人 3 名様がご宿泊できる客室は一つの客室タイプ ( ファミリールーム ) のみが提供されています すべての客室タイプはリクエストされた客室に対して有効な料金を提供しています この例において 大人 2 名様がご宿泊できる 1 室と大人 3 名様がご宿泊できる 1 室がリクエストされています 35

36 XML の例 目的地でリクエスト <availabilityrqxmlns=" org/2001/xmlschema-instance"> <stay checkin=" "checkout=" "shiftdays="1"/> <occupancies> <occupancy rooms="1"adults="1"children="1"> <paxes> <paxtype="ad"age="31"/> <paxtype="ch"age="3"/> </paxes> </occupancy> </occupancies> <destination code="pmi"/> </availabilityrq> GPS 座標でリクエスト <availabilityrq xmlns=" xmlns:xsi=" > <stay checkin=" " checkout=" " shitdays="1"/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <!-- GPS point and radius: longitude, latitude, radius and unit--> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> <!-- GPS area : longitude, latitude, secondarylatitude, secondarylongitude --> <!--geolocation latitude=" " longitude=" " secondarylatitude=" " secondarylongitude=" "/--> </availabilityrq> ホテルリストでリクエスト <availabilityrq xmlns=" xmlns:xsi=" > <stay checkin=" " checkout=" " shiftdays="1"/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <hotels> <hotel>730</hotel> <hotel>22900</hotel> </hotels> </availabilityrq> 子供を含むリクエスト xmlns:xsi=" > <stay checkin=" " checkout=" " shiftdays="1"/> 36

37 <occupancies> <occupancy rooms="1" adults="2" children="1"> <paxes> <pax type="ch" age="5"/> </paxes> </occupancy> </occupancies> <destination code="ist"/> </availabilityrq> 子供とプロモーションを含む応答 <availabilityrs xmlns:xsi=" xmlns=" schemalocation=" <auditdata processtime="672" timestamp=" :26:39.870" serverid="ws3xmi01" environment="[itest, iset_a, ehcache]" release="4791" internal=" "/> <hotels checkin=" " checkout=" " total="57"> <hotel code="233475" name="istanbul Holiday Hotel" categorycode="bou" categoryname="boutique" destinationcode="ist" destinationname="istanbul" zonecode="2" zonename="old City" latitude=" " longitude=" " currency="eur" minrate=" " maxrate=" "> <rooms> <room code="fam.st" name="family ROOM"> <rates> <rate paymenttype="at_web" packaging="false" boardcode="bb" boardname="bed AND BREAKFAST" rooms="1" adults="2" children="1" childrenages="5" ratekey=" FAM.ST B2C 77 BB 1~2~ W N# " rateclass="nor" ratetype="bookable" net=" " sellingrate=" " hotelmandatory="true" allotment="3"> <cancellationpolicies> <cancellationpolicy amount=" " from=" T23:59:00Z"/> </cancellationpolicies> <promotions> <promotion code="9007" name="last minute discount"/> <promotion code="9002" name="early Booking discount"/> </promotions> <offers> <offer code="9007" name="last minute discount" amount=" "/> </offers> </rate> </rates> </room> </rooms> </hotel> </hotels> </availabilityrs> プロモーションを含む共同宿泊のリクエストに対する応答 xmlns=" schemalocation=" <auditdata processtime="295" timestamp=" :35:03.856" serverid="ws3xmi01" environment="[itest, iset_a, ehcache]" release="4791" internal=" "/> <hotels checkin=" " checkout=" " total="50"> 37

38 <hotel code="233475" name="istanbul Holiday Hotel" categorycode="bou" categoryname="boutique" destinationcode="ist" destinationname="istanbul" zonecode="2" zonename="old City" latitude=" " longitude=" " currency="eur" minrate=" " maxrate=" "> <rooms> <room code="dbl.st" name="double"> <rates> <rate paymenttype="at_web" packaging="false" boardcode="bb" boardname="bed AND BREAKFAST" rooms="1" adults="2" children="0" ratekey=" DBL.ST B2C 77 BB 1~2~ W N# " rateclass="nor" ratetype="bookable" net=" " sellingrate=" " hotelmandatory="true" allotment="1"> <cancellationpolicies> <cancellationpolicy amount="67.150" from=" T23:59:00Z"/> </cancellationpolicies> <promotions> <promotion code="9007" name="last minute discount"/> <promotion code="9002" name="early Booking discount"/> </promotions> <offers> <offer code="9007" name="last minute discount" amount=" "/> </offers> </rate> </rates> </room> <room code="fam.st" name="family ROOM"> <rates> <rate paymenttype="at_web" packaging="false" boardcode="bb" boardname="bed AND BREAKFAST" rooms="1" adults="2" children="0" ratekey=" FAM.ST B2C 77 BB 1~2~ W N# " rateclass="nor" ratetype="bookable" net=" " sellingrate=" " hotelmandatory="true" allotment="3"> <cancellationpolicies> <cancellationpolicy amount=" " from=" T23:59:00Z"/> </cancellationpolicies> <promotions> <promotion code="9007" name="last minute discount"/> <promotion code="9002" name="early Booking discount"/> </promotions> <offers> <offer code="9007" name="last minute discount" amount=" "/> </offers> </rate> <rate paymenttype="at_web" packaging="false" boardcode="bb" boardname="bed AND BREAKFAST" rooms="1" adults="3" children="0" ratekey=" FAM.ST B2C 77 BB 1~3~ W N# " rateclass="nor" ratetype="bookable" net=" " sellingrate=" " hotelmandatory="true" allotment="3"> <cancellationpolicies> <cancellationpolicy amount=" " from=" T23:59:00Z"/> </cancellationpolicies> <promotions> <promotion code="9007" name="last minute discount"/> <promotion code="9002" name="early Booking discount"/> </promotions> <offers> 38

39 <offer code="9007" name="last minute discount" amount=" "/> </offers> </rate> </rates> </room> </rooms> </hotel> </hotels> </availabilityrs> 重要事項 : この例において 一つの大人 2 名様がご宿泊できる客室は二つの異なる客室タイプ ( ファミリールームとダブルルーム ) が提供されています 大人 3 名様がご宿泊できる客室は一つの客室タイプ ( ファミリールーム ) のみが提供されています すべての客室タイプはリクエストされた客室に対して有効な料金を提供しています この例において 大人 2 名様がご宿泊できる 1 室と大人 3 名様がご宿泊できる 1 室がリクエストされています 39

40 JSON 共同宿泊の空室状況 共同宿泊の予約 ( 同じ宿泊人数ノードに対して 1 室以上の客室を予約する ) もサポートされています 共同宿泊のタイプ : 客室ごとのお客様の数が同じ 1. 客室の数 >1 応答においてすべての客室に一つの価格キーのみが提供されます 2. 客室の数 =1 複数の価格キーを選択することができます オプション 1: 空室状況 [...] "occupancies": [ ] [...] "rooms": 2, "adults": 2, "children": 0 オプション 1: 確認 [...] "rooms": [ "ratekey": "99658 TPL.ST OP-TODOS 1 BB 2~2~1 30~26~ # ", "paxes": [ "type": "AD", "age": 30, "name": "Bruce", "surname": "Dickinson", "type": "AD", "age": 30, "name": "Usain", "surname": "Bolt", "type": "AD", "age": 30, "name": "Tomeu", 40

41 ] [...] ] "surname": "Quely" "type": "AD", "age": 30, "name": "Michael", "surname": "Knight" ご注意 : リクエストされた客室の数に応じて お客様のタイプ = 大人 の数を複製します オプション 2: 空室状況 [...] "occupancies": [ "rooms": 1, "adults": 2, "children": 0 ] [...] オプション 2: 確認 [...] "rooms": [ "ratekey": "99658 TPL.ST OP-TODOS 1 BB 1~2~1 30~26~ # ", "paxes": [ "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname", "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname", ], 41

42 ] "ratekey": "99658 TPL.ST OP-TODOS 1 BB 1~2~1 30~26~ # ", "paxes": [ "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname", "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname", ] ご注意 : ここで一つ客室の空室状況のみをリクエストしますが 空室がある場合において 必要とされる限り多くの客室を確認することができます ( 空室状況応答における割当属性で ) 客室ごとの異なるお客様の人数 空室状況 [...] "occupancies": [ ] [...], "rooms": 1, "adults": 2, "children": 2 "rooms": 1, "adults": 3, "children": 0 確認 [...] "rooms": [ 42

43 "ratekey": "99658 TPL.ST OP-TODOS 1 BB 1~2~1 30~26~ # ", "paxes": [ "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname", "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname" ], [...] "ratekey": "99658 TPL.ST OP-TODOS 1 BB 1~3~1 30~26~ # ", "paxes": [ "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname", "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname", ] "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname" ご注意 : 同時に異なるホテルにおける異なる価格キーを確認できません ただし 同じホテルの客室タイプを混合することが可能です 43

44 XML 共同宿泊の空室状況 共同宿泊の予約 ( 同じ宿泊人数ノードに対して 1 室以上の客室を予約する ) もサポートされています 共同宿泊のタイプ : 客室ごとのお客様の数が同じ 1. 客室の数 >1 応答においてすべての客室に一つの価格キーのみが提供されます 2. 客室数 =1 複数の価格キーを選択することができます オプション 1- 空室状況のリクエスト [...] <occupancies> <occupancy rooms="2" adults="2" children="0"/> </occupancies> [...] オプション 1- 確認リクエスト [...] <rooms> <room ratekey=" DBL-E10 NRF-TODOS 102 ST RO- E10 2~2~ # "> <paxes> <pax type="ad" age="30" name="adultname" surname="surname"/> <pax type="ad" age="30" name="adultname" surname="surname"/> <pax type="ad" age="30" name="adultname" surname="surname"/> <pax type="ad" age="30" name="adultname" surname="surname"/> </paxes> </room> </rooms> [...] ご注意 : リクエストされた客室の数に応じて お客様のタイプ = 大人 の数を複製します オプション 2- 空室状況リクエスト [...] <occupancies> <occupancy rooms="1" adults="2" children="0"/> </occupancies> [...] オプション 2- 確認リクエスト [...] <rooms> <room ratekey=" DBL-E10 NRF-TODOS 102 ST RO- E10 1~2~ # "> <paxes> <pax type="ad" age="30" 44

45 name="adultname" surname="surname"/> <pax type="ad" age="30" name="adultname" surname="surname"/> </paxes> </room> <room ratekey=" DBL-E10 NRF- TODOS 102 ST RO-E10 1~2~ # "> <paxes> <pax type="ad" age="30" name="adultname" surname="surname"/> <pax type="ad" age="30" name="adultname" surname="surname"/> </paxes> </room> </rooms> [...] ご注意 : ここで一つ客室の空室状況のみをリクエストしますが 空室がある場合において 必要とされる限り多くの客室を確認することができます ( 空室状況応答における割当属性で ) 客室ごとのお客様の数が異なる 空室状況 [...] <occupancies> <occupancy rooms="1" adults="2" children="0"/> <occupancy rooms="1" adults="3" children="0"/> </occupancies> [...] 確認 [...] <rooms> <room ratekey=" DBL-E10 NRF-TODOS 102 ST RO-E10 1~2~ # "> <paxest> <pax type="ad" age="30" name="adultname" surname="surname"/> <pax type="ad" age="30" name="adultname" surname="surname"/> </paxes> </room> <room ratekey=" DBL-E10 NRF- TODOS 102 ST RO-E10 1~3~ # "> <paxes> <pax type="ad" age="30" name="adultname" surname="surname"/> <pax type="ad" age="30" name="adultname" surname="surname"/> </paxes> </room> </rooms> [...] 45

46 ご注意 : 同時に異なるホテルにおける異なる価格キーを確認することができません ただし 同じホテルの客室タイプを混合することが可能です 46

47 JSON 追加検索オプションと情報 ルート親ノード :< 空室状況リクエスト > と当社 I/O Docs セクションにおける一部の例 1.- 地理的位置で検索 ノード / 属性 タイプ availabilityrq/geolocation/@longitude N 必須かどうか ディスクリプション 地理的位置の経度データ availabilityrq/geolocation/@latitude N 地理的位置の緯度データ geolocation/@radius geolocation/@unit N N 決定された地理的位置における半径 半径を定義する単位 "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 2, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30, "type": "CH", "age": 8, "type": "CH", 47

48 "age": 8 ] ], "geolocation": "longitude": , "latitude": , "radius": 200, "unit": "km" ノード / 属性 タイプ availabilityrq/geolocation/@longitude N 必須かどうか ディスクリプション 地理的位置の経度データ availabilityrq/geolocation/@latitude N 地理的位置の緯度データ availabilityrq/geolocation/@longitude N availabilityrq/geolocation/@latitude N ポリゴンをトレースするための地理的位置における緯度データ ポリゴンをトレースするための地理的位置における緯度データ "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 2, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30, "type": "CH", "age": 8, 48

49 "type": "CH", "age": 8 ], "rooms": 1, "adults": 1, "children": 1, "paxes": [ "type": "AD", "age": 30, "type": "CH", "age": 8 ] ], "geolocation": "longitude": , "latitude": , "secondarylatitude": , "secondarylongitude": キーワードで検索 ノード / 属性 availabilityrq/keywords/ 必須かタイプどうかディスクリプション Array of keyword element N すべてのキーワードがホテルに含まれていなければならない場合 値は真です availabilityrq/keywords/@allincluded boolean Y 真 = すべてのキーワードは ホテルリストに含まれていなければなりません availabilityrq/keywords/keyword Int N 偽 = すべてのキーワードは ホテルリストに含まれている必要がありません ファシリティコード 49

50 "AD", "AD", "CH", "CH", "AD", "CH", "stay":, "occupancies": [ "checkin": " ", "checkout": " ", "shiftdays": "2", ] "geolocation": "longitude": , 50 "rooms": 1, "adults": 2, "children": 2, "paxes": [ ] "rooms": 1, "adults": 1, "children": 1, "paxes": [ ],,,, "type": "age": 30 "type": "age": 30 "type": "age": 8 "type": "age": 8 "type": "age": 30 "type": "age": 8

51 "latitude": , "radius": 200, "unit": "km", "boards": "board": [ "SC", "HB" ], "included": true, "filter": "maxhotels": 10, "maxrooms": 5, "minrate": , "maxrate": , "maxratesperroom": 2, "keywords": "keyword": [ "allincluded": true 38 ], キーワードリスト : 29 ロマンティックホテル 31 設計 34 ビジネスホテル 36 ゴルフホテル 37 ビーチ周辺ホテル 38 都市 39 SPA を備えたホテル 42 歴史 43 スキーホテル 44 農村ホテル 45 スポーツホテル 81 ファミリーホテル 83 インターネット 84 車椅子の使用に便利 85 レストラン 86 SPA 87 駐車 88 テレビ 51

52 89 ジム 90 エアコン 92 暖房 100 魅力のあるホテル 101 スイミングプール 3.- ホテルコードで検索 ノード / 属性 タイプ availabilityrq/hotels/hotel Int N 必須かどうかディスクリプション リクエストされたホテルコードはリストすることができます ( ホテルコードに必要な可能な限り多くのノードが提供されています ) "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 2, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30, "type": "CH", "age": 8, "type": "CH", "age": 8 ] ], "destination": "code": "PMI", "zone": "90", "hotels": "hotel": [ 2643 ] 4.- 最低価格および / または最高価格で検索 ノード / 属性 タイプ必須かどうかディスクリプション availabilityrq/filter/@minrate N 検索された最低価格 availabilityrq/filter/@maxrate N 検索された最高価格 "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 2, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30, "type": "CH", "age": 8, "type": "CH", "age": 8 ], "rooms": 1, "adults": 1, "children": 1, "paxes": [ "type": "AD", 52

53 "age": 30, "type": "CH", "age": 8 ] ], "destination": "code": "PMI", "zone": "90", "filter": "minrate": , "maxrate": 食事コードで検索 ノード / 属性 タイプ availabilityrq/boards/@ncluded Boolean N availabilityrq/boards/board N 必須かどうかディスクリプション 真 の場合は 応答がリストに含まれている食事のみを返します ; 偽 の場合は 食事タイプのリストが除外されます 食事タイプのリスト "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 2, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30, "type": "CH", "age": 8, "type": "CH", "age": 8 ], "rooms": 1, "adults": 1, "children": 1, "paxes": [ "type": "AD", "age": 30, "type": "CH", "age": 8 ] ], "destination": "code": "PMI", "zone": "90", "boards": "board": [ "SC", "HB" ], "included": true 6.- 応答において毎日の価格を追加する ノード / 属性 availabilityrq/@dailyrate タイプ Boolean N 必須かどうか ディスクリプション 空室状況の応答における毎日価格の内訳については 値は Y でなければなりません 値が N であるか エクストラノードが追加されていない場合 応答は 価格内訳を含みません 53

54 "dailyrate": true, "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 2, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30, "type": "CH", "age": 8, "type": "CH", "age": 8 ], "rooms": 1, "adults": 1, "children": 1, "paxes": [ "type": "AD", "age": 30, "type": "CH", "age": 8 ] ], "destination": "code": "PMI", "zone": "90" 7.- カテゴリで検索 54

55 ノード / 属性 タイプ availabilityrq/filter/@mincategory Int N availabilityrq/filter/@maxcategory Int N 必須かどうか ディスクリプション 返されたプロパティの最低の星評価 返されたプロパティの最高の星評価 "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 2, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30, "type": "CH", "age": 8, "type": "CH", "age": 8 ], "rooms": 1, "adults": 1, "children": 1, "paxes": [ "type": "AD", "age": 30, "type": "CH", "age": 8 ] ], 55

56 "destination": "code": "PMI", "zone": "90", "filter": "mincategory": 2, "maxcategory": 商品の種類で検索 ノード / 属性 タイプ 必須かどうか ディスクリプション 現地決済 (Liberate モデルのみ ) availabilityrq/filter/@paymenttype Boolean N オンラインカード決済 ( マーチャントモデルのみ ) 両方 "dailyrate": true, "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 0, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30 ] ], "destination": "code": "PMI", 56

57 "zone": "90", "filter": "paymenttype": "AT_HOTEL" 9.- 宿泊タイプで検索 ノード / 属性 availabilityrq/accommodations タイプ accommodation/accommodation Array of accommodations element 必須かどうか N N ディスクリプション 応答においてフィルタされる宿泊施設のリスト 応答においてフィルタされる宿泊施設コード "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 0, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30 ] ], "destination": "code": "PMI", "zone": "90", "hotels": "hotel": [ 2643 ], "included": true, "accommodations": [ "HOTEL", "HOSTEL" ] 10.- レビュー評価でフィルタする ノード / 属性タイプディスクリプション availabilityrq/reviews Array of review elements レビューリストを含む availabilityrq/review Element レビュー要素 57

58 レビュータイプ 例 : TRIPADVISOR HOTELBEDS availabilityrq/review/@maxrate 最高評価 availabilityrq/review/@minrate Floai 最低評価 availabilityrq/review/@minreviewcount Int レビューの最小数 11.- 各ホテルの客室の数を制限する ノード / 属性 タイプ ディスクリプション 表示されるホテルごとの客室の最大数 availabilityrq/filter/@maxrooms Int "dailyrate": true, "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 0, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30 ] ], "destination": "code": "PMI", "zone": "90", "filter": "maxrooms": "1" 58

59 12.- 各ホテルの客室の数を制限する ノード / 属性 availabilityrq/filter/@maxratesperroom タイプディスクリプション Int 表示される客室タイプごとの最大料金 "dailyrate": true, "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 0, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30 ] ], "destination": "code": "PMI", "zone": "90", "filter": "maxroomsperrate": "3" 59

60 13.- パッケージ商品に対して料金をフィルタ 追加または削除する ノード / 属性タイプディスクリプションフィルタは パッケージ商品のための料金を受け取るか ま availabilityrq/filter/@packaging Boolean たは除外するために使用されています "dailyrate": true, "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 0, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30 ] ], "destination": "code": "PMI", "zone": "90", "filter": "packaging": "TRUE" 14.- 客室タイプで検索 60

61 ノード / 属性タイプディスクリプション availabilityrq/rooms Array of rooms availabilityrq/rooms/@included Boolean 客室コード付きの客室ノード配列 availabilityrq/rooms/room 客室タイプコード 客室には ( 真 ) が含まれるか ( 偽 ) が除外されなければならないかを示します "dailyrate": true, "stay": "checkin": " ", "checkout": " ", "shiftdays": "2", "occupancies": [ "rooms": 1, "adults": 2, "children": 0, "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30 ] ], "destination": "code": "PMI", "zone": "90", "rooms": "included": "TRUE", "room": [ DB.ST ] 61

62 XML 追加検索オプションと情報 ルート親ノード :< 空室状況リクエスト > と当社 I/O Docs セクションにおける一部の例 1.- 地理的位置で検索 ノード / 属性 タイプ 必須かどうか ディスクリプション availabilityrq/geolocation/@longitude N 地理的位置の経度データ availabilityrq/geolocation/@latitude N 地理的位置の緯度データ geolocation/@radius N 決定された地理的位置における半径 半径を定義する単位 geolocation/@unit N mi マイル km キロメートル <availabilityrq xmlns=" xmlns:xsi=" checkin=" " checkout=" "/> <stay <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> </availabilityrq> ノード / 属性 タイプ availabilityrq/geolocation/@longitude N 必須かどうか ディスクリプション 地理的位置の経度データ availabilityrq/geolocation/@latitude N 地理的位置の緯度データ 62

63 N availabilityrq/geolocation/@latitude N ポリゴンをトレースするための地理的位置における緯度データ ポリゴンをトレースするための地理的位置における緯度データ <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <geolocation latitude=" " longitude=" " secondarylatitude=" " secondarylongitude=" "/> </availabilityrq> 2.- キーワードで検索する ノード / 属性 availabilityrq/keywords/ タイプ Array of keyword element N 必須かどうかディスクリプション すべてのキーワードがホテルに含まれていなければならない場合 値は真です availabilityrq/keywords/@allincluded boolean Y 真 = すべてのキーワードは ホテルリストに含まれていなければなりません availabilityrq/keywords/keyword Int N 偽 = すべてのキーワードは ホテルリストに含まれている必要がありません ファシリティコード <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> <keywords> <keyword>34</keyword> <keyword>38</keyword> <keyword>100</keyword> </keywords> </availabilityrq 63

64 キーワードリスト : 29 ロマンティックホテル 31 設計 34 ビジネスホテル 36 ゴルフホテル 37 ビーチ周辺ホテル 38 都市 39 SPA を備えたホテル 42 歴史 43 スキーホテル 44 農村ホテル 45 スポーツホテル 81 ファミリーホテル 83 インターネット 84 車椅子の使用に便利 85 レストラン 86 SPA 87 駐車 88 テレビ 89 ジム 90 エアコン 92 暖房 100 魅力のあるホテル 101 スイミングプール 3.- ホテルコードで検索 ノード / 属性 タイプ availabilityrq/hotels/hotel Int N 必須かどうかディスクリプション リクエストされたホテルコードはリストすることができます ( ホテルコードに必要な可能な限り多くのノードが提供されています ) 64

65 <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <hotels> <hotel>237515</hotel> <hotel>197494</hotel> <hotel>26356</hotel> </hotels> </availabilityrq> 4.- 最低価格および / または最高価格で検索 ノード / 属性 タイプ必須かどうかディスクリプション availabilityrq/filter/@minrate N 検索された最低価格 availabilityrq/filter/@maxrate N 検索された最高価格 <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> <filter minrate=" " maxrate=" "/> </availabilityrq> 5.- 食事コードで検索 ノード / 属性 タイプ availabilityrq/boards/@included Boolean N availabilityrq/boards/board N 必須かどうか ディスクリプション 真 の場合は 応答がリストに含まれている食事のみを返します ; 偽 の場合は 食事タイプのリストが除外されます 食事タイプのリスト 65

66 <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <filter paymenttype="at_hotel"/> <boards included="true"> <board>ro- E10</board> <board>bb-e10</board> <board>ro</board> </boards> </availabilityrq> 6.- 応答において毎日の価格を追加する ノード / 属性 タイプ availabilityrq/@dailyrate Boolean N 必須かどうか ディスクリプション 真 である場合 応答が毎日価格の内訳を返します <availabilityrq xmlns=" xmlns:xsi=" dailyrate="true"> <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> </availabilityrq> 7.- カテゴリで検索 ノード / 属性 タイプ必須かどうかディスクリプション availabilityrq/filter/@mincategory Int N 返されたプロパティの最低の星評価 availabilityrq/filter/@maxcategory Int N 返されたプロパティの最高の星評価 <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> 66

67 </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> <filter mincategory="3" maxcategory="5"/> </availabilityrq> 8. 支払いタイプで検索 ノード / 属性 タイプ 必須かどうか ディスクリプション 現地決済 (Liberate モデルのみ ) availabilityrq/filter/@paymenttype Boolean N オンラインカード決済 ( マーチャントモデルのみ ) 両方 ( デフォルト値 ) <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> <filter paymenttype="at_hotel"/> </availabilityrq> 9.- 宿泊タイプで検索 ノード / 属性 availabilityrq/accommodations タイプ accommodation/accommodation Array of accommodations element 必須かどうか N N ディスクリプション 応答においてフィルタされる宿泊施設のリスト 応答においてフィルタされる宿泊施設コード 67

68 <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> <filter paymenttype="at_hotel"/> <accommodations> <accommodation>hotel</accommodation> <accommodation>hostel</accommodation> </accommodations> </availabilityrq> 10.- レビュー評価でフィルタする ノード / 属性 タイプ ディスクリプション availabilityrq/reviews Array of review elements レビューリストを含む availabilityrq/review Element レビュー要素 レビュータイプ 例 : availabilityrq/review/@type TRIPADVISOR HOTELBEDS availabilityrq/review/@maxrate 最高評価 availabilityrq/review/@minrate Floai 最低評価 availabilityrq/review/@minreviewcount Int レビューの最小数 11.- 各ホテルの客室の数を制限する ノード / 属性 タイプ ディスクリプション 表示されるホテルごとの客室の最大数 availabilityrq/filter/@maxrooms Int 68

69 <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> <filter maxrooms="3"/> </availabilityrq> 12.- 各ホテルの客室の数を制限する ノード / 属性 availabilityrq/filter/@maxratesperroom タイプディスクリプション Int 表示される客室タイプごとの最大料金 <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> <filter maxratesperrooom="3"/> </availabilityrq> 13.- パッケージ商品に対して料金をフィルタ 追加または削除する ノード / 属性タイプディスクリプションフィルタは パッケージ商品のための料金を受け取るか ま availabilityrq/filter/@packaging Boolean たは除外するために使用されています 69

70 <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> <filter packaging="true"/> </availabilityrq> 14.- 客室タイプで検索 ノード / 属性タイプディスクリプション availabilityrq/rooms Array of rooms availabilityrq/rooms/@included Boolean 客室コード付きの客室ノード配列 availabilityrq/rooms/room 客室タイプコード 客室には ( 真 ) が含まれるか ( 偽 ) が除外されなければならないかを示します <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> <occupancy rooms="1" adults="1" children="0"/> </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> <filter packaging="true"/> </availabilityrq> 70

71 ホテルの料金チェックリクエスト コンテンツなぜ料金チェックが必要とされるか料金チェックを実行するメソッド GET POST 以前に戻された料金はまだ空室があるかどうかをチェックし 最新の空室状況と料金を取得します なぜ料金チェックが必要とされるか 料金チェックメソッドは 予約プロセスを補完することができ 空室状況リクエストと追加情報を返すことができます しかし 料金タイプ値が RECHECK である場合 料金チェックメソッドは必須です リアルタイムの空室状況を持っていない料金に対して 料金タイプ値である RECHECK は返されます すなわち この値は サプライヤ自身 目的地 ホテルのどの変化によるものであるとともに 定期的に自社システムにおいて商品を更新する宿泊パートナーから来るものです 料金チェックを実行するメソッド GET と POST という 2 つの料金チェックを実行するメソッドがあります ここで唯一の必須のパラメータは 空室状況応答から取られる料金キーの値です GET リクエストパラメータ ノード / 属性 タイプ rooms/room/@ratekey Y 必須かどうか ディスクリプション 空室状況リクエストによって返される客室料金キーは 料金の詳細の取得と予約確認に必要なすべての情報を含む必要があります 71

72 エンドポイント POST エンドポイント HTTP POST リクエストパラメータ ノード / 属性 タイプ rooms/room/@ratekey Y 必須かどうか ディスクリプション 空室状況リクエストによって返される客室料金キーは 料金の詳細の取得と予約確認に必要なすべての情報を含む必要があります ノード / 属性 タイプ ディスクリプション checkraterq トップ要素 checkraterq/@language 応答の言語 checkraterq/rooms Array of room elements 客室リスト checkraterq/rooms/room element 客室要素 checkraterq/rooms/room/@ratekey チェックに使用される価格キー 72

73 ホテル料金チェックの応答 コンテンツお客様にお知らせる重要な情報プロモーションと割引アップセリングのオプション 料金チェックメソッドの応答は 空室状況応答に提供されたものと同じな情報が含まれていますが 特定のホテルと料金に関する情報のみを返します このメソッドの目的は あらゆる特定ホテル / 料金の空室状況と価格を再確認することです このメソッドで取得した価格は常に最新価格です ; いくつかの他の情報を含みます : 料金の内訳 コメント契約 ( 詳細は に参照してください ) とアップセリングオプション お客様にお知らせる重要な情報 予約を確認する前にお客様に示されるべきホテルが提供した重要な情報が含まれているため 評価コメント属性を確認することが重要です プロモーション 割引と追加料金 返される価格内訳内の価格は すでにプロモーションと割引を含みます また 追加料金は 料金チェック応答に含まれています [...] <rate ratekey=" W DBL.NY B2C BB 1~1~1 5 N@ " rateclass="nor" ratetype="bookable" net="57.010" sellingrate="61.100" hotelmandatory="true" ratecomments=". " paymenttype="at_web" packaging="false" boardcode="bb" boardname="bed AND BREAKFAST" rooms="1" adults="1" children="1" childrenages="5"> <cancellationpolicies> <cancellationpolicy amount="57.010" from=" T23:59:00Z"/> </cancellationpolicies> <ratebreakdown> <ratediscounts> <ratediscount code="lmd" name="last Minute discount" amount=" "/> </ratediscounts> </ratebreakdown> </rate> [...] 73

74 アップセリングのオプション 応答は アップセリングノードも含みます このノードはそれぞれの価格キーで同じホテルでの追加客室オプションを提供します 価格キーは 特定キーを定義するための内部識別子です 確認ステップにおいて希望の料金を選択するために使用されています [...] <upselling> <rooms> <room code="dbl.st" name="double-standard"> <rates> <rate ratekey=" W DBL.ST B2C BB 1~1~1 5 N@ " rateclass="nor" ratetype="bookable" net="68.520" sellingrate="73.450" hotelmandatory="true" allotment="3" paymenttype="at_web" packaging="false" boardcode="bb" boardname="bed AND BREAKFAST" rooms="1" adults="1" children="1" childrenages="5" rateup="12.350"> <cancellationpolicies> <cancellationpolicy amount="68.520" from=" t23:59:00z"/> </cancellationpolicies> <promotions> <promotion code="9007" name="last minute discount"/> <promotion code="9002" name="early Booking discount"/> </promotions> <offers> <offer code="9007" name="last minute discount" amount=" "/> </offers> </rate> </rates> </room> </rooms> </upselling> [...] 応答パラメータ ノード / 属性 タイプ ディスクリプション checkraters Element トップ要素 checkraters/auditdata Element 関連する内部情報 74

75 checkraters/hotel Date Element サーバの処理時間をミリ秒単位で表示 リクエストが処理される日付 / 時刻 サーバコードまたは ID( 内部用 ) リクエストが送信と処理された環境 ホテル及び関連料金についての情報を含む要素 checkraters/hotel/@checkin Date チェックイン日付 checkraters/hotel/@checkout Date チェックアウト日付 checkraters/hotel/@name ホテルの名称 checkraters/hotel/@code checkraters/hotel/@description checkraters/hotel/@categorycode checkraters/hotel/@categoryname checkraters/hotel/@destinationcode checkraters/hotel/@destinationname Int Hotelbeds 内部ホテルコード ホテルの住所 ホテルのカテゴリコード カテゴリの名称 ホテルの位置の目的地コード ホテルの位置の目的地名称 checkraters/hotel/@zonecode checkraters/hotel/@zonename checkraters/hotel/@latitude checkraters/hotel/@longitude checkraters/hotel/@currency checkraters/hotel/@maxrate Int ホテルの位置の区域コード ホテルの位置の区域名称 地理的位置の緯度データ 地理的位置の経度データ クライアント通貨 ホテルの客室の最高価格 75

76 Int ホテルの客室の最低価格 Giata ホテルコード クライアント通貨 checkraters/hotels/creditcards checkraters/hotels/creditcards/creditcard pe checkraters/hotel/rooms checkraters/hotel/rooms/room/ Array of credit cards Element Int Array of room elements Element ホテルでお支払い モデルにおいて使用可能なクレジットカードのリスト クレジットカードに関する情報を含む要素 クレジットカードコード クレジットカード名称 お払いのタイプ 現地決済 オンラインカード決済 特定ホテルの空室リスト 客室および関連料金についての情報を含む要素 Int 内部客室コード 客室の名称 確認に使用される内部価格キー 内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 76

77 e checkraters/hotel/rooms/room/rates/rate/@packaging 予約は 以下の 2 つのステップ (BOOKABLE) または 3 つのステップ (RECHECK) で確認することができます 評価コメント ホテルでのお支払いであるかまたはマーチャントであるかを識別する 料金はパッケージ商品に対するものであるかどうかを識別する checkraters/hotel/rooms/room/rates/rate/@boardcode 内部食事コード checkraters/hotel/rooms/room/rates/rate/@boardname 食事の名称 checkraters/hotel/rooms/room/rates/rate/@net 客室の正味価格 checkraters/hotel/rooms/room/rates/rate/@sellingrate checkraters/hotel/rooms/room/rates/rate/@comission checkraters/hotel/rooms/room/rates/rate/@comissionpc T checkraters/hotel/rooms/room/rates/rate/@comissionva t checkraters/hotel/rooms/room/rates/rate/@hotelselling Rate checkraters/hotel/rooms/room/rates/rate/@hotelcurrenc y checkraters/hotel/rooms/room/rates/rate/@hotelmandat ory checkraters/hotel/rooms/room/rates/rate/@allotment Boolean Int 客室の総価 ( 含まれている場合 ) 代理のコミッション コミッションの割合 コミッション増値税 ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 価格が推奨されているかどうかを識別 特定客室タイプの空室の数 77

78 78 Int 同じ宿泊人数のリクエストされた空室の数 Int リクエストされた客室ごとの大人の人数 Int リクエストされた客室ごとの子供の人数 s 重要な情報を含む評価コメント checkraters/hotel/rooms/room/rates/rate/cancellationpol icies Array of policies elements キャンセルポリシーのリスト checkraters/hotel/rooms/room/rates/rate/cancellationpol icies/policy Element キャンセルポリシー要素 checkraters/hotel/rooms/room/rates/rate/cancellationpol 日付以後に課金される料金 checkraters/hotel/rooms/room/rates/rate/cancellationpol Date 料金が課金される開始日付 checkraters/hotel/rooms/room/rates/rate/cancellationpol Floar 特定の日付以降にホテル通貨で課金される料金 ( ホテルでのお支払いモデル向け ) checkraters/hotel/rooms/room/rates/rate/ratebreakdown Element 価格内訳要素 checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratediscounts Element 割引要素 checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratediscounts/ratediscount/@amount 割引金額 checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratediscounts/ratediscount/@code Int 割引コード checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratediscounts/ratediscount/@name 割引の名称 / ディスクリプション checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratesupplements Element 追加料金要素 checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratesupplements/ratesupplement/@amount 追加料金金額 checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratesupplements/ratesupplement/@code Int 追加料金の内部コード checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratesupplements/ratesupplement/@from Date 追加料金が課金される開始日付

79 79 checkraters/hotel/rooms/room/rates/rate/ratebreakdown Date 追加料金の課金が停止される日付 checkraters/hotel/rooms/room/rates/rate/ratebreakdown Int 追加料金が課金される宿泊日数 checkraters/hotel/rooms/room/rates/rate/ratebreakdown int 追加料金に影響されるお客様の数 checkraters/hotel/rooms/room/rates/rate/ratebreakdown 影響されるお客様のタイプ checkraters/hotel/rooms/room/rates/rate/offers Array of offer elements 特典リスト checkraters/hotel/rooms/room/rates/rate/offers/offer Element 特典情報を含む要素 ode Int 特典コード mount 特典の金額 ame 特典の名称 checkraters/hotel/rooms/room/rates/rate/promotions Array of promotion elements 特定価格のプロモーションリスト checkraters/hotel/rooms/room/rates/rate/promotions/pro motion Element プロモーション情報を含む要素 checkraters/hotel/rooms/room/rates/rate/promotions/pro Int プロモーションコード checkraters/hotel/rooms/room/rates/rate/promotions/pro プロモーションの簡単ディスクリプション checkraters/hotel/rooms/room/rates/rate/promotions/pro プロモーション備考 checkraters/hotel/rooms/room/rates/rate/taxes Array of tax elements 税込みまたは税抜き価格のリスト uded Boolean すべての税金を含むかどうかを表示 checkraters/hotel/rooms/room/rates/rate/taxes/tax Element 税金に関する情報を含む要素 cluded Boolean 価格に税金が含まれているどうかを表示

80 port elimport elcurrency centage checkraters/hotel/upselling ekey eclass etype ymenttype ckaging ardcode ardname Array of rooms lingrate mission 税金の値 ホテル通貨での税金の値 ( 価格に税金が含まれていない場合 ) ホテル通貨 現地決済のパーセンテージ 選択されたもの以外の使用可能な客室オプション 確認に使用される内部価格キー 内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 客室が空室であるかどうか ホテルでのお支払いであるかまたはマーチャントであるかを識別する 料金はパッケージ商品に対するものであるかどうかを識別する 内部食事コード 食事の名称 客室の正味価格 客室の総価 ( 含まれている場合 ) コミッションモデルに対するコミッション 80

81 elsellingrate elcurrency Boolean elmandatory otment Int ms ults ldren ecomments eup checkraters/hotel/upselling/rooms/room/rates/rate/canc ellationpolicies checkraters/hotel/upselling/rooms/room/rates/rate/canc ellationpolicies/policy checkraters/hotel/upselling/rooms/room/rates/rate/canc checkraters/hotel/upselling/rooms/room/rates/rate/canc checkraters/hotel/upselling/rooms/room/rates/rate/canc Int Int Int Array of policies elements Element Date ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 価格が推奨されているかどうかを識別 特定客室タイプの空室の数 このタイプのリクエストされた客室の数 客室ごとの宿泊可能な大人の数 リクエストされた客室ごとの子供の人数 重要な情報を含む評価コメント オリジナルの価格とアップセリング価格との差 キャンセルポリシーのリスト キャンセルポリシー要素 日付以後に課金される料金 料金が課金される開始日付 特定の日付以降にホテル通貨で課金される料金 ( ホテルでのお支払いモデル向け ) 81

82 "auditdata": "processtime": "59", "timestamp": " :26:08.395", "serverid": "ws3xmi01", "environment": "[itest, iset_a, ehcache]", "release": "4838", "internal": " null null null null N null null null null null 1", "hotel": "checkin": " ", "checkout": " ", "code": 2643, "name": "Club Marthas", "categorycode": "4EST", "categoryname": "4 STARS", "destinationcode": "PMI", "destinationname": "Majorca", "zonecode": 90, "zonename": "Cala d'or", "latitude": " ", "longitude": " ", "rooms": [ "code": "APT.1B-C4", "name": "APARTMENT", "rates": [ "ratekey": "2643 APT.1B-C4 REP- OPACO 1 AI 1~2~2 8~ W N# ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "ratecomments": "BABY COT 4 PAY DIRECTLY IN THE HOTEL Estimated total amount of taxes & fees for this booking: Estimated total amount of taxes & fees for this booking: payable on arrival. ", "paymenttype": "AT_WEB", "packaging": false, "boardcode": "AI", "boardname": "ALL INCLUSIVE", "cancellationpolicies": [ "amount": " ", "from": " T00:00:00+02:00" ], "ratebreakdown": "ratediscounts": [ "code": "EB", "name": "EARLY BOOKING", "amount": " ", "code": "DN", "name": "CHILD", "amount": " " ], "agcommission": "0.00", "commissionvat": "0.00", "commissionpct": "0.00", "rooms": 1, 82

83 "adults": 2, "children": 2, "childrenages": "8~8" ] ], "totalsellingrate": " ", "totalnet": "0.000", "currency": "EUR" 83

84 - JSON の例 シングルレートのチェック リクエスト "rooms":[ "ratekey":"4294 DUS-E10 CG-TODOS 102 ST SC-E10 1~1~ # " ] 応答 "auditdata": "processtime": "59", "timestamp": " :26:08.395", "serverid": "ws3xmi01", "environment": "[itest, iset_a, ehcache]", "release": "4838", "internal": " null null null null N null null null null null 1", "hotel": "checkin": " ", "checkout": " ", "code": 2643, "name": "Club Marthas", "categorycode": "4EST", "categoryname": "4 STARS", "destinationcode": "PMI", "destinationname": "Majorca", "zonecode": 90, "zonename": "Cala d'or", "latitude": " ", "longitude": " ", "rooms": [ "code": "APT.1B-C4", "name": "APARTMENT", "rates": [ "ratekey": "2643 APT.1B-C4 REP- OPACO 1 AI 1~2~2 8~ W N# ", 84

85 "rateclass": "NOR", "ratetype": "BOOKABLE", "net": " ", "ratecomments": "BABY COT 4 PAY DIRECTLY IN THE HOTEL Estimated total amount of taxes & fees for this booking: Estimated total amount of taxes & fees for this booking: payable on arrival. ", "paymenttype": "AT_WEB", "packaging": false, "boardcode": "AI", "boardname": "ALL INCLUSIVE", "cancellationpolicies": [ "amount": " ", "from": " T00:00:00+02:00" ], "ratebreakdown": "ratediscounts": [ "code": "EB", "name": "EARLY BOOKING", "amount": " ", "code": "DN", "name": "CHILD", "amount": " " ], "agcommission": "0.00", "commissionvat": "0.00", "commissionpct": "0.00", "rooms": 1, "adults": 2, "children": 2, "childrenages": "8~8" ] ], "totalsellingrate": " ", "totalnet": "0.000", "currency": "EUR" アップセリングの応答例 "auditdata": "processtime": "128", 85

86 "timestamp": " :36:00.931", "serverid": "ws3xmi01", "environment": "[itest, iset_a, ehcache]", "release": "4954", "internal": " null null null null N null null null null null 1", "hotel": "checkin": " ", "checkout": " ", "code": , "name": "Istanbul Holiday Hotel", "categorycode": "BOU", "categoryname": "BOUTIQUE", "destinationcode": "IST", "destinationname": "Istanbul", "zonecode": 2, "zonename": "Old City", "latitude": " ", "longitude": " ", "rooms": [ "code": "DBL.NY", "name": "DOUBLE", "rates": [ "ratekey": " W DBL.NY B2C BB 1~1~1 5 N@ ", "rateclass": "NOR", "ratetype": "BOOKABLE", "net": "57.010", "sellingrate": "61.100", "hotelmandatory": true, "ratecomments": ". ", "paymenttype": "AT_WEB", "packaging": false, "boardcode": "BB", "boardname": "BED AND BREAKFAST", "cancellationpolicies": [ "amount": "57.010", "from": " T23:59:00Z" ], "ratebreakdown": "ratediscounts": [ "code": "LMD", "name": "Last Minute discount", "amount": " " ], "rooms": 1, "adults": 1, "children": 1, "childrenages": "5" ] ], "totalnet": "57.010", "currency": "EUR", "upselling": "rooms": [ "code": "DBL.ST", "name": "DOUBLE-STANDARD", "rates": [ "ratekey": " W DBL.ST B2C BB 1~1~1 5 N@ ", 86

87 ] ] "rateclass": "NOR", "ratetype": "BOOKABLE", "net": "68.520", "sellingrate": "73.450", "hotelmandatory": true, "allotment": 3, "paymenttype": "AT_WEB", "packaging": false, "boardcode": "BB", "boardname": "BED AND BREAKFAST", "cancellationpolicies": [ "amount": "68.520", "from": " T23:59:00Z" ], "rooms": 1, "adults": 1, "children": 1, "childrenages": "5", "promotions": [ "code": "9007", "name": "Last minute discount", "code": "9002", "name": "Early Booking discount" ], "offers": [ "code": "9007", "name": "Last minute discount", "amount": " " ], "rateup": "12.350" - XML の例 シングルレートのチェック リクエスト <checkraterq xmlns=" xmlns:xsi=" > <rooms> <room ratekey="6914 DUS.ST CG- TODOS1 1 HB 1~1~ W N# "/> </rooms> 87

88 </checkraterq> 応答 <?xml version="1.0" encoding="utf-8"?> <checkraters xmlns=" xmlns:xsi=" schemalocation=" <auditdata processtime="277" timestamp=" :25:57.128" serverid="ws3xmi01" environment="[itest, iset_a, ehcache]" release="4838" internal=" N 1"/> <hotel checkin=" " checkout=" " code="6914" name="bellevue Vistanova" categorycode="3est" categoryname="3 STARS" destinationcode="pmi" destinationname="majorca" zonecode="29" zonename="palmanova" latitude=" " longitude=" " totalsellingrate=" " totalnet="0.000" currency="eur"> <rooms> <room code="dus.st" name="double SINGLE USE"> <rates> <rate ratekey="6914 DUS.ST CG- TODOS1 1 HB 1~1~ W N# " rateclass="nor" ratetype="bookable" net=" " ratecomments=" " paymenttype="at_web" packaging="false" boardcode="hb" boardname="half BOARD" rooms="1" adults="1" children="0"> <cancellationpolicies> <cancellationpolicy amount="55.350" from=" T23:59:00+02:00"/> </cancellationpolicies> </rate> </rates> </room> </rooms> </hotel> </checkraters> アップセリングの応答例 <?xml version="1.0" encoding="utf-8"?> <checkraters xmlns=" xmlns:xsi=" schemalocation=" <auditdata processtime="126" timestamp=" :32:24.118" serverid="ws3xmi01" environment="[itest, iset_a, ehcache]" release="4954" internal=" N 1"/> 88

89 <hotel checkin=" " checkout=" " code="233475" name="istanbul Holiday Hotel" categorycode="bou" categoryname="boutique" destinationcode="ist" destinationname="istanbul" zonecode="2" zonename="old City" latitude=" " longitude=" " totalnet="57.010" currency="eur"> <rooms> <room code="dbl.ny" name="double"> <rates> <rate ratekey=" W DBL.NY B2C BB 1~1~1 5 N@ " rateclass="nor" ratetype="bookable" net="57.010" sellingrate="61.100" hotelmandatory="true" ratecomments=". " paymenttype="at_web" packaging="false" boardcode="bb" boardname="bed AND BREAKFAST" rooms="1" adults="1" children="1" childrenages="5"> <cancellationpolicies> <cancellationpolicy amount="57.010" from=" T23:59:00Z"/> </cancellationpolicies> <ratebreakdown> <ratediscounts> <ratediscount code="lmd" name="last Minute discount" amount=" "/> </ratediscounts> </ratebreakdown> </rate> </rates> </room> </rooms> <upselling> <rooms> <room code="dbl.st" name="double-standard"> <rates> <rate ratekey=" W DBL.ST B2C BB 1~1~1 5 N@ " rateclass="nor" ratetype="bookable" net="68.520" sellingrate="73.450" hotelmandatory="true" allotment="3" paymenttype="at_web" packaging="false" boardcode="bb" boardname="bed AND BREAKFAST" rooms="1" adults="1" children="1" childrenages="5" rateup="12.350"> <cancellationpolicies> <cancellationpolicy amount="68.520" from=" T23:59:00Z"/> </cancellationpolicies> <promotions> <promotion code="9007" name="last minute discount"/> <promotion code="9002" name="early Booking discount"/> </promotions> <offers> <offer code="9007" name="last minute discount" amount=" "/> </offers> </rate> </rates> </room> </rooms> </upselling> </hotel> </checkraters> 89

90 ホテル確認リクエスト コンテンツ保有者とお客様の名前 POST 予約リクエストメソッドは 選択された価格キーを確認します 同じホテルと同じ日付の複数の価格キーを確認することも可能です 予約 API は オンリクエスト確認をサポートしません すべての確認はインスタント確認です 保有者とお客様の名前予約保有者の名前と他のお客様の名前を入力しなければなりません エンドポイント HTTP POST リクエストパラメータ ノード / 属性値ディスクリプション bookingrq Element トップレベル bookingrq/@language 応答の言語 bookingrq/holder Element 予約保有者に関する情報要素 bookingrq/holder/@name bookingrq/holder/@surname bookingrq/rooms Array of room elements 予約におけるすべての客室の予約保有者の名前 予約におけるすべての客室の予約保有者の姓氏 確認される客室リスト bookingrq/rooms/room Element 確認される客室 bookingrq/rooms/room/@ratekey 前のステップで取られた確認される価格キー 90

91 bookingrq/rooms/room/paxes Array of pax elements 客室におけるお客様のリスト bookingrq/rooms/room/paxes/pax Element お客様情報を記述する要素 お客様のタイプ 2 つの値がこの属性に対して許可されます : AD は大人 CH は子供 bookingrq/rooms/room/paxes/pax/@name お客様の名前 bookingrq/rooms/room/paxes/pax/@surname お客様の姓氏 bookingrq/rooms/room/paxex/pax/@age Int お客様の年齢 ( お客様が子供の場合は必須 ) bookingrq/rooms/room/paxex/pax/@roomid Int お客様が宿泊する客室 bookingrq/clientreference ご自分の内部予約番号またはコメント bookingrq/paymentdata bookingrq/paymentdata/paymentcard/cardtype bookingrq/paymentdata/paymentcard/cardnumber Int bookingrq/paymentdata/paymentcard/expirtydate Int bookingrq/paymentdata/paymentcard/cardcvc Element Int 支払い情報 支払いタイプ = 現地決済 の場合 本ノードを使用しなければなりません クレジットカードタイプ VISA AMEX MAESTRO クレジットカード番号 クレジットカードの有効期間 クレジットカード CVC セキュリティコード bookingrq/paymentdata/contactdata/ お客様のメールアドレス bookingrq/paymentdata/contactdata/phonenumber お客様の電話番号 ご注意 : ホテルでのお支払い (LIBERATE) モデルだけにおいて支払いデータノードを使用してください その他のプライシングモデルにおいては これらのノードを使用してはいけません 91

92 リクエストの例 <?xml version="1.0" encoding="utf-8"?> <bookingrqxmlns=" org/2001/xmlschema-instance"> <holder name="holder Name"surname="Holder Surname"/> <rooms> <room ratekey=" SGL-E10 CG-MERCHANT 1 ST BB- E10 1~1~ # "> <paxes> <paxtype="ad"age="30"name="adult Name"surname="Auldt Surname"/> </paxes> </room> </rooms> <paymentdata> <paymentcard> <cardtype>visa</cardtype> <cardnumber> </cardnumber> <expirydate>0615</expirydate> <cardcvc>123</cardcvc> </paymentcard> <contactdata> < >integration@test.com</ > <phonenumber> </phonenumber> </contactdata> </paymentdata> <clientreference>my booking reference</clientreference> </bookingrq> 応答の例 <?xml version="1.0" encoding="utf-8" standalone="yes"?> <bookingrsxmlns:xsi=" lbeds.com/schemas/messages"> <auditdataprocesstime="2486"timestamp=" :57:26.473"serverId="ws3xmi01"environment="[itest, HOTEL_CONTENT_UPDATER- ITEST]"release="2878"/> <booking reference=" "clientreference="my BOOKING REFERENCE"creationDate=" "status="CONFIRMED"totalAmount="209.32"currency="EUR"> <holder name="holder NAME,HOLDER"surname="SURNAME"/> <hotel code="5263"name="amura Alcobendas"destination="MAD"zone="11"netPrice="209.32"currency="EUR"maxPrice=" "min Price=" "> <rooms> <room status="confirmed"code="dbl-e10-st"> <occupancy> <paxtype="ad"age="30"name="adult Name"surname="Auldt Surname"/> </occupancy> <prices> <price checkin=" "checkout=" "ratename="cg- TODOS"rateComments="FREE SHUTTLE SERVICE FROM BOTH - THE AIRPORT AS A BUSINESS ZONE, MONDAY THROUGH FRIDAY FROM 7:00 TO 23:00.. "ratekey="5263 DBL-E10-ST CG-TODOS 102 RO- E10 1~1~ #~~~~~~~~~~~"rateClass="SPE"paymentType="AT_WEB"packaging="fa lse"boardcode="ro-e10"net=" "gross=" "currency="eur"rooms="1"> <taxes> <tax included="true"percent="10.00"currency="eur"/> </taxes> </price> 92

93 </prices> </room> </rooms> <supplier name="hotelbeds PRODUCT,S.L.U."vatNumber="B "/> </hotel> </booking> </bookingrs> 93

94 ホテル確認応答 コンテンツ - 予約リクエストメソッドによる価格キーの確認が成功した場合 予約番号と予約の重要情報を提供します 次を含みます : 確認された予約保有者および宿泊のお客様確認されたホテル確認された価格 価格された金額と日付を含む 応答は 価格の内訳 キャンセルポリシー 追加料金と割引も含みます 応答パラメータ ノード / 属性タイプディスクリプション bookingrs Element トップ要素 bookingrs/auditdata Element 関連する内部情報 bookingrs/auditdata/@time bookingrs/auditdata/@processtime bookingrs/auditdata/@serverid bookingrs/auditdata/@environment bookingrs/booking/@reference bookingrs/booking/@clientreference bookingrs/booking/@creationdate 94 Date Date サーバの処理時間をミリ秒単位で表示 リクエストが処理される日付 / 時刻 サーバコードまたは ID( 内部用 ) リクエストが送信と処理された環境 予約参照番号 フォーマット : XXX-XXXXXX クライアント内部の予約参照番号 予約の作成日 フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) bookingrs/booking/@creationdate 予約の作成日 bookingrs/booking/@totalnet 予約の合計額

95 支払うべき金額の通貨 チェックイン日付 Date フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) bookingrs/booking/@remark お客様備考 bookingrs/booking/@checkout bookingrs/hotel Date Element チェックアウト日付 フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) ホテル及び関連料金についての情報を含む要素 bookingrs/hotel/@name ホテルの名称 bookingrs/hotel/@code Int 内部ホテルコード bookingrs/hotel/@category ホテルのカテゴリ bookingrs/hotel/@categoryname カテゴリの名称 bookingrs/hotel/@destination bookingrs/hotel/@destinationname bookingrs/hotel/@zonecode bookingrs/hotel/@zonename bookingrs/hotel/@longitude bookingrs/hotel/@latitude Int ホテルの位置の目的地コード ホテルの位置の目的地名称 ホテルの位置の区域コード ホテルの位置の区域名称 地理的位置の経度データ 地理的位置の緯度データ bookingrs/hotel/@currency クライアント通貨 bookingrs/hotels/hotel/rooms bookingrs/hotels/hotel/rooms/room/ Array of room elements Element 特定ホテルの空室リスト 客室および関連料金についての情報を含む要素 95

96 予約状況 : CONFIRMED CANCELLED bookingrs/hotel/rooms/room/@code Int 内部客室コード bookingrs/hotel/rooms/room/@name 客室の名称 bookingrs/hotels/hotel/rooms/room/rates bookingrs/hotels/hotel/rooms/room/rates/rate bookingrs/hotel/rooms/room/rates/rate/@rateclass bookingrs/hotel/rooms/room/rates/rate/@ratetype bookingrs/hotel/rooms/room/rates/rate/@paymenttype bookingrs/hotel/rooms/room/rates/rate/@packaging Array of price elements Element 特定ホテルの価格リスト 客室タイプと食事の価格情報 内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 予約は 以下の 2 つのステップ (BOOKABLE) または 3 つのステップ (RECHECK) で確認することができます ホテルでのお支払いであるかまたはマーチャントであるかを識別する 料金はパッケージ商品に対するものであるかどうかを識別する bookingrs/hotel/rooms/room/rates/rate/@boardcode 内部食事コード bookingrs/hotel/rooms/room/rates/rate/@net 客室の正味価格 bookingrs/hotel/rooms/room/rates/rate/@sellingprice 客室の総価 ( 含まれている場合 ) bookingrs/hotel/rooms/room/rates/rate/@agcomission 代理のコミッション bookingrs/hotel/rooms/room/rates/rate/@comissionvat コミッション増値税 bookingrs/hotel/rooms/room/rates/rate/@comissionpct コミッションの割合 bookingrs/hotel/rooms/room/rates/rate/@hotelsellingrate ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) 96

97 bookingrs/hotel/rooms/room/rates/rate/cancellationpolicies bookingrs/hotel/rooms/room/rates/rate/cancellationpolicies/ policy bookingrs/hotel/rooms/room/rates/rate/cancellationpolicies/ bookingrs/hotel/rooms/room/rates/rate/cancellationpolicies/ bookingrs/hotel/rooms/room/rates/rate/cancellationpolicies/ bookingrs/hotel/rooms/room/rates/rate/cancellationpolicies/ 97 Boolean Int Int Int Array of policies elements Element Date ホテル通貨 ( ホテルでのお支払いモデル向け ) 販売価格であるどうかを確認 同じ宿泊人数のリクエストされた空室の数 リクエストされた客室ごとの大人の人数 リクエストされた客室ごとの子供の人数 キャンセルポリシーのリスト 日付以後に課金される料金 料金が課金される開始日付 日付以降にホテル通貨で課金される料金 ( ホテルでのお支払いモデル向け ) ホテルに到着時に払う金額の通貨 bookingrs/hotel/rooms/rates/ratebreakdown Element 価格内訳要素 bookingrs/hotel/rooms/rates/ratebreakdown/@agcomissio n bookingrs/hotel/rooms/rates/ratebreakdown/@comissionpc t bookingrs/hotel/rooms/rates/ratebreakdown/@comissionv at bookingrs/hotel/rooms/rates/ratebreakdown/ratesupplemen ts bookingrs/hotel/rooms/rates/ratebreakdown/ratesupplemen ts/ratesupplement/@amount bookingrs/hotel/rooms/rates/ratebreakdown/ratesupplemen ts/ratesupplement/@code bookingrs/hotel/rooms/rates/ratebreakdown/ratesupplemen ts/ratesupplement/@from Element Int Date 代理のコミッション コミッションの割合 コミッション税金 価格の追加料金要素 追加料金金額 追加料金コード 追加料金が課金される開始日付

98 98 bookingrs/hotel/rooms/rates/ratebreakdown/ratesupplemen Int 追加料金が課金される宿泊日数 bookingrs/hotel/rooms/rates/ratebreakdown/ratesupplemen Int 追加料金が課金されるお客様の数 bookingrs/hotel/rooms/rates/ratebreakdown/ratesupplemen 追加料金が課金されるお客様のタイプ bookingrs/hotel/rooms/rates/ratebreakdown/ratesupplemen Date 追加料金の課金が停止される日付 bookingrs/hotel/rooms/rates/ratebreakdown/ratediscounts Element 割引要素 bookingrs/hotel/rooms/rates/ratebreakdown/ratediscounts/r 割引金額 bookingrs/hotel/rooms/rates/ratebreakdown/ratediscounts/r Int 割引内部コード bookingrs/hotel/rooms/rates/ratebreakdown/ratediscounts/r 割引の名称 bookingrs/hotels/hotel/rooms/room/rates/rate/offers Array of offer elements 特典リスト bookingrs/hotels/hotel/rooms/room/rates/rate/offers/offer Element 特典情報を含む要素 code Int 特典コード amount 特典の金額 name 特典の名称 bookingrs/hotels/hotel/rooms/room/rates/rate/promotions Array of promotion elements 特定価格のプロモーションリスト bookingrs/hotels/hotel/rooms/room/rates/rate/promotions/pr omotion Element プロモーション情報を含む要素 bookingrs/hotels/hotel/rooms/room/rates/rate/promotions/pr Int プロモーションコード bookingrs/hotels/hotel/rooms/room/rates/rate/promotions/pr プロモーションの名称 bookingrs/hotels/hotel/rooms/room/rates/rate/promotions/pr プロモーション備考 bookingrs/hotel/rooms/room/rates/rate/taxes Array of tax elements 税込みまたは税抜き価格のリスト Boolean すべての税金を含むかどうかを表示

99 bookingrs/hotel/rooms/room/prices/taxes/tax Element Boolean 税金の値 t cy bookingrs/hotel/supplier Element 税金に関する情報を含む要素 価格に税金が含まれているどうかを表示 ホテル通貨での税金の値 ( 価格に税金が含まれていない場合 ) ホテル通貨 現地決済のパーセンテージ サプライヤー情報を含む要素 bookingrs/hotel/supplier/@name サプライヤーの名称 bookingrs/hotel/supplier/@vatnumber Strung サプライヤーの増値税番号 <bookingrs xmlns:xsi=" <auditdata processtime="4713"timestamp=" :01:44.741"serverId="ws3xmi01"environment="[itest, iset_a, ehcache]"release="4757"internal=" N 1"/> <booking reference=" "clientreference="my BOOKING REFERENCE"creationDate=" "status="CONFIRMED"currency="EUR"pendingAmount=" "totalNet=" "creation User="XML"checkIn=" "checkOut=" "> <holder name="holder NAME"surname="HOLDER SURNAME"/> <hotel code="8577"name="playa Moreia"categoryCode="2LL"categoryName="2 KEYS"destinationCode="PMI"destinationName="Majorca"zoneCode="73"zoneName="S'Illot"la titude=" "longitude=" "currency="eur"> <rooms> <room status="confirmed"code="apt.1b"name="apartment"> <paxes> <pax type="ad"age="30"surname="adult SURNAME"/> <pax type="ad"age="30"surname="adult SURNAAME"/> </paxes> <rates> <rate ratename="cg- TODOS"paymentType="AT_WEB"packaging="false"boardCode="HB"boardName="HALF BOARD"rooms="1"rateClass="NOR"net=" "> <cancellationpolicies> 99

100 <cancellationpolicy amount="72.060"from=" t23:59:00+02:00"/> </cancellationpolicies> <taxes allincluded="true"/> <ratebreakdown agcommission="0.00"commissionvat="0.00"commissionpct="0.00"> <ratediscounts> <ratediscount code="sd"name="special DISCOUNT"amount=" "/> <ratediscount code="sd"name="special DISCOUNT"amount=" "/> </ratediscounts> <ratesupplements> <ratesupplement code="sr"name="board SUPPLEMENT"from=" "to=" "amount="65.120"nights="2"paxType="AD"paxNumber="2"/> </ratesupplements> </ratebreakdown> </rate> </rates> </room> </rooms> <supplier name="hotelbeds PRODUCT,S.L.U."vatNumber="B "/> </hotel> </booking> </bookingrs> "auditdata": "processtime":"53187", "timestamp":" :32:35.702", "serverid":"ts", "environment":"[test]", "booking": "filenumber":" ", "checkin":" ", "checkout":" ", "creationdate":" ", "status":"booking", "totalamount":108.68, "currency":"eur", "holder": "name":"integrationtestfirstname,integrationtestlastname", "surname":"", "hotel": "code":"284695", "name":"karina", "destination":"cfu", "zone":"26", "net Price":108.68, "rooms":[ "status":"confirm ED", "code":"fam-g01- SV", "occupancy":[ "type ":"AD", "age":30, "name":"adultname", "surname":"surname" ], "rates":[ "ratename":"gr- FIT", "ratecomments":"rellenodummyinválido", "ratekey":" FAM-G01-SV rellenodummyinválido 436 RO- G01 1~1~ #~~~~~~~~~~~", "rateclass":"rellenodummyinválido", "paymenttype":"at_web", "packaging":false, "boardcode":"ro-g01", "net": , "gross":108.68, "currency":"eur", "rooms":1 ] ], "supplier": "name":"hotelbeds PRODUCT,S.L.U.", "vatnumber":"b ", "currency":"eur", "minprice":108.68, "maxprice":

101 XML の例 単一の客室の確認 リクエスト <bookingrq xmlns=" xmlns:xsi=" <holder name="holder NAME" surname="holder SURNAME"/> <clientreference>my booking reference</clientreference> <rooms> <room ratekey="15875 SGL.ST CG- TODOS 1 BB 1~1~ W N# "> <paxes> <pax type="ad" age="30" name="adult NAME" surname="adult SURNAAME"/> </paxes> </room> </rooms> </bookingrq> 応答 <?xml version="1.0" encoding="utf-8" standalone="yes"?> <bookingrs xmlns:xsi=" xmlns=" schemalocation=" <auditdata processtime="2661" timestamp=" :59:06.112" serverid="ws3xmi01" environment="[itest, iset_a, ehcache]" release="4791" internal=" N 1"/> <booking reference=" " clientreference="my BOOKING REFERENCE" creationdate=" " status="confirmed" currency="eur" pendingamount="81.400" totalnet="81.400" creationuser="xml" checkin=" " checkout=" "> <holder name="holder NAME" surname="holder SURNAME"/> <hotel code="15875" name="golf Beach" categorycode="2est" categoryname="2 STARS" destinationcode="pmi" destinationname="majorca" zonecode="31" zonename="santa Ponsa" latitude=" " longitude=" " currency="eur"> <rooms> <room status="confirmed" code="sgl.st" name="single"> <paxes> <pax type="ad" age="30" surname="adult SURNAAME"/> </paxes> <rates> <rate ratename="cg-todos" paymenttype="at_web" packaging="false" boardcode="bb" boardname="bed AND BREAKFAST" rooms="1" rateclass="nor" net="81.400"> 101

102 19T12:00:00+02:00"/> <cancellationpolicies> <cancellationpolicy amount="40.700" from=" </cancellationpolicies> <taxes allincluded="true"/> <ratebreakdown agcommission="0.00" commissionvat="0.00" commissionpct="0.00"> <ratesupplements> <ratesupplement code="sr" name="board SUPPLEMENT" from=" " to=" " amount="10.860" nights="2" paxtype="ad" paxnumber="1"/> </ratesupplements> </ratebreakdown> </rate> </rates> </room> </rooms> <supplier name="hotelbeds PRODUCT,S.L.U." vatnumber="b "/> </hotel> </booking> </bookingrs> 複数の客室の確認 リクエスト <bookingrq xmlns=" xmlns:xsi=" <holder name="holder NAME" surname="holder SURNAME"/> <clientreference>my booking reference</clientreference> <rooms> <room ratekey="1540 SGL.ST CG- BRITANICO 1 AI 1~1~ W N# "> <paxes> <pax type="ad" age="30" name="adult NAME" surname="adult SURNAAME"/> </paxes> </room> <room ratekey="1540 SGL.ST CG- BRITANICO 1 AI 1~1~ W N# "> <paxes> <pax type="ad" age="30" name="adult NAME" surname="adult SURNAAME"/> </paxes> </room> </rooms> </bookingrq> 102

103 応答 <bookingrs xmlns:xsi=" xmlns=" schemalocation=" <auditdata processtime="6219" timestamp=" :03:33.292" serverid="ws3xmi01" environment="[itest, iset_a, ehcache]" release="4791" internal=" N N 1"/> <booking reference=" " clientreference="my BOOKING REFERENCE" creationdate=" " status="confirmed" currency="eur" pendingamount=" " totalnet=" " creationuser="xml" checkin=" " checkout=" "> <holder name="holder NAME" surname="holder SURNAME"/> <hotel code="1540" name="caribbean Bay" categorycode="3est" categoryname="3 STARS" destinationcode="pmi" destinationname="majorca" zonecode="75" zonename="el Arenal" latitude=" " longitude=" " currency="eur"> <rooms> <room status="confirmed" code="sgl.st" name="single"> <paxes> <pax type="ad" age="30" surname="adult SURNAAME"/> </paxes> <rates> <rate ratename="cg- BRITANICO" paymenttype="at_web" packaging="false" boardcode="ai" boardname="all INCLUSIVE" rooms="1" rateclass="nor" net=" "> <cancellationpolicies> <cancellationpolicy amount="55.500" from=" T23:59:00+02:00"/> </cancellationpolicies> <taxes allincluded="true"/> <ratebreakdown agcommission="0.00" commissionvat="0.00" commissionpct="0.00"> <ratesupplements> <ratesupplement code="em" name="minimum STAY" from=" " to=" " amount="10.720" nights="2" paxtype="ad" paxnumber="1"/> <ratesupplement code="em" name="minimum STAY" from=" " to=" " amount="10.720" nights="2" paxtype="ad" paxnumber="1"/> </ratesupplements> </ratebreakdown> </rate> </rates> </room> <room status="confirmed" code="sgl.st" name="single"> <paxes> <pax type="ad" age="30" surname="adult SURNAAME"/> </paxes> <rates> <rate ratename="cg- BRITANICO" paymenttype="at_web" packaging="false" boardcode="ai" boardname="all INCLUSIVE" rooms="1" rateclass="nor" net=" "> <cancellationpolicies> <cancellationpolicy amount="55.500" from=" T23:59:00+02:00"/> </cancellationpolicies> <taxes allincluded="true"/> <ratebreakdown agcommission="0.00" commissionvat="0.00" commissionpct="0.00"> 103

104 <ratesupplements> <ratesupplement code="em" name="minimum STAY" from=" " to=" " amount="10.720" nights="2" paxtype="ad" paxnumber="1"/> <ratesupplement code="em" name="minimum STAY" from=" " to=" " amount="10.720" nights="2" paxtype="ad" paxnumber="1"/> </ratesupplements> </ratebreakdown> </rate> </rates> </room> </rooms> <supplier name="hotelbeds PRODUCT,S.L.U." vatnumber="b "/> </hotel> </booking> </bookingrs> 104

105 JSON の例 シングルレートの確認 リクエスト "holder": "name": "IntegrationTestFirstName", "surname": "IntegrationTestLastName", "rooms": [ "ratekey": "99658 TPL.ST OP-TODOS 1 BB 1~2~0 30~26~ # ", "paxes": [ "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname", "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname" ] ], "clientreference": "IntegrationAgen" 応答 "auditdata": "processtime": "3340", "timestamp": " :34:25.748", 105

106 "serverid": "ws3xmi01", "environment": "[itest, iset_a, ehcache]", "release": "4838", "internal": " N 1", "booking": "reference": " ", "clientreference": "INTEGRATIONAGEN", "creationdate": " ", "status": "CONFIRMED", "creationuser": "XML", "holder": "name": "INTEGRATIONTESTFIRSTNAME", "surname": "INTEGRATIONTESTLASTNAME", "hotel": "checkin": " ", "checkout": " ", "code": 6912, "name": "Valentin Playa de Muro ", "categorycode": "APTH3", "categoryname": "APARTHOTEL 3*", "destinationcode": "PMI", "destinationname": "Majorca", "zonecode": 76, "zonename": "Playa de Muro", "latitude": " ", "longitude": " ", "rooms": [ "status": "CONFIRMED", "code": "APT.1B-C4", "name": "APARTMENT", "paxes": [ "type": "AD", "age": 30, "surname": "Surname", "type": "AD", "age": 30, "surname": "Surname" ], "rates": [ "rateclass": "NOR", "net": " ", "ratename": "CG-MERCHANT", "paymenttype": "AT_WEB", "packaging": false, "boardcode": "HB", "boardname": "HALF BOARD", "cancellationpolicies": [ "amount": " ", "from": " T23:59:00+02:00" ], "taxes": "taxes": [], "allincluded": true, "ratebreakdown": "ratesupplements": [ "code": "SR", "name": "BOARD SUPPLEMENT", 106

107 "from": " ", "to": " ", "amount": " ", "nights": 2, "paxtype": "AD", "paxnumber": 2 ], "agcommission": "0.00", "commissionvat": "0.00", "commissionpct": "0.00", "rooms": 1 ] ], "totalsellingrate": " ", "totalnet": " ", "pendingamount": " ", "currency": "EUR", "supplier": "name": "HOTELBEDS PRODUCT,S.L.U.", "vatnumber": "B " マルチレートの確認 リクエスト "holder": "name": "IntegrationTestFirstName", "surname": "IntegrationTestLastName", "rooms": [ "ratekey": ""6912 APT.1B-C4 CG- MERCHANT 1 HB 1~2~ W N# ", "paxes": [ "type": "AD", "age": 30, "name": "AdultName", 107

108 ], "surname": "Surname", "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname" "ratekey": "6912 APT.1B-C4 CG- MERCHANT 1 BB 1~2~ W N# ", "paxes": [ "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname", "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname", "type": "CH", "age": 2, "name": "Child", "surname": "Surname" ] ], "clientreference": "IntegrationAgen" 応答 "auditdata": "processtime": "2733", "timestamp": " :01:52.148", "serverid": "ws3xmi02", "environment": "[itest, iset_b, ehcache]", "release": "4838", 108

109 "internal": " N N 1", "booking": "reference": " ", "clientreference": "INTEGRATIONAGEN", "creationdate": " ", "status": "CONFIRMED", "creationuser": "XML", "holder": "name": "INTEGRATIONTESTFIRSTNAME", "surname": "INTEGRATIONTESTLASTNAME", "hotel": "checkin": " ", "checkout": " ", "code": 6912, "name": "Valentin Playa de Muro ", "categorycode": "APTH3", "categoryname": "APARTHOTEL 3*", "destinationcode": "PMI", "destinationname": "Majorca", "zonecode": 76, "zonename": "Playa de Muro", "latitude": " ", "longitude": " ", "rooms": [ "status": "CONFIRMED", "code": "APT.1B-C4", "name": "APARTMENT", "paxes": [ "type": "AD", "age": 30, "surname": "Surname", "type": "AD", "age": 30, "surname": "Surname", "type": "AD", "age": 30, "surname": "Surname" ], "rates": [ "rateclass": "NOR", "net": " ", "ratename": "CG-MERCHANT", "paymenttype": "AT_WEB", "packaging": false, "boardcode": "BB", "boardname": "BED AND BREAKFAST", "cancellationpolicies": [ "amount": " ", "from": " T23:59:00+02:00" ], "taxes": "taxes": [], "allincluded": true, "ratebreakdown": "ratesupplements": [ 109

110 "code": "CA", "name": "EXTRA BED", "from": " ", "to": " ", "amount": " ", "nights": 2, "paxnumber": 1, "code": "SR", "name": "BOARD SUPPLEMENT", "from": " ", "to": " ", "amount": " ", "nights": 2, "paxtype": "AD", "paxnumber": 2 ], "agcommission": "0.00", "commissionvat": "0.00", "commissionpct": "0.00", "rooms": 1 ], "status": "CONFIRMED", "code": "APT.1B-C4", "name": "APARTMENT", "paxes": [ "type": "AD", "age": 30, "surname": "Surname", "type": "AD", "age": 30, "surname": "Surname" ], "rates": [ "rateclass": "NOR", "net": " ", "ratename": "CG-MERCHANT", "paymenttype": "AT_WEB", "packaging": false, "boardcode": "HB", "boardname": "HALF BOARD", "cancellationpolicies": [ "amount": " ", "from": " T23:59:00+02:00" ], "taxes": "taxes": [], "allincluded": true, "ratebreakdown": "ratesupplements": [ "code": "CA", "name": "EXTRA BED", "from": " ", "to": " ", "amount": " ", "nights": 2, "paxnumber": 1 110

111 , "code": "SR", "name": "BOARD SUPPLEMENT", "from": " ", "to": " ", "amount": " ", "nights": 2, "paxtype": "AD", "paxnumber": 2 ], "agcommission": "0.00", "commissionvat": "0.00", "commissionpct": "0.00", "rooms": 1 ] ], "totalsellingrate": " ", "totalnet": " ", "pendingamount": " ", "currency": "EUR", "supplier": "name": "HOTELBEDS PRODUCT,S.L.U.", "vatnumber": "B " 111

112 予約リストと詳細のリクエスト コンテンツご予約の詳細を取得ご予約を検索する 予約リスト方式が GET リクエストである場合 以下二つの異なる場合に使用することができます : 予約リストを取得するある具体的な予約の詳細を取得する ご予約を検索する エンドポイント HTTP GET リクエストパラメータ パラメータ start end タイプ Date Y Date Y includecancelled N filtertype N 必須かどうかディスクリプション この方式で予約をチェックする開始日付 フォーマットは YYYY-MM-DD( 年 - 月 - 日 ) でなければなりません この方式で予約をチェックする終了日付 フォーマットは YYYY-MM-DD( 年 - 月 - 日 ) でなければなりません このパラメーターはすべての予約を取得するために使用され キャンセルされた予約を含めるまたは除外することができます 値 : Y はキャンセルされた予約を含むものであり N はキャンセルされた予約を除外するものです このパラメータは チェックイン日付でまたは予約の作成日で予約リストを取得することであるかどうかを識別するために使用されています CHECKIN: チェックイン日付で CREATION: 作成日で 112

113 from Int Y 返される予約開始番号を から に指定 to Int Y 返される予約終了番号を まで に指定 リクエストの例 15&filterType=CREATION&includeCancelled=true&from=1&to=25 ご予約の詳細を取得 エンドポイント HTTP GET リクエストパラメータパラメータタイプ必須かどうかディスクリプション確認応答または予約リスト機能から取られた予約参照番号 booking_reference Y フォーマット :XXX-XXXXXX リクエストの例 HTTP GET 113

114 予約リストの応答 コンテンツ XML の例 JSON の例 (tabla sin título) 予約リストの応答は 検索条件に基づいて 予約リストを表示します リストにおける各予約に対して返される最も重要な情報は 次のとおりです : 予約参照番号 予約保有者 予約のお客様 確認されたホテル 客室と食事 予約の料金 114

115 XML の例 <?xml version="1.0" encoding="utf-8" standalone="yes"?> <bookinglistrs xmlns:xsi=" xmlns=" schemalocation=" <auditdata processtime="10091" timestamp=" :41:12.238" serverid="ws3xmi01" environment="[itest, iset_a, ehcache]" release="4726"/> <bookings from="1" to="25" total="63"> <booking reference=" " clientreference="zffxus8c7rzfabxp8rgkgt27" creationdate=" " status="cancelled" totalamount="0.000" currency="eur" checkin=" " checkout=" "> <holder name="andrés" surname="sánchez"/> <hotel name="subur" destinationcode="sts"> <rooms> <room status="cancelled" code="sgl.st"> <paxes> <pax type="ad"/> </paxes> <rates> <rate paymenttype="at_hotel" boardcode="bb" rooms="1" amount="0.000"/> </rates> </room> </rooms> </hotel> </booking> <booking reference=" " clientreference="zffxus8c7rzfabxp8rgkgt27" creationdate=" " status="cancelled" totalamount="0.000" currency="eur" checkin=" " checkout=" "> <holder name="integrationtestfirstname" surname="integrationtestlastname"/> <hotel name="nh Paseo de la Habana" destinationcode="mad"> <rooms> <room status="cancelled" code="sgl.st"> <paxes> <pax type="ad"/> </paxes> <rates> <rate paymenttype="at_web" boardcode="ro" rooms="1" amount="0.000"/> </rates> </room> </rooms> </hotel> </booking> <booking reference=" " clientreference="zffxus8c7rzfabxp8rgkgt27" creationdate=" " status="cancelled" totalamount="0.000" currency="eur" checkin=" " checkout=" "> <holder name="andrés" surname="sánchez"/> <hotel name="hesperia Ciutat de Mallorca" destinationcode="pmi"> <rooms> <room status="cancelled" code="dbt.st"> <paxes> 115

116 amount="0.000"/> </rates> </room> </rooms> </hotel> </booking> <pax type="ad"/> </paxes> <rates> <rate paymenttype="at_web" boardcode="ro" rooms="1" <booking reference=" " clientreference="zffxus8c7rzfabxp8rgkgt27" creationdate=" " status="cancelled" totalamount="0.000" currency="eur" checkin=" " checkout=" "> <holder name="test NAME " surname="test SURNAME "/> <hotel name="ainb Las Ramblas-Guardia Apartments" destinationcode="bcn"> <rooms> <room status="cancelled" code="stu.st"> <paxes> <pax type="ad"/> </paxes> <rates> <rate paymenttype="at_web" boardcode="sc" rooms="1" amount="0.000"/> </rates> </room> </rooms> </hotel> </booking> <booking reference=" " clientreference="zffxus8c7rzfabxp8rgkgt27" creationdate=" " status="cancelled" totalamount="0.000" currency="eur" checkin=" " checkout=" "> <holder name="test NAME " surname="test SURNAME "/> <hotel name="ainb Las Ramblas-Guardia Apartments" destinationcode="bcn"> <rooms> <room status="cancelled" code="stu.st"> <paxes> <pax type="ad"/> </paxes> <rates> <rate paymenttype="at_web" boardcode="sc" rooms="1" amount="0.000"/> </rates> </room> </rooms> </hotel> </booking> </bookings> </bookinglistrs> 116

117 JSON の例 "auditdata": "processtime": "3727", "timestamp": " :27:20.859", "serverid": "ws3xmi01", "environment": "[itest, iset_a, ehcache]", "release": "4877", "bookings": "bookings": [ "reference": " ", "clientreference": "zffxus8c7rzfabxp8rgkgt27", "creationdate": " ", "status": "CANCELLED", "holder": "name": "TEST NAME ", "surname": "TEST SURNAME ", "hotel": "checkin": " ", "checkout": " ", "name": "Castro Exclusive Residences Sant Pau", "destinationcode": "BCN", "rooms": [ "status": "CANCELLED", "code": "APT.1B-DP", "paxes": [ "type": "AD" ], "rates": [ "amount": "0.000", "paymenttype": "AT_WEB", "boardcode": "SC", "rooms": 1 ] ], "totalsellingrate": "0.000", "totalnet": "0.000", "currency": "EUR", "reference": " ", "clientreference": "zffxus8c7rzfabxp8rgkgt27", "creationdate": " ", "status": "CANCELLED", "holder": "name": "TEST NAME ", "surname": "TEST SURNAME ", "hotel": "checkin": " ", "checkout": " ", 117

118 "name": "Castro Exclusive Residences Sant Pau", "destinationcode": "BCN", "rooms": [ "status": "CANCELLED", "code": "APT.1B-DP", "paxes": [ "type": "AD" ], "rates": [ "amount": "0.000", "paymenttype": "AT_WEB", "boardcode": "SC", "rooms": 1 ] ], "totalsellingrate": "0.000", "totalnet": "0.000", "currency": "EUR", "reference": " ", "clientreference": "zffxus8c7rzfabxp8rgkgt27", "creationdate": " ", "status": "CANCELLED", "holder": "name": "TEST NAME ", "surname": "TEST SURNAME ", "hotel": "checkin": " ", "checkout": " ", "name": "Castro Exclusive Residences Sant Pau", "destinationcode": "BCN", "rooms": [ "status": "CANCELLED", "code": "APT.1B-DP", "paxes": [ "type": "AD" ], "rates": [ "amount": "0.000", "paymenttype": "AT_WEB", "boardcode": "SC", "rooms": 1 ] ], "totalsellingrate": "0.000", "totalnet": "0.000", "currency": "EUR", "reference": " ", "clientreference": "zffxus8c7rzfabxp8rgkgt27", "creationdate": " ", "status": "CANCELLED", "holder": "name": "TEST NAME ", "surname": "TEST SURNAME ", "hotel": "checkin": " ", 118

119 "checkout": " ", "name": "Castro Exclusive Residences Sant Pau", "destinationcode": "BCN", "rooms": [ "status": "CANCELLED", "code": "APT.1B-DP", "paxes": [ "type": "AD" ], "rates": [ "amount": "0.000", "paymenttype": "AT_WEB", "boardcode": "SC", "rooms": 1 ] ], "totalsellingrate": "0.000", "totalnet": "0.000", "currency": "EUR" ], "from": 1, "to": 25, "total": 119 応答パラメータ ノード / 属性 タイプ ディスクリプション bookinglistrs Element トップ要素 bookinglistrs/auditdata Element 関連する内部情報 bookinglistrs/auditdata/@time bookinglistrs/auditdata/@processtime bookinglistrs/auditdata/@serverid bookinglistrs/auditdata/@environment bookinglistrs/bookings Date Array of booking elements サーバの処理時間をミリ秒単位で表示 リクエストが処理される日付 / 時刻 サーバコードまたは ID( 内部用 ) リクエストが送信と処理された環境 予約リスト bookinglistrs/bookings/@total Int 予約総数 119

120 予約参照番号 フォーマット : XX-XXXXXX 予約の作成日 bookinglistrs/bookings/booking/@creationdate 120 Date フォーマット : YYYY-MM-DD ( 年 - 月 - 日 ) bookinglistrs/bookings/booking/@totalamount 予約の合計額 bookinglistrs/bookings/booking/@currency bookinglistrs/bookings/booking/@status bookinglistrs/bookings/booking/holder Element 支払うべき金額の通貨 予約状況 : CONFIRMED CANCELLED 保有者に関する情報要素 bookinglistrs/bookings/booking/holder/@name 保有者の名前 bookinglistrs/bookings/booking/holder/@surname 保有者の姓氏 bookinglistrs/hotel Element ホテル及び関連料金についての情報を含む要素 bookinglistrs/bookings/booking/hotel/@name ホテルの名称 bookinglistrs/bookings/booking/hotel/@code Int Hotelbeds 内部ホテルコード bookinglistrs/bookings/booking/hotel/@category ホテルのカテゴリ bookinglistrs/bookings/booking/hotel/@destination bookinglistrs/bookings/booking/hotel/@zone Int ホテルの位置の目的地コード ホテルの位置の区域コード bookinglistrs/bookings/booking/hotel/@currency クライアント通貨 bookinglistrsbookings/booking//hotels/hotel/rooms bookinglistrs/bookings/booking/hotels/rooms/room/ Array of room elements Element 特定ホテルの空室リスト 客室および関連料金についての情報を含む要素 bookinglistrs/bookings/booking/hotel/rooms/room/@code Int 内部客室コード checkavailrs/hotels/hotel/rooms/room/rates Array of rate elements 特定ホテルの価格リスト

121 checkavailrs/hotels/hotel/rooms/room/rates/rate Element 客室タイプまたは食事の価格に関する情報 チェックイン日付 Date Date フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) チェックアウト日付 フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) 内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 予約は 以下の 2 つのステップ (BOOKABLE) または 3 つのステップ (RECHECK) で確認することができます ホテルでのお支払いであるかまたはマーチャントであるかを識別する 料金はパッケージ商品に対するものであるかどうかを識別する 内部食事コード 客室の正味価格 客室の総価 ( 含まれている場合 ) ホテル通貨での客室正味価格 ( ホテルでのお支払いモデル向け ) 121

122 Boolean Int Int Int ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 販売価格であるどうかを確認 同じ宿泊人数のリクエストされた空室の数 リクエストされた客室ごとの大人の人数 リクエストされた客室ごとの子供の人数 122

123 予約詳細の応答 コンテンツ XML の例 JSON の例 我々は料金を確認し 確認が成功した ( 予約リクエストメソッド ) 場合には 予約参照番号が表示される予約の詳細は返されます それは以下の情報を含みます : 確認された予約保有者および宿泊のお客様 確認されたホテル 確認された価格 適宜の金額 日付 追加料金および割引が含まれています XML の例 <bookingdetailrs xmlns:xsi=" xmlns=" schemalocation=" <auditdata processtime="4713" timestamp=" :01:44.741" serverid="ws3xmi01" environment="[itest, iset_a, ehcache]" release="4757" internal=" N 1"/> <booking reference=" " clientreference="my BOOKING REFERENCE" creationdate=" " status="confirmed" currency="eur" pendingamount=" " totalnet=" " creationuser="xml" checkin=" " checkout=" "> <holder name="holder NAME" surname="holder SURNAME"/> <hotel code="8577" name="playa Moreia" categorycode="2ll" categoryname="2 KEYS" destinationcode="pmi" destinationname="majorca" zonecode="73" zonename="s'illot" latitude=" " longitude=" " currency="eur"> <rooms> status="confirmed" code="apt.1b" name="apartment"> <room <paxes> 123

124 <pax type="ad" age="30" surname="adult SURNAME"/> <pax type="ad" age="30" surname="adult SURNAAME"/> </paxes> <rates> <rate ratename="cg-todos" paymenttype="at_web" packaging="false" boardcode="hb" boardname="half BOARD" rooms="1" rateclass="nor" net=" "> <cancellationpolicies> icy amount="72.060" from=" t23:59:00+02:00"/> <cancellationpol </cancellationpolicies> <taxes allincluded="true"/> 124

125 <ratebreakdown agcommission="0.00" commissionvat="0.00" commissionpct="0.00"> <ratediscounts> DISCOUNT" amount=" "/> <ratediscount code="sd" name="special DISCOUNT" amount=" "/> <ratediscount code="sd" name="special </ratediscounts> > <ratesupplements <ratesupplement code="sr" name="board SUPPLEMENT" from=" " to=" " amount="65.120" nights="2" paxtype="ad" paxnumber="2"/> 125

126 s> </ratesupplement </ratebreakdown> </rate> </rates> </room> </rooms> <supplier name="hotelbeds PRODUCT,S.L.U." vatnumber="b "/> </hotel> </booking> </bookinglistrs> JSON の例 "auditdata": "processtime": "462", "timestamp": " :24:17.578", "serverid": "ws3xmi01", "environment": "[itest, iset_a, ehcache]", "release": "4877", "booking": "reference": " ", "clientreference": "MY BOOKING REFERENCE", "creationdate": " ", "status": "CONFIRMED", 126

127 "creationuser": "XML", "holder": "name": "HOLDER NAME", "surname": "HOLDER SURNAME", "hotel": "checkin": " ", "checkout": " ", "code": 6914, "name": "BelleVue Vistanova", "categorycode": "3EST", "categoryname": "3 STARS", "destinationcode": "PMI", "destinationname": "Majorca", "zonecode": 29, "zonename": "Palmanova", "latitude": " ", "longitude": " ", "rooms": [ "status": "CONFIRMED", "code": "DUS.ST", "name": "DOUBLE SINGLE USE", "paxes": [ "type": "AD", "age": 30, "surname": "ADULT SURNAAME" ], "rates": [ "rateclass": "NOR", "net": " ", "ratename": "CG-TODOS1", "paymenttype": "AT_WEB", "packaging": false, "boardcode": "HB", "boardname": "HALF BOARD", "cancellationpolicies": [ "amount": "55.350", "from": " T23:59:00+02:00" ], "taxes": "taxes": [], "allincluded": true, "ratebreakdown": "agcommission": "0.00", "commissionvat": "0.00", "commissionpct": "0.00", "rooms": 1 ] ], "totalsellingrate": " ", "totalnet": " ", "pendingamount": " ", "currency": "EUR", "supplier": "name": "HOTELBEDS PRODUCT,S.L.U.", "vatnumber": "B " 127

128 応答パラメータ ノード / 属性 タイプ ディスクリプション bookinglistrs Element トップ要素 bookinglistrs/auditdata Element 関連する内部情報 bookinglistrs/auditdata/@time bookinglistrs/auditdata/@processtime bookinglistrs/auditdata/@serverid bookinglistrs/auditdata/@environment bookinglistrs/booking/@reference bookinglistrs/booking/@clientreference bookinglistrs/booking/@creationdate Date Date サーバの処理時間をミリ秒単位で表示 リクエストが処理される日付 / 時刻 サーバコードまたは ID( 内部用 ) リクエストが送信と処理された環境 予約参照番号 フォーマット : XX-XXXXXX クライアント内部の予約参照番号 予約の作成日 フォーマット : YYYY-MM-DD ( 年 - 月 - 日 ) bookinglistrs/booking/@creationdate 予約の作成日 bookinglistrs/booking/@totalnet 予約の合計額 bookinglistrs/booking/@currency 支払うべき金額の通貨 チェックイン日付 bookinglistrs/booking/@checkin Date フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) 128

129 bookinglistrs/hotel 129 Date Element チェックアウト日付 フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) ホテル及び関連料金についての情報を含む要素 bookinglistrs/hotel/@name ホテルの名称 bookinglistrs/hotel/@code Int Hotelbeds 内部ホテルコード bookinglistrs/hotel/@category ホテルのカテゴリ bookinglistrs/hotel/@categoryname カテゴリの名称 bookinglistrs/hotel/@destination bookinglistrs/hotel/@destinationname bookinglistrs/hotel/@zone bookinglistrs/hotel/@zonename bookinglistrs/hotel/@longitude bookinglistrs/hotel/@latitude Int ホテルの位置の目的地コード ホテルの位置の目的地名称 ホテルの位置の区域コード ホテルの位置の区域名称 地理的位置の経度データ 地理的位置の緯度データ bookinglistrs/hotel/@currency クライアント通貨 bookinglistrs/hotels/hotel/rooms bookinglistrs/hotels/hotel/rooms/room/ bookinglistrs/hotel/rooms/room/@status Array of room elements Element 特定ホテルの空室リスト 客室および関連料金についての情報を含む要素 予約状況 : CONFIRMED CANCELLED bookinglistrs/hotel/rooms/room/@code Int 内部客室コード bookinglistrs/hotel/rooms/room/@name 客室名称 / 説明 checkavailrs/hotels/hotel/rooms/room/prices Array of price elements 特定ホテルの価格リスト

130 checkavailrs/hotels/hotel/rooms/room/rates/rate 130 Element 客室タイプと食事の価格情報 内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 予約は 以下の 2 つのステップ (BOOKABLE) または 3 つのステップ (RECHECK) で確認することができます ホテルでのお支払いであるかまたはマーチャントであるかを識別する 料金はパッケージ商品に対するものであるかどうかを識別する bookinglistrs/hotel/rooms/room/rates/rate/@boardcode 内部食事コード bookinglistrs/hotel/rooms/room/rates/rate/@net 客室の正味価格 bookinglistrs/hotel/rooms/room/rates/rate/@sellingprice 客室の総価 ( 含まれている場合 ) bookinglistrs/hotel/rooms/room/rates/rate/@comission コミッション bookinglistrs/hotel/rooms/room/rates/rate/@hotelsellingra te bookinglistrs/hotel/rooms/room/rates/rate/@hotelcurrency bookinglistrs/hotel/rooms/room/rates/rate/@hotelmandator y bookinglistrs/hotel/rooms/room/rates/rate/@rooms bookinglistrs/hotel/rooms/room/rates/rate/@adults Boolean Int Int ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 販売価格であるどうかを確認 同じ宿泊人数のリクエストされた空室の数 リクエストされた客室ごとの大人の人数

131 131 Int リクエストされた客室ごとの子供の人数 bookinglistrs/hotel/rooms/room/rates/rate/cancellationpolic ies Array of policies elements キャンセルポリシーのリスト bookinglistrs/hotel/rooms/room/rates/rate/cancellationpolic ies/policy Element キャンセルポリシー bookinglistrs/hotel/rooms/room/rates/rate/cancellationpolic 日付以後に課金される料金 bookinglistrs/hotel/rooms/room/rates/rate/cancellationpolic Date 料金が課金される開始日付 bookinglistrs/hotel/rooms/room/rates/rate/cancellationpolic Floar 日付以降にホテル通貨で課金される料金 ( ホテルでのお支払いモデル向け ) bookinglistrs/hotel/rooms/room/rates/rate/cancellationpolic ies/policy/@hotelcurrency ホテルに到着時に払う予約の通貨 bookinglistrs/hotel/rooms/rates/ratebreakdown Element 価格内訳要素 bookinglistrs/hotel/rooms/rates/ratebreakdown/@agcomis sion 代理のコミッション bookinglistrs/hotel/rooms/rates/ratebreakdown/@comissio npct コミッションの割合 bookinglistrs/hotel/rooms/rates/ratebreakdown/@comissio nvat コミッション税金 bookinglistrs/hotel/rooms/rates/ratebreakdown/ratesupple ments Element 価格の追加料金要素 bookinglistrs/hotel/rooms/rates/ratebreakdown/ratesupple ments/ratesupplement/@amount 追加料金金額 bookinglistrs/hotel/rooms/rates/ratebreakdown/ratesupple ments/ratesupplement/@code Int 追加料金コード bookinglistrs/hotel/rooms/rates/ratebreakdown/ratesupple ments/ratesupplement/@from Date 追加料金が課金される開始日付 bookinglistrs/hotel/rooms/rates/ratebreakdown/ratesupple ments/ratesupplement/@nights Int 追加料金が課金される宿泊日数 bookinglistrs/hotel/rooms/rates/ratebreakdown/ratesupple ments/ratesupplement/@paxnumber Int 追加料金が課金されるお客様の数 bookinglistrs/hotel/rooms/rates/ratebreakdown/ratesupple ments/ratesupplement/@paxtype お客様のタイプ bookinglistrs/hotel/rooms/rates/ratebreakdown/ratesupple ments/ratesupplement/@to Date 追加料金の課金が停止される日付

132 bookinglistrs/hotel/rooms/rates/ratebreakdown/ratediscou Element nts bookinglistrs/hotel/rooms/rates/ratebreakdown/ratediscou bookinglistrs/hotel/rooms/rates/ratebreakdown/ratediscou Int bookinglistrs/hotel/rooms/rates/ratebreakdown/ratediscou bookinglistrs/hotel/rooms/room/rates/rate/taxes Array of tax elements 割引要素 割引金額 割引内部コード 割引の名称 / ディスクリプション 税込みまたは税抜き価格のリスト bookinglistrs/hotel/rooms/room/prices/taxes/@allincluded Boolean bookinglistrs/hotel/rooms/room/prices/taxes/tax Element bookinglistrs/hotel/rooms/room/prices/taxes/tax/@included Boolean bookinglistrs/hotel/rooms/room/prices/taxes/tax/@import bookinglistrs/hotel/rooms/room/prices/taxes/tax/@hotelim port bookinglistrs/hotel/rooms/room/prices/taxes/tax/@hotelcur rency bookinglistrs/hotel/rooms/room/prices/taxes/tax/@percenta ge bookingdetailrs/hotel/supplier bookingdetailrs/hotel/supplier/@name bookingdetailrs/hotel/supplier/@vatnumber Element すべての税金を含むかどうかを表示 税金に関する情報を含む要素 価格に税金が含まれているどうかを表示 税金の値 ホテル通貨での税金の値 ( 価格に税金が含まれていない場合 ) ホテル通貨 現地決済のパーセンテージ サプライヤー情報を含む要素 サプライヤーの名称 サプライヤーの増値税番号 132

133 予約キャンセルのリクエスト コンテンツ XML/REST URL 予約キャンセルの URL キャンセル方法は DELETE メソッドであり 二つの異なる場合において使用することができます : 予約のキャンセルをシミュレートする予約をキャンセルする XML/REST URL: 予約キャンセルの URL: シミュレートする : キャンセル : リクエストパラメータ パラメータ タイプ 必須かどうか ディスクリプション language N 応答の言語 booking_reference Y 確認応答または予約リスト機能から取られた予約参照番号 フォーマット :XXX-XXXXXX 使用するキャンセル方法のタイプ : cancellationflag Y SIMULATION: 予約キャンセルをシミュレートする CANCELLATION: 予約をキャンセルする 133

134 JSON の例 * リクエスト リクエストヘッダー ヘッダーの名称 値 Api-Key asdfsdfsdreas234 ssdr4356dg Content-Type application/json Accept application/json 応答 "auditdata": "processtime": "3662", "timestamp": " :22:21.853", "serverid": "ws3xmi01", "environment": "[iset_a, itest]", "release": "5081", "booking": "reference": " ", "cancellationreference": "UIWQSFSARS", "clientreference": "MY BOOKING REFERENCE", "creationdate": " ", "status": "CANCELLED", "creationuser": "XML", "holder": "name": "HOLDER NAME", "surname": "HOLDER SURNAME", "hotel": "checkin": " ", "checkout": " ", 134

135 XML の例 + "code": 14530, "name": "San Francisco", "categorycode": "HS", "categoryname": "HOSTEL 1*", "destinationcode": "PMI", "destinationname": "Majorca", "zonecode": 90, "zonename": "Cala d'or", "latitude": " ", "longitude": " ", "rooms": [ "status": "CANCELLED", "code": "DBL.ST", "name": "DOUBLE STANDARD", "paxes": [ "type": "AD", "type": "AD" ], "rates": [ "rateclass": "NOR", "net": "0.000", "ratename": "REP-TODOS", "paymenttype": "AT_WEB", "packaging": false, "boardcode": "RO", "boardname": "ROOM ONLY", "rooms": 1 ] ], "totalnet": "0.000", "pendingamount": "0.000", "currency": "EUR", "supplier": "name": "HOTELBEDS SPAIN, S.L.U.", "vatnumber": "B " リクエストヘッダー ヘッダーの名称 値 Api-Key Your registered API key Content-Type application/xml Accept application/xml 135

136 XML 応答 <bookingcancellationrs xmlns:xsi=" xmlns=" schemalocation=" <auditdata processtime="1663" timestamp=" :06:53.714" serverid="ws3xmi01" environment="[itest, iset_a, ehcache]" release="4791"/> <booking reference=" " cancellationreference="gerjewugak" clientreference="my BOOKING REFERENCE" creationdate=" " status="cancelled" currency="eur" pendingamount="0.000" totalnet="0.000" creationuser="xml" checkin=" " checkout=" "> <holder name="holder NAME" surname="holder SURNAME"/> <hotel code="4096" name="nh Paseo de la Habana" categorycode="4est" categoryname="4 STARS" destinationcode="mad" destinationname="madrid" zonecode="53" zonename="santiago Bernabeu-Castellana" latitude=" " longitude=" " currency="eur"> <rooms> <room status="cancelled" code="dbl.st" name="double"> <rates> <rate ratename="cg-barcom18" paymenttype="at_web" packaging="false" boardcode="ro" boardname="room ONLY" rooms="1" rateclass="nor" net="0.000"> <taxes allincluded="true"/> <ratebreakdown agcommission="0.00" commissionvat="0.00" commissionpct="0.00"/> </rate> </rates> </room> </rooms> <supplier name="hotelbeds SPAIN, S.L.U." vatnumber="b "/> </hotel> </booking> </bookingcancellationrs> 136

137 予約キャンセルの応答 コンテンツ - 予約がキャンセルされた場合 キャンセルされた予約の詳細は 以下の情報で返されます : 予約状況 :CANCELLED キャンセル参照番号該当する場合のキャンセル料予約をキャンセルされたホテル お客様及び料金 <?xml version="1.0" encoding="utf-8" standalone="yes"?> <bookingcancellationrs xmlns:xsi=" xmlns=" schemalocation=" <auditdata processtime="2570" timestamp=" :31:47.895" serverid="ws3xmi01" environment="[itest]" release="3821"/> <booking reference=" " cancellationreference="vduzhxmyhy" clientreference="my BOOKING REFERENCE" creationdate=" " status="cancelled" totalgross="0.000" currency="eur" agcommision="0.000" commisionvat="0.000" pendingamount="0.000" totalnet="0.000" creationuser="xml" checkin=" " checkout=" "> <holder surname="holder NAME"/> <hotel code="1540" name="caribbean Bay" destination="pmi" zone="75"> <rooms> <room status="cancelled" code="sgl.st"> <rates> <rate paymenttype="at_web" packaging="false" boardcode="ai" rooms="1" rateclass="nor" ratetype="bookable" net="0.000" ratecommentid="1" gross="0.000" currency="eur"/> </rates> </room> </rooms> <supplier name="hotelbeds SPAIN, S.L.U." vatnumber="b "/> </hotel> </booking> </bookingcancellationrs> "auditdata": "processtime": "6568", "timestamp": " :27:50.976", "serverid": "ws3xmi01", "environment": "[itest]", 137

138 "release": "2844", "booking": "reference": " ", "cancellationtoken": "CX1: ", "clientreference": "rellenodummyinválido_esteseborraba?", "creationdate": " ", "status": "CANCELLED", "totalamount": 0, "currency": "EUR", "holder": "name": "HOLDER NAME,HOLDER", "surname": "SURNAME", "hotel": "code": "66699", "name": "Blau Porto Petro Beach Resort & Spa", "destination": "PMI", "zone": "92", "netprice": 0, "rooms": [ "status": "CANCELLED", "code": "DUS-E10-ST", "rates": [ "checkin": " ", "checkout": " ", "ratename": "CG-VARIOS", "ratekey": "66699 DUS-E10-ST CG-VARIOS 1 HB- E10 1~1~ #~~~~~~~~~~~", "rateclass": "NOR", "paymenttype": "AT_WEB", "packaging": false, "boardcode": "HB-E10", "net": 0.000, "gross": 0.000, "currency": "EUR", "rooms": 1 ] ], "supplier": "name": "HOTELBEDS SPAIN, S.L.U.", "vatnumber": "B ", "currency": "EUR", "minprice": 0.000, "maxprice": 応答パラメータ ノード / 属性 タイプ ディスクリプション bookingcancellationrs Element トップ要素 138

139 bookingcancellationrs/auditdata Element Date 関連する内部情報 サーバの処理時間をミリ秒単位で表示 リクエストが処理される日付 / 時刻 サーバコードまたは ID( 内部用 ) リクエストが送信と処理された環境 予約参照番号 フォーマット : XXX-XXXXXX キャンセル参照番号 予約作成日 bookingcancellationrs/booking/@creationdate bookingcancellationrs/booking/@cancellationdate 139 Date Date フォーマット : YYYY-MM-DD ( 年 - 月 - 日 ) 予約がキャンセルされた日付 フォーマット : YYYY-MM-DD ( 年 - 月 - 日 ) bookingcancellationrs/booking/@totalamount 予約の合計額 bookingcancellationrs/booking/@currency bookingcancellationrs/hotel Element 支払うべき金額の通貨 ホテル及び関連料金についての情報を含む要素 bookingcancellationrs/hotel/@name ホテルの名称 bookingcancellationrs/hotel/@code bookingcancellationrs/hotel/@category Int Hotelbeds 内部ホテルコード ホテルのカテゴリ

140 bookingcancellationrs/hotels/hotel/rooms bookingcancellationrs/hotels/hotel/rooms/room/ Int Array of room elements Element ホテルの位置の目的地コード ホテルの位置の区域コード クライアント通貨 特定ホテルの空室リスト 客室および関連料金についての情報を含む要素 予約状況 : bookingcancellationrs/hotel/rooms/room/@status CONFIRME D CANCELLE D bookingcancellationrs/hotel/rooms/room/@code Int 内部客室コード bookingcancellationrs/hotel/rooms/room/rates/rate/@checkin checkavailrs/hotels/hotel/rooms/room/prices checkavailrs/hotels/hotel/rooms/room/rates/rate Date Array of price elements Element bookingcancellationrs/hotel/rooms/room/rates/rate/@checkout Date bookingcancellationrs/hotel/rooms/room/rates/rate/@rateclass チェックイン日付 フォーマット : YYYY-MM-DD ( 年 - 月 - 日 ) 特定ホテルの価格リスト 客室タイプと食事の価格情報 チェックアウト日付 フォーマット : YYYY-MM-DD ( 年 - 月 - 日 ) 内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 140

141 ype e 予約は 以下の 2 つのステップ (BOOKABLE) または 3 つのステップ (RECHECK) で確認することができます ホテルでのお支払いであるかまたはマーチャントであるかを識別する 料金はパッケージ商品に対するものであるかどうかを識別する 内部食事コード bookingcancellationrs/hotel/rooms/room/rates/rate/@net 客室の正味価格 bookingcancellationrs/hotel/rooms/room/rates/rate/@gross bookingcancellationrs/hotel/rooms/room/rates/rate/@hotelnet bookingcancellationrs/hotel/rooms/room/rates/rate/@hotelgross bookingcancellationrs/hotel/rooms/room/rates/rate/@hotelcurre ncy bookingcancellationrs/hotel/rooms/room/rates/rate/@recommen ded bookingcancellationrs/hotel/rooms/room/rates/rate/@rooms Boolean Int 客室の総価 ( 含まれている場合 ) ホテル通貨での客室正味価格 ( ホテルでのお支払いモデル向け ) ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 価格が推奨されているかどうかを識別 同じ宿泊人数のリクエストされた空室の数 141

142 bookingcancellationrs/hotel/rooms/room/rates/rate/cancellation Policies bookingcancellationrs/hotel/rooms/room/rates/rate/policy ount m elamount Int Int Array of policies elements Element Date Floar リクエストされた客室ごとの大人の人数 リクエストされた客室ごとの子供の人数 キャンセルポリシーのリスト キャンセルポリシー 日付以後に課金される料金 クライアントのキャンセルによる課金開始日付 日付以降にホテル通貨で課金される料金 ( ホテルでのお支払いモデル向け ) 認証プロセス コンテンツ検索エンジン空室状況ホテル詳細予約を確認する前確認バウチャー 認証プロセスは 予約 API が当社クライアントのサイトまたはアプリケーションにおいて正確に使用されているかどうかを検証します それは クライアントによって表示される情報は Hotelbeds の規格と当社のホテルパートナーの要件に沿ったものであることを保証します 我々のチームは つねにできるだけスムーズに このプロセスを実行するために すべての必要なサポートを提供しようとします このプロセス中に疑問を持っているか 問題が発生した場合は こちらにご連絡ください 142

143 検索エンジン 我々のチームは まず検索エンジンを検査し 応答にすべての国 / 目的地が表示されているかどうかを判断します 表示されていない場合は それれのシステムはすべての目的地が表示表示されていない理由を 我々のクライアントに求めます そして 具体的に特定目的地が受け入れられない原因は 商業的な意思決定の結果にあるかどうかを把握します 我々は 検証プロセスを開始する前に この種の商業的決定を知らされていることが極めて重要です 我々は 検索エンジンが客室あたりの宿泊の大人と子供の数が表示しているかどうか および子供の年齢がリクエストされているかどうかを検証します 予約プロセス中に 子供の年齢は変更できません 我々はまた エンジンにおいていかなる適用できない可能性のある追加の検索フィルタがあるかどうかを検査します 空室状況 我々のチームは XML または JSON 経由で提供する商品全体が正しく表示されているかどうかを検証します ; 価格 客室の数 日付 ホテル 食事タイプ 客室タイプ ホテルの評価 ( 星評価 アパート 別荘 アパート式ホテル ) またページ区切りの正しい実行と表示を含みます 認証プロセスにおいて問題としてこれを強調表示するのを防止するため 我々は すべての客室タイプ 食事タイプとホテルを含んでいないいかなる商業的な理由を 知らされているが重要です 143

144 同じ宿泊人数の複数の客室のリクエストについては 空室状況リクエスト / 共同宿泊 / 一人宿泊 /@ 客室 を使用することは非常に重要です 我々はまた お客様の数が異なる客室 またはお客様の数が同じで子供の年齢が異なる客室の場合において お客様のノードを分割することをおすすめします このような場合には 宿泊人数ノードを複製する必要があります 144

145 ホテル詳細 ホテルの詳細は すべての Hotelbeds クライアントに必須です これらのデータは コンテンツ API を使用して クライアントシステムに格納する必要があります 145

146 クライアントシステムは 要件に応じて頻繁に更新できますが 我々は 最低でも週に 1 度お使いのシステムのデータベースを更新することをおすすめします データベースの最後のコンテンツ API の更新後に作成されたため ホテルがデータベースに表示されない場合は ホテルのすべての情報 ( 住所 ディスクリプション 施設 写真 客室施設など ) を表示するホテルの詳細機能を使用してください 追加料金が必要な施設を含みます ホテル施設料金は ホテル施設のリクエストが行われた時に ( ホテル操作において ) コンテンツ API で確認できます そのうち 真 または 偽 値を含む 料金 属性は お客様に当該施設は料金を払う必要があるかどうかをお知らせることができます クレームを防止するため すべての場合において お客様に追加料金をお知らせるべきです 予約を確認する前 評価コメント ( 評価コメント ID ディスクリプション ) は 予約前に 予約の要約およびバウチャー上に表示されなければなりません これは ホテル経営者からお客様に提供した重要な情報であり 客室情報とともに含まれている必要があります 評価コメントは 料金チェックリクエストと予約リクエストで提供されます 空室状況リクエストから評価コメント ID を取得し コンテンツ API を使用して 適切な方法でディスクリプションを取得するオプションも用意されています テスト環境において 目的地 AND( アンドラ ) または BKK ( バンコク ) で検索するホテルの大半は 評価コメントがあります クライアントの詳細と子供の年齢もチェックします 子供の年齢は 検索エンジンを使用して入力された場合 予約の流れにおいて任意に変更できません 146

147 予約は 確認のための準備ができたら すべての情報が正しく表示されるはずです 今後かかわる情報の商品 サービスまたは目的地に関して問題が発生するのを回避するため 各客室にお客様の名前を入力することが必須です 必須ではありませんが 我々はまた 予約を確認する前にいかなるキャンセルポリシーとホテルに影響を与える可能性のある問題 ( 問題 ノードはコンテンツ API におけるホテル操作で返される ) をお客様に知らせることをおすすめします 価格は 各ステップにおいてチェックする必要があります ( 空室状況リクエスト 料金チェックリクエスト ( ある場合 ) と予約リクエスト ) 料金 割引 追加料金または他のいかなる条件は最近変更した場合 システムが ( 空室状況を ) 検索する時に時々誤算の価格を返す可能性があることを心にお留めておいてください ご注意 : キャンセル料を決定するために使用される日付と時間は お客さまのローカルタイムではなく 予約の目的地の日付と時間に依存します 147

148 確認バウチャー バウチャーには サプライヤー ( 予約請求書を発行した者 ) の情報 例えばサプライヤーの名称と増値税番号などを表示されなければなりません それは により予約し支払う 文で明らかにしなければなりません この情報は 予約リクエストによって提供されます Hotelbeds の予約番号が強調表示されなければなりません お客様の名前 ( 客室ごとに少なくとも大人 1 名様 ) 子供の年齢 目的地 チェックイン / チェックアウト日付 客室タイプ 食事タイプ ホテルの詳細 ( 住所 電話とカテゴリ ) すべてが示されなければなりません 148

149 ご注意 : 我々は標準の予約手続きのワークスフロー ( 空室状況リクエスト 料金チェックリクエスト ( 必要の場合 ) と予約リクエスト ) をチェックしますので 上記方式以外の機能 ( 例えば 予約キャンセルポリシー キャンセル 変更 ) をチェックする希望がございましたら 認証プロセスが始まる前にお知らせください 確認バウチャー コンテンツバウチャーに重要な情報を表示する お客様が必要とするすべての情報は正しく表示されなければなりません 認証プロセスにおいて検証を行います 予約情報は 予約確認または予約詳細の応答に提供されます バウチャーに重要な情報を表示する バウチャーには サプライヤー ( 予約請求書を発行した者 ) の情報 例えばサプライヤーの名称と増値税番号などを表示されなければなりません それは により予約し支払う 文で明らかにしなければなりません Hotelbeds の予約番号が強調表示されなければなりません 次の予約情報が表示されなければならないと明記されること お客様の名前 ( 客室ごとに少なくとも 1 名様 ) 子供の年齢目的地チェックイン / チェックアウト日付客室タイプ食事タイプ ホテルの詳細 ( 住所 電話とカテゴリ ) 149

150 評価コメント詳細リクエスト コンテンツ返される評価コメントの位置ご自分の評価コメント詳細を取得 評価コメント ( 契約コメントともいう ) は ホテル経営者から提供され 予約を確認する前にお客様に示されなければなりません 返される評価コメントの位置 150