Contents API キーを認証... 5 API キーを登録... 5 認証... 7 X - 署名を取得する方法... 7 予約 API Hotelbeds プライシングモデル 料金チェックと予約メソッドにおけるプライシング属性 空室状況の応答... 19

Transcription

1 予約 API BookingAPI 1

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

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

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

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

6 ステップ 3 呼び出しを行うためにご自分の API キーを生成します このステップでは API パッケージを選択し サービス約款に同意する必要があります ステップ 4 ご自分の API キーを受け取った後 ドキュメントを閲覧し 当社の API で予約する方法 サンドボックスでリクエストを行う方法と当社システムを統合するために準備する方法を把握することを確認してください この時点で Postman を使用して当社のワークフローの例を実行することができます : 6

7 Postman において実行する 実行した後 Postman においてグローバル環境を編集し ご自分の API キーと API シークレットを追加する必要があります そして 我々の空室状況をテストし リクエストをチェックと確認することができます 認証 認証する時 以下のヘッダーを送信してください : ヘッダーの名称 値 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); 7

8 // 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(); 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"; 8

9 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); 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().u nix()))) signature := hex.encodeto(hasher.sum(nil)) // Example of call to the API endpoint := " // Creating GET Request with headers 9

10 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" # 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) 10

11 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 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"]; 11

12 [request setvalue:apikey [request // 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; 12

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

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

15 / 状態 このメソッドは API の現在の状態を提供します Hotelbeds プライシングモデル コンテンツ通貨プライシングモデルネット価格コミッションおすすめのネット価格 Liberate( 現地決済 ) 空室状況メソッドにおけるプライシング属性キャンセルポリシーにおけるプライシング属性料金チェックと予約メソッドにおけるプライシング属性 予約 API では いくつかのプライシングノードと属性を有します そのうちの一部は ある特定のプライシングモデルと一致するものであるため メソッドの応答に表示されない場合があります 当社プライシングモデルに関する詳細については Hotelbeds 担当セールスマネージャーにお問い合わせください セールスマネージャーにより お客様のニーズに応じて最適なソリューションをおすすめいたします 通貨 15

16 異なるプライシングモデルに対して すべての目的地において同じ通貨を使用しても可能です または目的地によって最大 3 つの異なる通貨 ( ユーロダラー ドル ポンド ) が提供されます ホテルでのお支払いモデル (Liberate) は クライアント通貨とホテル通貨 ( ホテルに到着時に支払うのに使用される ) で示されます プライシングモデル ネット価格 提供された価格は正味価格であり クライアントはご自分のマークアップを追加できます ただし 販売価格がホテル側のおすすめであか (hotelmandatory 属性で示される ) または Liberate( ホテルでのお支払い ) 価格において 正味価格にくわえて さらに一つの販売価格が提供されるということになります それが hotelmandatory である場合 販売価格属性を適用することを推奨します コミッション このモデルにおいて コミッションはすでに提供した最終的価格に含まれています 価格はつねに最終的な価格です Liberate( 現地決済 ) 価格は最終的な価格です このモデルは 上記 2 つのモデル ( ネット価格またはコミッションモデル ) のうちの任意の一つと併用することができます 空室状況メソッドにおけるプライシング属性 正味価格モデル コミッションモデル Liberateモデル 属性 net Yes Yes Yes 16

17 discount No No No comission No Yes No sellingrate hotelmandatory* hotelmandatory の場合 = 真 販売価格が必須である場合 ホテルによって決定される Yes 販売価格が必須である場合 ホテルによって決定される dailynet Yes No No dailysellingrate hotelmandatoryの場合 = 真 Yes Yes hotelsellingrate** No No Yes hotelcurrency** No No Yes Yes 販売価格が必須である場合 ホテルによって決定される * 値が 真 である場合のみ hotelmandatory 属性が返されます ** Liberate モデルはすべてのモデルと混合することができます キャンセルポリシーにおけるプライシング属性 正味価格モデル コミッションモデル Liberateモデル 属性 amount Yes Yes Yes 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> 17

18 <rate ratekey=" H STU.C1 CG-TODOS SC 1~1~0 N# "rateClass="NOR"rateType="BOOKABLE"net=" "comission="10.00"sellingRate=" "hotelSel lingrate=" "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 18

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

20 XML または JSON フィードを減らす最善の方法については リンク をクリックして詳細に参照するか 当社のサポート担当にお問い合わせください 応答パラメータ ノード / 属性 タイプ ディスクリプション availabilityrs Element トップ要素 availabilityrs/auditdata Element 関連する内部情報 availabilityrs/auditdata/@processtime Float サーバの処理時間をミリ秒単位で表示 availabilityrs/auditdata/@time Date リクエストが処理される日付 / 時刻 ( 常にスペインの時間で表示 ) availabilityrs/auditdata/@serverid サーバコードまたは ID( 内部用 ) availabilityrs/auditdata/@environment リクエストが送信と処理された環境 availabilityrs/hotels Array of hotel elements 空室のあるホテルリスト availabilityrs/hotels/@total Int 返されるホテルの数 チェックイン日付 availabilityrs/hotels/@checkin availabilityrs/hotels/@checkout availabilityrs/hotels/hotel Date Date Element フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) チェックアウト日付 フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) ホテル及び関連料金についての情報を含む要素 20

21 availabilityrs/hotels/hotel/keywords Array of keyword elements キーワード要素リスト availabilityrs/hotels/hotel/keywords/keyword Element キーワードに関する情報を含む要素 Int キーワードコード Int キーワード評価 ホテルの名称 Int Hotelbeds 内部ホテルコード ホテルの住所 ホテルのカテゴリコード カテゴリの名称 ホテルの位置の目的地コード ホテルの位置の目的地名称 ホテルの位置の区域名称 Int ホテルの位置の区域コード Float 地理的位置の緯度データ Float 地理的位置の経度データ クライアント通貨 Float 最大のホテル客室の価格 Float 最小のホテル客室の価格 Int Giataホテルコード クライアント通貨 21

22 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 Array of room elements 現地決済 オンラインカード決済 特定ホテルの空室リスト availabilityrs/hotels/hotel/rooms/room/ Element 客室および関連料金についての情報を含む要素 availabilityrs/hotels/hotel/rooms/room/@code Int 内部客室コード availabilityrs/hotels/hotel/rooms/room/rates Array of rates 料金リスト availabilityrs/hotels/hotel/rooms/room/rates/rate Element 料金要素 availabilityrs/hotels/hotel/rooms/room/rates/rate/@ratecom mentsid availabilityrs/hotels/hotel/rooms/room/rates/rate/@ratekey availabilityrs/hotels/hotel/rooms/room/rates/rate/@rateclass Int この料金に関連したコメント確認に使用される内部価格キー内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 22

