宿泊APIローンチ要件
Rapid Lodging APIですぐに始められます。
Rapid Lodging APIの開始要件には、利用者に関係なく、どのような実装にも適用される要件と、business-to-business (B2B) またはbusiness-to-consumer (B2C) の使用に関する特定の要件が含まれます。これらの要件は、以前に統合した他の料金タイプ / 予約フローとは異なる場合があるため、注意深くお読みください。
注: 以下の各要件には、カスタマーサービスチームがお客様をサポートするための参照コードが含まれています。
要件
以下の要件は、Lodging APIの実装に適用されます。
一般的な要件
エクスペディアの情報を正しく利用
GR1: 当社の名称およびロゴの使用
当社の名称およびロゴの使用は、traveler-facingまたはagent-facingのサイトにおいてのみ、例外として当社の書面による明確な事前承認がある場合に限り可能です。
ユーザーインターフェースの例

GR2:表示される利用規約URLへのリンク
あなたのサイトの利用規約のテキスト内に当社の利用規約へのリンクを提供するか、あなたの予約ページから直接利用規約にリンクしてください。これらの規約には、予約管理のポリシーが詳述されています。easy-to-find、「Supplier Terms & Conditions(サプライヤー規約)」というリンク文言を用いて、以下のリンクを設置してください。
弊社がサポートする各言語の利用規約のバージョンは、このRapid API利用規約ページから入手できます。
ユーザーインターフェースの例 - B2B

ユーザーインターフェースの例 - B2C

