Developer Hub
これは自動生成された翻訳です。

Vrbo on Rapid 統合ガイド

パートナー向け Vrbo 統合プロセスのガイドです。

概要

この記事は、Rapid と Vrbo の統合プロセスに関するガイドです。統合の仕組み、API リクエストとレスポンスの例、制限事項、エラーの処理、よくあるご質問などを取り上げます。

このガイドは、推奨される Vrbo 提供施設を対象としています。高度なユーザーケースについては、以下の高度な統合ガイドをご覧ください。

|

Geography

注意点

  • Rapid Geography APIをご利用で、Vrboの機能が有効になっているパートナー様は、従来の宿泊施設に加え、すべてのGeography APIからVrboの 施設IDにもアクセスできます。

重要なトピック : マッピング

  • 予約が成立するまで施設の住所は開示できませんのでご注意ください。詳細については、滞在に関する重要事項の統合ガイドをご覧ください。
  • パートナー様側で Content API の緯度と経度を独自の地理情報ソリューションと組み合わせて、施設をマッピングしていただく必要があります。
  • プライバシーを要求している宿泊施設では、地図表示に難読化された緯度 / 経度を使用する必要がありますが、宿泊施設の正確な位置がお客様に表示されない限り、宿泊施設検索に正確な緯度 / 経度を使用できます。

他の宿泊施設との主な違い

  • パートナー様は、Vrboと宿泊施設に関する「地域」の回答、Vrboのみ(有効化されたプロフィールでsupply_source=vrbo を使用)、または宿泊施設のみ(supply_source=expedia を使用)をリクエストすることができます。supply_sourceが指定されていない場合、Rapid Geography APIではデフォルトで宿泊施設のみが対象となります。

Geography に関してよくあるご質問

**Q. ** Vrbo 宿泊施設のみ、または Vrbo 以外の宿泊施設のみを返すように Geography API をフィルタリングできますか ?
**A. ** はい、パートナー様は supply_source=vrbo を使用してフィルタリングしていただけます。Vrbo 提供施設へのアクセスがプロフィールで許可されていない場合、結果は返されません。

コンテンツ

注意点

  • Vrboのコンテンツは、supply_source=vrbo を指定することで、他の宿泊施設と同様にRapid Content APIを通じて提供されますが、以下のスキーマの違いにご注意ください。
  • Vrboのコンテンツは、他のRapidの宿泊施設と比較して、施設の管理者による更新頻度が高くなっています。施設の掲載情報に誤りがあると、お客様による評価が低くなったり、サポートコールや返金リクエストにつながったりすることがあります。お客様に施設、設備やサービス、ポリシーが正確に伝わるように、少なくとも週 1 回、Vrbo のコンテンツを更新することを強くお勧めします。
  • Vrbo プレミア オーナー プログラムは、オーナーによるキャンセル率の低さ、口コミの評価の高さ、Vrbo プラットフォームを介してお客様にサービスを提供した経験に基づき、高いお客様満足度を実現することが実証されているオーナーのための、招待者限定の特典となっています。パートナーの皆様は、. を使用して「プレミアホスト」の宿泊施設を特定することができますattribute_id=1073745445。また、パートナーの皆様は、リクエストに「attribute_id=1073745445」を含めることで、検索結果を絞り込み、プレミアホストの物件のみを表示させることができます。

他の宿泊施設との主な違い

Vrbo 固有のフィールド :

API説明
コンテンツファイルVrboの物件情報は、他のRapid宿泊オプションとは別のコンテンツファイルで提供されています。
フィールド説明
vacation_rental_details:registry_numberバケーションレンタル施設を表示するための必須フィールドです。詳細については、公開要件を参照してください。
個人所有の施設属性1073745102。「プライベートホスト 施設」とは、施設 がプライベートホストによって管理されていることを示しています。表示に必須であり、追加の必須説明も含まれます。詳細については、公開要件を参照してください。
プロのホスト 施設属性1073745142「プロフェッショナル 施設 ホスト/マネージャー」は、施設 がプロのホスト/マネージャーによって管理されていることを示しています。表示に必須であり、追加の必須説明も含まれます。詳細については、公開要件を参照してください。
プレミアオーナー属性1073745445。「プレミアパートナー」とは、施設 がプレミアホストによって管理されていることを示します。「プレミアホスト」のマークを掲載物件に付与したり、検索結果を絞り込んで「プレミアホスト」の物件のみを表示したりすることができます。
statistics定員、ベッドルーム数、バスルーム数、部屋数 (1 棟貸しのバケーションレンタルの場合は 1)、宿泊施設の床面積 (平方メートルと平方フィート) など、バケーションレンタルユニットに固有の情報が含まれます。検索結果および宿泊施設詳細ページの上部に主要な宿泊施設情報の概要を表示するために使用する必要があります。
バスルームとベッドルームの数属性 1073743378「ベッドルームの数」は、棟内のベッドルームの数を指しています。属性 1073743379「バスルームの数」は、棟内のバスルームの数を指しています。
vacation_rental_details:property_manager施設管理者の名前、画像、対応言語 (ある場合) が含まれています。宿泊施設を管理するオーナーにお客様を紹介するために使用する必要があります。連絡先情報は、ご予約完了後に、「エッセンシャル・ステイ」コンテンツの一部としてご案内いたします。
>>「エッセンシャル・ステイ」コンテンツをご覧ください
vacation_rental_details:unit_configurations客室にあるベッドタイプとそれぞれの数を表します。宿泊施設のレイアウトをお客様に表示し、宿泊施設にお客様の同行者も宿泊できるという安心感を与えるためにこの情報を使用する必要があります。
vacation_rental_details:house_rulesこのフィールドは廃止されています。代わりに vacation_rental_details:enhanced_house_rules を使用してください。
vacation_rental_details:enhanced_house_rules「拡張ハウスルール」には、ペット、パーティー、お子様、喫煙に関する方針など、重要なポリシー情報が含まれています。「additional_information」には、ポリシーの詳細説明、アクセスコード、パスワード、画像、およびstay-collectedの料金(市観光税やusage-basedの料金など)など、ゲストの滞在に不可欠な各ポリシーの詳細を記載することができます。
詳細については、Vrboの「エッセンシャル・ステイ」コンテンツガイドをご覧ください。
vacation_rental_details:rental_agreement施設管理者が用意している PDF またはウェブサイトへのリンクを提供し、お支払いページに表示する必要があります。レンタル契約書に署名して返送または提出するお客様側の対応も必要になる場合があります。
vacation_rental_details: free_textこれはオーナーが入力する自由入力形式のテキストフィールドで、宿泊施設でお客様が利用できるユニークな属性や体験をアピールするためのものです。この説明には、近隣の観光スポット、オーナーから提供を受けられるオプションのサービス、またはお客様が予約する前に理解しておく必要があるその他の重要な情報 (構造、騒音、水の状態、スキー場へのアクセス、駐車場など) も含まれる場合があります。このセクションはかなり冗長になる可能性があるため、このフィールドの UI 表示には、特にモバイルエクスペリエンスにおいて慎重な注意を払う必要があります。