23 予約は 以下の 2 つのステップ (BOOKABLE) または 3 つのステップ (RECHECK) で確認することができます availabilityrs/hotels/hotel/rooms/room/rates/rate/@payment Type ホテルでのお支払いモデルであるかまたはマーチャントモデルであるかを識別します availabilityrs/hotels/hotel/rooms/room/rates/rate/@packagin g 料金はパッケージ商品に対するものであるかどうかを識別する availabilityrs/hotels/hotel/rooms/room/rates/rate/@boardco de 内部食事コード availabilityrs/hotels/hotel/rooms/room/rates/rate/@boardna me 食事の名称 availabilityrs/hotels/hotel/rooms/room/rates/rate/@net Float 客室の正味価格 availabilityrs/hotels/hotel/rooms/room/rates/rate/@sellingr ate availabilityrs/hotels/hotel/rooms/room/rates/rate/@comissio n availabilityrs/hotels/hotel/rooms/room/rates/rate/@comissio nvat availabilityrs/hotels/hotel/rooms/room/rates/rate/@comissio npct availabilityrs/hotels/hotel/rooms/room/rates/rate/@hotelsell ingrate availabilityrs/hotels/hotel/rooms/room/rates/rate/@hotelcur rency availabilityrs/hotels/hotel/rooms/room/rates/rate/@hotelma ndatory Float Float Float Float Float Boolean 客室の総価 ( 含まれている場合 ) コミッションモデルに対するコミッション コミッション増値税 コミッションの割合 ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 価格が推奨されているかどうかを識別 23

24 t availabilityrs/hotels/hotel/rooms/room/rates/rate/@rooms availabilityrs/hotels/hotel/rooms/room/rates/rate/@adults availabilityrs/hotels/hotel/rooms/room/rates/rate/@children Int availabilityrs/hotels/hotel/rooms/room/rates/rate/@children 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 Rate/@checkIn availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift Rate/@checkOut availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift Rate/@rateKey availabilityrs/hotels/hotel/rooms/room/rates/rate/shifts/shift Rate/@rateClass Int Int Int Array of shift elements Element Date Date 特定客室タイプの空室の数同じ宿泊人数のリクエストされた空室の数客室における宿泊可能な大人の数リクエストされた子供の人数子供の年齢 コンマで区切られるチェックイン日付が柔軟な空室の料金リストチェックイン日付が柔軟な空室と料金に関する情報を含む要素チェックイン日付 フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) チェックアウト日付 フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) 確認に使用される内部価格キー内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 24

25 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 Float Float Float Float Boolean Int Int 値がBOOKABLEである場合 すぐにご予約することができます 値が RECHECKである場合 まずは 料金チェック メソッドで再確認する必要があります ホテルでのお支払いモデルであるかまたはマーチャントモデルであるかを識別します 料金はパッケージ商品に対するものであるかどうかを識別する 内部食事コード 客室の正味価格 客室の販売価格 ( 含まれている場合 ) コミッション ( コミッションモデルである場合 ) ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 価格が推奨されているかどうかを識別特定客室タイプの空室の数このタイプのリクエストされた客室の数 25

26 26 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 Float 特定の日付以降に課金される料金 availabilityrs/hotels/hotel/rooms/room/rates/rate/cancellatio Date 料金が課金される開始日付 availabilityrs/hotels/hotel/rooms/room/rates/rate/cancellatio Float 特定の日付以降にホテル通貨で課金される料金 ( ホテルでのお支払いモデル向け ) availabilityrs/hotels/hotel/rooms/room/rates/rate/dailyprices /dailyprice/@offset Int 検索期限内の日数 availabilityrs/hotels/hotel/rooms/room/rates/rate/dailyprices /dailyprice/@dailysellingrate Float 客室の毎日の販売価格 availabilityrs/hotels/hotel/rooms/room/rates/rate/dailyprices /dailyprice/@dailynet Float 毎日の正味価格 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 Float 特典の金額 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 プロモーション情報を含む要素

27 availabilityrs/hotels/hotel/rooms/room/rates/rate/promotions availabilityrs/hotels/hotel/rooms/room/rates/rate/promotions availabilityrs/hotels/hotel/rooms/room/rates/rate/promotions Array of availabilityrs/hotels/hotel/rooms/room/rates/rate/taxes tax elements Int プロモーションコードプロモーションの名称 プロモーション備考 税込みまたは税抜き価格のリスト 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> 27

28 JSON の例 "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": " ", 28

29 "currency": "EUR" ], "checkin": " ", "checkout": " ", "total": 2 29

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

31 GPS 座標で検索 "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" 31

32 ホテルリストで検索 "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 ] ], "hotels": "hotel": [ 2643,

33 ] 子供を含む検索 "stay": "checkin": " ", "checkout": " ", "shiftdays": "1", "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", 33

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

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

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

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

38 "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": " ", "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": " " ] ] 38

39 ], "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": [ "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, 39

40 "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": " " ] ] ], "minrate": " ", "maxrate": " ", "currency": "EUR" ], "checkin": " ", "checkout": " ", "total": 1 40

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

42 XML の例 目的地でリクエスト <availabilityrqxmlns=" / <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> 42

43 子供を含むリクエスト xmlns:xsi=" > <stay checkin=" " checkout=" " shiftdays="1"/> <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> 43

44 </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"> <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"/> 44

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

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

47 ] [...] ], "type": "AD", "age": 30, "name": "Tomeu", "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, 47

48 ], "name": "AdultName", "surname": "Surname", "type": "AD", "age": 30, "name": "AdultName", "surname": "Surname", "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 48

49 ] [...] "rooms": 1, "adults": 3, "children": 0 確認 [...] "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" ], "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" 49

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

51 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> [...] 51

52 オプション 2- 確認リクエスト [...] <rooms> <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> <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 52

53 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> [...] ご注意 : 同時に異なるホテルにおける異なる価格キーを確認することができません ただし 同じホテルの客室タイプを混合することが可能です 53

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

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

56 , "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": , "secondarylatitude": , "secondarylongitude": キーワードで検索 ノード / 属性 タイプ 必須かどうか ディスクリプション 56

57 availabilityrq/keywords/ Array of keyword element N すべてのキーワードがホテルに含まれていなければならない場合 値は真です availabilityrq/keywords/@allincluded boolean Y 真 = すべてのキーワードは ホテルリストに含まれていなければなりません availabilityrq/keywords/keyword Int N 偽 =すべてのキーワードは ホテルリストに含まれている必要がありません ファシリティコード pe": "AD", e": 30 pe": "AD", e": 30 pe": "CH", "stay":, "occupancies": [ "checkin": " ", "checkout": " ", "shiftdays": "2" "rooms": 1, "adults": 2, "children": 2, "paxes": [,, "ty "ag "ty "ag "ty 57

58 e": 8 pe": "CH", e": 8 pe": "AD", e": 30 pe": "CH", e": 8, ] "geolocation": "longitude": , "latitude": , "radius": 200, "unit": "km", "boards": "board": [ "SC", "HB" ], "included": true, "filter": "maxhotels": 10, "maxrooms": 5, "minrate": , "maxrate": , "maxratesperroom": 2, "keywords": "keyword": [ "allincluded": true ] "rooms": 1, "adults": 1, "children": 1, "paxes": [ ] 38 ],,, "ag "ty "ag "ty "ag "ty "ag 58

