Vrbo on Rapid 統合ガイド
パートナー向け Vrbo 統合プロセスのガイドです。
概要
この記事は、Rapid と Vrbo の統合プロセスに関するガイドです。統合の仕組み、API リクエストとレスポンスの例、制限事項、エラーの処理、よくあるご質問などを取り上げます。
このガイドは、推奨される Vrbo 提供施設を対象としています。高度なユーザーケースについては、以下の高度な統合ガイドをご覧ください。
Geography
注意点
- Vrboが有効になっているRapid Geography APIを使用しているパートナーは、従来の宿泊施設と同様に、すべての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のコンテンツは、他の宿泊オプションと同じRapid Content APIsを介して、
supply_source=vrbo
、渡すことで提供されますが、以下のスキーマの違いに注意してください。 - Vrboのコンテンツは施設のマネージャーにより、他のラピッド宿泊オプションに比べて頻繁に更新されます。施設の掲載情報に誤りがあると、お客様による評価が低くなったり、サポートコールや返金リクエストにつながったりすることがあります。お客様に施設、設備やサービス、ポリシーが正確に伝わるように、少なくとも週 1 回、Vrbo のコンテンツを更新することを強くお勧めします。
- Vrbo プレミア オーナー プログラムは、オーナーによるキャンセル率の低さ、口コミの評価の高さ、Vrbo プラットフォームを介してお客様にサービスを提供した経験に基づき、高いお客様満足度を実現することが実証されているオーナーのための、招待者限定の特典となっています。パートナーは.NET Frameworkを使用してプレミアホストのプロパティを特定できます
attribute_id=1073745445
。さらに、パートナーはリクエストにattribute_id=1073745445
を含めることで、結果をフィルタリングし、プレミアホストの物件のみを返すことができます。
他の宿泊オプションとの主な違い
Vrbo 固有のフィールド :
API | 説明 |
---|---|
コンテンツファイル | Vrboプロパティは、他のRapid宿泊オプションとは別のコンテンツファイルで提供されます。 |
フィールド | 説明 |
---|---|
vacation_rental_details:registry_number | バケーションレンタル施設を表示するための必須フィールドです。詳細については、公開要件を参照してください。 |
個人所有の施設 | 属性1073745102 'プライベートホスト 施設'は、施設がプライベートホストによって管理されている ことを示します。表示に必須であり、追加の必須説明も含まれます。詳細については、公開要件を参照してください。 |
プロフェッショナル・ホスト 施設 | 属性1073745142 'プロの施設ホスト/マネージャ' は、施設がプロのホスト/マネージャによって管理されている ことを示します。表示に必須であり、追加の必須説明も含まれます。詳細については、公開要件を参照してください。 |
プレミアオーナー | 属性1073745445「プレミアパートナー」は施設がプレミアホストによって管理されている ことを示します。プレミアホスト(Premier Host)インジケータの付いた物件をバッジ表示したり、結果をフィルタリングしてプレミアホスト(Premier Host)物件のみを表示することができます。 |
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 | このフィールドは廃止されています。使用しないでください。推奨されるチェックアウト表示テキストについては、公開要件をご覧ください。 |
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 Shop の merchant_of_record
フィールドは、Rapid 施設の Vrbo では異なる意味を持ちます。
- 予約時に提供されたカードに誰が請求するかを表すものではありません。予約はすべて前払いとなります。
- merchant=expedia (「Merchant」) は、予約成立率が高く、エラーの説明に一貫性がある EG チェックアウトシステムを使用して予約が行われることを示しています。
- merchant=property (「Agency」) は、従来の Vrbo チェックアウトシステムを使用して予約が行われることを示しています。この提供施設の販売は、デフォルトでは無効になっています。詳細については、高度な統合セクションをご覧ください。
- 施設は、1 つのモデルに関連付けられているわけではありません。「Merchant」の資格は、以下の 3 つの重要な要素に基づいています。
- 返金可能な損害補償金なし (推奨されていない高度な統合オプション。以下の高度な統合セクションを参照)
- デポジットに関するポリシー / お支払いスケジュールなし (推奨されていない高度な統合オプション。以下の高度な統合セクションを参照)
- 空室状況を確認するには、目的地の通貨で検索を実行する必要があります。
重要なトピック : Vrbo 予約の通貨コード
ショップリクエストで指定された通貨は、予約で使用する通貨には影響しません。
- Vrbo 予約の通貨を指定することはできません。使用する通貨は常に施設の通貨と一致します。
- 重要: パートナーは、「マーチャント」として最も多くのVrbo供給を利用するために、すべてのラピッドショップリクエストに目的地通貨を含める必要があります。目的地の通貨が指定されていない場合は、指定された通貨での支払いをオーナーが選択している利用可能な施設のみが 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では365泊までVrboの物件を予約・購入することができますが、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 の違いのため、サービス料の金額はお客様の宿泊地によって異なります。その結果、予約時に提供されたカードの請求先住所が、ショッピング中に提供された国と異なる場合、「無効な国番号」という予約エラーが発生します。
- この予約エラーを避けるために、パートナー様は予約を送信する前に、この不一致を検出する必要があります。一致しない場合、パートナー様は施設に対して再度ショップリクエストを行い、お客様の請求先の国に基づく新しい価格をリクエストする必要があります。
- パートナー様は、このような不一致が起きないように、ショッピングが行われた販売サイトからの支払いをカードに制限することができます。
お客様のクレジットカード
- 他の通貨で予約を行った場合、国際取引手数料が発生する可能性があること、また返金を受ける際に為替レートの影響を受ける可能性があることをお客様に知らせる必要があります。
パートナー クレジット カード (バーチャルカード)
- パートナー様は、他の通貨で予約が行われた場合にかかる国際取引手数料も考慮する必要があります。
- パートナー様は、お支払いスケジュール (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の予約のハードチェンジをサポートしていませんが、予約の変更はRapid API. このシナリオでは、迅速な検索応答には合計価格のみが含まれます(1泊または滞在の価格は除外されます)。また、Rapid APIのエコシステムの性質上、Vrboで変更された予約の検索レイテンシーは、non-modifiedの検索レイテンシーよりも高くなりますのでご注意ください。
予約の管理方法
- ゲストは、Rapid Cancel APIに基づき、パートナーサイト経由で予約をキャンセルすることができます。
- お客様はオーナーに変更をリクエストすることも、キャンセルしたうえで再予約することで変更することもできます (こちらが推奨)。
- Vrbo の在庫に対するキャンセルのリクエストについて、予約作成から 4 時間以内にキャンセルを試みた場合は、特別な注意事項があります。
- リクエストに対して http コードが返されることがありますが、これはバックエンドが決済を行うのにさらに時間を必要としていることを示しています。その場合、数分待ってからキャンセルをやり直してください (最初の 6 回は 10 分おき、その後は 30 分おきに試すことをお勧めします)。予約作成から5時間以上経過してもキャンセルができない場合は、ラピッドログをEPSサポートチームまでご連絡ください。
問題がある場合
- サポート (パートナー、カスタマーダイレクトサポート (CDS)、または Vrbo) への連絡方法をお客様に通知します。
- 問題が発生した場合はすぐにサポートに連絡し、滞在後まで問題の報告を保留しない (Vrbo では出発後に問題を解決できないため) ようお客様に伝えます。
- お客様が施設にアクセスできない場合、お客様はまずオーナーへの連絡を試みる必要があります。連絡できなかった場合は、お客様はすぐにパートナー様に連絡してサポートを受ける必要があります。お客様が自分で別の宿泊施設を手配された場合、お客様に払い戻しは行われません。
注 : Vrbo の確認番号 (HA-########) は、オーナーと Vrbo サポートが利用できる唯一の参照番号であり、Vrbo のすべてのメールで参照されるため、お客様に提供する必要があります。
主要トピック:Post-bookingペイメント
予約が完了した後、またはお客様が宿泊した後に、Vrbo のオーナーが追加の支払いをリクエストすることがあります。支払いリクエストは、お支払いページへのリンクを含む Vrbo からお客様へのメールを通じて、簡単に行うことができます (ログイン不要)。オーナーがリクエストしている追加の料金が支払われない場合、予約がキャンセルされる可能性があることをお客様に知らせる必要があります。オーナーがリクエストしているすべての料金は、 free_text の施設の説明、ハウスルール、または宿泊予約における同意書などの Rapid コンテンツの自由入力形式のテキストフィールドに含まれています。
追加の支払いのリクエストの例として、以下のようなものがあります。
- ペットデポジットの支払い
- 追加の宿泊料金の支払い (オーナーに滞在期間の延長をリクエストした場合)
- 電気使用料やタオル使用料などの滞在ごとの料金の支払い
- 施設の損害に対する支払い
stay-collected手数料の例については、付録5をご参照ください。
他の宿泊オプションとの主な違い
Vrbo 固有のフィールド :
フィールド | 説明 |
---|---|
滞在に関する重要事項 | Vrbo ウェルカムガイドを表し、予約作成直後にお客様に提供する必要があります。詳細については、Vrbo の滞在に関する重要事項をご覧ください。 |
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. ** ラピッド通知を購読しているパートナーは、予約が変更またはキャンセルされた場合に通知を受け取ります。現時点では、誰が予約を変更したかを特定することはできません。
**Q. ** Vrbo オーナーとのやり取りは施設メッセージセンターでできますか?
**A. ** 現時点ではできません。
**Q. ** お客様はチェックイン情報をどのように受け取りますか?
**A. ** パートナー様には、到着の 72 時間前にお客様にウェルカムガイドを送信する責任があります。このウェルカムガイドの内容は、Rapid Itinerary API の Rapid の「滞在に関する重要事項」から採られています。すべてのオーナーがこの機能を利用しているわけではないことに注意してください。多くのオーナーが、代わりにウェルカムガイドをメールメッセージとしてお客様に送信しています。到着の 48 時間前になっても到着時の手順が届かない場合は、パートナーサポートに連絡し、オーナーに連絡するか、別の宿泊施設を手配するのを手伝ってもらうようにお客様に伝える必要があります。詳細については、Rapid の「滞在に関する重要事項」をご覧ください。
**Q. ** Vrbo の予約が確定した後、宿泊施設側でそれをキャンセルすることはできますか ?
**A. ** はい、予約からお客様の到着までの間、施設管理者はいつでも Vrbo の予約をキャンセルできます。多くの場合、予約作成後 1 日以内に、その日に空きがないことに施設管理者が気づいた場合に発生します。宿泊客の到着前にこのような事態が発生した場合、宿泊客はVrboCare が適切な代替宿泊施設を探すようサポートします。詳細については、Vrbo on Rapid サポートガイドをご覧ください。
**Q. ** 予約をキャンセルした場合、オーナーにペナルティはありますか?
**A. ** 施設管理者のキャンセルの頻度はプレミアオーナーの適格性を判断する要素となり、検索結果における施設の掲載に影響するため、施設管理者は必要なとき以外はキャンセルしないよう注意しています。プレミアオーナーのステータスを活用し、最高の施設を検索結果の上位に表示することで、パートナー様はこのリスクを軽減することができます。
高度な統合ガイド
高度なシナリオ : 返金可能な損害補償金 (RDD)
一部の Vrbo 施設では、到着前に損害補償金の徴収が必要ですが、施設の状態に応じてチェックアウト後に返金されます。RDD が高額になり、パートナー様やお客様にとって受け入れがたいものになる可能性があるため、パートナー様の検索結果にこれらの施設が表示されないようにすることを強くお勧めします。
RDD について
- RDD を要求する施設は、ホリデーシーズンなどの繁忙期により頻繁に発生する可能性があります。
- 約 2% の施設では、到着前に返金可能な損害保証金の支払いが必要です。
- RDD の金額と要件は地域や季節によって異なる場合があります。
お客様には次のことを通知する必要があります。
- 損害補償金の支払いは、最後に予定されていた支払い時に行われます (1 回払いの場合は予約時)。

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

郵便番号のない国

各国の郵便番号と詳細

サポート対象国のリストは、付録4をご覧ください。
高度なシナリオ : お支払いスケジュール
Vrbo 施設では、事前に定義されたスケジュールに基づいて支払いを徴収する場合があります。これらの施設は、パートナープロフィールの設定で有効 / 無効にすることができます。お支払いスケジュールがある場合、お支払いスケジュールは Rapid Shop でも Property Collect と同様にデポジットとして表示されます。デポジットの確認方法の詳細については、Rapid Shop のドキュメントをご覧ください。
デポジットについて (お支払いスケジュール)
- 約 20 ~ 30% の施設が、3 か月を超える長期の予約期間に対してお支払いスケジュールを提供しています。
- 15% 未満の施設が、1 か月未満の短期の予約期間に対してお支払いスケジュールを提供しています。
お客様には次のことを通知する必要があります。
- お支払いスケジュールの詳細は、理想的には視覚的なタイムラインビューとして、購入 / チェックアウト時に表示される必要があります。
例 :
"deposits": [
{
"value": "412.10",
"due": "2023-05-17",
"currency": "USD"
},
{
"value": "236.17",
"due": "2023-08-24",
"currency": "USD"
}
]

- 指定されたスケジュールに従って 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:住所の検証
住所確認のため、以下の国では郵便番号が必要です。また、追加の詳細が必要な場合もあります。
- アルゼンチン
- オーストラリア(+州)
- オーストリア
- ブラジル(+州およびCPF/CNPJ納税者ID、ブラジルのPOSを使用する場合は、近隣の住民も含める必要があります。)
- カナダ(+州)
- デンマーク
- フランス
- ドイツ
- 英国
- ギリシャ
- イタリア
- 日本(郵便番号は不要ですが、都道府県と住所2行目が必要です。)
- オランダ
- ノルウェー
- ポーランド
- ポルトガル
- スペイン
- スウェーデン
- トルコ
- アメリカ合衆国(郵便番号は不要ですが、州名は必ずご記入ください。)
付録5:Stay-collected手数料の例
施設が徴収する料金には、以下のものが含まれる場合があります:
- 管理費
- エアコン
- クラブ
- 電気
- 暖房
- ホットタブ
- インターネット
- ランドリー
- リネン
- バスタオル類
- 駐車場
- プール
- 施設使用料
- 水道