このフィールドが存在しない場合、パートナー様は Descriptions.General にフォールバックする必要があります。
descriptions.general宿泊施設の属性、設備やサービス、所在地に基づき、機械的に生成されたバケーションレンタル施設の説明を提供します。このテキストにはオーナーからの案内や情報は含まれていません。このフィールドは従来型の宿泊施設に最も関係があります。vacation_rental_details.free_text が存在しない場合にこのフィールドを使用する必要があります。
traveler_service_feeこのフィールドは廃止されています。使用しないでください。check-outの推奨表示テキストについては、公開要件をご参照ください。
>> 公開要件を確認する

Vrbo 施設に関係のないフィールド :

フィールド説明
施設の評価現時点では Vrbo の施設は評価の対象ではありません。お客様の口コミの評価が代わりに使用される場合があります。
客室の詳細1 棟貸しのバケーションレンタル施設には関係ありません。代わりに客室レベルの情報を使用する必要があります。
料金プランVrbo の施設には関係ありません。
客室レベルの情報客室の詳細はすべて施設レベルで提供されます。Vrbo の施設には客室レベルのコンテンツがないため、通常は客室レベルで提供されるアメニティ情報が vacation_rental_details という新しいセクションに含まれています。
vrbo_srp_idlisting_idlisting_numberlisting_sourcelisting_unitこれらのフィールドは Vrbo リンクオフモデルにのみ関連しますが、宿泊施設のマッピング / マッチングにも使用される場合があります。
IPM_NameVrbo IPM トライアルに参加しているパートナー様のみが使用します。値は IPM の名前を提供するもので、これをお客様に伝えることで、お客様のクレジットカードに課金し滞在に関する電子メールをお客様に送信する請求元を通知する必要があります。

コンテンツに関するよくあるご質問

**Q. ** 住所が Rapid コンテンツに提供されていない場合、Vrbo コンテンツをマッピングするにはどうすればよいですか ?
**A. ** Rapid Geography API または施設の緯度と経度を使用して、施設の地理的位置を特定できます。


**Q. ** Vrbo の施設は Rapid コンテンツファイルに含まれていますか?
**A. ** はい。API リクエストで supply_source=vrbo を渡すことで、Vrbo 固有のコンテンツファイルを取得できます。


**Q. ** Vrbo の施設はすべての言語で利用できますか?
**A. ** はい。ただし、オーナーが入力したいくつかの自由入力形式のテキストフィールドはローカライズされず、代わりにオーナーの言語で表示されます。これらの影響を受けるフィールドには、property_description (descriptions.general)、強化されたハウスルール (vacation_rental_details:enhanced_house_rules)、滞在に関する重要事項、(Vrbo で簡単に行える) オーナーからお客様へのメールメッセージなどがあります。


**Q. ** お客様が Vrbo を知りません。すべての地域で Vrbo ブランドの表示が必要ですか?
**A. ** 表示は必要ですが、ドイツ、フランス、オーストラリア、ニュージーランドでは、現地の Vrbo ブランドで代用いただけます。以下の付録 2 をご覧ください。ページおよび地域ごとの要件については、公開要件ガイドをご覧ください。パートナー様が複数のサプライヤーから同じ施設を調達している場合は例外もあり得ますが、予約するサプライヤーとして Vrbo が特定された時点で、速やかに Vrbo の名前を表示する必要があります。お客様に説明を行い、予約後の期待事項を設定するうえで、Vrbo ブランドを紹介することは重要なステップです。


**Q. **bed_groups がない場合、各客室のベッドタイプを説明するにはどうすればよいですか?
**A. ** ベッドタイプの説明に関する詳細については、「ユニット構成」のページをご覧ください。
>> ユニット構成について

ショップ