59 キーワードリスト : 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.- ホテルコードで検索 59

60 ノード / 属性 タイプ 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 Float N 検索された最低価格 availabilityrq/filter/@maxrate Float 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", "filter": "minrate": , "maxrate": 食事コードで検索 60

61 ノード / 属性 タイプ 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 であるか エクストラノードが追加されていない場合 応答は 価格内訳を含みません "dailyrate": true, "stay": "checkin": " ", 61

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

63 7.- カテゴリで検索 ノード / 属性 タイプ 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": [ 63

64 "type": "AD", "age": 30, "type": "CH", "age": 8 ] ], "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, 64

65 "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30 ] ], "destination": "code": "PMI", "zone": "90", "filter": "paymenttype": "AT_HOTEL" 9.- 宿泊タイプで検索 必須かノード / 属性タイプどうか Array of accommodations availabilityrq/accommodations N element accommodation/accommodation 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" ] 65

66 10.- レビュー評価でフィルタする ノード / 属性 タイプ ディスクリプション availabilityrq/reviews Array of review elements レビューリストを含む availabilityrq/review Element レビュー要素 レビュータイプ 例 : availabilityrq/review/@type TRIPADVISOR HOTELBEDS availabilityrq/review/@maxrate Float 最高評価 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, 66

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

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

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

70 "paxes": [ "type": "AD", "age": 30, "type": "AD", "age": 30 ] ], "destination": "code": "PMI", "zone": "90", "rooms": "included": "TRUE", "room": [ DB.ST ] 70

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

72 ノード / 属性 タイプ availabilityrq/geolocation/@longitude Float N 必須かどディスクリプションうか 地理的位置の経度データ availabilityrq/geolocation/@latitude Float N 地理的位置の緯度データ availabilityrq/geolocation/@longitude Float N availabilityrq/geolocation/@latitude Float 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 72

73 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 キーワードリスト : 29 ロマンティックホテル 31 設計 34 ビジネスホテル 36 ゴルフホテル 37 ビーチ周辺ホテル 38 都市 39 SPA を備えたホテル 42 歴史 43 スキーホテル 44 農村ホテル 45 スポーツホテル 81 ファミリーホテル 83 インターネット 73

74 84 車椅子の使用に便利 85 レストラン 86 SPA 87 駐車 88 テレビ 89 ジム 90 エアコン 92 暖房 100 魅力のあるホテル 101 スイミングプール 3.- ホテルコードで検索 ノード / 属性 タイプ availabilityrq/hotels/hotel Int N 必須かどうか ディスクリプション リクエストされたホテルコードはリストすることができます ( ホテルコードに必要な可能な限り多くのノードが提供されています ) <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.- 最低価格および / または最高価格で検索 ノード / 属性 タイプ必須かどうかディスクリプション 74

75 Float N 検索された最低価格 availabilityrq/filter/@maxrate Float 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 必須かどうか ディスクリプション 真 の場合は 応答がリストに含まれている食事のみを返します ; 偽 の場合は 食事タイプのリストが除外されます 食事タイプのリスト <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> 75

76 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"/> </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> <filter mincategory="3" maxcategory="5"/> </availabilityrq> 76

77 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.- 宿泊タイプで検索 必須かノード / 属性タイプどうか Array of accommodations availabilityrq/accommodations N element accommodation/accommodation N ディスクリプション 応答においてフィルタされる宿泊施設のリスト応答においてフィルタされる宿泊施設コード 77

78 <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 Float 最高評価 availabilityrq/review/@minrate Floai 最低評価 availabilityrq/review/@minreviewcount Int レビューの最小数 11.- 各ホテルの客室の数を制限する ノード / 属性 タイプ ディスクリプション 表示されるホテルごとの客室の最大数 availabilityrq/filter/@maxrooms Int 78

79 <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> 79

80 13.- パッケージ商品に対して料金をフィルタ 追加または削除する ノード / 属性タイプディスクリプションフィルタは パッケージ商品のための料金を受け取 availabilityrq/filter/@packaging Boolean るか または除外するために使用されています <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.- 客室タイプで検索 ノード / 属性タイプディスクリプション Array of 客室コード付きの客室ノード配列 availabilityrq/rooms rooms 客室には ( 真 ) が含まれるか ( 偽 ) が availabilityrq/rooms/@included Boolean 除外されなければならないかを示します availabilityrq/rooms/room 客室タイプコード <availabilityrq xmlns=" xmlns:xsi=" <stay checkin=" " checkout=" "/> <occupancies> 80

81 <occupancy rooms="1" adults="1" children="0"/> </occupancies> <geolocation longitude=" " latitude=" " radius="20" unit="km"/> <filter packaging="true"/> </availabilityrq> 81

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

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

84 ホテル料金チェックの応答 コンテンツお客様にお知らせる重要な情報プロモーションと割引アップセリングのオプション 料金チェックメソッドの応答は 空室状況応答に提供されたものと同じな情報が含まれていますが 特定のホテルと料金に関する情報のみを返します このメソッドの目的は あらゆる特定ホテル / 料金の空室状況と価格を再確認することです このメソッドで取得した価格は常に最新価格です ; いくつかの他の情報を含みます : 料金の内訳 コメント契約 ( 詳細は に参照してください ) とアップセリングオプション telbeds.com/docs/read/apitude_content/use_of_rate_comments お客様にお知らせる重要な情報 予約を確認する前にお客様に示されるべきホテルが提供した重要な情報が含まれているため 評価コメント属性を確認することが重要です プロモーション 割引と追加料金 返される価格内訳内の価格は すでにプロモーションと割引を含みます また 追加料金は 料金チェック応答に含まれています [...] <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> 84

85 <ratebreakdown> <ratediscounts> <ratediscount code="lmd" name="last Minute discount" amount=" "/> </ratediscounts> </ratebreakdown> </rate> [...] アップセリングのオプション 応答は アップセリングノードも含みます このノードはそれぞれの価格キーで同じホテルでの追加客室オプションを提供します 価格キーは 特定キーを定義するための内部識別子です 確認ステップにおいて希望の料金を選択するために使用されています [...] <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> [...] 85