GR4:Expedia GroupがMerchant of Record(MOR)である場合のクレジットカード規定の適切な使用と表示
旅行者のカード会員データを取得、使用、送信、保管、または処理する場合は、PCIセキュリティ基準審議会が発行したPayment Card Industry(PCI)データセキュリティ基準を遵守する必要があります。これらの規制に関する完全なリファレンスは、公式ウェブサイト(PCI Security Standards Council)で入手できます。
GR5: 施設collectを使用する場合、またはExpedia GroupがMORである場合は、PCI準拠の証拠を提出してください (該当するパートナーのみ)。
Expedia GroupがMORであっても、施設 がMORであっても、PCI準拠の証拠として準拠証明書(AOC)を提出する必要があります。
PCIコンプライアンスに関するアドバイスは、公式ウェブサイト(PCI Security Standards Council)でご覧いただけます。
検索ページ
正確な検索パラメータの設定
SP1: 適切なメッセージングと、アフィリエイトが予約に子供を含めることを許可している場合の子供の年齢の入力
お子様連れのご旅行を許可する場合は、チェックイン時にお子様の年齢を指定できるようにする必要があります。この情報は、occupancy オブジェクトを通じて提供されます(以下の例を参照)。
旅行者が小児旅行者を指定した場合、APIレスポンスには年齢制限および/または追加客室料金やベビーベッド料金が含まれる場合があり、予約の料金や適格性に影響を与える可能性があります。
子供とみなされる年齢の範囲は、ホテルごとに設定されます。多くの場合、17 歳以下が子供とみなされます。一部の施設では、18 歳未満の宿泊を許可していません。
APIリクエスト例
https://api.ean.com/2.4/properties/availability?checkin=2020-09-11
&checkout=2020-09-14
¤cy=USD&language=en-US& occupancy=2-9,4 &property_id=XXXX
&country_code=XX&sales_channel=XXXX
&sales_environment=XXXX&filter=XXXX&rate_plan_count=XXXX
&rate_option=XXXX&billing_terms=XXXX&payment_terms=XXXX
&partner_point_of_sale=XXXX&platform_name=XXXXAPIレスポンスの例
"occupancies": {
"2-9,4" : {
"nightly": [
[ユーザーインターフェースの例: 1大人2名、子供3名(17歳、2歳、1歳未満)。

施設または空室状況
部屋や施設に関する情報を表示します。
AP1: 各部屋にあるベッドタイプの 説明
ショッピングのレスポンスでは、bed_groups 配列を単一の値で返すこともあれば、複数のオプションで返すこともあります。設定配列に含まれる値を表示し、旅行者のベッド選択を記述します。
bed_groups配列が複数の選択肢を返す場合、旅行者が選択できるように、ショッピングのレスポンスで提供される各ベッドタイプのprice_check リンクを表示します。
同じ客室に複数ベッドタイプのオプションを選んだお客様に対しては、リクエストはできるものの、空室状況によってはホテルで受け付けられない場合があるというメッセージを表示しなければなりません。
部屋名はShoppingレスポンスのrooms配列内でroom_name として返されます。
APIレスポンスの例
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Superior double room" ,
"rates": [
{
...
"bed_groups": {
"133243": {
"id": "133243",
"description": "Double bed" ,
"links": {...},
"configuration": [...]
},
"133242": {
"id": "133242",
"description": "2 single beds" ,
"links": {...},
"configuration": [...]
}
},ユーザーインターフェースの例 - B2B

ユーザーインターフェースの例 - B2C

AP2:Non-refundable国旗がはっきりと見えます
Non-refundable refundable=falseShopping API availability responseの。 空室状況のレスポンスでrefundable=false が返された場合は、該当する客室を明確に表示してください。この値は、どのポリシーデータよりも常に優先されます。これらの予約では、どのような状況であっても施設からの返金は行われません。
APIレスポンスの例
"property_id": "XXXX",
"rooms":
"id": "XXXX",
"room_name": "Fairmont King",
"rates":
"id": "XXXX",
"status": "available",
"available_rooms": 4999,
"refundable": false ,
"deposit_required": false,
"merchant_of_record": "expedia",ユーザーインターフェースの例 - B2B

ユーザーインターフェースの例 - B2C

AP3:Check-inおよび特別指示の表示
checkinContent APIcheckout 施設定義で返されるように、fees、policies、、 オブジェクトの内容を各部屋ごとに表示する必要があります。この情報は、チェックイン時に発生する可能性のある料金や、特別なアクセス方法について旅行者が確実に認識できるよう、空室状況ページに表示する必要があります。
check-in check-in checkin例えば、到着予定時刻を施設に通知する要件、ゲストビルとは異なる場所でのcheck-in、電子メールによる施設からの特別なcheck-in指示を期待するアラートなど。
旅行者に対して同じエリア内に instructions と special_instructions の両方を必ず表示してください。
APIレスポンスの例
"11775754": {
"property_id": "11775754",
"checkin": {
"begin_time": "16:00 PM",
"end_time": "4:00 AM",
"instructions": "Minimum age to check in is 18 years old.
<br />Extra-person charges may apply and vary depending on property policy.
<br />Government-issued photo identification and a credit card may be required at
check- in for incidental charges.
<br />Special requests are subject to availability upon check-in and
may incur additional charges. Special requests cannot be guaranteed. <ul>. ",
"special_instructions": "Front desk staff will greet guests on arrival. For more details,
please contact the property using the information on the booking confirmation.",
"min_age": 18
"checkout": {
"time": "11:00 AM"
"fees": {
"mandatory": "<p>You'll be asked to pay the following charges at the property:</p>
<ul><li>Deposit: USD 50 per day</li>
<li>Resort fee: USD 28.25 per accommodation,
per night</li></ul> The resort fee includes:<ul
><li>Pool access</li><li>Fitness center access</li><li>Fitness/yoga classes</li>
<li>Airport shuttle</li><li>Phone calls</li><li>In-room safe</li><li>Self parking</li>
<li>Valet parking</li><li>Parking</li></ul> <p>We have included all charges provided to us by the property.
However, charges can vary, for example, based on length of stay or the room you book. </p>",
"optional": "<p>The following fees and deposits are charged by the property at time of service,
check-in, or check-out. </p> <ul> <li>Breakfast fee: between USD 6 and USD 25 per person
(approximately)</li> <li>Late check-out is available for a fee (subject to availability)</li>
<li>Rollaway bed fee: USD 20.0 per night</li>
</ul> <p>The above list may not be comprehensive. Fees and deposits may not include tax
and are subject to change. </p>"
"policies": {
"know_before_you_go": "<ul> <li>Up to 2 children 12 years old and younger stay free when
occupying the parent or guardian's room, using existing bedding. </li>
<li>The property has connecting/adjoining rooms, which are subject to availability
and can be requested by contacting the property using the number on the booking
confirmation. </li> </ul>"ユーザーインターフェースの例

予約ページ
チェックアウトの詳細
BP1: 個人情報のSSL暗号化の有無
個人データを送受信する場合は、SSL 暗号化を使用して、クライアントのブラウザ / アプリケーションとサイト間の接続、および依存システムとのネットワーク通信を保護する必要があります。個人データには、お客様の名前、電話番号またはメールアドレス、決済カードの詳細、予約 / 旅程の受領と確認のページが含まれます。接続が保護されていない場合は、接続を停止またはリダイレクトします。
BP2:Check-inおよび特別指示の表示
checkin,checkout,fees,policies オブジェクトの内容は、コンテンツ 施設 定義で返されるように、部屋ごとに表示されなければなりません。この情報は、旅行者が予約を 確定する前に、check-inで発生する可能性のある料金や特別なアクセス方法を確実に認識できるように表示する必要があります。
check-in check-in checkin例えば、到着予定時刻を施設に通知する要件、ゲストビルとは異なる場所でのcheck-in、電子メールによる施設からの特別なcheck-in指示を期待するアラートなど。
旅行者に対して同じエリア内に instructions と special_instructions の両方を必ず表示してください。
BP3: キャンセルポリシーとnon-refundableタグを明確に表示します。
旅行者が最終予約ページで購入を確定する前に、選択した客室のキャンセルポリシーまたはnon-refundableタグを提供する必要があります。各料金のキャンセルポリシーは、Rapid Shopping Availability APIのcancel_penalties オブジェクト内で提供されます。
返金可の料金の場合、レスポンスには一連のキャンセルポリシーの詳細が含まれます。詳細には、指定されたキャンセル料の適用開始日と終了日、およびキャンセル料のタイプ、値、適用される例外予約期間が含まれます。キャンセル料のタイプには、固定金額、宿泊数、合計料金に対する割合が含まれます。
| レスポンス | 意味 |
|---|---|
refundable=true | この料金は全額返金可能です。 |
refundable=true + cancel_penalties | • この料金は、キャンセル期間内であれば払い戻しが可能です。 • 最も早い cancel_penalties.[].start、将来のタイムラインであれば、無料キャンセル期限となります。• レートは100%non-refundable cancel_penalties.[].end |
refundable=false | • このレートはnon-refundable. • キャンセル料適用期間は返されません。 |
refundable=false + cancel_penalties | • 料金の一部は払い戻し可能です。 • cancel_penaltiesは、nonrefundable_date_ranges と共に表示される必要があります。予約が作成されると、この範囲の滞在日がnon-refundableであることが示されます。 |
詳しくはこちらキャンセルポリシーの作り方 .
参考ページ :
refundable=false
- 予約が作成されるとすぐに返金不可の金額が発生します。
cancel_penaltiesとnonrefundable_date_rangesが詳細を提供します。
nonrefundable_date_ranges
- 予約が作成されると、この範囲の滞在期間は返金不可となります。
cancel_penalties
nonrefundable_date_rangesに含まれない滞在期間に適用されます。cancel_penaltiesが空欄か返されない場合、料金は 100% 返金不可です。cancel_penaltiesの期間内にキャンセルするとキャンセル料が発生します。- 最も早い
cancel_penalties.[].start、将来のタイムラインであれば、無料キャンセル期限となります。 - 最新の
cancel_penalties.[].end以降は100%non-refundableです。
APIレスポンスの例:キャンセルポリシーとnon-refundableフラグ
"property_id": "11775754",
"rooms": [
{
"id": "230434524",
"room_name": "Traditional Room (Partner:Connect Test)",
"rates":
"id": "276321199",
"status": "available",
"available_rooms": 4999,
"refundable": true,
"cancel_penalties": [
{
"start": "2020-09-10T18:00:00.000-07:00",
"end": "2020-09-11T18:00:00.000-07:00",
"amount": "76.00",
"currency": "USD"ユーザーインターフェースの例

BP4: 料金内訳に表示されている施設で別途支払うべき料金
料金が fees 配列で返される場合、各値を施設で支払う料金 (チェックインまたはチェックアウト) として個別に表示します。旅行者に現地通貨を提示し、通貨を要求します。これらの料金は施設によって直接徴収されるものであり(当社や地方自治体によって徴収されるものではありません)、税金・料金の項目に含まれる標準的な税金回収料金、税金、料金の一部ではありません。
APIレスポンスの例手数料の配列
"fees" : {
"resort_fee": {
"request_currency": {
"value": "74.97",
"currency": "USD"
},
"billable_currency": {
"value": "74.97",
"currency": "USD"
},
"scope": "per_accommodation",
"frequency": "per_night"
}
},ユーザーインターフェースの例

BP5: 価格表示には、合計価格と税金および手数料の内訳を含める必要があります。
A) 合計価格
予約の合計価格は、お支払いページで旅行者に表示する必要があります。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。最終的な内訳には、宿泊料金(合計または1泊あたり)、追加宿泊料金(後述のproperty_fee フィールドに記載されているものを除く)、すべての宿泊金額と税金、請求可能な合計金額を記載し、施設で現在支払うものと後日支払うものを明記する必要があります。
**注:**B2B またはB2C ダイナミックパッケージ用ホテル料金、および公開されている ダイナミックパッケージ用ホテル料金 の実装には、 追加の価格表示要件が適用されます。
B) 税金の明細
価格表示には、tax_and_service_fee とproperty_fee の合計を「税金と手数料」というタイトルの1行として含める必要があります。料金の内訳に含まれる税金と手数料の合計に言及する場合、以下の正確なテキストを表示することが法的に義務付けられています。これは、pop-up, プレーンテキスト、モーダル、またはその他の実装として表示できます。施設料金はチェックアウトページに別途表示すべきではありません。
"税金は業者(e.g. ホテル)に支払う税金回収料です。詳細は利用規約をご覧ください。サービス料は、お客様のご予約を処理するための報酬として保持され、ベンダーによって請求される手数料が含まれる場合があります。" 翻訳はエクスペディア パートナーソリューション でご覧いただけます。
tax_and_service_fee、返される金額には、税務当局によって義務付けられた税金と手数料のみが含まれます。
C) パートナーサービス料と予約手数料
Expedia Group、追加サービス料金や予約料金の免除を許可する場合、両者を明確に区別する必要があります。貴団体が予約に加算するサービス料を課す場合、その料金が貴団体によって課されるものであり、Expedia Group、別個のサービス(つまり、宿泊施設の提供に対する追加料金ではない)に対して課されるものではないことを、旅行者に明確に伝えなければなりません。料金は、既存の税金および手数料の項目に含まれない場合があります。あなたの施設が課す料金を「料金」という言葉で表現しないでください。代わりに、"アフィリエイト・ブッキング・チャージ "または "アフィリエイト・サービス・チャージ "を使用することができます。
注: B2B またはB2C 施設 コレクトおよび公開された ダイナミックパッケージ用ホテル料金 実装には追加要件が適用されます。
BP7: 子どもの年齢の再確認(該当する場合)
お子様連れのご旅行が可能で、ご旅行者がお部屋の選択にお子様連れのご旅行者を指定された場合、予約ページでお子様連れの人数と年齢を明確に確認する必要があります。この情報はchild_ages オブジェクトを通じて提供されます。
ユーザーインターフェースの例

BP8: エンドトラベラーからの支払いがいつ行われるかのステートメント(施設 コレクトの場合、またはExpedia GroupがMORの場合)。
エクスペダ・グループがMORの場合、提供されたクレジットカードに予約金額全額が直ちに請求されることを明記してください。
施設で徴収する場合、提示したクレジットカードでチェックインまたはチェックアウト時に施設により課金されることを明示し ます。もし施設がnon-refundable post-payレートを提供している場合は、代わりに予約完了後すぐに施設から旅行者に請求が来る可能性があることを示してください。
BP9: SCAレギュレーションに準拠
規制当局やカードネットワークは、オンライン決済のセキュリティを強化し、消費者を詐欺から守るための新たな要件を導入しています。このような規制の多くには、オンライン決済に強固な顧客認証(SCA)を使用するという要件が含まれています。
BP10:Expedia GroupがMORの場合にcheck-outページに表示される支払い処理場所
Expedia GroupがMORの場合、支払いが処理される国をcheck-outページの目立つ場所に表示する必要があります。"This payment will be processed in" というフレーズを国名の前に挿入する必要があります。
この情報を取得するには、Shopping API の支払いオプション機能を使用します。
支払いオプションのAPIリクエスト例
https://api.ean.com/<payment-options link from previous availability request>
APIレスポンスの例
"credit_card": {
"name": "Credit Card",
"card_options": [
"name": "MasterCard",
"processing_country": "US"
"name": "Visa",
"processing_country": "US"ユーザーインターフェースの例

確認ページ
予約に関する重要な情報の共有
CP1: 価格表示には、合計金額と、内訳が記載されている場合は税金と手数料を含める必要があります。
A) 合計価格
予約の合計金額は、確認ページで旅行者に表示されなければなりません。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。最終的な内訳には、宿泊料金(合計または1泊あたり)、追加宿泊料金(後述のproperty_fee フィールドに記載されているものを除く)、すべての宿泊金額および税金、請求可能な合計金額を記載し、施設で現在支払うものと後日支払うものを明記する必要があります。
注: B2B またはB2C ダイナミックパッケージ用ホテル料金の実装には、価格表示の追加要件が適用されます。
B) 税金の明細
価格表示には、tax_and_service_fee とproperty_fee の合計を「税金と手数料」というタイトルの1行として含める必要があります。税およびサービス料の合計が価格明細に記載される箇所では、以下と完全に一致する表現を使用して表示することが法的に義務付けられています。これは、pop-up, プレーンテキスト、モーダル、またはその他の実装として表示できます。施設料金はチェックアウトページに別途表示すべきではありません。
"税金はベンダー(e.g. ホテル)に支払われる税金回収料です。詳細は利用規約をご覧ください。サービス料は、お客様のご予約を処理するための報酬として保持され、ベンダーによって請求される手数料が含まれる場合があります。" 翻訳はエクスペディア パートナーソリューション でご覧いただけます。
tax_and_service_fee、返される金額には、税務当局によって義務付けられた税金と手数料のみが含まれます。
C) パートナーサービス料と予約手数料
Expedia Group、追加サービス料金や予約料金の免除を許可する場合、両者を明確に区別する必要があります。貴団体が予約に加算するサービス料を課す場合、その料金が貴団体によって課されるものであり、Expedia Group、別個のサービス(つまり、宿泊施設の提供に対する追加料金ではない)に対して課されるものではないことを、旅行者に明確に伝えなければなりません。料金は、既存の税金および手数料の項目に含 まれない場合があります。あなたの施設が課す料金を「料金」という言葉で表現しないでください。代わりに、"アフィリエイト・ブッキング・チャージ "または "アフィリエイト・サービス・チャージ "を使用することができます。
確認メールまたはバウチャー
参考のため、旅行者の予約情報を提供します。
モバイルアプリケーション内でホスト型バウチャーを提供する場合は、以下の要件に従う必要があります。
ER1: 旅程IDが正しく表示されます。
カスタマー・ダイレクト・サポート (CDS) のみ
お客様の統合により、当社のitinerary_id が旅行者に直接提供される場合は、確認メールにこの番号を明記する必要があります。
該当する場合、代理人がカスタマーサポートのサポートを必要とする場合に、代理人が当社のオリジナルの旅程IDにアクセスできることを証明する書類をご提出いただく必要があります。
エージェント間(A2A)サポート
代理店の方は、カスタマーサポートからのサポートが必要な場合、オリジナルの旅程IDにアクセスできるようにしておいてください。
ER2:オンラインカスタマーサービスツールへのリンクを含む、カスタマーサポートの明確な表示
予約フローまたは確認メール内にカスタマー サポート チャネル (電話番号やライブチャットなど) を明確に表示します。当社のエージェントが旅行者に直接サポートを提供する場合は、予約フローに当社のサポート番号を表示してください。
ER3: 各部屋にあるベッドタイプの説明
確認メール / バウチャーで旅行者がリクエストしたベッドタイプを確認し、同じ客室に複数ベッドタイプのオプションを選んだ旅行者には、リクエストはできるものの、空室状況によってはホテルで受け付けられない場合があるというメッセージを表示します。
設定配列に含まれる値を表示し、旅行者のベッドの選択を説明します。
ER4:Check-inおよび特別な指示が表示されます。
checkin,checkout,fees,policies オブジェクトの内容は、施設 コンテンツ定義で返されるように、各部屋ごとに表示されなければなりません。この情報は、check-inで発生する可能性のある料金や、特別なアクセス方法について旅行者が確実に認識できるよう、空室状況ページに表示する必要があります。
check-in check-in checkin例えば、到着予定時刻を施設に通知する要件、ゲストビルとは異なる場所でのcheck-in、電子メールによる施設からの特別なcheck-in指示を期待するアラートなど。
旅行者に対して同じエリア内に instructions と special_instructions の両方を必ず表示してください。
ER5: 料金内訳に表示されている施設で別途支払うべき料金
料金が fees 配列で返される場合、各値を施設で支払う料金 (チェックインまたはチェックアウト) として個別に表示します。これらの料金は、施設(当社や地方自治体ではありません)が直接徴収するものであり、標準的な税金回収料金の一部ではありません。
ER6: 価格表示には、合計価格と税金および手数料の内訳を含める必要があります。
A) 合計価格
予約の合計金額は、Eメールの領収書に旅行者に表示されなければなりません。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。最終的 な内訳には、宿泊料金(合計または1泊あたり)、追加宿泊料金(後述のproperty_fee フィールドに記載されているものを除く)、すべての宿泊金額および税金、請求可能な合計金額を記載し、施設で現在支払うものと後日支払うものを明記する必要があります。
**注:**B2B またはB2C ダイナミックパッケージ用ホテル料金、および公開されている ダイナミックパッケージ用ホテル料金 の実装には、 追加の価格表示要件が適用されます。
B) 税金の明細
価格表示には、tax_and_service_fee とproperty_fee の合計を「税金と手数料」というタイトルの1行として含める必要があります。税およびサービス料の合計が価格明細に記載される箇所では、以下と完全に一致する表現を使用して表示することが法的に義務付けられています。これは、pop-up, プレーンテキスト、モーダル、またはその他の実装として表示できます。施設料金はチェックアウトページに別途表示すべきではありません。
"税金はベンダー(e.g. ホテル)に支払われる税金回収料です。詳細は利用規約をご覧くだ さい。サービス料は、お客様のご予約を処理するための報酬として保持され、ベンダーによって請求される手数料が含まれる場合があります。" 翻訳はエクスペディア パートナーソリューション でご覧いただけます。
tax_and_service_fee、返される金額には、税務当局によって義務付けられた税金と手数料のみが含まれます。
C) パートナーサービス料と予約手数料
Expedia Group、追加サービス料金や予約料金の免除を許可する場合、両者を明確に区別する必要があります。貴団体が予約に加算するサービス料を課す場合、その料金が貴団体によって課されるものであり、Expedia Group、別個のサービス(つまり、宿泊施設の提供に対する追加料金ではない)に対して課されるものではないことを、旅行者に明確に伝えなければなりません。料金は、既存の税金および手数料の項目に含まれない場合があります。あなたの施設が課す料金を「料金」という言葉で表現しないでください。代わりに、"アフィリエイト・ブッキング・チャージ "または "アフィリエイト・サービス・チャージ "を使用することができます。
技術要件
Behind-the-scenes要件
TR1: 各予約リクエストに一意のアフィリエイト参照IDを提供します。
すべての予約リクエストに対して、affiliate_reference_id 要素を使用する必要があります:
- 独自に追跡できるようにする。
- 複数フォーム送信による二重予約 / 二重課金を回避する。
- 上流のタイムアウトにより予約がタイムアウトまたは空の結果を返した場合、旅程のシステムをチェックします。
例
{
"affiliate_reference_id": "Launch_Requirement_TR1" ,
"hold": false,
"email": "TR4@Launch.Requirement",
"phone": {
"country_code": "Launch_Requirement_TR5b",
"number": "Launch_Requirement_TR5b",
"area_code": "Launch_Requirement_TR5b"
},
"rooms": [
{
"given_name": "John_Launch_Requirement_TR5a",
"family_name": "Doe_Launch_Requirement_TR5a,
"smoking": false,
},
{
"given_name": "David_Launch_Requirement_TR5a",
"family_name": "Smith_Launch_Requirement_TR5a",
"smoking": false,
}
],TR2:各リクエストに旅行者の国コードを入力してください。
- ショッピングとレコメンデーションのAPIリクエストでは、旅行者の
country_code。国コードは、旅行者がアクセスする販売店と一致している必要があります。 - この要件により、当社のシステムは、販売市場に基づいた適切なコンテンツと最適な料金を旅行者に提供することができます。
APIリクエスト例
https://api.ean.com/2.4/properties/availability?checkin=2020-09-11
&checkout=2020-09-14
¤cy=USD&language=en-US&occupancy=2-3,4&property_id=XXXX
&country_code=XX&sales_channel=XXXX
&sales_environment=XXXX&filter=XXXX&rate_plan_count=XXXX
&rate_option=XXXX&billing_terms=XXXX&payment_terms=XXXX
&partner_point_of_sale=XXXX&platform_name=XXXXTR3:請求ごとに請求情報を提供
A) 支払人名
旅行者、法人、バーチャルカード向け:
- 当社から請求されるカードの名義人の名前を送信する必要があります。
エクスペディア アフィリエイト コレクト (EAC) パートナー:
- 可能な限り、Expedia Group、予約の実際の最終支払者の名前を送信することを強くお勧めします。
- この情報は、規制 / 制裁審査の目的で必要です。
- 実際の最終支払者の名前を提供することが不可能な場合は、当社に支払いを行っている会社名または法人名を提供してください。
注: POSがロシア、ウクライナ、またはベネズエラの場合は、常に真の支払者情報が必要です。
B) 請求国
- 請求先 / 支払人名フィールドに渡された個人名を表す必要があります。
C)請求先郵便番号
- 請求先 / 支払人名フィールドに渡された個人名を表す必要があります。
注: 郵便番号を管理していない国については、この情報を提供する必要はありません。
例
"payments": [
{
"type": "customer_card",
"billing_contact": {
"given_name": "Launch_Requirement_TR3a",
"family_name": "Launch_Requirement_TR3a",
"address": {
"line_1": "555 1st St",
"line_2": "10th Floor",
"line_3": "Unit 12",
"city": "Seattle",
"state_province_code": "WA",
"postal_code": "Launch_Requirement_TR3c",
"country_code": "Launch_Requirement_TR3b"
}
},TR4:旅行者のEメールアドレスまたは監視用Eメールボックスの提供
各旅程の email 要素には、旅行者のメールアドレスの情報、または統合施設で確認メール処理のためにモニター対象とするメールボックスの情報が含まれていなければなりません。これは、予約の紛争やトラブルシューティングの事例が発生した場合に必要です。
TR5: 正確な旅行者情報の提供
A) 旅行者名
ご予約の際は、各お部屋に実際にご宿泊されるお客様のお名前を必ず明記して ください。これは、予約リクエストの本文で、roomsオブジェクト内のgiven_name とfamily_name の値が、各部屋のチェックインするメインゲストの姓と名に一致する必要があることを意味します。
B) 旅行者の電話番号
予約には、旅行者の有効な連絡先番号が含まれていなければなりません。各旅程で、この番号を予約リクエストの電話番号フィールドに含めてください。Expedia Group代理店が旅行者に直接サポートを提供する場合は、旅行者に連絡することはありません。
TR6:multi-room予約情報の提供
複数の客室の予約がサポートされている場合、各客室が予約、キャンセルされたことを示すテスト予約の API リクエストとレスポンスのログを提供します。
予約した客室に対して、それぞれ別の確認用 ID が作成されるので、客室を別々にキャンセルすることができます。すべての客室をキャンセルするには、確認用 ID ごとにキャンセルコールを完了します。
Expedia Group弊社のAPIまたはテンプレートでは、8室以上のグループ予約は直接承っておりません。8部屋以 上のご予約が必要な場合は、アカウントマネージャーがアドバイスいたします。
TR7: エラー処理に関する推奨事項の見直し
エラー処理に関する推奨事項 を確認し、それらを処理するロジックを実装したことを確認してください。
B2B導入の具体例
開発支援に役立つチェックリストや、要件に関するフィードバック をご覧いただけます。サイトレビューにスクリーンショットを提供する場合は、チェックリストにスクリーンショットと対応するログを追加してください。
一般的な要件
エクスペディアの情報を正しく利用
GR3川下エージェントは、当社のインベントリにアクセスするために、当社のエージェント利用規約に同意する必要があります。
旅行者の代理として予約を行う代理店は、当社の下流代理店規約に同意する必要があります。予約前に代理店が確認し、同意できるように、下流代理店へのリンク()を提供する必要があります。その他のバージョンは、Expedia Partner Solutions でご覧いただけます。
ユーザーインターフェースの例

その他 ダイナミックパッケージ用ホテル料金に必要なもの
上記の共通要件に加えて、ダイナミックパッケージ用ホテル料金要素を実装に含める場合は、以下の要件も満たす必要があります。
施設または空室状況
予約に関する標準的な情報を表示します。
AP4: ダイナミックパッケージ用ホテル料金を固有のラベルまたは識別子で表示します。
Expedia Group、パッケージ料金であることを客室単位で明示する必要があります(個別の商品ではありません)。
ユーザーインターフェースの例

予約ページ
チェックアウトの詳細
BP5: 価格表示には、合計価格と税金および手数料の内訳を含める必要があります。
ダイナミックパッケージ用ホテル料金の合計価格要件は、上記の共通要件とは異なります。
A) 合計価格
パッケージの合計価格を表示するには、パッケージ価格と運送費を組み合わせる必要があります。これは通常、施設と輸 送にかかる費用をper-person。
予約の合計価格は、お支払いページで旅行者に表示する必要があります。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。
ユーザーインターフェースの例

BP11: 代理店にパッケージ料金ルールの受け入れを義務付け
承認された運送手段とともに、この料金を販売していることをエージェントが認めるチェックボックスを購入手続きページに含めます。
ユーザーインターフェースの例

確認ページ
予約に関する重要な情報の共有
CP1: 価格表示には、合計価格と税金および手数料の内訳を含める必要があります。
ダイナミックパッケージ用ホテル料金の合計価格要件は、上記の共通要件とは異なります。
A) 合計価格
パッケージの合計価格を表示するには、パッケージ価格と運送費を組み合わせる必要があります。これは通常、施設と輸送にかかる費用をper-person。
予約の合計金額は、確認ページで旅行者に表示されなければなりません。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。
確認メールまたはバウチャー
参考のため、お客様の予約情報を提供します。
ER6: 価格表示には 、パッケージ料金の総額、および内訳が提示されている場合は税金と手数料を含める必要があります。
ダイナミックパッケージ用ホテル料金の合計価格要件は、上記の共通要件とは異なります。
A) 合計価格
パッケージの合計価格を表示するには、パッケージ価格と運送費を組み合わせる必要があります。これは通常、施設と輸送にかかる費用をper-person。
予約の合計金額は、Eメールの領収書に旅行者に表示されなければなりません。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。
追加 施設コレクト要件
上記の共通要件に加えて、施設コレクトを実装に含める場合は、以下の要件も満たす必要があります。
一般的な要件
エクスペディアの情報を正しく利用
GR6: 代理店は施設のキャンセルプロセスをサポートする必要があります。
施設のコレクト(または後払い)予約では、施設がMORとして機能します。予約時に提供された支払いカードを確認します。支払いに失敗した場合、またはカードが有効であることを確認できない場合、施設は有効な支 払い方法についてエージェントに連絡を試みます。もし、施設からの返信がない場合は、14日前まで予約をキャンセルすることができます。check-in.
予約がキャンセルされると、サプライヤーのキャンセル通知が予約連絡先に送信されます。このメッセージを旅行者と共有し、再予約できるようにする必要があります。
代理店は、このような連絡がタイムリーに受け取れるよう、特定の監視付き連絡方法を提供する必要があります。一般的な、または監視されていない連絡方法からの応答がない場合、旅行者のリスクが高まる可能性があります。
予約ページ
チェックアウトの詳細
BP5: 価格表示には、合計価格と税金および手数料の内訳を含める必要があります。
上記の共通要件に加えて、施設collectの実装では、デポジットポリシーに関する情報を表示する必要があります。
D) 預金
施設コレクト予約でデポジットを徴収する場合、デポジットポリシーと支払いスケジュールを旅行者に表示する必要があります。
確認ページ
予約に関する重要な情報の共有
CP1: 価格表示には、合計金額と、内訳が記載されている場合は税金と手数料を含める必要があります。
上記の共通要件に加えて、施設collectの実装では、消費税とデポジットポリシーに関する情報を表示する必要があります。
C) 売上税
B2B施設 コレクト実装のsales_tax が夜間配列によって返された場合、料金の内訳に個別に表示します。この項目は、地方自治体や州によって徴収される税金の詳細のため、現地の法律に従って表示する必要があります。
E) 預金
施設コレクト予約でデポジットを徴収する場合、デポジットポリシーと支払いスケジュールを旅行者に表示する必要があります。
確認メールまたはバウチャー
参考のため、旅行者の予約情報を提供します。
ER6: 価格表示には、合計価格と税金および手数料の内訳を含める必要があります。
上記の共通要件に加えて、施設collectの実装では、消費税とデポジットポリシーに関する情報を表示する必要があります。
C) 売上税
B2B施設 コレクト実装のsales_tax が夜間配列によって返された場合、料金の内訳に個別に表示します。この項目は、地方自治体や州によって徴収される税金の詳細のため、現地の法律に従って表示する必要があります。
E) 預金
B2Bを導入する際に施設を使用してデポジットを徴収する場合は、デポジットポリシーと支払いスケジュールを旅行者に表示する必要があります。
ER8: 確認メールには、支払いが 施設 によって行われることを明記すべきです。
旅行者のEメール確認書には、予約が確保され、施設が以下の場所で支払いを受け取る旨が記載されている必要があります。check-in. 払い戻し不可の施設コレクトレートでの予約の場合、予約完了後すぐに施設から旅行者に請求が来る可能性があることをEメールに記載する必要があります。
B2C導入の具体例
チェックリスト を作成しましたので、開発をサポートしたり、要件に関するフィードバックを提供したりする際にお役立てください。サイトレビューにスクリーンショットを提供する場合は、チェックリストにスクリーンショットと対応するログを追加してください。
一般的な要件
エクスペディアの情報を正しく利用
GR10:member-onlyお得な情報への適切なアクセスの提供
Member-only案件は、closed-user環境(例えば、サイト、モバイルアプリ、またはエージェントツールへのログインを経由して)のみで販売されます。
ユーザーインターフェースの例