注意点

  • Vrbo の施設は 1 棟の宿泊施設全体を指し、共有宿泊施設ではありません。
  • Vrbo の施設はすべて 1 棟貸しです。
  • Vrbo の施設は単一の料金プランのみを返します。
  • 損害補償金がある施設は、ショッピングリクエストで exclusion=refundable_damage_deposit を渡すことで除外する必要があります。これらの施設を有効にする前に知っておくべきことの詳細については、高度な統合ガイドをご覧ください。
  • デポジットに関するポリシーがある宿泊施設は除外されます。詳細については、以下の高度な統合ガイドをご覧ください。
  • 当日予約はサポートされていません (空室なしが返されます)。

重要なトピック : Vrbo 予約の Merchant_of_record

Rapid Shop の merchant_of_record フィールドは、Rapid 施設の Vrbo では異なる意味を持ちます。

  • 予約時に提供されたカードに誰が請求するかを表すものではありません。予約はすべて前払いとなります。
  • merchant=expedia (「Merchant」) は、予約成立率が高く、エラーの説明に一貫性がある EG チェックアウトシステムを使用して予約が行われることを示しています。
  • merchant=property (「Agency」) は、従来の Vrbo チェックアウトシステムを使用して予約が行われることを示しています。この提供施設の販売は、デフォルトでは無効になっています。詳細については、高度な統合セクションをご覧ください。
  • 施設は、1 つのモデルに関連付けられているわけではありません。「Merchant」の資格は、以下の 3 つの重要な要素に基づいています。
    • 返金可能な損害補償金なし (推奨されていない高度な統合オプション。以下の高度な統合セクションを参照)
    • デポジットに関するポリシー / お支払いスケジュールなし (推奨されていない高度な統合オプション。以下の高度な統合セクションを参照)
    • 空室状況を確認するには、目的地の通貨で検索を実行する必要があります。

重要なトピック : Vrbo 予約の通貨コード

ショップリクエストで指定された通貨は、予約で使用する通貨には影響しません。

  • Vrbo 予約の通貨を指定することはできません。使用する通貨は常に施設の通貨と一致します。
  • 重要:「販売者」としてVrboの物件を最大限に活用するためには、パートナーの皆様は、Rapid Shopへのすべてのリクエストに、決済通貨を明記していただく必要があります。目的地の通貨が指定されていない場合は、指定された通貨での支払いをオーナーが選択している利用可能な施設のみが Rapid Shop レスポンスで返されます。地域別の目的地の通貨に関する推奨事項については、付録を参照するか、詳細なマッピングについてパートナーコネクトの連絡先までお問い合わせください。

重要なトピック : Vrbo 予約の国コード

ショップリクエストで指定された国コードは、予約時に提供されたクレジットカードの請求先国と一致させる必要があります。これは、Vrbo では請求先住所の国コードによって決定されるお客様の所在地に基づいて、旅行者サービス料に対する VAT を請求する必要があるためです。

  • 一致しない場合、VAT 徴収要件の違いにより予約エラーが発生する可能性があります。
  • お客様が支払い請求先住所を入力した後、パートナー様は、国コードがショッピング中に Rapid に渡された国コードと同じであることを確認する必要があります。これらの値が異なる場合、予約を送信するとエラーが発生します。パートナー様は、予約を送信する代わりに、お客様から提供された請求先住所を使用して再度ショップリクエストを行い、予約に有効な料金を取得する必要があります。予約リクエストを送信する前に、料金が変更された (高くなった、または安くなった) ことをお客様に通知する必要があります。

他の宿泊施設との主な違い

Vrbo 固有のフィールド :

料金説明
property_fee清掃料金、管理費、追加ゲスト料金などを含む、予約にかかる施設料金の総額を説明します。
traveler_service_fee予約を容易にし、サポートを提供するために Vrbo によって請求されるサービス料です。この料金は、予約の一部が返金不可となった時点で返金不可となります。表示の詳細については、公開要件をご覧ください。

旅行者サービス料と Rapid Shop の国選択 : Vrbo の料金応答に旅行者サービス料が含まれる場合、金額には Rapid Shop リクエストで使用される国に対応する VAT が含まれます。予約を正常に行うには、ショップでリクエストされた国がチェックアウト時に使用される支払いの国と一致していることをパートナー様が確認する必要があります。

Vrbo 施設に関係のないフィールド :

フィールド説明
客室 ID客室名と料金 ID は Vrbo 在庫には適用されないので、表示しないようにしてください。
利用可能な客室Vrbo の施設では常に 0 です。緊急性を示すためにこのフィールドを使用しないでください。
ベッドグループVrbo の施設ではベッドに関する選択肢や希望には対応できないので、適用されません。
プロモーション ID と説明Vrbo の在庫には適用されません。

ショップに関するよくあるご質問

**Q. ** Vrbo の施設はどのような方法でランク付けできますか?
**A. ** お客様の評価スコア / 評価数をご利用いただけます (利用可能な場合)。さらに、属性「1073745445」の「プレミアパートナー」を使用すると、「プレミアホストプログラム」の認定を受けたホストが管理する物件を特定することができ、これを活用して「施設」の並べ替えに影響を与えることも可能です。

**Q. ** 1 泊の宿泊が許可されていないのはなぜですか?
**A. ** VrboCareは2泊以上の滞在にのみ適用されるため、ゲストに不都合が生じないよう、パートナーの皆様には短期の予約を受け付けないことをお勧めいたします。