86 応答パラメータ ノード / 属性 タイプ ディスクリプション checkraters Element トップ要素 checkraters/auditdata Element 関連する内部情報 checkraters/auditdata/@processtime Float サーバの処理時間をミリ秒単位で表示 checkraters/auditdata/@time Date リクエストが処理される日付 / 時刻 checkraters/auditdata/@serverid サーバコードまたはID( 内部用 ) checkraters/auditdata/@environment リクエストが送信と処理された環境 checkraters/hotel Element ホテル及び関連料金についての情報を含む要素 checkraters/hotel/@checkin Date チェックイン日付 checkraters/hotel/@checkout Date チェックアウト日付 checkraters/hotel/@name ホテルの名称 checkraters/hotel/@code Int Hotelbeds 内部ホテルコード checkraters/hotel/@description ホテルの住所 checkraters/hotel/@categorycode ホテルのカテゴリコード checkraters/hotel/@categoryname カテゴリの名称 checkraters/hotel/@destinationcode ホテルの位置の目的地コード checkraters/hotel/@destinationname ホテルの位置の目的地名称 checkraters/hotel/@zonecode Int ホテルの位置の区域コード 86

87 87 ホテルの位置の区域名称 Float 地理的位置の緯度データ Float 地理的位置の経度データ クライアント通貨 Float ホテルの客室の最高価格 Float ホテルの客室の最低価格 Int Giata ホテルコード クライアント通貨 checkraters/hotels/creditcards Array of credit cards ホテルでお支払い モデルにおいて使用可能なクレジットカードのリスト checkraters/hotels/creditcards/creditcard Element クレジットカードに関する情報を含む要素 Int クレジットカードコード クレジットカード名称 pe お払いのタイプ現地決済オンラインカード決済 checkraters/hotel/rooms Array of room elements 特定ホテルの空室リスト checkraters/hotel/rooms/room/ Element 客室および関連料金についての情報を含む要素

88 Int 内部客室コード 客室の名称 e 確認に使用される内部価格キー内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 予約は 以下の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 Float 客室の正味価格 checkraters/hotel/rooms/room/rates/rate/@sellingrate Float 客室の総価 ( 含まれている場合 ) checkraters/hotel/rooms/room/rates/rate/@comission Float 代理のコミッション checkraters/hotel/rooms/room/rates/rate/@comissionpc T checkraters/hotel/rooms/room/rates/rate/@comissionva t Float Float コミッションの割合コミッション増値税 88

89 Rate y ory checkraters/hotel/rooms/room/rates/rate/@rooms checkraters/hotel/rooms/room/rates/rate/@children Float Boolean s checkraters/hotel/rooms/room/rates/rate/cancellationpol icies checkraters/hotel/rooms/room/rates/rate/cancellationpol icies/policy checkraters/hotel/rooms/room/rates/rate/cancellationpol checkraters/hotel/rooms/room/rates/rate/cancellationpol checkraters/hotel/rooms/room/rates/rate/cancellationpol Int Int Int Int Array of policies elements Element Float Date Floar checkraters/hotel/rooms/room/rates/rate/ratebreakdown Element ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 価格が推奨されているかどうかを識別特定客室タイプの空室の数同じ宿泊人数のリクエストされた空室の数リクエストされた客室ごとの大人の人数リクエストされた客室ごとの子供の人数重要な情報を含む評価コメント キャンセルポリシーのリスト キャンセルポリシー要素日付以後に課金される料金料金が課金される開始日付特定の日付以降にホテル通貨で課金される料金 ( ホテルでのお支払いモデル向け ) 価格内訳要素 89

90 90 checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratediscounts Element 割引要素 checkraters/hotel/rooms/room/rates/rate/ratebreakdown Float 割引金額 checkraters/hotel/rooms/room/rates/rate/ratebreakdown Int 割引コード checkraters/hotel/rooms/room/rates/rate/ratebreakdown 割引の名称 / ディスクリプション checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratesupplements Element 追加料金要素 checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratesupplements/ratesupplement/@amount Float 追加料金金額 checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratesupplements/ratesupplement/@code Int 追加料金の内部コード checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratesupplements/ratesupplement/@from Date 追加料金が課金される開始日付 checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratesupplementsratesupplement//@to Date 追加料金の課金が停止される日付 checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratesupplements/ratesupplement/@nights Int 追加料金が課金される宿泊日数 checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratesupplements/ratesupplement/@paxnumber int 追加料金に影響されるお客様の数 checkraters/hotel/rooms/room/rates/rate/ratebreakdown /ratesupplements/ratesupplement/@paxtype 影響されるお客様のタイプ checkraters/hotel/rooms/room/rates/rate/offers Array of offer elements 特典リスト checkraters/hotel/rooms/room/rates/rate/offers/offer Element 特典情報を含む要素 checkraters/hotel/rooms/room/rates/rate/offers/offer/@c ode Int 特典コード checkraters/hotel/rooms/room/rates/rate/offers/offer/@a mount Float 特典の金額 checkraters/hotel/rooms/room/rates/rate/offers/offer/@n ame 特典の名称 checkraters/hotel/rooms/room/rates/rate/promotions Array of promotion elements 特定価格のプロモーションリスト

91 checkraters/hotel/rooms/room/rates/rate/promotions/pro motion checkraters/hotel/rooms/room/rates/rate/promotions/pro checkraters/hotel/rooms/room/rates/rate/promotions/pro Element Int checkraters/hotel/rooms/room/rates/rate/promotions/pro Array of checkraters/hotel/rooms/room/rates/rate/taxes tax elements Boolean uded checkraters/hotel/rooms/room/rates/rate/taxes/tax cluded port Element Boolean Float Float elimport elcurrency Float centage checkraters/hotel/upselling ekey eclass Array of rooms プロモーション情報を含む要素プロモーションコードプロモーションの簡単ディスクリプションプロモーション備考 税込みまたは税抜き価格のリスト すべての税金を含むかどうかを表示税金に関する情報を含む要素価格に税金が含まれているどうかを表示 税金の値 ホテル通貨での税金の値 ( 価格に税金が含まれていない場合 ) ホテル通貨 現地決済のパーセンテージ選択されたもの以外の使用可能な客室オプション確認に使用される内部価格キー内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 91

92 etype ymenttype ckaging ardcode ardname Float Float lingrate mission Float Float elsellingrate elcurrency Boolean elmandatory otment Int ms ults Int Int 客室が空室であるかどうかホテルでのお支払いであるかまたはマーチャントであるかを識別する料金はパッケージ商品に対するものであるかどうかを識別する 内部食事コード 食事の名称 客室の正味価格客室の総価 ( 含まれている場合 ) コミッションモデルに対するコミッションホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 価格が推奨されているかどうかを識別特定客室タイプの空室の数このタイプのリクエストされた客室の数客室ごとの宿泊可能な大人の数 92

93 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 Float Array of policies elements Element Float Date Float リクエストされた客室ごとの子供の人数重要な情報を含む評価コメントオリジナルの価格とアップセリング価格との差 キャンセルポリシーのリスト キャンセルポリシー要素日付以後に課金される料金料金が課金される開始日付特定の日付以降にホテル通貨で課金される料金 ( ホテルでのお支払いモデル向け ) "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", 93

94 "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, "adults": 2, "children": 2, "childrenages": "8~8" ] ], "totalsellingrate": " ", "totalnet": "0.000", "currency": "EUR" 94

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

