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の宿泊施設と比較して、施設の管理者による更新頻度が高くなっています。施設の掲載情報に誤りがあると、お客様による評価が低くなったり、サポートコールや返金リクエストにつながったりすることがあります。ゲストの皆様に、施設 の正確な情報、設備、 および利用規約を確実にご確認いただけるよう、Vrboのコンテンツは少なくとも週1回は更新されることを強くお勧めいたします。
- Vrbo プレミア オーナー プログラムは、オーナーによるキャンセル率の低さ、口コミの評価の高さ、Vrbo プラットフォームを介してお客様にサービスを提供した経験に基づき、高いお客様満足度を実現することが実証されているオーナーのための、招待者限定の特典となっています。「プレミア・ホスト」の物件は、…で識別できます
attribute_id=1073745445。さらに、リクエストに「attribute_id=1073745445」を含めることで、検索結果を絞り込み、プレミア・ホストの物件のみを表示させることができます。
他の宿泊施設との主な違い
コンテンツファイルAPIでは、Vrboの物件は、その他のRapid Lodgingのオプションとは別に提供されています。
Vrbo-specificフィールド
| フィールド | 説明 |
|---|---|
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の「Essential Stay」コンテンツガイドをご覧ください。 |
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_id、listing_id、listing_number、listing_source、listing_unit | これらのフィールドは Vrbo リンクオフモデルにのみ関連しますが、宿泊施設のマッピング / マッチングにも使用される場合があります。 |
IPM_Name | Vrbo 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 Shopping APIの「merchant_of_record」フィールドは、Rapid掲載物件におけるVrboでは異なる意味を持ちます。
- 予約時に提供されたカードに誰が請求するかを表すものではありません。予約はすべて前払いとなります。
- merchant=expedia (「Merchant」) は、予約成立率が高く、エラーの説明に一貫性がある EG チェックアウトシステムを使用して予約が行われることを示しています。
- merchant=property (「Agency」) は、従来の Vrbo チェックアウトシステムを使用して予約が行われることを示しています。この提供施設の販売は、デフォルトでは無効になっています。詳細については、高度な統合セクションをご覧ください。
- 施設は、1 つのモデルに関連付けられているわけではありません。「Merchant」の資格は、以下の 3 つの重要な要素に基づいています。
- 返金可能な損害補償金なし (推奨されていない高度な統合オプション。以下の高度な統合セクションを参照)
- デポジットに関するポリシー / お支払いスケジュールなし (推奨されていない高度な統合オプション。以下の高度な統合セクションを参照)
- 空室状況を確認するには、目的地の通貨で検索を実行する必要があります。
重要なトピック : Vrbo 予約の通貨コード
ショップリクエストで指定された通貨は、予約の請求通貨には影響しません。
- Vrbo 予約の通貨を指定することはできません。使用する通貨は常に施設の通貨と一致します。
- 重要:「販売者」としてVrboの物件を最大限に活用するには、すべてのショップリクエストに目的の通貨を明記する必要があります。受取通貨が指定されていない場合、ショップからの応答には、その指定通貨での支払いを受け入れること を選択したホストが管理する物件のみが表示されます。地域ごとの決済通貨に関する推奨事項については、付録をご参照いただくか、より詳細な対応表については、Partner Connectの担当者までお問い合わせください。
重要なトピック : Vrbo 予約の国コード
Shopping APIのリクエストで指定された国コードは、予約時に登録されたクレジットカードの請求先国と一致している必要があります。これは、Vrbo では請求先住所の国コードによって決定されるお客様の所在地に基づいて、旅行者サービス料に対する VAT を請求する必要があるためです。
- 一致しない場合、VAT 徴収要件の違いにより予約エラーが発生する可能性があります。
- ゲストが決済先住所を入力した後、その国コードが、ショッピング中にRapidに渡された国コードと一致しているかどうかを確認する必要があります。これらの値が異なる場合、予約を送信するとエラーが発生します。その代わりに、ご予約の有効な価格を確認するためには、guest-providedの請求先住所を使用して、再度購入リクエストを行ってください。ご予約のお申し込みを送信する前に、お客様に料金の変更(値上げまたは値下げ)についてお知らせする必要があります。
他の宿泊施設との主な違い
Vrbo-specificフィールド
| 料金 | 説明 |
|---|---|
property_fee | 清掃料金、管理費、追加ゲスト料金などを含む、予約にかかる施設料金の総額を説明します。 |
traveler_service_fee | 予約を容易にし、サポートを提供するために Vrbo によって請求されるサービス料です。この料金は、予約の一部が返金不可となった時点で返金不可となります。表示の詳細については、公開要件をご覧ください。 旅行者サービス料およびRapid Shopping APIの国選択: Vrboが価格応答に旅行者サービス料を含める場合、その金額には、Rapid Shopping APIのリクエストで使用された国に対応するVATが含まれます。予約を正常に完了させるには、ショップで指定した国と、お支払いに使用する国の情報が一致していることをご確認ください。check-out. |
Vrboの物件には関係のない項目
| フィールド | 説明 |
|---|---|
| 客室 ID | 客室名と料金 ID は Vrbo 在庫には適用されないので、表示しないようにしてください。 |
| 利用可能な客室 | Vrbo の施設では常に 0 です。緊急性を示すためにこのフィールドを使用しないでください。 |
| ベッドグループ | Vrbo の施設ではベッドに関する選択肢や希望には対応できないので、適用されません。 |
| プロモーション ID と説明 | Vrbo の在庫には適用されません。 |
ショッピングに関するよくある質問
**Q. ** Vrbo の施設はどのような方法でランク付けできますか?
**A. ** お客様の評価スコア / 評価数をご利用いただけます (利用可能な場合)。さらに、属性「1073745445」の「プレミアパートナー」を使用すると、「プレミアホストプログラム」の認定を受けたホストが管理する物件を特定することができ、これを活用して「施設」の並べ替えに影響を与えることも可能です。
**Q. ** 1 泊の宿泊が許可されていないのはなぜですか?
**A. ** VrboCareは2泊以上の滞在にのみ適用されますので、お客様にご不満をおかけしないよう、短期の予約を受け付けることはお勧めいたしません。
**Q. ** 短い予約期間 (72 時間未満) が許可されていないのはなぜですか?
**A. ** オーナーが予約リクエストを処理したり、到着に向けて施設の準備を行ったり、お客様と連絡を取ったりするために時間が必要なためです。ゲストへの不都合やサプライヤーによるキャンセルを防ぐため、close-inでの予約を制限していただく必要があります。
**Q. ** お客様がペット可の施設を検索できるようにするにはどうすればよいですか?
**A. ** 現在 Rapid では、ペットに関するルールで絞り込んだり、ペット料金込みの価格を表示する機能は提供されていません。pet-friendlyの施設は、コンテンツの施設属性に基づいて特定することができ、宿泊客は各施設のペットに関する規定を確認することができます。ペットに関する特定のポリシーのより詳細かつ正確な情報がわかる場合がある、ペットに関するポリシーの追加情報をオーナーが 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 で表示される価格とは異なる場合があります。これは多くの場合、サービス料金の計算に基づいており、若干高くなったり低くなったりする場合があります。さらに、施設料金の合計額はブランドによって若干異なる場合があります。
**Q. ** 「在庫状況」と同様に、「価格チェック」の際にも取り消し線付きの価格が表示されますか?
**A. ** いいえ。販促データは「在庫状況確認」の通話中には確認できますが、「価格確認」の応答では確認できません。
ご予約とお支払い
知っておくべきこと
- ホストとゲスト間の連絡を円滑にするため、ご予約のたびにゲストの連絡先(お名前、電話番号、メールアドレス)をご提供いただく必要があります。
- Vrbo には、予約時に州 / 都 道府県と郵便番号が必要な国に関する厳しい要件があります。詳細については、以下の高度な統合ガイドをご覧ください。
- 宿泊予約における同意書は、コンテンツで提供される場合、チェックアウトページに表示する必要があります。詳細については、公開要件を参照してください。
- 使用する通貨は Vrbo の施設で事前に定義されているため、バーチャルカードの利用限度額に注意を払う必要があります。残高不足による決済エラーを防ぐため、バーチャルカードの利用時には、為替レートの変動や国際銀行手数料が反映されていることをご確認ください。
- 現時点では、Rapid での Vrbo 予約では Expedia Affiliate Collect (EAC) がサポートされていないことにご注意ください。
- 現在、宿泊施設への要望は施設に伝えられません。ご宿泊に関する特別なご要望がございましたら、ご予約後にホストに直接ご相談ください。
重要なトピック : 支払い
検証
- Vrbo on Rapid の予約を行うには、必ず請求先住所が一致する有効なクレジットカードが必要になります。
- 地域によっては、Vrbo が 0 ドルまた少額でカードを認証する場合があります。バーチャルクレジットカードを送付する場合は、複数の決済を受け付けられるように設定されていることを必ずご確認ください。
- クレジットカードの認証ルールが他の Rapid の予約とは異なります。詳細については、付録 4 をご覧ください。
- 多くの場合、Vrbo の価格には、Vrbo が請求するサービス料が含まれています。このサービス料に対して法律で徴収が義務付けられている VAT の違いのため、サービス料の金額はお客様の宿泊地によって異なります。そのため、ご予約時にご登録いただいたカードの請求先住所が、お買い物時に指定された国と異なる場合、「国コードが無効です」という予約エラーが発生します。このような不一致が生じないよう、point-of-saleで買い物したカードへの支払いを制限することも可能です。
注: この不一致は、予約エラーを回避するため、予約を送信する前に必ず検出する必要があります。この場合、施設 に対して再度購入依頼を行い、お客様の請求先国に基づいた新しい価格をリクエストする必要があります。
お客様のクレジットカード
- 他の通貨で予約を行った場合、国際取引手数料が発生する可能性があること、また返金を受ける際に為替レートの影響を受ける可能性があることをお客様に知らせる必要があります。
パートナー クレジット カード (バーチャルカード)
- 他の通貨で予約を行う際は、国際取引手数料が適用される可能性があるため、必ずその点にご留意ください。
- 支払いスケジュールを提供する物件(Rapid Shopping APIの入金)は、配布しないでください。
- 必要な(0ドルまたは名目金額の)請求をすべて受け付けるためには、パートナーカードを複数回の請求を受け付けられるように設定する必 要があります。pre-authorization.s
- カードの請求先住所は、販売時点での請求通貨と一致している必要があります。
- パートナーカードの設定では、複数の通貨での決済が可能である必要があります。あるいは、銀行手数料を抑えつつ決済を行えるよう、複数のカードを用意しておく必要があります。
- カードへの請求が可能であることを確認するため、書籍のリクエストを送信する数秒前にVCCを有効にしてください
- 支払いスケジュールが設定されている物件に関する詳細については、以下の「高度な連携」のセクションをご覧ください。
重要なトピック : 施設の損害
返金可能な損害保証金(RDD)
- プロパティで要求されるRDDは、Rapid Shopping APIに表示され、予約時に徴収された保証金を表しています。お客様が施設に損害を与えなかった場合、保証金はお客様の出発から 2 週間以内に返金されます。
- RDDが設定されている物件は、Rapid Shopping APIの除外パラメータを使用して、ショップリクエストの一部として除外する必要があります。
- 詳細については、以下の「高度な統合」のセクションをご覧ください。
Card-on-file
- Card-on-fileこれは、ゲストが施設に滞在中に施設の損害を与えた場合、Vrboには、ゲストが施設をチェックアウトした後、Rapid Shopping APIで返された金額を上限として、登録されたクレジットカードに請求する権利があることを示しています。損害賠償請求が行われると、Vrbo からお客様に損害の概要と請求書が送信されます。予約時に指定されたカードへの請求ができなかった場合、Vrbo からお客様に、Vrbo サイト経由での支払いの送信を求める通知が送信されます。
- 滞在中に施設が損害を被った場合、施設が請求する可能性のある金額をお客様に通知する必要があります。これは、
card_on_file_limitオブジェクトの下のショップレスポンスで返されます。 - Card-on-file Rapid Shopping APIの除外パラメータを使用することで、ショップリクエストの一部としてプロパティを非表示にすることができます。
重要なトピック : Vrbo 予約の通貨コード
ショップリクエストで指定された通貨は、予約の請求通貨には影響し ません。
- Vrbo 予約の通貨を指定することはできません。使用する通貨は、常に施設が指定した通貨と一致します。それ以外の場合、価格確認のレスポンスで返される通貨は、Rapid Shopping APIで返される通貨と異なる場合があり、これは決済手段に請求される請求通貨となります。
- お支払いにバーチャルカードをご利用の場合は、ご利用の銀行が請求する国際為替手数料を賄えるだけの余裕額を確保していただく必要があります。
- お客様には、国際取引に伴う銀行手数料が発生する可能性があることをお伝えください。また、予約のキャンセルに伴う返金額は、為替レートの変動により、当初のお支払い額と異なる場合があります。
宿泊施設との主な違い
Vrbo-specificフィールド
| フィールド | 説明 |
|---|---|
| 郵便番号 | 要件は他の Rapid ホテル在庫とは異なります。詳細については、付録4をご参照く ださい。 |
Vrboの物件には関係のない項目
| 機能 | 説明 |
|---|---|
| 保留 / 再開 | 現在、Vrbo on Rapid の予約には対応していません。 |
| 宿泊施設への要望 | 現時点では、宿泊 施設への要望を施設に伝えることはできません。宿泊施設への要望がある場合は、予約後にお客様が施設に連絡する必要があります。 |
| お客様の対応に関する指示 | 現時点では Vrbo 予約に対応していません。 |
予約と支払いに関するよくあるご質問
**Q. ** 予約リクエストにはどのようなお客様情報が必要ですか?
**A. ** すべての Vrbo on Rapid 予約には、お客様がオーナーとやり取りができるように、お客様のメールアドレスと電話番号が必要です。
Post-booking経験
知っておくべきこと
Rapid API, を通じてVrboの予約が完了しましたら、ゲストに「post-booking」の体験についてご案内ください。以下のトピックをご提案いたします。
説明の内容
- ホストは、Conversation APIを通じてゲストにメッセージを送ることができます(話題の例については以下をご覧ください)。
- ゲストは、「Trips」ページの予約画 面から、Conversation APIを使用してホストにメッセージを送信できるようにする必要があります。
- Check-in到着の72時間前までに、「Essential Stay Content」またはConversation APIを介したホストからのメッセージを通じて、案内を提供する必要があります。到着から48時間以内に受け取れない場合は、ゲストは直ちにホストまたはサポートにご連絡ください。
- その他の支払いのリクエスト
- Rapid APIではVrboの予約に対する正式な変更はサポートされていませんが、Vrbo以外で予約を変更することは可能です。Rapid API. このシナリオでは、迅速な検索結果には総額のみが含まれます(1泊あたりの料金や滞在総額は除外されます)。なお、Rapid APIエコシステムの特性上、Vrboで変更された予約については、non-modifiedでの取得に比べて、データ取得の遅延が大きくなる点にご留意ください。
予約の管理方法
- Rapid Cancel APIに基づき、ゲストは貴社のサイトを通じて予約をキャンセルすることができます。
- お客様はオーナーに変更をリクエストすることも、キャンセルしたうえで再予約することで変更することもできます (こちらが推奨)。
- Vrboの物件に関するキャンセル依頼については、予約作成から4時間以内にキャンセル手続きが行われた場合、特別な取り扱いとなります。このリクエストでは、バックエンドで処理を完了させるために追加の時間が必要であることを示す「
HTTP」コードが返される場合があります。そのような場合は、数分間お待ちいただき、再度キャンセルをお試しください(最初の6回は10分おきに、その後は30分おきにお試しいただくことをお勧めします)。予約作成から5時間経過してもキャンセルが引き続きできない場合は、Rapidのログを添えて、Expedia Groupのサポートチームまでご連絡ください。
問題がある場合
- お客様には、貴社のカスタマーサポート、またはExpedia Groupのカスタマーダイレクトサポート(CDS).
- 問題が発生した場合はすぐにサポートに連絡し、滞在後まで問題の報告を保留しない (Vrbo では出発後に問題を解決できないため) ようお客様に伝えます。
- お客様が施設にアクセスできない場合、お客様はまずオーナーへの連絡を試みる必要があります。うまくいかない場合は、お客様は直ちに貴社へご連絡いただき、サポートをお願いいたします。お客様が自分で別の宿泊施設を手配された場合、お客様に払い戻しは行われません。
注: Vrboの確認番号(HA-########)は、ホストおよびVrboサポートが参照できる唯一の情報となりますので、ゲストに必ずお伝えください。
主なトピック:Post-bookingの支払い
予約が完了した後、またはお客様が宿泊した後に、Vrbo のオーナーが追加の支払いをリクエストすることがあります。支払いリクエストは、お支払いページへのリンクを含む Vrbo からお客様へのメールを通じて、簡単に行うことができます (ログイン不要)。オーナーがリクエストしている追加の料金が支払われない場合、予約がキャンセルされる可能性があることをお客様に知らせる必要があります。オーナーがリクエストしているすべての料金は、 free_text の施設の説明、ハウスルール、または宿泊予約における同意書などの Rapid コンテンツの自由入力形式のテキストフィールドに含まれています。
追加の支払いのリクエストの例として、以下のようなものがあります。
- ペットデポジットの支払い
- 追加の宿泊料金の支払い (オーナーに滞在期間の延長をリクエストした場合)
- stay-collectedの電気代やタオル代などの料金のお支払い。
- 施設の損害に対する支払い
stay-collectedの料金例については、付録5をご参照ください。
他の宿泊施設との主な違い
Vrbo-specificフィールド
| フィールド | 説明 |
|---|---|
| 滞在に関する重要事項 | Vrboのウェルカムガイドを表しており、予約作成後すぐにゲストに提供する必要があります。 >> 詳細については、Vrboの「Essential Stay」コンテンツをご覧ください。 |
Vrboの物件には関係のない項目
| フィールド | 説明 |
|---|---|
| キャンセル返金額 | Vrbo on Rapid の予約には対応していません。 |
| 軽微な変更 | Vrbo 予約には対応していません。お客様はメールでオーナーに直接変更をリクエストするか、サポートに問い合わせる必要があります。 |
| 大幅な変更 | Vrbo 予約には対応していません。お客様はメールでオーナーに直接変更をリクエストするか、サポートに問い合わせる必要があります。 |
Post-bookingよくある質問
**Q. ** お客様は Vrbo からどのようなメールを受け取りますか?
**A. ** お客様が Vrbo から予約確認メールまたはキャンセル確認メールを受け取ることはありません。Rapid Itinerary APIに基づいて、これらの確認情報を提供してください。ゲストには、追加のお支払いのお願いに関するVrboからのメールのみが届きます。
**Q. ** Vrbo on Rapid 予約は、Rapid Cancel API を使用してキャンセルできますか?
**A. ** はい。Rapid 旅程レスポンスでキャンセルトークンを使用することで、すべての Vrbo on Rapid 予約をキャンセルできます。施設管理者またはサポートにお客様がキャンセルをリクエストすることもできます。
**Q. ** Vrbo ではウェブサイトでの予約後にどのような機能を提供していますか ?
**A. ** パートナーサイトで行われた Vrbo 予約は、お客様の Vrbo アカウントではアクセスできません。
**Q. ** Vrbo の予約はどのような方法でに変更できますか?
**A. ** ゲストの皆様には、予約をキャンセルして再予約されることをお勧めいたしますが、Vrboでの予約内容の変更をご希望の場合は、ホストと直接連絡を取るか、サポートを通じて変更依頼を行うことで対応可能です。
**Q. ** 予約の変更やキャンセルに関する Rapid 通知は受け取れますか?
**A. ** Rapid通知を購読されている場合、予約の変更やキャンセルがあった際に通知が届きます。なお、現時点では、誰が予約を変更したかを特定することはできませんので、ご了承ください。
**Q. ** Vrbo オーナーとのやり取りは施設メッセージセンターでできますか?
**A. ** Conversation APIをご利用いただくには、Host-traveler通信が必要です。
**Q. ** お客様はチェックイン情報をどのように受け取りますか?
**A. ** ご到着の72時間前までに、ゲストへウェルカムガイドをお送りいただくのは、お客様の責任となります。このウェルカムガイドの内容は、Rapid Itinerary API の Rapid の「滞在に関する重要事項」から採られています。すべてのオーナーがこの機能を利用しているわけではないことに注意してください。その代わりに、多くのホストは、Conversation APIを通じてメッセージとして、ゲストにウェルカムガイドを送ります。ゲストが到着の48時間前までに到着に関する案内を受け取っていない場合は、ホストへの連絡や代替の宿泊施設の手配についてサポートを受けるため、貴社のカスタマーサポート に連絡するようお伝えください。
>>「Essential Stay」のコンテンツについて詳しくはこちら
**Q. ** Vrbo の予約が確定した後、宿泊施設側でそれをキャンセルすることはできますか ?
**A. ** はい、予約からお客様の到着までの間、施設管理者はいつでも Vrbo の予約をキャンセルできます。多くの場合、予約作成後 1 日以内に、その日に空きがないことに施設管理者が気づいた場合に発生します。ゲストのご到着前にこのような事態が発生した場合は、VrboCareにて、適切な代替宿泊施設をお探しいただけるようサポートいたします。詳細については、Vrbo on Rapid サポートガイドをご覧ください。
**Q. ** 予約をキャンセルした場合、オーナーにペナルティはありますか?
**A. ** はい。さらに、施設 マネージャーによるキャンセル頻度は、プレミアホストの認定要件の一つであり、検索結果における 施設 の表示順位にも影響を与えるため、施設 マネージャーは、必要がない限りキャンセルしないよう注意を払っています。「プレミアホスト」のステータスを活用して、 検索結果の上位に最高の物件を表示させることで、このリスクを軽減することができます。
高度な統合ガイド
上級シナリオ:返金可能な損害保証金(RDD)
一部の Vrbo 施設では、到着前に損害補償金の徴収が必要ですが、施設の状態に応じてチェックアウト後に返金されます。RDDの金額は高額になる可能性があり、お客様にとってもゲストの方々にとっても受け入れがたい場合があるため、検索結果からこれらの物件を非表示にすることを強くお勧めいたします。
RDD について
- RDD を要求する施設は、ホリデーシーズンなどの繁忙期により頻繁に発生する可能性があります。
- 約 2% の施設では、到着前に返金可能な損害保証金の支払いが必要です。
- RDD の金額と要件は地域や季節によって異なる場合があります。
お客様には次のことを通知する必要があります。
- 損害補償金の支払いは、最後に予定されていた支払い時に行われます (1 回払いの場合は予約時)。

- オーナーの確認に基づき、損害補償金はチェックアウト後 14 日以内に返金されます。
- 損害が発生した場合、Vrbo からお客様にメールで損害請求書が送信されます。
- 返金可能な損害補償金の金額はチェックアウト時に表示する必要があります。
- Rapid Shopping APIに表示されるRDDの金額は概算です。Rapid Price Check の金額はお客様に請求される金額であり、チェックアウト時にお客様に表示する必要があります。
登録販売業者としてのパートナー
- バーチャルカードによるお支払いの際は、ゲストからの保証金の徴収および返金の手続きが可能でない限り、RDDを除外することをお勧めいたします。
- お客様に対して金額をお知らせし、それに応じて代金の徴収・返金を行うのは、お客様の責任となります。
例 :
"rates": [
{
"refundable_damage_deposit": {
"value": "150.00",
"currency": "USD"
}
}
]応用シナリオ:顧客のクレジットカード
お客様のクレジットカードを使用するには、追加の検証とお客様への連絡が必要です。
住所の検証
国によっては郵便番号の入力が不要な場合もあれば、追加情報の入力が必要な場合もあるため、Vrboでの予約では、他の宿泊施設とは異なる住所の検証が必要となります。
郵便番号がある国

郵便番号のない国

対応している国のリストについては、付録4をご参照ください。
高度なシナリオ : お支払いスケジュール
Vrbo 施設では、事前に定義されたスケジュールに基づいて支払いを徴収する場合があります。これらのプロパティは、パートナープロファイルの設定を通じて有効化または無効化することができます。支払いスケジュールが存在する場合、施設Collectと同様に、Rapid Shopping APIには「入金」として表示されます。
>> Rapid Shopping APIにおける入金について、詳しくはこちらをご覧ください
デポジットについて (お支払いスケジュール)
- 約 20 ~ 30% の施設が、3 か月を超える長期の予約期間に対してお支払いスケジュールを提供しています。
- 15% 未満の施設が、1 か月未満の短期の予約期間に対してお支払いスケジュールを提供しています。
お客様には次のことを通知する必要があります。
支払いスケジュールの詳細は、shop/check-out, ページ上で、できれば視覚的なタイムライン形式で表示されるようにしてください。
例 :
"deposits": [
{
"value": "412.10",
"due": "2027-05-17",
"currency": "USD"
},
{
"value": "236.17",
"due": "2027-08-24",
"currency": "USD"
}
]
また、ゲストには、Vrboサイト上で指定されたスケジュールに従って支払いを行う責任があることをお伝えください。そうしないと、ホストによって予約がキャンセルされる可能性があります。
お客様に支払い要件を確実に知らせるため、支払い期日の前、当日、後に Vrbo からメールによるリマインダーが送信されます。
返金可能な損害保証金と合わせて
RDD が必要な場合は、最後に予定されている支払いの一部として請求されます。1 回払いの場合は予約時に徴収されます。
パートナーと提携し、記録上の販売業者として登録されています
Vrbo.com では手動で支払いを行う必要があるため、お支払いスケジュールのある施設をクレジットカードの請求元として予約することはお勧めしません。
付録 1 : オーナーによる連絡
施設 のホストと旅行者の間で直接コミュニケーションをとれるようにするには、Conversation APIを統合する必要があります。
施設管理者からの連絡に含まれる情報の例 :
- 歓迎メッセージと施設管理者の紹介
- 連絡先
- ポリシーと出発前の確認事項
- 住所とアクセス
- キーボックスのコード
- お支払いスケジュール
- 宿泊予約における同意書 (必須の場合あり。この場合、応じないと施設管理者によって予約がキャンセルされる可能性あり)
- パスポート写真の提出依頼 (必須の場合あり。この場合、応じないと施設管理者によって予約がキャンセルされる可能性あり)
- オーナーによるメッセージへの返信
付録 2 : Vrbo による連絡
次の Vrbo メールは、Rapid API 経由で行われた予約では送信されません。
- 予約の確認
- お客様がキャンセルした予約
- 施設がキャンセルした予約
- 予約返金の確認
- ウェルカムガイド
- リマーケティング
- 宿泊施設の口コミのリクエスト
- サポートサービスの評価のリクエスト
- キャンセル後のお客様の再ターゲティング
追加の宿泊料金 (ペット料金など) の支払い、変更 (滞在期間の延長)、損害の支払いなどを含む、お客様に送信されることがある Vrbo の支払いに関連するその他のメール :
- リクエストされたその他の支払い
- 支払いの確認
- 支払いの受領
- 施設の損害報告
Vrbo.com でのお客様とのやり取りに基づく追加のメール
- アカウントの作成
- パスワードのリセット
- パスワードのリセットの確認
- パスワードの作成
高度な統合シナリオに特化した Vrbo メールテンプレート :
- 不正なキャンセル
- 損害補償金の請求 - RDD 付きの施設のみ
- 損害補償金の受領 - RDD 付きの施設のみ
- 損害補償金の請求 - RDD 付きの施設のみ
- お支払いスケジュールの期限切れ - お支払いスケジュールを利用する施設のみ
付録 3 : お客様向けブランド
| 販売サイト | お客様向けブランド |
|---|---|
| フランス | Abritel |
| ドイツ | Fewo-Direkt |
| オーストラリア | Stayz |
| ニュージーランド | Bookabach |
| その他 | Vrbo |
付録4:住所の有効性確認
住所の有効性確認にあたり、以下の国では郵便番号の入力が必要です。
- アルゼンチン
- オーストラリア
- オーストリア
- ブラジル
- カナダ
- デンマーク
- フランス
- ドイツ
- 英国
- ギリシャ
- イタリア
- オランダ
- ノルウェー
- ポーランド
- ポルトガル
- スペイン
- スウェーデン
- トルコ
付録5:Stay-collectedの料金例
施設 が徴収する手数料には、以下のようなものがあります:
- 管理費
- エアコン
- クラブ
- 電気
- 暖房
- ホットタブ
- インターネット
- ランドリー
- リネン
- バスタオル類
- 駐車場
- プール
- 施設使用料
- 水道