**Q. ** 短い予約期間 (72 時間未満) が許可されていないのはなぜですか?
**A. ** オーナーが予約リクエストを処理したり、到着に向けて施設の準備を行ったり、お客様と連絡を取ったりするために時間が必要なためです。お客様満足度が低下したり、サプライヤーがキャンセルしたりするのを避けるため、パートナー様は直前の予約を制限する必要があります。

**Q. ** お客様がペット可の施設を検索できるようにするにはどうすればよいですか?
**A. ** 現在 Rapid では、ペットに関するルールで絞り込んだり、ペット料金込みの価格を表示する機能は提供されていません。パートナー様はコンテンツの施設の属性に基づいてペット可の施設を特定でき、お客様は個々のペットに関するルールを確認できます。ペットに関する特定のポリシーのより詳細かつ正確な情報がわかる場合がある、ペットに関するポリシーの追加情報をオーナーが vacation_rental_details.free_text 内または enhanced_house_rules 内に提供する場合があります。ペットやそれに付随する料金の支払いについて、施設のオーナーと相談するようにお客様に伝える必要があります。

**Q. ** 長期滞在 (28 泊を超える) を検索できますか?
**A. ** はい、RapidではVrbo物件の最大365泊までの予約・販売が可能ですが、90泊までに制限することを強くお勧めいたします。ショップスロットリング制限に近づいているパートナー様は、長期滞在の検索はショップの呼び出し数への影響が大きいことに注意する必要があります。

**Q. ** Rapid で Vrbo.com と同じ料金明細が表示されないのはなぜですか?
**A. ** 現在 Rapid では、施設の料金を個々の構成要素に分割することはできません。これらの構成要素には、清掃料金、管理費、追加ゲスト料金などが含まれる場合があり、property_fees にまとめられます。

**Q. ** Vrbo 在庫をパッケージ予約にできますか?
**A. ** いいえ、Vrboの物件をパッケージの一部として販売したり、予約を受け付けたりすることはできません。

**Q. ** Vrbo の施設は、会員限定プロモーションの対象になりますか?
**A. ** 現時点ではできません。

**Q. ** Rapidに掲載されているVrboの物件は、#で提供されているような、早期予約割引、直前割引、新規掲載割引、週単位・月単位の割引などのプロモーションの対象となりますか?Vrbo.com?
**A. ** はい、Rapidでは、従来の宿泊施設と同様に、プロモーションの説明文、プロモーション価格、および元の価格(取り消し線付き)が表示されるため、旅行者に対してそのオファーや割引情報をアピールすることができます。

**Q. ** ショップリクエストを行う段階で、チェックアウトの前にお客様とオーナーのやり取りを可能にすることはできますか ?
**A. ** 現時点ではできません。

**Q. ** 空室状況のレスポンスで、正しいマーケティング手数料は表示されますか?
**A. **gross_profit の見積もりを参照して、ご契約内容に基づいて計算してください。

**Q. ** Vrbo on Rapid の料金は Vrbo および Expedia Group のサイトの料金と同じですか ?
**A. ** Rapid の Vrbo 施設の価格には、Expedia Group ブランドサイトに表示される価格を反映する必要がありますが、Vrbo で表示される価格とは異なる場合があります。これは多くの場合、サービス料金の計算に基づいており、若干高くなったり低くなったりする場合があります。さらに、施設料金の合計額はブランドによって若干異なる場合があります。

ご予約とお支払い

注意点

  • オーナーとお客様がスムーズにやり取りできるように、それぞれの予約について、お客様の連絡先詳細 (名前、電話番号、メールアドレス) をパートナー様にご提供いただく必要があります。
  • Vrbo には、予約時に州 / 都道府県と郵便番号が必要な国に関する厳しい要件があります。詳細については、以下の高度な統合ガイドをご覧ください。
  • 宿泊予約における同意書は、コンテンツで提供される場合、チェックアウトページに表示する必要があります。詳細については、公開要件を参照してください。
  • Rapid API 経由の Vrbo 予約では、支払いにバーチャルカードが必要です。お客様のクレジット カードの送信を希望されるパートナー様は、高度な統合ガイドをご覧いただく必要があります。
  • 使用する通貨は Vrbo の施設で事前に定義されているため、バーチャルカードの利用限度額に注意を払う必要があります。資金不足による予約エラーを回避するために、可能性のある為替レートの差と国際銀行手数料がバーチャルカードに反映されていることをパートナー様は確認する必要があります。
  • 現時点では、Rapid での Vrbo 予約では Expedia Affiliate Collect (EAC) がサポートされていないことにご注意ください。複数回の支払いが必要な施設では、パートナー様がクレジットカードの請求元になることはできません。これらの施設を有効にする方法については、高度な統合ガイドをご覧ください。
  • 現在、宿泊施設への要望は施設に伝えられません。宿泊について宿泊施設に要望がある場合、お客様は予約後にオーナーに直接相談する必要があります。

重要なトピック : 支払い