96 "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, "adults": 2, "children": 2, "childrenages": "8~8" ] ], "totalsellingrate": " ", "totalnet": "0.000", "currency": "EUR" アップセリングの応答例 96

97 "auditdata": "processtime": "128", "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, 97

98 "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@ ", "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" ] ] 98

99 - XML の例 シングルレートのチェック リクエスト <checkraterq xmlns=" xmlns:xsi=" > <rooms> <room ratekey="6914 DUS.ST CG- TODOS1 1 HB 1~1~ W N# "/> </rooms> </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"/> 99

100 </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"/> <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"> 100

101 <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> 101

102 ホテル確認リクエスト コンテンツ保有者とお客様の名前 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 確認される客室 102

103 前のステップで取られた確認される価格キー 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 Element 支払い情報 支払いタイプ= 現地決済 の場合 本ノードを使用しなければなりません クレジットカードタイプ bookingrq/paymentdata/paymentcard/cardtype VISA AMEX MAESTRO bookingrq/paymentdata/paymentcard/cardnumber Int クレジットカード番号 bookingrq/paymentdata/paymentcard/expirtydate Int クレジットカードの有効期間 bookingrq/paymentdata/paymentcard/cardcvc Int クレジットカードCVCセキュリティコード bookingrq/paymentdata/contactdata/ お客様のメールアドレス bookingrq/paymentdata/contactdata/phonenumber お客様の電話番号 103

104 ご注意 : ホテルでのお支払い (LIBERATE) モデルだけにおいて支払いデータノードを使用してください その他のプライシングモデルにおいては これらのノードを使用してはいけません 104

105 リクエストの例 <?xml version="1.0" encoding="utf-8"?> <bookingrqxmlns=" / <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=" <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=" "minPrice=" "> <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 105

106 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"packa ging="false"boardcode="ro- E10"net=" "gross=" "currency="EUR"rooms="1"> <taxes> <tax included="true"percent="10.00"currency="eur"/> </taxes> </price> </prices> </room> </rooms> <supplier name="hotelbeds PRODUCT,S.L.U."vatNumber="B "/> </hotel> </booking> </bookingrs> 106

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

108 予約の作成日 Date フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) bookingrs/booking/@creationdate 予約の作成日 bookingrs/booking/@totalnet Float 予約の合計額 bookingrs/booking/@currency 支払うべき金額の通貨 チェックイン日付 bookingrs/booking/@checkin Date フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) bookingrs/booking/@remark お客様備考 チェックアウト日付 bookingrs/booking/@checkout Date フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) ホテル及び関連料金 bookingrs/hotel Element についての情報を含 む要素 bookingrs/hotel/@name ホテルの名称 bookingrs/hotel/@code Int 内部ホテルコード bookingrs/hotel/@category ホテルのカテゴリ bookingrs/hotel/@categoryname カテゴリの名称 bookingrs/hotel/@destination ホテルの位置の目的地コード bookingrs/hotel/@destinationname ホテルの位置の目的地名称 bookingrs/hotel/@zonecode Int ホテルの位置の区域コード bookingrs/hotel/@zonename ホテルの位置の区域名称 bookingrs/hotel/@longitude Float 地理的位置の経度データ 108

109 Float 地理的位置の緯度データ クライアント通貨 bookingrs/hotels/hotel/rooms Array of room elements 特定ホテルの空室リスト bookingrs/hotels/hotel/rooms/room/ Element 客室および関連料金についての情報を含む要素 予約状況 : bookingrs/hotel/rooms/room/@status 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) で確認することができますホテルでのお支払いであるかまたはマーチャントであるかを識別する料金はパッケージ商品に対するものであるかどうかを識別する 109

110 内部食事コード Float 客室の正味価格 Float 客室の総価 ( 含まれている場合 ) bookingrs/hotel/rooms/room/rates/rate/@agcomission Float 代理のコミッション bookingrs/hotel/rooms/room/rates/rate/@comissionvat Float コミッション増値税 bookingrs/hotel/rooms/room/rates/rate/@comissionpct Float コミッションの割合 bookingrs/hotel/rooms/room/rates/rate/@hotelsellingrate Float ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) bookingrs/hotel/rooms/room/rates/rate/@hotelcurrency ホテル通貨 ( ホテルでのお支払いモデル向け ) bookingrs/hotel/rooms/room/rates/rate/@hotelmandatory Boolean 販売価格であるどうかを確認 bookingrs/hotel/rooms/room/rates/rate/@rooms Int 同じ宿泊人数のリクエストされた空室の数 bookingrs/hotel/rooms/room/rates/rate/@adults Int リクエストされた客室ごとの大人の人数 bookingrs/hotel/rooms/room/rates/rate/@children Int リクエストされた客室ごとの子供の人数 bookingrs/hotel/rooms/room/rates/rate/cancellationpolicies bookingrs/hotel/rooms/room/rates/rate/cancellationpolicies/ policy bookingrs/hotel/rooms/room/rates/rate/cancellationpolicies/ policy/@amount bookingrs/hotel/rooms/room/rates/rate/cancellationpolicies/ policy/@from bookingrs/hotel/rooms/room/rates/rate/cancellationpolicies/ policy/@hotelamount bookingrs/hotel/rooms/room/rates/rate/cancellationpolicies/ policy/@hotelcurrency Array of policies elements Element Float Date Float キャンセルポリシーのリスト 日付以後に課金される料金料金が課金される開始日付日付以降にホテル通貨で課金される料金 ( ホテルでのお支払いモデル向け ) ホテルに到着時に払う金額の通貨 bookingrs/hotel/rooms/rates/ratebreakdown Element 価格内訳要素 110

111 111 n Float 代理のコミッション t Float コミッションの割合 at Float コミッション税金 bookingrs/hotel/rooms/rates/ratebreakdown/ratesupplemen ts Element 価格の追加料金要素 bookingrs/hotel/rooms/rates/ratebreakdown/ratesupplemen Float 追加料金金額 bookingrs/hotel/rooms/rates/ratebreakdown/ratesupplemen Int 追加料金コード bookingrs/hotel/rooms/rates/ratebreakdown/ratesupplemen Date 追加料金が課金される開始日付 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 Float 割引金額 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 Float 特典の金額 name 特典の名称

112 Array of bookingrs/hotels/hotel/rooms/room/rates/rate/promotions promotion elements bookingrs/hotels/hotel/rooms/room/rates/rate/promotions/pr Element omotion bookingrs/hotels/hotel/rooms/room/rates/rate/promotions/pr 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 Int Array of tax elements 特定価格のプロモーションリスト プロモーション情報を含む要素 プロモーションコードプロモーションの名称 プロモーション備考 税込みまたは税抜き価格のリスト Boolean すべての税金を含むかどうかを表示 bookingrs/hotel/rooms/room/prices/taxes/tax Element 税金に関する情報を含む要素 Boolean 価格に税金が含まれているどうかを表示 Float 税金の値 t Float ホテル通貨での税金の値 ( 価格に税金が含まれていない場合 ) bookingrs/hotel/rooms/room/prices/taxes/tax/@hotelcurren cy ホテル通貨 bookingrs/hotel/rooms/room/prices/taxes/tax/@percentage Float 現地決済のパーセンテージ bookingrs/hotel/supplier Element サプライヤー情報を含む要素 bookingrs/hotel/supplier/@name サプライヤーの名称 サプライヤーの増値 bookingrs/hotel/supplier/@vatnumber Strung 税番号 112