パッケージ料金の追加要件
上記の共通要件に加え、パッケージ料金の要素を実装に含める場合は、以下の要件も満たす必要があります。
予約ページ
チェックアウトの詳細
BP5: パッケージ料金の表示には、合計金額と税金および手数料の内訳を含める必要があります。
ダイナミックパッケージ用ホテル料金の合計価格要件は、上記の共通要件とは異なります。
A) 合計価格
パッケージの合計価格を表示するには、パッケージ価格と運送費を組み合わせる必要があります。これは通常、施設と輸送にかかる費用をper-person。
予約の合計価格は、お支払いページで旅行者に表示する必要があります。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。
ユーザーインターフェースの例

確認ページ
予約に関する重要な情報の共有
CP1: 価格表示には、合計金額と、内訳が記載されている場合は税金と手数料を含める必要があります。
ダイナミックパッケージ用ホテル料金の合計価格要件は、上記の共通要件とは異なり ます。
A) 合計価格
パッケージの合計価格を表示するには、パッケージ価格と運送費を組み合わせる必要があります。これは通常、施設と輸送にかかる費用をper-person。
予約の合計金額は、確認ページで旅行者に表示されなければなりません。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。
確認メールまたはバウチャー
参考のため、お客様の予約情報を提供します。
ER6: 価格表示には、パッケージ料金の総額、および内訳が提示されている場合は税金と手数料を含める必要があります。
ダイナミックパッケージ用ホテル料金の合計価格要件は、上記の共通要件とは異なります。
A) 合計価格
パッケージの合計価格を表示するには、パッケージ価格と運送費を組み合わせる必要があります。これは通常、施設と輸送にかかる費用をper-person。
予約の合計金額は、確認ページで旅行者に表示されなければなりません。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。
公開されたダイナミックパッケージ用ホテル料金の追加要件
上記の共通要件に加え、実装にパッケージ料金要素を含める場合は、以下の要件も満たす必要があります。
予約条件
晒される資格 ダイナミックパッケージ用ホテル料金
EXP1: ダイナミックパッケージ用ホテル料金が表示されるシナリオ
旅行者には、ダイナミックパ ッケージ用ホテル料金が表示されます:
- ご出発が30日以上先の場合、対象コンポーネントのご予約後20日間ご利用いただけます。
- ご出発が30日以内の場合、対象コンポーネントのご予約から10日間ご利用いただけます。
EXP2:往復
ホテル滞在は、予約の両端から3日以内に発生する必要があります。
EXP3: 片道
ご搭乗日の前後1週間以内のご宿泊に限ります。
EXP4: 適格部品の購入
露出したレートは、旅行者に提供することができます:
- 飛行機を利用した旅行
- パッケージの大部分を占める鉄道旅行
- ご予約のホテル滞在期間中、少なくとも全期間分のレンタカーをご利用いただけます。
- 一泊クルーズ
- 総料金の35%以上のイベントまたはアクティビティ(最低カート金額#1$100)
EXP5:コンポネントのご予約をされたご旅行者に限り、公開料金をご提供します。
旅行者はアフィリエイトサイトにログインし、Eメールによるレートオファーや予約済み旅程へのユニークなリンクにアクセスする必要があります。
最大客室数は、予約のコンポーネントチケット数を超えることはできません。
cross-sell、旅行者が特別割引を受けられる理由について、適切なメッセージを掲載する必要があります。
EXP6: デスティネーション制限
パッケージ・コンポーネントの目的地は、ご予約いただいたホテルから200マイル以内でなければなりません。
EXP7:rate_optionパラメータを含む
公開されているダイナミックパッケージ用ホテル料金で統合を行う場合、常にrate_option の値cross_sell を送信する必要があります。
予約ページ
チェックアウトの詳細
BP6: 価格表示には、合計価格と税金および手数料の内訳を含める必要があります。
注: ダイナミックパッケージ用ホテル料金の実装が公開されている場合の価格表示要件は、上記の共通要件とは異なります。
A) 合計価格
予約の合計価格は、お支払いページで旅行者に表示する必要があります。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。
最終的な内訳には、宿泊料金(合計または1泊あたり)、追加宿泊料金(後述のproperty_fee フィールドにあるものを除く)、すべての宿泊金額および税金、請求可能な合計金額が含まれ、施設で現在支払うものと後日支払うものを明記する必要があります。
B) 税金の明細
価格表示には、tax_and_service_fee とproperty_fee の合計を「税金と手数料」というタイトルの1行として含める必要があります。 料金の内訳に含まれる税金と手数料の合計に言及する場合、以下の正確なテキストを表示することが法的に義務付けられています。これは、pop-up, プレーンテキスト、モーダル、またはその他の実装として表示できます。施設料金はチェックアウトページに別途表示すべきではありません。
"税金は業者(e.g. ホテル)に支払う税金回収料です。詳細は利用規約をご覧ください。サービス料は、お客様のご予約を処理するための報酬として保持され、ベンダーによって請求される手数料が含まれる場合があります。" 翻訳はエクスペディア パートナーソリューション でご覧いただけます。
tax_and_service_fee、返される金額には、税務当局によって義務付けられた税金と手数料のみが含まれます。
C) パートナーサービス料と予約手数料
Expedia Group、追加サービス料金や予約料金の免除を許可する場合、両者を明確に区別する必要があります。貴団体が予約に加算するサービス料を課す場合、その料金が貴団体によって課されるものであり、Expedia Group、別個のサービス(つまり、宿泊施設の提供に対する追加料金ではない)に対して課されるものではないことを、旅行者に明確に伝えなければなりません。料金は、既存の税金および手数料の項目に含まれない場合があります。あなたの施設が課す料金を「料金」という言葉で表現しないでください。代わりに、"アフィリエイト・ブッキング・チャージ "または "アフィリエイト・サービス・チャージ "を使用することができます。
確認メールまたはバウチャー
参考のため、お客様の予約情報を提供します。
ER6: 価格表示には、パッケージ料金の総額、および内訳が提示されている場合は税金と手数料を含める必要があります。
公開されたダイナミックパッケージ用ホテル料金の合計価格要件は、上記の共通要件とは異なります。
A) 合計価格
パッケージの合計価格を表示するには、パッケージ価格と運送費を組み合わせる必要があります。これは通常、施設と輸送にかかる費用をper-person。
予約の合計金額は、Eメールの領収書に旅行者に表示されなければなりません。合計価格は API レスポンスと一致する必要があり、切り上げや切り捨て、通貨換算は許可されていません。
追加 施設コレクト要件
上記の共通要件に加え、実装にパッケージ料金要素を含める場合は、以下の要件も満たす必要があります。
一般的な要件
エクスペディアの情報を正しく利用
GR6: 代理店は施設のキャンセルプロセスをサポートする必要があります。
施設のコレクト(または後払い)予約では、施設がMORとして機能します。予約時に提供された支払いカードを確認します。支払いに失敗した場合、またはカードが有効であることを確認できない場合、施設は有効な支払い方法についてエージェントに連絡を試みます。もし、施設からの返信がない場合は、14日前まで予約をキャンセルすることができます。check-in.
予約がキャンセルされると、サプライヤーのキャンセル通知が予約連絡先に送信されます。このメッセージを旅行者と共有し、再予約できるようにする必要があります。
代理店は、このような連絡がタイムリーに受け取れるように、特定の監視付き連絡方法を提供する必要があります。一般的な、または監視されていない連絡方法からの応答がない場合、旅行者のリスクが高まる可能性があります。
予約ページ
チェックアウトの詳細
BP5: パッケージ料金の表示には、合計金額と税金お よび手数料の内訳を含める必要があります。
上記の共通要件に加えて、施設collectの実装では、デポジットポリシーに関する情報を表示する必要があります。
D) 預金
施設コレクト予約でデポジットを徴収する場合、デポジットポリシーと支払いスケジュールを旅行者に表示する必要があります。
確認ページ
予約に関する重要な情報の共有
CP1: 価格表示には、合計金額と、内訳が記載されている場合は税金と手数料を含める必要があります。
上記の共通要件に加えて、施設collectの実装では、デポジットポリシーに関する情報を表示する必要があります。
D) 預金
施設コレクト予約でデポジットを徴収する場合、デポジットポリシーと支払いスケジュールを旅行者に表示する必要があります。
確認メールまたはバウチャー
参考のため、お客様の予約情報を提供します。
ER6: 価格表示には、合計価格と税金および手数料の内訳を含める必要があります。
上記の共通要件に加えて、施設collectの実装では、デポジットポリシーに関する情報を表示する必要があります。
D) 預金
B2Bを導入する際に施設を使用してデポジットを徴収する場合は、デポジットポリシーと支払いスケジュールを旅行者に表示する必要があります。
ER8: 確認メールには、支払いが 施設 によって行われることを明記すべきです。
旅行者のEメール確認書には、予約が確保され、施設が以下の場所で支払いを受け取る旨が記載されている必要があります。check-in. 払い戻し不可の施設コレクトレートでの予約の場合、予約完了後すぐに施設から旅行者に請求が来る可能性があることをEメールに記載する必要があります。