検証

  • Vrbo on Rapid の予約を行うには、必ず請求先住所が一致する有効なクレジットカードが必要になります。
  • 地域によっては、Vrbo が 0 ドルまた少額でカードを認証する場合があります。バーチャルクレジットカードを送付する場合は、複数の請求を受け付けられるように設定されていることを確認する必要があります。
  • クレジットカードの認証ルールが他の Rapid の予約とは異なります。詳細については、付録 4 をご覧ください。
  • 多くの場合、Vrbo の価格には、Vrbo が請求するサービス料が含まれています。このサービス料に対して法律で徴収が義務付けられている VAT の違いのため、サービス料の金額はお客様の宿泊地によって異なります。その結果、ご予約時にご登録いただいたカードの請求先住所が、Shopでの手続き時に指定された国と異なる場合、「国コードが無効です」という予約エラーが発生します。このような不一致が生じないよう、point-of-saleでショッピングされたカードへの支払いを制限することができます。

注: この不一致は、予約エラーを防ぐため、予約を送信する前に必ず検出する必要があります。この場合、ゲストの請求先国に基づいて新しい価格をリクエストするには、施設 に対してre-shopを実行する必要があります。

お客様のクレジットカード

  • 他の通貨で予約を行った場合、国際取引手数料が発生する可能性があること、また返金を受ける際に為替レートの影響を受ける可能性があることをお客様に知らせる必要があります。

パートナー クレジット カード (バーチャルカード)

  • 他の通貨で予約を行う際は、国際取引手数料が適用される可能性があるため、必ずご確認いただくようお願いいたします。
  • 支払いスケジュール(Rapid Shopの入金)を提示する物件は、掲載しないでください。
  • パートナーカードは、必要な (0 ドルまたは少額の) 事前承認を可能にするために、複数の請求を許可するように設定する必要があります。
  • パートナーカードの請求先住所は、販売サイトの使用する通貨と一致している必要があります。
  • パートナーカードは、複数の通貨での請求を許可するように設定する必要があります。または、銀行手数料を削減しながら請求を可能にするには、パートナー様が一連のカードを用意する必要があります。
  • カードへの請求が可能であることを確認するため、書籍のリクエストを送信する数秒前にVCCを有効にしてください
  • お支払いスケジュールを持つ施設の詳細については、以下の高度な統合セクションをご覧ください。

重要なトピック : 施設の損害

返金可能な損害補償金 (RDD) :

  • 施設が要求する RDD が Rapid Shop に表示されますが、これは予約時に徴収される保証金を表しています。お客様が施設に損害を与えなかった場合、保証金はお客様の出発から 2 週間以内に返金されます。
  • RDD がある施設は、Rapid Shop リクエストの一環として、Rapid Shop の除外パラメーターを使用して表示されないようにする必要があります。
  • 詳細については、以下の「高度な統合」のセクションをご覧ください。

カードオンファイル :

  • カードオンファイルは、お客様が施設に損害をもたらした場合に、お客様が施設を去った後に Vrbo が Rapid Shop で返された金額まで指定カードに請求できることを表します。損害賠償請求が行われると、Vrbo からお客様に損害の概要と請求書が送信されます。予約時に指定されたカードへの請求ができなかった場合、Vrbo からお客様に、Vrbo サイト経由での支払いの送信を求める通知が送信されます。
  • 滞在中に施設が損害を被った場合、施設が請求する可能性のある金額をお客様に通知する必要があります。これは、card_on_file_limit オブジェクトの下のショップレスポンスで返されます。
  • カードオンファイル施設は、Rapid Shop リクエストの一環として、Rapid Shop の除外パラメーターを使用して表示されないようにすることができます。

重要なトピック : Vrbo 予約の通貨コード

ショップリクエストで指定された通貨は、予約で使用する通貨には影響しません。

  • Vrbo 予約の通貨を指定することはできません。使用する通貨は、常に施設が指定した通貨と一致します。なお、価格確認の応答で返される通貨は、Rapid Shopで返される通貨と異なる場合があり、これは決済手段に請求される請求通貨となります。
  • お支払いにバーチャルカードをご利用の場合は、ご利用の銀行が請求する国際為替手数料を賄えるだけの余裕額を確保しておく必要があります。
  • 国際取引に銀行手数料がかかる可能性があること、また為替レートの変動のため、予約をキャンセルした場合の返金が最初に支払った金額と同額にならない場合があることをお客様に知らせる必要があります。

宿泊施設との主な違い

Vrbo 固有のフィールド :

フィールド説明
都道府県要件は他の Rapid ホテル在庫とは異なります。詳しくは以下をご覧ください。
郵便番号要件は他の Rapid ホテル在庫とは異なります。詳しくは以下をご覧ください。

Vrbo 施設に関係のないフィールド :

機能説明
保留 / 再開現在、Vrbo on Rapid の予約には対応していません。
宿泊施設への要望現時点では、宿泊施設への要望を施設に伝えることはできません。宿泊施設への要望がある場合は、予約後にお客様が施設に連絡する必要があります。
お客様の対応に関する指示現時点では Vrbo 予約に対応していません。

予約と支払いに関するよくあるご質問

**Q. ** 予約リクエストにはどのようなお客様情報が必要ですか?
**A. ** すべての Vrbo on Rapid 予約には、お客様がオーナーとやり取りができるように、お客様のメールアドレスと電話番号が必要です。これは、予約後またはお客様の到着前に、オーナーが到着時の出迎えやドアのアクセスコードの引き継ぎの手配など、宿泊関連の情報をメールで提供する場合があるため、非常に重要です。

Post-booking経験

Rapid APIを通じてVrboの予約が完了した後、パートナー各社は、ゲストに対し、post-bookingでの体験についてご案内ください。推奨されるガイダンスのトピックは次のとおりです。