113 <bookingrs xmlns:xsi=" tp:// <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> <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> <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", 113

114 "timestamp":" :32:35.702", "serverid":"ts", "environment":"[test]", "booking": "filenumber":" ", "checkin":" ", "checkout":" ", "creationdate":" ", "status":"booking", "totalamount":108.68, "currency": "EUR", "holder": "name":"integrationtestfirstname,integrat IONTESTLASTNAME", "surname":"", "hotel": "code":"284695", "name":"karina", "destination":"cfu", "zone":"26", "netprice":108.68, "rooms":[ "status":"confirmed", "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":

115 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"/> 115

116 </paxes> <rates> <rate ratename="cg-todos" paymenttype="at_web" packaging="false" boardcode="bb" boardname="bed AND BREAKFAST" rooms="1" rateclass="nor" net="81.400"> <cancellationpolicies> <cancellationpolicy amount="40.700" from=" t12:00:00+02:00"/> </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> 116

117 <pax type="ad" age="30" name="adult NAME" surname="adult SURNAAME"/> </paxes> </room> </rooms> </bookingrq> 応答 <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> 117

118 </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"> <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> 118

119 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" 応答 119

120 "auditdata": "processtime": "3340", "timestamp": " :34:25.748", "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" 120

121 ], "taxes": "taxes": [], "allincluded": true, "ratebreakdown": "ratesupplements": [ "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 " マルチレートの確認 リクエスト "holder": 121

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

123 応答 "auditdata": "processtime": "2733", "timestamp": " :01:52.148", "serverid": "ws3xmi02", "environment": "[itest, iset_b, ehcache]", "release": "4838", "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" 123

124 ], "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": [ "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": [ 124

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

126 予約リストと詳細のリクエスト コンテンツご予約の詳細を取得ご予約を検索する 予約リスト方式が GET リクエストである場合 以下二つの異なる場合に使用することができます : 予約リストを取得するある具体的な予約の詳細を取得する ご予約を検索する エンドポイント HTTP GET リクエストパラメータ パラメータ start end タイプ Date Y Date Y 必須かどうか ディスクリプション この方式で予約をチェックする開始日付 フォーマットはYYYY-MM-DD( 年 - 月 - 日 ) でなければなりませんこの方式で予約をチェックする終了日付 フォーマットは YYYY-MM-DD( 年 - 月 - 日 ) でなければなりません 126

127 includecancelled N このパラメーターはすべての予約を取得するために使用され キャンセルされた予約を含めるまたは除外することができます filtertype N 値 : Y はキャンセルされた予約を含むものであり N はキャンセルされた予約を除外するものです このパラメータは チェックイン日付でまたは予約の作成日で予約リストを取得することであるかどうかを識別するために使用されています CHECKIN: チェックイン日付で CREATION: 作成日で from Int Y 返される予約開始番号を から に指定 to Int Y 返される予約終了番号を まで に指定 リクエストの例 10&end= &filterType=CREATION&includeCancelled=true&from=1&to=25 ご予約の詳細を取得 エンドポイント HTTP GET リクエストパラメータ パラメータ タイプ 必須かどうか ディスクリプション 127

128 booking_reference Y 確認応答または予約リスト機能から取られた予約参照番号 フォーマット :XXX-XXXXXX リクエストの例 HTTP GET 128

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

130 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=" " 130

131 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> <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="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> 131

132 </room> </rooms> </hotel> </booking> </bookings> </bookinglistrs> 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 132

133 ] ], "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": " ", "checkout": " ", "name": "Castro Exclusive Residences Sant Pau", "destinationcode": "BCN", "rooms": [ "status": "CANCELLED", "code": "APT.1B-DP", "paxes": [ "type": "AD" 133

134 ], "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" ], "from": 1, "to": 25, "total": 119 応答パラメータ 134

135 ノード / 属性 タイプ ディスクリプション bookinglistrs Element トップ要素 bookinglistrs/auditdata Element 関連する内部情報 bookinglistrs/auditdata/@time Float サーバの処理時間をミリ秒単位で表示 bookinglistrs/auditdata/@processtime Date リクエストが処理される日付 / 時刻 bookinglistrs/auditdata/@serverid サーバコードまたはID( 内部用 ) bookinglistrs/auditdata/@environment リクエストが送信と処理された環境 bookinglistrs/bookings Array of booking 予約リスト elements bookinglistrs/bookings/@total Int 予約総数 予約参照番号 bookinglistrs/bookings/booking/@reference フォーマット : XX-XXXXXX 予約の作成日 bookinglistrs/bookings/booking/@creationdate Date フォーマット : YYYY-MM-DD ( 年 - 月 - 日 ) bookinglistrs/bookings/booking/@totalamount Float 予約の合計額 bookinglistrs/bookings/booking/@currency 支払うべき金額の通貨 予約状況 : bookinglistrs/bookings/booking/@status CONFIRMED CANCELLED bookinglistrs/bookings/booking/holder Element 保有者に関する情報要素 bookinglistrs/bookings/booking/holder/@name 保有者の名前 bookinglistrs/bookings/booking/holder/@surname 保有者の姓氏 135

136 bookinglistrs/hotel Element ホテル及び関連料金についての情報を含む要素 ホテルの名称 Int Hotelbeds 内部ホテルコード ホテルのカテゴリ ホテルの位置の目的地コード Int ホテルの位置の区域コード クライアント通貨 bookinglistrsbookings/booking//hotels/hotel/rooms Array of room elements 特定ホテルの空室リスト bookinglistrs/bookings/booking/hotels/rooms/room/ Element 客室および関連料金についての情報を含む要素 Int 内部客室コード checkavailrs/hotels/hotel/rooms/room/rates checkavailrs/hotels/hotel/rooms/room/rates/rate Array of rate elements Element 特定ホテルの価格リスト 客室タイプまたは食事の価格に関する情報チェックイン日付 Date Date フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) チェックアウト日付 フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) 136

137 Float Float Float Float Boolean 内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 予約は 以下の2つのステップ (BOOKABLE) または3つのステップ (RECHECK) で確認することができますホテルでのお支払いであるかまたはマーチャントであるかを識別する料金はパッケージ商品に対するものであるかどうかを識別する 内部食事コード 客室の正味価格 客室の総価 ( 含まれている場合 ) ホテル通貨での客室正味価格 ( ホテルでのお支払いモデル向け ) ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 販売価格であるどうかを確認 137

138 Int Int Int 同じ宿泊人数のリクエストされた空室の数リクエストされた客室ごとの大人の人数リクエストされた客室ごとの子供の人数 138

139 予約詳細の応答 コンテンツ 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=" "> surname="holder SURNAME"/> <holder name="holder NAME" <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> 139

140 <room status="confirmed" code="apt.1b" name="apartment"> <paxes> type="ad" age="30" surname="adult SURNAME"/> <pax type="ad" age="30" surname="adult SURNAAME"/> <pax </paxes> <rates> <rate ratename="cg-todos" paymenttype="at_web" packaging="false" boardcode="hb" boardname="half BOARD" rooms="1" rateclass="nor" net=" "> <cancellationpolicies> 140

141 from=" t23:59:00+02:00"/> <cancellationpolicy amount="72.060" </cancellationpolicies> allincluded="true"/> <taxes <ratebreakdown agcommission="0.00" commissionvat="0.00" commissionpct="0.00"> <ratediscounts> amount=" "/> <ratediscount code="sd" name="special DISCOUNT" amount=" "/> <ratediscount code="sd" name="special DISCOUNT" 141

142 </ratediscounts> <ratesupplements> <ratesupplement code="sr" name="board SUPPLEMENT" from=" " to=" " amount="65.120" nights="2" paxtype="ad" paxnumber="2"/> </ratesupplements> </ratebreakdown> </rate> </rates> </room> 142

143 </rooms> vatnumber="b "/> <supplier name="hotelbeds PRODUCT,S.L.U." </hotel> trs> </booking> </bookinglis 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", "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": " ", 143

144 "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 " 応答パラメータ ノード / 属性 タイプ ディスクリプション bookinglistrs Element トップ要素 bookinglistrs/auditdata Element 関連する内部情報 144

145 Float Date サーバの処理時間をミリ秒単位で表示リクエストが処理される日付 / 時刻サーバコードまたはID( 内部用 ) リクエストが送信と処理された環境予約参照番号 フォーマット : XX-XXXXXX クライアント内部の予約参照番号予約の作成日 bookinglistrs/booking/@creationdate Date フォーマット : YYYY-MM-DD ( 年 - 月 - 日 ) bookinglistrs/booking/@creationdate 予約の作成日 bookinglistrs/booking/@totalnet Float 予約の合計額 bookinglistrs/booking/@currency 支払うべき金額の通貨 チェックイン日付 bookinglistrs/booking/@checkin Date フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) チェックアウト日付 bookinglistrs/booking/@checkout Date フォーマット : YYYY-MM-DD( 年 - 月 - 日 ) ホテル及び関連料 bookinglistrs/hotel Element 金についての情報 を含む要素 bookinglistrs/hotel/@name ホテルの名称 145

146 Int Hotelbeds 内部ホテルコード ホテルのカテゴリ カテゴリの名称 ホテルの位置の目的地コード ホテルの位置の目的地名称 Int ホテルの位置の区域コード ホテルの位置の区域名称 Float 地理的位置の経度データ Float 地理的位置の緯度データ クライアント通貨 bookinglistrs/hotels/hotel/rooms Array of room elements 特定ホテルの空室リスト bookinglistrs/hotels/hotel/rooms/room/ Element 客室および関連料金についての情報を含む要素 予約状況 : bookinglistrs/hotel/rooms/room/@status CONFIRMED CANCELLED bookinglistrs/hotel/rooms/room/@code Int 内部客室コード bookinglistrs/hotel/rooms/room/@name 客室名称 / 説明 checkavailrs/hotels/hotel/rooms/room/prices checkavailrs/hotels/hotel/rooms/room/rates/rate bookinglistrs/hotel/rooms/room/rates/rate/@rateclass Array of price elements Element 特定ホテルの価格リスト 客室タイプと食事の価格情報内部価格のクラスタイプ (NOR NRF SPE OFE PAQ ) 146

147 予約は 以下の2つのステップ (BOOKABLE) または3つのステップ (RECHECK) で確認することができます ホテルでのお支払 いであるかまたはマーチャントであ るかを識別する 料金はパッケージ商品に対するものであるかどうかを識別する 内部食事コード Float 客室の正味価格 Float 客室の総価 ( 含まれている場合 ) bookinglistrs/hotel/rooms/room/rates/rate/@comission Float コミッション bookinglistrs/hotel/rooms/room/rates/rate/@hotelsellingra te Float 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 bookinglistrs/hotel/rooms/room/rates/rate/@children Boolean Int Int Int ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 販売価格であるどうかを確認同じ宿泊人数のリクエストされた空室の数リクエストされた客室ごとの大人の人数リクエストされた客室ごとの子供の人数 147

148 148 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 Float 日付以後に課金される料金 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 Float 代理のコミッション bookinglistrs/hotel/rooms/rates/ratebreakdown/@comissio npct Float コミッションの割合 bookinglistrs/hotel/rooms/rates/ratebreakdown/@comissio nvat Float コミッション税金 bookinglistrs/hotel/rooms/rates/ratebreakdown/ratesupple ments Element 価格の追加料金要素 bookinglistrs/hotel/rooms/rates/ratebreakdown/ratesupple ments/ratesupplement/@amount Float 追加料金金額 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 追加料金の課金が停止される日付

149 bookinglistrs/hotel/rooms/rates/ratebreakdown/ratediscou Element nts bookinglistrs/hotel/rooms/rates/ratebreakdown/ratediscou Float 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 Float bookinglistrs/hotel/rooms/room/prices/taxes/tax/@hotelim port Float bookinglistrs/hotel/rooms/room/prices/taxes/tax/@hotelcur rency bookinglistrs/hotel/rooms/room/prices/taxes/tax/@percenta Float ge bookingdetailrs/hotel/supplier bookingdetailrs/hotel/supplier/@name bookingdetailrs/hotel/supplier/@vatnumber Element すべての税金を含むかどうかを表示税金に関する情報を含む要素価格に税金が含まれているどうかを表示税金の値ホテル通貨での税金の値 ( 価格に税金が含まれていない場合 ) ホテル通貨 現地決済のパーセンテージサプライヤー情報を含む要素サプライヤーの名称サプライヤーの増値税番号 149

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

151 使用するキャンセル方法のタイプ : cancellationflag Y SIMULATION: 予約キャンセルをシミュレートする CANCELLATION: 予約をキャンセルする 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": 151

152 "reference": " ", "cancellationreference": "UIWQSFSARS", "clientreference": "MY BOOKING REFERENCE", "creationdate": " ", "status": "CANCELLED", "creationuser": "XML", "holder": "name": "HOLDER NAME", "surname": "HOLDER SURNAME", "hotel": "checkin": " ", "checkout": " ", "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 " 152

153 XML の例 + リクエストヘッダー ヘッダーの名称 値 Api-Key Your registered API key Content-Type application/xml Accept application/xml 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"/> 153

154 <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> 154