説明の内容

  • オーナーからお客様にメッセージが送信される場合があります (サンプルトピックについては以下を参照)。こうしたメールは Vrbo (または現地の Vrbo ブランド) から送信されます。
  • 「Rapid」の「必須滞在」コンテンツに記載されている連絡先情報を使用して、ホストに連絡する方法です。
    >>「必須滞在」コンテンツの詳細はこちら
  • チェックインの手順は、到着の 72 時間前に提供されます。到着の 48 時間前になっても届かない場合、お客様はすぐにサポートまで問い合わせる必要があります。
  • その他の支払いのリクエスト
  • Rapid APIではVrboの予約に対する正式な変更はサポートされていませんが、Vrbo以外で予約を変更することは可能です。Rapid API. このシナリオでは、迅速な検索結果には総額のみが含まれます(1泊あたりの料金や滞在総額は除外されます)。なお、Rapid APIのエコシステムの特性上、Vrboで変更された予約については、non-modifiedからの取得に比べて、取得にかかる遅延が長くなる点にご留意ください。

予約の管理方法

  • お客様は、Rapid Cancel APIに基づき、提携サイトを通じて予約をキャンセルすることができます。
  • お客様はオーナーに変更をリクエストすることも、キャンセルしたうえで再予約することで変更することもできます (こちらが推奨)。
  • Vrbo の在庫に対するキャンセルのリクエストについて、予約作成から 4 時間以内にキャンセルを試みた場合は、特別な注意事項があります。
    • リクエストに対して http コードが返されることがありますが、これはバックエンドが決済を行うのにさらに時間を必要としていることを示しています。その場合、数分待ってからキャンセルをやり直してください (最初の 6 回は 10 分おき、その後は 30 分おきに試すことをお勧めします)。予約作成から5時間経過してもキャンセルが引き続きできない場合は、Rapidのログを添えてエクスペディアのサポートチームまでご連絡ください。

問題がある場合

  • サポート (パートナー、カスタマーダイレクトサポート (CDS)、または Vrbo) への連絡方法をお客様に通知します。
  • 問題が発生した場合はすぐにサポートに連絡し、滞在後まで問題の報告を保留しない (Vrbo では出発後に問題を解決できないため) ようお客様に伝えます。
  • お客様が施設にアクセスできない場合、お客様はまずオーナーへの連絡を試みる必要があります。連絡できなかった場合は、お客様はすぐにパートナー様に連絡してサポートを受ける必要があります。お客様が自分で別の宿泊施設を手配された場合、お客様に払い戻しは行われません。