155 予約キャンセルの応答 コンテンツ - 予約がキャンセルされた場合 キャンセルされた予約の詳細は 以下の情報で返されます : 予約状況 :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> 155

156 "auditdata": "processtime": "6568", "timestamp": " :27:50.976", "serverid": "ws3xmi01", "environment": "[itest]", "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":

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

158 bookingcancellationrs/hotel Element ホテル及び関連料金についての情報を含む要素 ホテルの名称 Int Hotelbeds 内部ホテルコード ホテルのカテゴリ ホテルの位置の目的地コード Int ホテルの位置の区域コード クライアント通貨 bookingcancellationrs/hotels/hotel/rooms bookingcancellationrs/hotels/hotel/rooms/room/ 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 フォーマット : YYYY-MM-DD ( 年 - 月 - 日 ) 特定ホテルの価格リスト 客室タイプと食事の価格情報 158

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

160 Float ncy ded bookingcancellationrs/hotel/rooms/room/rates/rate/cancellation Policies bookingcancellationrs/hotel/rooms/room/rates/rate/policy ount m elamount Boolean Int Int Int Array of policies elements Element Float Date Floar ホテル通貨での客室総価 ( ホテルでのお支払いモデル向け ) ホテル通貨 ( ホテルでのお支払いモデル向け ) 価格が推奨されているかどうかを識別同じ宿泊人数のリクエストされた空室の数リクエストされた客室ごとの大人の人数リクエストされた客室ごとの子供の人数 キャンセルポリシーのリスト キャンセルポリシー日付以後に課金される料金クライアントのキャンセルによる課金開始日付日付以降にホテル通貨で課金される料金 ( ホテルでのお支払いモデル向け ) 認証プロセス コンテンツ 160

161 検索エンジン空室状況ホテル詳細予約を確認する前確認バウチャー 認証プロセスは 予約 APIが当社クライアントのサイトまたはアプリケーションにおいて正確に使用されているかどうかを検証します それは クライアントによって表示される情報はHotelbedsの規格と当社のホテルパートナーの要件に沿ったものであることを保証します 我々のチームは つねにできるだけスムーズに このプロセスを実行するために すべての必要なサポートを提供しようとします このプロセス中に疑問を持っているか 問題が発生した場合は こちらにご連絡ください 検索エンジン 我々のチームは まず検索エンジンを検査し 応答にすべての国 / 目的地が表示されているかどうかを判断します 表示されていない場合は それれのシステムはすべての目的地が表示表示されていない理由を 我々のクライアントに求めます そして 具体的に特定目的地が受け入れられない原因は 商業的な意思決定の結果にあるかどうかを把握します 我々は 検証プロセスを開始する前に この種の商業的決定を知らされていることが極めて重要です 我々は 検索エンジンが客室あたりの宿泊の大人と子供の数が表示しているかどうか および子供の年齢がリクエストされているかどうかを検証します 予約プロセス中に 子供の年齢は変更できません 我々はまた エンジンにおいていかなる適用できない可能性のある追加の検索フィルタがあるかどうかを検査します 161

162 空室状況 我々のチームは XMLまたはJSON 経由で提供する商品全体が正しく表示されているかどうかを検証します ; 価格 客室の数 日付 ホテル 食事タイプ 客室タイプ ホテルの評価 ( 星評価 アパート 別荘 アパート式ホテル ) またページ区切りの正しい実行と表示を含みます 認証プロセスにおいて問題としてこれを強調表示するのを防止するため 我々は すべての客室タイプ 食事タイプとホテルを含んでいないいかなる商業的な理由を 知らされているが重要です 同じ宿泊人数の複数の客室のリクエストについては 空室状況リクエスト / 共同宿泊 / 一人宿泊 /@ 客室 を使用することは非常に重要です 我々はまた お客様の数が異なる客室 またはお客様の数が同じで子供の年齢が異なる客室の場合において お客様のノードを分割することをおすすめします このような場合には 宿泊人数ノードを複製する必要があります 162

163 163

164 ホテル詳細 ホテルの詳細は すべてのHotelbedsクライアントに必須です これらのデータは コンテンツAPI を使用して クライアントシステムに格納する必要があります クライアントシステムは 要件に応じて頻繁に更新できますが 我々は 最低でも週に1 度お使いのシステムのデータベースを更新することをおすすめします データベースの最後のコンテンツAPIの更新後に作成されたため ホテルがデータベースに表示されない場合は ホテルのすべての情報 ( 住所 ディスクリプション 施設 写真 客室施設など ) を表示するホテルの詳細機能を使用してください 追加料金が必要な施設を含みます ホテル施設料金は ホテル施設のリクエストが行われた時に ( ホテル操作において ) コンテンツ APIで確認できます そのうち 真 または 偽 値を含む 料金 属性は お客様に当該施設は料金を払う必要があるかどうかをお知らせることができます クレームを防止するため すべての場合において お客様に追加料金をお知らせるべきです 164

165 予約を確認する前 評価コメント ( 評価コメントIDディスクリプション ) は 予約前に 予約の要約およびバウチャー上に表示されなければなりません これは ホテル経営者からお客様に提供した重要な情報であり 客室情報とともに含まれている必要があります 評価コメントは 料金チェックリクエストと予約リクエストで提供されます 空室状況リクエストから評価コメントIDを取得し コンテンツAPIを使用して 適切な方法でディスクリプションを取得するオプションも用意されています テスト環境において 目的地 AND( アンドラ ) またはBKK( バンコク ) で検索するホテルの大半は 評価コメントがあります クライアントの詳細と子供の年齢もチェックします 子供の年齢は 検索エンジンを使用して入力された場合 予約の流れにおいて任意に変更できません 予約は 確認のための準備ができたら すべての情報が正しく表示されるはずです 今後かかわる情報の商品 サービスまたは目的地に関して問題が発生するのを回避するため 各客室にお客様の名前を入力することが必須です 必須ではありませんが 我々はまた 予約を確認する前にいかなるキャンセルポリシーとホテルに影響を与える可能性のある問題 ( 問題 ノードはコンテンツAPIにおけるホテル操作で返される) をお客様に知らせることをおすすめします 価格は 各ステップにおいてチェックする必要があります ( 空室状況リクエスト 料金チェックリクエスト ( ある場合 ) と予約リクエスト ) 料金 割引 追加料金または他のいかなる条件は最近変更した場合 システムが ( 空室状況を ) 検索する時に時々誤算の価格を返す可能性があることを心にお留めておいてください ご注意 : キャンセル料を決定するために使用される日付と時間は お客さまのローカルタイムではなく 予約の目的地の日付と時間に依存します 165

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

167 ご注意 : 我々は標準の予約手続きのワークスフロー ( 空室状況リクエスト 料金チェックリクエスト ( 必要の場合 ) と予約リクエスト ) をチェックしますので 上記方式以外の機能 ( 例えば 予約キャンセルポリシー キャンセル 変更 ) をチェックする希望がございましたら 認証プロセスが始まる前にお知らせください 167

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

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