注 : Vrbo の確認番号 (HA-########) は、オーナーと Vrbo サポートが利用できる唯一の参照番号であり、Vrbo のすべてのメールで参照されるため、お客様に提供する必要があります。

主なトピック:Post-bookingでの支払い

予約が完了した後、またはお客様が宿泊した後に、Vrbo のオーナーが追加の支払いをリクエストすることがあります。支払いリクエストは、お支払いページへのリンクを含む Vrbo からお客様へのメールを通じて、簡単に行うことができます (ログイン不要)。オーナーがリクエストしている追加の料金が支払われない場合、予約がキャンセルされる可能性があることをお客様に知らせる必要があります。オーナーがリクエストしているすべての料金は、 free_text の施設の説明、ハウスルール、または宿泊予約における同意書などの Rapid コンテンツの自由入力形式のテキストフィールドに含まれています。

追加の支払いのリクエストの例として、以下のようなものがあります。

  • ペットデポジットの支払い
  • 追加の宿泊料金の支払い (オーナーに滞在期間の延長をリクエストした場合)
  • 電気使用料やタオル使用料などの滞在ごとの料金の支払い
  • 施設の損害に対する支払い

stay-collectedの手数料の例については、付録5をご参照ください。

他の宿泊施設との主な違い

Vrbo 固有のフィールド :

フィールド説明
滞在に関する重要事項Vrboのウェルカムガイドであり、予約が作成された直後にゲストに提供する必要があります。
>> 詳細については、Vrboの「Essential Stay」コンテンツをご覧ください。

Vrbo 施設に関係のないフィールド :

フィールド説明
キャンセル返金額Vrbo on Rapid の予約には対応していません。
メッセージトークンVrbo on Rapid の予約には対応していません。
軽微な変更Vrbo 予約には対応していません。お客様はメールでオーナーに直接変更をリクエストするか、サポートに問い合わせる必要があります。
大幅な変更Vrbo 予約には対応していません。お客様はメールでオーナーに直接変更をリクエストするか、サポートに問い合わせる必要があります。

Post-bookingよくある質問

**Q. ** お客様は Vrbo からどのようなメールを受け取りますか?
**A. ** お客様が Vrbo から予約確認メールまたはキャンセル確認メールを受け取ることはありません。Rapid Itinerary APIに基づいて、これらの確認情報を提供することができます。

**Q. ** お客様は (Vrbo 経由で) オーナーからどのようなメールを受け取りますか?
**A. ** お客様は、予約作成時に送信されたゲストのメールを使用してホストからメッセージを受け取ります。メッセージには、お客様の到着や施設での体験において重要な情報が含まれる場合があり、滞在中のコミュニケーション チャネルとしても機能します。これらのメールは、Vrbo から簡単に送ることもできれば、オーナーから直接送ることもできます。オーナーは、SMS や WhatsApp など他の手段で連絡することもできます。

**Q. ** Vrbo on Rapid 予約は、Rapid Cancel API を使用してキャンセルできますか?
**A. ** はい。Rapid 旅程レスポンスでキャンセルトークンを使用することで、すべての Vrbo on Rapid 予約をキャンセルできます。施設管理者またはサポートにお客様がキャンセルをリクエストすることもできます。

**Q. ** Vrbo ではウェブサイトでの予約後にどのような機能を提供していますか ?
**A. ** パートナーサイトで行われた Vrbo 予約は、お客様の Vrbo アカウントではアクセスできません。お客様は、お客様とオーナー間のメッセージが含まれる、Vrbo の受信ボックスのみ利用できます。

**Q. ** Vrbo の予約はどのような方法でに変更できますか?
**A. ** お客様がキャンセルして再予約することが推奨されていますが、オーナーに連絡するか、サポートに連絡して変更リクエストを開始することにより、お客様が Vrbo 予約の変更をリクエストできます。

**Q. ** 予約の変更やキャンセルに関する Rapid 通知は受け取れますか?
**A. ** Rapid通知に登録されている場合、予約の変更やキャンセルがあった際に通知が届きます。なお、現時点では、誰が予約を変更したかを特定することはできませんので、ご了承ください。

**Q. ** Vrbo オーナーとのやり取りは施設メッセージセンターでできますか?
**A. ** 現時点ではできません。

**Q. ** お客様はチェックイン情報をどのように受け取りますか?
**A. ** ご到着の72時間前までに、ゲストへウェルカムガイドをお送りいただくのは、お客様の責任となります。このウェルカムガイドの内容は、Rapid Itinerary API の Rapid の「滞在に関する重要事項」から採られています。すべてのオーナーがこの機能を利用しているわけではないことに注意してください。多くのオーナーが、代わりにウェルカムガイドをメールメッセージとしてお客様に送信しています。到着の 48 時間前になっても到着時の手順が届かない場合は、パートナーサポートに連絡し、オーナーに連絡するか、別の宿泊施設を手配するのを手伝ってもらうようにお客様に伝える必要があります。詳細については、Rapid の「滞在に関する重要事項」をご覧ください。

**Q. ** Vrbo の予約が確定した後、宿泊施設側でそれをキャンセルすることはできますか ?
**A. ** はい、予約からお客様の到着までの間、施設管理者はいつでも Vrbo の予約をキャンセルできます。多くの場合、予約作成後 1 日以内に、その日に空きがないことに施設管理者が気づいた場合に発生します。ゲストのご到着前にこのような事態が発生した場合は、VrboCareにて、適切な代替宿泊施設をお探しいただけるようサポートいたします。詳細については、Vrbo on Rapid サポートガイドをご覧ください。

>> #について詳しく知るVrboCare

**Q. ** 予約をキャンセルした場合、オーナーにペナルティはありますか?
**A. ** 施設管理者のキャンセルの頻度はプレミアオーナーの適格性を判断する要素となり、検索結果における施設の掲載に影響するため、施設管理者は必要なとき以外はキャンセルしないよう注意しています。「プレミアホスト」のステータスを活用して、検索結果の上位に最高の物件を表示させることで、このリスクを軽減することができます。

高度な統合ガイド

高度なシナリオ : 返金可能な損害補償金 (RDD)

一部の Vrbo 施設では、到着前に損害補償金の徴収が必要ですが、施設の状態に応じてチェックアウト後に返金されます。RDDの金額は高額になる可能性があり、お客様やご来客の皆様にとって受け入れがたい場合があるため、検索結果からこれらの物件を除外することを強くお勧めいたします。

RDD について

  • RDD を要求する施設は、ホリデーシーズンなどの繁忙期により頻繁に発生する可能性があります。
  • 約 2% の施設では、到着前に返金可能な損害保証金の支払いが必要です。
  • RDD の金額と要件は地域や季節によって異なる場合があります。

お客様には次のことを通知する必要があります。

  • 損害補償金の支払いは、最後に予定されていた支払い時に行われます (1 回払いの場合は予約時)。

RDD の例

  • オーナーの確認に基づき、損害補償金はチェックアウト後 14 日以内に返金されます。
  • 損害が発生した場合、Vrbo からお客様にメールで損害請求書が送信されます。
  • 返金可能な損害補償金の金額はチェックアウト時に表示する必要があります。
  • Rapid Shop に表示される RDD 金額は概算です。Rapid Price Check の金額はお客様に請求される金額であり、チェックアウト時にお客様に表示する必要があります。

パートナー様がクレジットカードの請求元になる場合 :

  • バーチャルカードによるお支払いを行う際は、ゲストからの保証金の徴収および返金の手続きが可能でない限り、RDDを除外することをお勧めいたします。
  • お客様には、その金額をお客様に提示し、それに応じて代金の徴収または返金を行う責任があります。

例 :

"rates": [
    {
        "refundable_damage_deposit": {
            "value": "150.00",
            "currency": "USD"
        }  
    }
]

高度なシナリオ : お客様のクレジットカード

お客様のクレジットカードを使用するには、追加の検証とお客様への連絡が必要です。

住所の検証

国によっては郵便番号の入力が不要な場合もあれば、追加情報の入力が必要な場合もあるため、Vrboでの予約では、他の宿泊施設とは異なる住所の検証が必要となります。

郵便番号がある国

countries-with-postal-codes

郵便番号がない国

countries-without-postal-codes

郵便番号およびその他の詳細情報が掲載されている国

countries-with-postal-codes-and-additional-details

対応している国のリストについては、付録4をご参照ください。

高度なシナリオ : お支払いスケジュール

Vrbo 施設では、事前に定義されたスケジュールに基づいて支払いを徴収する場合があります。これらの施設は、パートナープロフィールの設定で有効 / 無効にすることができます。お支払いスケジュールがある場合、お支払いスケジュールは Rapid Shop でも Property Collect と同様にデポジットとして表示されます。デポジットの確認方法の詳細については、Rapid Shop のドキュメントをご覧ください。

デポジットについて (お支払いスケジュール)

  • 約 20 ~ 30% の施設が、3 か月を超える長期の予約期間に対してお支払いスケジュールを提供しています。
  • 15% 未満の施設が、1 か月未満の短期の予約期間に対してお支払いスケジュールを提供しています。

お客様には次のことを通知する必要があります。

  • お支払いスケジュールの詳細は、理想的には視覚的なタイムラインビューとして、購入 / チェックアウト時に表示される必要があります。

例 :

"deposits": [
              {
               "value": "412.10",
               "due": "2027-05-17",
               "currency": "USD"
              },
              {
               "value": "236.17",
               "due": "2027-08-24",
               "currency": "USD"
              }
             ]

payment-schedule-example


  • 指定されたスケジュールに従って Vrbo サイトで支払いを行う責任があること、そうしない場合オーナーによってキャンセルされる可能性があることをお客様に通知する必要があります。
  • お客様に支払い要件を確実に知らせるため、支払い期日の前、当日、後に Vrbo からメールによるリマインダーが送信されます。

返金可の損害補償用デポジットとの組み合わせ :

  • RDD が必要な場合は、最後に予定されている支払いの一部として請求されます。1 回払いの場合は予約時に徴収されます。

パートナー様がクレジットカードの請求元になる場合との組み合わせ :

  • Vrbo.com では手動で支払いを行う必要があるため、お支払いスケジュールのある施設をクレジットカードの請求元として予約することはお勧めしません。

付録 1 : オーナーによる連絡

Vrbo の予約には、施設管理者とお客様がスムーズに直接やり取りできるように、必ずお客様のメールアドレスを含める必要があります。パートナー / エージェントメールを使用すると、オーナーによる予約キャンセルのリスクが生じる場合があります。

施設管理者からの連絡に含まれる情報の例 :

  • 歓迎メッセージと施設管理者の紹介
  • 連絡先
  • ポリシーと出発前の確認事項
  • 住所とアクセス
  • キーボックスのコード
  • お支払いスケジュール
  • 宿泊予約における同意書 (必須の場合あり。この場合、応じないと施設管理者によって予約がキャンセルされる可能性あり)
  • パスポート写真の提出依頼 (必須の場合あり。この場合、応じないと施設管理者によって予約がキャンセルされる可能性あり)
  • オーナーによるメッセージへの返信
  • お客様からのオーナーへのメッセージ

例 :

施設管理者のメッセージ

付録 2 : Vrbo による連絡

次の Vrbo メールは、Rapid API 経由で行われた予約では送信されません。

  • 予約の確認
  • お客様がキャンセルした予約
  • 施設がキャンセルした予約
  • 予約返金の確認
  • ウェルカムガイド
  • リマーケティング
  • 宿泊施設の口コミのリクエスト
  • サポートサービスの評価のリクエスト
  • キャンセル後のお客様の再ターゲティング

追加の宿泊料金 (ペット料金など) の支払い、変更 (滞在期間の延長)、損害の支払いなどを含む、お客様に送信されることがある Vrbo の支払いに関連するその他のメール :

  • リクエストされたその他の支払い
  • 支払いの確認
  • 支払いの受領
  • 施設の損害報告

Vrbo.com でのお客様とのやり取りに基づく追加のメール

  • アカウントの作成
  • パスワードのリセット
  • パスワードのリセットの確認
  • パスワードの作成

高度な統合シナリオに特化した Vrbo メールテンプレート :

  • 不正なキャンセル
  • 損害補償金の請求 - RDD 付きの施設のみ
  • 損害補償金の受領 - RDD 付きの施設のみ
  • 損害補償金の請求 - RDD 付きの施設のみ
  • お支払いスケジュールの期限切れ - お支払いスケジュールを利用する施設のみ

付録 3 : お客様向けブランド

販売サイトお客様向けブランド
フランスAbritel
ドイツFewo-Direkt
オーストラリアStayz
ニュージーランドBookabach
その他Vrbo

付録4:住所の有効性確認

住所の有効性確認にあたり、以下の国では郵便番号の入力が必要です。

  • アルゼンチン
  • オーストラリア
  • オーストリア
  • ブラジル
  • カナダ
  • デンマーク
  • フランス
  • ドイツ
  • 英国
  • ギリシャ
  • イタリア
  • オランダ
  • ノルウェー
  • ポーランド
  • ポルトガル
  • スペイン
  • スウェーデン
  • トルコ

付録5:Stay-collectedの料金例

施設 が徴収する手数料には、以下のようなものがあります:

  • 管理費
  • エアコン
  • クラブ
  • 電気
  • 暖房
  • ホットタブ
  • インターネット
  • ランドリー
  • リネン
  • バスタオル類
  • 駐車場
  • プール
  • 施設使用料
  • 水道
このページは役に立ちましたか ?
このコンテンツに改善が必要な点があれば、
サービス向上にご協力いただきありがとうございます。