Esta traducción se ha generado automáticamente

Guía de integración de Vrbo en Rapid

Una guía sobre el proceso de integración de Vrbo

Información general

En este artículo se ofrece una guía para el proceso de integración de Vrbo en Rapid, que incluye su funcionamiento, ejemplos de solicitudes y respuestas de la API, limitaciones, resolución de errores y preguntas frecuentes.

Esta guía está orientada a nuestra oferta de inventario de Vrbo recomendada. Para ver ejemplos de uso avanzados, consulta más adelante la guía de integración avanzada.

|

Geografía

Lo que tienes que saber

Si utilizas la API de Rapid Geography y tienes habilitado Vrbo, también puedes acceder a los ID de propiedades de Vrbo desde todas las API de Geography, junto con las propiedades de alojamiento convencionales.


Tema clave: ubicación

  • Ten en cuenta que no podemos mostrar la dirección exacta de los alojamientos hasta que se haya realizado una reserva. Consulta la guía de integración de contenido básico sobre la estancia para obtener más información.
  • Deberías usar las coordenadas de latitud y longitud de la API de contenido junto con tu propia solución geográfica para localizar las propiedades en el mapa.
  • Los alojamientos que hayan solicitado privacidad deben usar las coordenadas de latitud y longitud enmascaradas para mostrarse en el mapa, pero pueden usar las coordenadas exactas para la búsqueda de alojamientos, siempre y cuando no se muestre la ubicación exacta del alojamiento al huésped.

Diferencias clave respecto a otras opciones de alojamiento

Puedes solicitar respuestas sobre geografía con Vrbo y alojamiento, solo con Vrbo (usando supply_source=vrboen un perfil habilitado) o solo alojamiento (usando supply_source=expedia). Si no se indica « supply_source », las API de Rapid Geography se limitarán por defecto solo al alojamiento.


Preguntas frecuentes sobre geografía

P. ¿Puedo filtrar las API de geografía de modo que devuelvan solo alojamientos de Vrbo o solo alojamientos que no son de Vrbo?
R. Sí, puedes filtrar usando supply_source=vrbo. Si el perfil no puede acceder al inventario de Vrbo, no se devolverán resultados.

Contenido

Lo que tienes que saber

  • El contenido de Vrbo se proporciona a través de las mismas API de Rapid Content que el de otras opciones de alojamiento, pasando supply_source=vrbo, pero ten en cuenta las diferencias en el esquema que aparece a continuación.
  • El contenido de Vrbo se actualiza con más frecuencia por parte de los gestores de propiedades en comparación con otras opciones de alojamiento de Rapid. Mostrar información incorrecta en un anuncio de alojamiento puede dar lugar a malas experiencias de los huéspedes, llamadas de asistencia y solicitudes de reembolso. Te recomendamos encarecidamente que actualices el contenido de Vrbo al menos una vez a la semana para asegurarte de que los huéspedes vean una descripción precisa del alojamiento, los servicios y las normas.
  • El programa de propietarios Premium de Vrbo es un beneficio al que solo se accede por invitación y que está reservado a quienes han demostrado ofrecer experiencias positivas a los huéspedes. Estos criterios se miden a partir de unas tasas de cancelación bajas por parte de los propietarios, opiniones positivas y la experiencia en la atención a huéspedes desde la plataforma de Vrbo. Puedes reconocer los alojamientos de Premier Host gracias a attribute_id=1073745445. Además, puedes incluir « attribute_id=1073745445 » en tu solicitud para filtrar los resultados y que solo aparezcan los alojamientos de Premier Host.

Diferencias clave respecto a otras opciones de alojamiento

En la API de archivos de contenido, los alojamientos de Vrbo se muestran por separado del resto de opciones de Rapid Lodging.

Vrbo-specific campos

CampoDescripción
vacation_rental_details:registry_numberCampo obligatorio para la visualización de alquileres vacacionales. Consulta los requisitos de lanzamiento para obtener más detalles.
Alojamiento de un particularAtributo n.º1073745102: «Propiedad de un anfitrión privado» indica que la propiedad la gestiona un anfitrión privado. Necesario para la visualización, junto con las descripciones adicionales requeridas. Consulta los requisitos de lanzamiento para obtener más detalles.
Inmueble de alquiler para huéspedesAtributo n.º1073745142: «Anfitrión/gestor inmobiliario profesional» indica que la propiedad está gestionada por un anfitrión o gestor profesional. Necesario para la visualización, junto con las descripciones adicionales requeridas. Consulta los requisitos de lanzamiento para obtener más detalles.
Propietario/a PremiumAtributo n.º1073745445: «Socio Premier» indica que el alojamiento lo gestiona un anfitrión Premier. Se puede usar para marcar los anuncios con el indicador «Anfitrión Premier» o para filtrar los resultados y que solo aparezcan las propiedades de Anfitrión Premier.
statisticsIncluye información específica de la unidad de alquiler vacacional, como la ocupación máxima, el número de dormitorios y de baños, el número de habitaciones (1 si es un alquiler vacacional de una sola unidad) y el área del alojamiento (en metros cuadrados y pies). Debe usarse para mostrar un resumen de la información clave del alojamiento en los resultados de búsqueda y en la parte superior de la página de detalles del alojamiento.
Número de baños y habitacionesEl atributo 1073743378 ("Número de dormitorios") hace referencia al número de dormitorios de la unidad. El atributo 1073743379 ("Número de baños") hace referencia al número de baños de la unidad.
vacation_rental_details:property_managerIncluye el nombre del gestor del alojamiento, una imagen y los idiomas que habla si están disponibles. Debe usarse para presentar al propietario que gestiona el alojamiento, a fin de que el huésped lo conozca mejor. La información de contacto se facilita una vez completada la reserva, como parte del contenido de «Essential Stay».
>> Explora el contenido de «Essential Stay»
vacation_rental_details:unit_configurationsDescribe los tipos y el número de camas de cada habitación. Esta información debe utilizarse para mostrar la distribución del alojamiento, a fin de que el huésped tenga la seguridad de que dispone de capacidad suficiente para el grupo con el que viaja.
vacation_rental_details:house_rulesEste campo está en desuso. Utiliza vacation_rental_details:enhanced_house_rules en su lugar.
vacation_rental_details:enhanced_house_rulesLas normas de la casa mejoradas incluyen información clave sobre mascotas, fiestas, niños, política de fumadores y mucho más. additional_informationpuede incluir detalles de cada norma que sean fundamentales para la estancia del huésped, como aclaraciones sobre las normas, códigos de acceso, contraseñas, imágenes y stay-collected tasas (impuestos turísticos municipales o usage-based cargos).
>> Más información en la guía de contenido «Estancia esencial» de Vrbo
vacation_rental_details:rental_agreementProporciona un enlace a un PDF o sitio web facilitado por el gestor del alojamiento que debe mostrarse en cualquier página de pago. También se podría solicitar la acción del huésped para firmar y enviar el contrato de alquiler.
vacation_rental_details: free_textEste es un campo de texto libre que proporciona el propietario para destacar las experiencias o atributos exclusivos a disposición de los huéspedes en el alojamiento. Esta descripción también puede incluir atracciones cercanas, servicios opcionales ofrecidos por el propietario u otra información importante (por ejemplo, obras, ruidos, condiciones del agua, acceso a pistas de esquí, estacionamiento, etc.) que el huésped debe comprender antes de hacer una reserva. Esta sección puede ser bastante extensa, por lo que debe prestarse especial atención a su visualización en la interfaz de usuario, sobre todo en dispositivos móviles.

Si este campo no aparece, deberías recurrir a Descriptions.General.
descriptions.generalProporciona una descripción del alquiler vacacional generada automáticamente a partir de sus atributos, servicios y ubicación. Este texto no incluye ninguna orientación ni información del propietario. Es un campo más relevante para alojamientos convencionales. Debe usarse cuando vacation_rental_details.free_text no está presente.
traveler_service_feeEste campo está en desuso. No lo uses. Echa un vistazo a los requisitos de lanzamiento para ver el texto recomendado que debe aparecer en check-out.
>> Consulta los requisitos de lanzamiento

Campos que no son relevantes para los alojamientos de Vrbo

CampoDescripción
Puntuación del alojamientoPor ahora las puntuaciones no están disponibles para los alojamientos de Vrbo. En su lugar, se pueden usar las valoraciones de los huéspedes.
Descripción de la habitaciónNo es pertinente para los alquileres vacacionales de una sola unidad. En su lugar, se debe utilizar información a nivel de habitación.
Plan de tarifasNo es pertinente para los alojamientos de Vrbo.
Información a nivel de habitaciónToda la información de descripción de la habitación está disponible a nivel de alojamiento. Debido a que no hay contenido a nivel de habitación para los alojamientos de Vrbo, los servicios que generalmente se encuentran a este nivel se incluyen en una nueva sección llamada vacation_rental_details.
vrbo_srp_id, listing_id, listing_number, listing_source, listing_unitEstos campos solo son pertinentes para el modelo de vinculación con Vrbo, pero también se pueden usar para la asignación de alojamientos o la búsqueda de coincidencias.
IPM_NameÚnicamente los colaboradores que forman parte del periodo de prueba de profesionales inmobiliarios integrados de Vrbo tienen acceso. El valor proporciona el nombre del profesional inmobiliario integrado, el cual debe mencionarse al huésped para comunicarle que será el intermediario que cargará su tarjeta y le enviará correos sobre su estancia.

Preguntas frecuentes sobre el contenido

P. ¿Cómo ubico contenido de Vrbo si la dirección no se proporciona en el contenido de Rapid?
R. Se pueden utilizar la API de geografía de Rapid y los valores de latitud y longitud para ubicar geográficamente los alojamientos.

P. ¿Se incluyen los alojamientos de Vrbo en los archivos de contenido de Rapid?
R. Sí. Se puede recuperar un archivo de contenido específico de Vrbo cuando se pasa supply_source=vrbo en la solicitud de API.

P. ¿Los alojamientos de Vrbo están disponibles en todos los idiomas?
R. Sí. Sin embargo, algunos campos de texto libre proporcionados por el propietario no se traducen, sino que se muestran en la lengua del propietario. Algunos de los campos afectados son property_description (descriptions.general), las normas del alojamiento mejoradas (vacation_rental_details:enhanced_house_rules), el contenido básico sobre la estancia y los correos electrónicos que envía el propietario al huésped (proporcionados por Vrbo).

P. Mis huéspedes no conocen Vrbo. ¿Es obligatorio mostrar la marca de Vrbo en todas las regiones?
R. Es obligatorio, pero se pueden reemplazar las marcas locales de Vrbo en Alemania, Francia, Australia y Nueva Zelanda. Consulta más abajo el Apéndice 2. Consulta la guía de requisitos de lanzamiento para conocer los requisitos por página y región. Se pueden hacer excepciones en los casos en los que un mismo alojamiento provenga de varios proveedores; sin embargo, en cuanto se identifique a Vrbo como el proveedor con el que se va a realizar la reserva, debe aparecer el nombre de Vrbo. Incluir la marca de Vrbo es importante para informar al huésped y empezar a establecer expectativas después de la reserva.

P. Sin bed_groups, ¿cómo describo los tipos de cama en cada habitación?
R. Echa un vistazo a la página de configuraciones de las unidades para ver más detalles sobre los tipos de camas.
>> Más información sobre las configuraciones de las unidades

Compras

Lo que tienes que saber

  • Los alojamientos de Vrbo son exclusivamente alojamientos completos, no compartidos.
  • Los alojamientos de Vrbo son de una sola unidad.
  • Los alojamientos de Vrbo solo devuelven un único plan de tarifas.
  • Los alojamientos con depósitos de daños deben excluirse. Para ello, hay que pasar exclusion=refundable_damage_deposit en la solicitud de compra. Consulta la guía de integración avanzada para obtener más información sobre lo que debes saber antes de habilitar estos alojamientos.
  • Los alojamientos con políticas de depósito están excluidos. Consulta más abajo la guía de integración avanzada para obtener más información.
  • No se admiten reservas para el mismo día (no aparecerá ninguna disponibilidad).

Tema clave: campo merchant_of_record para reservas de Vrbo

El campo « merchant_of_record » de la API de Rapid Shopping tiene un significado diferente para los alojamientos de Vrbo en Rapid.

  • No representa quién realizará el cargo la tarjeta proporcionada con la reserva. Todas las reservas se pagan por adelantado.
  • merchant=expedia ("intermediario") indica que la reserva se realizará a través de los sistemas de pago de EG, que proporcionan el mejor índice de éxito en las reservas y descripciones de errores coherentes.
  • merchant=property ("agencia") indica que la reserva se realizará mediante los sistemas de pago heredados de Vrbo. La distribución de este suministro está desactivada por defecto. Consulta la sección de integración avanzada para obtener más información.
  • Los alojamientos no están vinculados a un único modelo. De hecho, los requisitos del modelo "intermediario" se basan en tres factores clave:
    • No debe haber un depósito de daños reembolsable (opción de integración avanzada no recomendada; consulta la sección de integración avanzada).
    • No debe haber una política de depósitos o un calendario de pagos (opción de integración avanzada no recomendada; consulta la sección de integración avanzada).
    • Las búsquedas deben hacerse en la moneda de destino para recibir la disponibilidad.

Tema clave: códigos de divisa para reservas de Vrbo

La moneda que se indica en la solicitud de la tienda no afecta a la moneda de facturación de la reserva.

  • No es posible establecer la divisa para una reserva de Vrbo. La divisa de facturación siempre coincidirá con la del alojamiento.
  • Importante: Tienes que incluir la moneda de destino en cada solicitud de reserva para poder acceder a la mayor oferta de Vrbo como «Merchant'. Si no se indica la moneda de destino, en la respuesta de la tienda solo aparecerán los alojamientos disponibles cuyos anfitriones hayan elegido recibir el pago en esa moneda concreta. Echa un vistazo al anexo para ver las recomendaciones sobre la moneda del destino por región, o ponte en contacto con tu persona de contacto de Partner Connect para obtener información más detallada.

Tema clave: códigos de país para reservas de Vrbo

El código de país que se indique en la solicitud de la API de Shopping debe coincidir con el país de facturación de la tarjeta de crédito facilitada en la reserva. Esto se debe a los requisitos de Vrbo de cobrar el IVA sobre la tasa de servicio al viajero en función de la ubicación del huésped, determinada por el código de país de la dirección de facturación.

  • Si no coinciden, podría producirse un error en la reserva debido a los diferentes requisitos de recaudación del IVA.
  • Una vez que el cliente haya introducido su dirección de facturación, tienes que comprobar que el código de país coincida con el que se le pasó a Rapid durante el proceso de compra. Si estos valores difieren, el envío de la reserva dará error. En su lugar, tienes que volver a hacer la solicitud de compra utilizando la dirección de facturación guest-provided para obtener un precio válido para la reserva. Hay que informar al huésped del cambio de precio (al alza o a la baja) antes de que envíe la solicitud de reserva.

Diferencias clave respecto a otras opciones de alojamiento

Vrbo-specific campos

TasaDescripción
property_feeDescribe el importe total de las tasas del alojamiento para la reserva, incluidos los cargos por limpieza, gestión, huésped adicional y otros cargos.
traveler_service_feeTasa de servicio que cobra Vrbo para facilitar la reserva y prestar asistencia. Esta tasa no es reembolsable si hay alguna parte de la reserva que tampoco lo sea. Consulta los requisitos de lanzamiento para obtener más información sobre lo que debe mostrarse.

Tarifas de servicio para viajeros y selección de país en la API de Rapid Shopping: Cuando un anuncio de Vrbo incluye una tarifa de servicio para viajeros en la respuesta de precios, el importe incluirá el IVA correspondiente al país seleccionado en la solicitud de la API de Rapid Shopping. Para que la reserva se haga correctamente, tienes que asegurarte de que el país que has seleccionado en la tienda coincida con el país del método de pago que vas a usar en check-out.

Campos que no son relevantes para los alojamientos de Vrbo

CampoDescripción
ID de la habitaciónEl nombre de la habitación y el ID de la tarifa no se aplican al inventario de Vrbo y no deben mostrarse.
Habitaciones disponiblesSiempre es 0 en los alojamientos de Vrbo. No utilices este campo para indicar urgencia.
Grupos de camasNo se aplica a Vrbo, ya que no se puede seleccionar ninguna opción o preferencia.
ID y descripción de la promociónNo se aplica al inventario de Vrbo.

Preguntas frecuentes sobre compras

P. ¿Cómo se pueden posicionar los alojamientos de Vrbo?
R. Se pueden utilizar la puntuación y el recuento de las valoraciones de los huéspedes cuando las haya. Además, el atributo n.º1073745445 «Premier partner» te ayuda a identificar los alojamientos gestionados por anfitriones que cumplen los requisitos del Programa Premier Host, y puedes utilizarlo para influir en el orden de los resultados.

P. ¿Por qué no se permiten estancias de una noche?
R. Como el VrboCare solo se aplica a estancias de 2 o más noches, no te recomendamos que aceptes reservas cortas para evitar que los huéspedes se lleven una mala impresión.

P. ¿Por qué no se permiten periodos de reserva cortos (menos de 72 horas)?
R. Los propietarios necesitan tiempo para procesar una solicitud de reserva, preparar el alojamiento para la llegada y comunicarse con el huésped. Para evitar problemas con los huéspedes o cancelaciones por parte de los proveedores, tienes que limitar las reservas de « close-in ».

P. ¿Cómo puedo permitir que los huéspedes busquen alojamientos que admitan mascotas?
R. Actualmente, Rapid no ofrece la posibilidad de filtrar por la política de mascotas ni de ofrecer precios con la tarifa por mascota incluida. Puedes identificar las propiedades de « pet-friendly » según los atributos de los alojamientos de contenido, y los huéspedes pueden consultar las normas específicas sobre mascotas de cada una. Los propietarios pueden proporcionar información más detallada sobre las políticas de mascotas en vacation_rental_details.free_text o enhanced_house_rules. Se aconseja a los huéspedes que hablen con el propietario en lo que respecta a las mascotas y el pago de las tasas correspondientes.

P. ¿Puedo buscar estancias prolongadas (es decir, de más de 28 noches)?
R. Sí, Rapid te permite buscar y reservar propiedades de Vrbo para estancias de hasta 365 noches, pero te recomendamos encarecidamente que las limites a 90 noches. Si te estás acercando a los límites de restricción de la tienda, debes tener en cuenta que las búsquedas prolongadas tienen un mayor impacto en el volumen de llamadas de la tienda.

P. ¿Por qué no coincide el desglose de tasas de Rapid con el de Vrbo.com?
R. Por ahora, Rapid no puede desglosar la tasa del alojamiento en elementos individuales. Estos conceptos pueden incluir la tarifa de limpieza, la tarifa de gestión, las tarifas por personas adicionales y otras tarifas, y se suman en el « property_fees ».

P. ¿Puedo crear paquetes con el inventario de Vrbo?
R. No, no puedes promocionar ni reservar propiedades de Vrbo como parte de un paquete.

P. ¿Los alojamientos de Vrbo son compatibles con las ofertas exclusivas para miembros?
R. Sí.

P. ¿Las propiedades de Vrbo que están en Rapid pueden acogerse a promociones como descuentos por reserva anticipada, de última hora, por nuevos anuncios, semanales y mensuales, tal y como se ofrece en Vrbo.com?
R. Sí, Rapid te muestra la descripción de la promoción, el precio promocional y el precio original (tachado), igual que en el caso de los alojamientos convencionales, lo que te permite promocionar la oferta y los ahorros entre los viajeros.

P. ¿Puedo habilitar la comunicación del huésped con el propietario durante la fase de compra, antes del pago?
R. Por ahora no.

P. ¿Veré la tasa de marketing correcta en la respuesta de disponibilidad?
R. Consulta las estimaciones de gross_profit y realiza los cálculos en función de tu contrato.

P. ¿Las tarifas de Vrbo en Rapid serán coherentes con las tarifas de los sitios web de Vrbo y Expedia Group?
R. Los precios del suministro de Vrbo en Rapid deben ser similares a los que figuran en el sitio web de la marca Expedia Group, pero pueden diferir de los precios de Vrbo. Por lo general, estos se basan en el cálculo de la tasa del servicio y pueden ser un poco más altos o bajos. Además, el resumen de las tasas del alojamiento puede variar ligeramente según la marca.

P. ¿Aparecen los precios tachados en la función «Comprobación de precios», igual que en «Disponibilidad»?
R. No. Los datos promocionales están disponibles durante tu llamada de disponibilidad, pero no aparecen en la respuesta de la consulta de precios.

Reservas y pagos

Lo que tienes que saber

  • Tienes que facilitar los datos de contacto del huésped (nombre, teléfono y correo electrónico) en cada reserva para facilitar la comunicación entre el anfitrión y el huésped.
  • Vrbo aplica requisitos más estrictos sobre los países que necesitan un código postal y estatal al realizar una reserva. Consulta más abajo la guía de integración avanzada para obtener más información.
  • Los contratos de alquiler, si se proporcionan en el contenido, deben mostrarse en la página de pago. Consulta los requisitos de lanzamiento para obtener más información.
  • Las divisas de facturación están predefinidas para los alojamientos de Vrbo, por lo que se debe prestar atención a los límites de crédito de la tarjeta virtual. Debes asegurarte de que las tarjetas virtuales tengan en cuenta las posibles diferencias en el tipo de cambio y las comisiones bancarias internacionales para evitar errores de contabilización por falta de fondos.
  • Ten en cuenta que Expedia Affiliate Collect (EAC) no es compatible por el momento con las reservas de Vrbo en Rapid.
  • Actualmente, las solicitudes especiales no se transmiten al alojamiento. Los huéspedes deben hablar directamente con el anfitrión sobre cualquier petición especial que tengan para su estancia una vez realizada la reserva.

Tema clave: pagos

Validación

  • Todas las reservas de Vrbo en Rapid requieren una tarjeta de crédito válida con una dirección de facturación que coincida.
  • En algunas regiones, Vrbo puede autentificar la tarjeta con una autorización de 0 USD o un importe nominal. Si vas a enviar tarjetas de crédito virtuales, debes asegurarte de que estén configuradas para aceptar varios cargos.
  • Las normas de validación de las tarjetas de crédito difieren de las de otras reservas de Rapid. Consulta el apéndice 4 para obtener más información.
  • Los precios de Vrbo suelen incluir una tasa de servicio que cobra Vrbo. El importe de la tasa de servicio varía en función de la ubicación del huésped debido a los requisitos legales para recaudar el IVA sobre esta tasa. Por eso, si la dirección de facturación de la tarjeta que has dado al hacer la reserva no coincide con el país que indicaste al comprar, aparecerá un error de reserva que dice «Código de país no válido». Puedes restringir los pagos con tarjetas de la tienda point-of-sale para asegurarte de que no se produzca esta discrepancia.

Nota: Tienes que detectar esta discrepancia antes de enviar la reserva para evitar este error. En este caso, tienes que volver a enviar la solicitud de compra al alojamiento para pedir un nuevo precio según el país de facturación del huésped.

Tarjeta de crédito del cliente

  • Se debe informar a los huéspedes de que pueden estar sujetos a tasas por transacciones internacionales en las reservas realizadas con otras monedas, y que cualquier devolución puede verse afectada por los tipos de cambio.

Tarjeta de crédito del colaborador (tarjetas virtuales)

  • Asegúrate de tener en cuenta las comisiones por transacciones internacionales de las reservas realizadas en otras divisas.
  • No deberías distribuir propiedades que ofrezcan planes de pago (ingresos a través de la API de Rapid Shopping).
  • Las tarjetas asociadas deben configurarse para aceptar varios cargos, de modo que se puedan realizar los que sean necesarios (de 0 $ o de valor simbólico) pre-authorization.s
  • La dirección de facturación de la tarjeta debe coincidir con la moneda de facturación del punto de venta.
  • La configuración de las tarjetas de los socios debe permitir realizar cargos en varias divisas; si no, deberías tener un conjunto de tarjetas que te permita realizar cargos y, al mismo tiempo, reducir las comisiones bancarias.
  • Deberías activar la VCC unos segundos antes de enviar la solicitud de reserva para asegurarte de que la tarjeta sea válida para el pago
  • Echa un vistazo a la sección de integración avanzada que aparece más abajo para obtener más información sobre las propiedades con calendarios de pago.

Tema clave: daños al alojamiento

Fianzas reembolsables por daños (RDD)

  • Los RDD que exigen los alojamientos aparecen en la API de Rapid Shopping y corresponden a un depósito que se cobra en el momento de la reserva. Si el huésped no causa daños al alojamiento, la fianza se devuelve en un plazo de dos semanas desde su salida.
  • Las propiedades con RDD deben ocultarse como parte de una solicitud de compra utilizando el parámetro de exclusión de la API de Rapid Shopping.
  • Echa un vistazo a la sección de integración avanzada que aparece más abajo para obtener más detalles.

Card-on-file

  • Card-on-file indica que Vrbo tiene derecho a cargar en la tarjeta facilitada un importe equivalente al que aparece en la API de Rapid Shopping una vez que el huésped se haya marchado del alojamiento, en caso de que haya causado daños en el mismo. Vrbo enviará un resumen de los daños y la factura al huésped cuando se realice una reclamación por daños. Si se produce un error al realizar el cargo en la tarjeta proporcionada en la reserva, Vrbo se pondrá en contacto con el huésped para solicitarle que efectúe el pago a través del sitio web de Vrbo.
  • Debe informarse a los huéspedes de la cantidad que el alojamiento podría cobrar si se ocasionan daños durante la estancia. Esto se devuelve en la respuesta de compra bajo el objeto card_on_file_limit.
  • Card-on-file Las propiedades se pueden ocultar en una solicitud de compra utilizando el parámetro de exclusión de la API de Rapid Shopping.

Tema clave: códigos de divisa para reservas de Vrbo

La moneda que se indica en la solicitud de la tienda no afecta a la moneda de facturación de la reserva.

  • No es posible establecer la divisa para una reserva de Vrbo. La divisa de facturación siempre coincidirá con la que designe el alojamiento. De lo contrario, la moneda que aparece en la respuesta de la consulta de precios puede diferir de la que aparece en la API de Rapid Shopping y es la moneda de facturación con la que se cargará el importe en el medio de pago.
  • Si utilizas tarjetas virtuales para pagar, debes dejar un margen suficiente para cubrir las comisiones de cambio internacional que te cobre tu banco.
  • Hay que informar a los huéspedes de las posibles comisiones bancarias por transacciones internacionales, y es posible que los reembolsos por reservas canceladas no coincidan con el pago inicial debido a las fluctuaciones del tipo de cambio.

Diferencias clave con respecto al alojamiento

Vrbo-specific campos

CampoDescripción
Código postalLos requisitos son distintos a los de otros inventarios de hoteles de Rapid. Echa un vistazo al Apéndice 4 para más detalles.

Campos que no son relevantes para los alojamientos de Vrbo

FunciónDescripción
Retención y reanudaciónActualmente no es compatible con reservas de Vrbo en Rapid.
Solicitud especialPor el momento no se pueden comunicar solicitudes especiales al alojamiento. Los huéspedes deben ponerse en contacto con el alojamiento después de realizar la reserva para hacer solicitudes especiales.
Instrucciones de gestión de los viajerosPor el momento no es compatible con las reservas de Vrbo.

Preguntas frecuentes sobre la reserva y el pago

P. ¿Qué información del huésped se debe incluir en la solicitud de reserva?
R. Todas las reservas de Vrbo en Rapid requieren un correo electrónico y un número de teléfono del huésped para facilitar la comunicación con el propietario.

Post-booking experiencia

Lo que tienes que saber

Una vez completada una reserva en Vrbo a través de Rapid API,, deberías dar algunas indicaciones al huésped sobre cómo funciona post-booking. Te proponemos los siguientes temas.

Qué esperar

  • El anfitrión puede enviar mensajes al invitado (mira más abajo para ver ejemplos de temas) a través de la API de conversación.
  • Los huéspedes deberían poder enviar un mensaje al anfitrión desde su reserva en la página «Viajes» usando la API de Conversación.
  • Check-in Las instrucciones deben enviarse 72 horas antes de la llegada a través de Essential Stay Content o mediante un mensaje del anfitrión a través de la API de Conversation. Si no lo recibes en un plazo de 48 horas desde tu llegada, tienes que ponerte en contacto con el anfitrión o con el servicio de atención al cliente de inmediato.
  • Solicitudes de pago adicionales
  • Aunque Rapid API no permite modificar las reservas de Vrbo, sí que puedes cambiarlas fuera de Rapid API. En este caso, la respuesta rápida de búsqueda solo incluirá el precio total (se excluirán los precios por noche o por estancia). Además, ten en cuenta que, debido a la naturaleza del ecosistema de Rapid API, en el caso de las reservas modificadas a través de Vrbo, el tiempo de respuesta será mayor que en las consultas realizadas a través de non-modified.

Cómo gestionar las reservas

  • Los huéspedes pueden cancelar sus reservas a través de tu página web, gracias a la API de cancelación rápida.
  • Los huéspedes pueden solicitar cambios al propietario o cancelar la reserva y volver a realizarla (recomendado).
  • Las solicitudes de cancelación de alojamientos de Vrbo tienen unas condiciones especiales cuando se intenta cancelar dentro de las 4 horas siguientes a la realización de la reserva. La solicitud puede devolver un código « HTTP » que indica que el sistema de fondo necesita más tiempo para procesarla. En esos casos, espera unos minutos y vuelve a intentar la cancelación (te recomendamos que lo intentes cada 10 minutos durante los primeros 6 intentos y, a partir de ahí, cada 30 minutos). Si sigues sin poder cancelar la reserva pasadas 5 horas desde que la hiciste, ponte en contacto con el equipo de soporte de Expedia Group y envía los registros de Rapid.

Si hay un problema

  • Dile a los clientes que se pongan en contacto con tu servicio de atención al cliente o con el servicio de atención directa al cliente de Expedia Group (CDS).
  • Recomienda a los huéspedes que se pongan en contacto con el servicio de asistencia de inmediato cuando surja un problema y que no esperen hasta que finalice la estancia, ya que Vrbo no podrá ayudarles una vez realizada la salida.
  • Si los huéspedes no pueden acceder al alojamiento, primero deben intentar ponerse en contacto con el propietario. Si no lo consiguen, los huéspedes deberían ponerse en contacto contigo de inmediato para que les ayudes. No se reembolsará a los huéspedes que busquen alojamiento alternativo por su cuenta.

Nota:. Hay que facilitar a los huéspedes el número de confirmación de Vrbo (HA-########), ya que es la única referencia de la que disponen el anfitrión y el servicio de atención al cliente de Vrbo.

Tema clave: los pagos « Post-booking »

Los propietarios de Vrbo pueden solicitar pagos adicionales una vez completada la reserva o después de la estancia del huésped. Las solicitudes de pago se facilitan mediante un correo electrónico que envía Vrbo al huésped y que incluye un enlace a una página de pago (no es necesario iniciar sesión). Los huéspedes deben saber que el impago de cualquier cargo adicional que solicite el propietario puede conllevar la anulación de la reserva. Todas las tasas que solicite el propietario se incluyen en los campos de texto libre del contenido de Rapid, como la descripción del alojamiento, las normas del alojamiento o el contrato de alquiler en free_text.

Estos son algunos ejemplos de solicitudes de pago adicionales:

  • Pago del depósito por mascotas
  • Pago de noches adicionales si se solicita al propietario prolongar la estancia
  • Pago de los gastos de stay-collected, como el consumo de electricidad o el uso de toallas.
  • Pago por daños materiales

Echa un vistazo al Apéndice 5 para ver ejemplos de las tarifas de stay-collected


Diferencias clave respecto a otras opciones de alojamiento

Vrbo-specific campos

CampoDescripción
Contenido básico sobre la estanciaEs la guía de bienvenida de Vrbo y hay que enviársela al huésped justo después de hacer la reserva.
>> Echa un vistazo al contenido de «Estancia esencial» de Vrbo para más detalles

Campos que no son relevantes para los alojamientos de Vrbo

CampoDescripción
Importe del reembolso por cancelaciónActualmente no está disponible con reservas de Vrbo en Rapid.
Cambios menoresNo es compatible con las reservas de Vrbo. Los huéspedes deben solicitar los cambios directamente al propietario por correo electrónico o ponerse en contacto con el servicio de asistencia.
Cambio importanteNo es compatible con las reservas de Vrbo. Los huéspedes deben solicitar los cambios directamente al propietario por correo electrónico o ponerse en contacto con el servicio de asistencia.

Post-booking Preguntas frecuentes

P. ¿Qué correos electrónicos de Vrbo recibirá el huésped?
R. Los huéspedes no recibirán confirmaciones de reserva o cancelación de Vrbo. Tienes que proporcionar estas confirmaciones utilizando la API de Rapid Itinerary. Los huéspedes solo recibirán correos electrónicos de Vrbo relacionados con solicitudes de pago adicionales.

P. ¿Se pueden cancelar las reservas de Vrbo en Rapid a través de la API de cancelación de Rapid?
R. Sí, todas las reservas de Vrbo en Rapid se pueden cancelar con el token de cancelación en la respuesta del itinerario de Rapid. Como alternativa, los huéspedes pueden solicitar la cancelación al gestor del alojamiento o al servicio de asistencia.

P. ¿Qué funcionalidades ofrece Vrbo después de la reserva en su sitio web?
R. Las reservas de Vrbo realizadas en los sitios de colaboradores no figuran en la cuenta de Vrbo del huésped.

P. ¿Cómo se puede cambiar una reserva de Vrbo?
R. Se recomienda a los huéspedes que cancelen y vuelvan a reservar, pero también pueden solicitar cambios en sus reservas de Vrbo poniéndose en contacto con el anfitrión o enviando una solicitud de cambio a través del servicio de atención al cliente.

P. ¿Recibiré notificaciones de Rapid sobre cambios o cancelaciones de reservas?
R. Si te has suscrito a las notificaciones de Rapid, recibirás un aviso cada vez que se modifique o cancele una reserva. Ten en cuenta que, por ahora, no podemos saber quién ha modificado una reserva.

P. ¿Las conversaciones de propietarios de Vrbo son compatibles con el centro de mensajes del alojamiento?
R. No. Las comunicaciones de « Host-traveler » deben utilizar la API de Conversation.

P. ¿Cómo recibirán los huéspedes la información para la entrada?
R. Eres responsable de enviar una guía de bienvenida al huésped 72 horas antes de su llegada. El contenido de esta guía de bienvenida se proporciona a través del contenido básico sobre la estancia de Rapid en la API de itinerario de Rapid. Ten en cuenta que no todos los propietarios utilizan esta funcionalidad. En cambio, muchos anfitriones envían una guía de bienvenida al huésped a través de un mensaje con la API de Conversation. Hay que indicar a los huéspedes que se pongan en contacto con tu servicio de atención al cliente si no han recibido las instrucciones de llegada en las 48 horas previas a su llegada, para que les ayuden a ponerse en contacto con el anfitrión o a buscar un alojamiento alternativo.

>> Más información sobre el contenido imprescindible para tu estancia

P. ¿Puede el alojamiento cancelar una reserva de Vrbo una vez que está confirmada?
R. Sí, los profesionales inmobiliarios pueden cancelar una reserva de Vrbo en cualquier momento antes de la llegada del huésped. Esto suele suceder en un plazo de un día tras la creación de la reserva, cuando se observa que el alojamiento ya no está disponible en esa fecha. Si esto ocurre antes de que llegue el huésped, el equipo de VrboCare le ayudará a encontrar un alojamiento alternativo adecuado. Consulta la guía de asistencia de Vrbo en Rapid para obtener más información.

>> Descubre más sobre VrboCare

P. ¿Se penaliza a los propietarios por cancelar reservas?
R. Sí. Además, la frecuencia con la que los administradores de propiedades cancelan las reservas es un factor que influye a la hora de determinar si un anfitrión puede optar al estatus «Premier» y afecta a la posición del alojamiento en los resultados de búsqueda, por lo que los administradores de propiedades procuran no cancelar a menos que sea necesario. Aprovechar tu condición de anfitrión destacado para que tus mejores alojamientos aparezcan en los primeros puestos de los resultados de búsqueda puede ayudarte a reducir este riesgo.

Guía de integración avanzada

Caso práctico avanzado: Depósitos de garantía reembolsables (RDD)

Algunos alojamientos de Vrbo requieren el cobro de un depósito de daños antes de la llegada y ofrecen un reembolso después de la salida según el estado del alojamiento. Como los importes del RDD pueden ser elevados y resultar difíciles de aceptar tanto para ti como para tus huéspedes, te recomendamos encarecidamente que elimines estos alojamientos de tus resultados de búsqueda.

Acerca del depósito de daños reembolsable

  • Los alojamientos podrían solicitar un depósito de daños reembolsable con más frecuencia durante los períodos de alta compresión, como los días festivos.
  • Alrededor del 2 % de los alojamientos requieren un depósito de daños reembolsable antes de la llegada.
  • El requisito del depósito de daños reembolsable y su importe pueden variar según la geografía y la temporada.

Es necesario informar a los huéspedes de lo siguiente

  • El pago del depósito de daños se realiza con el último pago programado (o en el momento de la reserva si se trata de un pago único).

Ejemplo de RDD

  • El reembolso del depósito de daños se realizará en un plazo de 14 días después de la salida, en función de la inspección del propietario.
  • En caso de que se hayan producido daños, Vrbo enviará una factura por correo electrónico al huésped.
  • El importe del depósito de daños reembolsable debe indicarse en el momento del pago.
  • La cantidad de RDD que aparece en la API de Rapid Shopping es una estimación. El importe de la comprobación de precios de Rapid es lo que se cobrará al huésped y debe mostrarse durante el pago.

Socio como « Merchant » oficial

  • Te recomendamos que excluyas los RDD cuando realices el pago mediante tarjeta virtual, a menos que puedan facilitar el cobro y la devolución del depósito de garantía al huésped.
  • Eres responsable de indicarle el importe al cliente y de cobrarle o devolverle el dinero según corresponda.

Ejemplo:

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

Caso práctico avanzado: Tarjeta de crédito del cliente

El uso de tarjetas de crédito de cliente requiere validación adicional y comunicación con el huésped.

Validación de la dirección

Como algunos países no exigen códigos postales y otros piden datos adicionales, las reservas en Vrbo requieren un proceso de validación de direcciones diferente al de otras opciones de alojamiento.

Países con códigos postales

countries-with-postal-codes

Países sin códigos postales

countries-without-postal-codes

Echa un vistazo al apéndice 4 para ver la lista de países compatibles.

Situación avanzada: calendario de pagos

A veces, los alojamientos de Vrbo cobran el pago según un calendario predefinido. Estas propiedades se pueden activar o desactivar a través de la configuración del perfil de socio. Cuando haya, los calendarios de pago aparecerán en la API de Rapid Shopping como depósitos, igual que en Property Collect.

>> Más información sobre los depósitos en la API de Rapid Shopping

Acerca de los depósitos (calendarios de pagos)

  • Aproximadamente el 20-30 % de los alojamientos ofrecen un calendario de pagos para periodos de reserva superiores a tres meses.
  • Menos del 15 % de los alojamientos ofrecen un calendario de pagos para periodos de reserva inferiores a un mes.

Es necesario informar a los huéspedes de lo siguiente

Los detalles del calendario de pagos deberían aparecer durante el proceso de compra (shop/check-out, ), a ser posible en forma de línea de tiempo visual.

Ejemplo:

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

payment-schedule-example

Además, hay que informar a los huéspedes de que son responsables de realizar el pago en la página web de Vrbo según el calendario indicado; de lo contrario, el anfitrión podría cancelar la reserva.

Vrbo enviará recordatorios por correo electrónico antes, durante y después de la fecha de vencimiento del pago para garantizar que el huésped conozca la obligación de pagar.

Junto con los depósitos de garantía reembolsables

Cuando se requiera un depósito de daños reembolsable, se cobrará como parte del último pago programado. Si se realiza un solo pago, se cobrará en el momento de la reserva.

Se ha asociado con un socio como « Merchant » oficial

Debido al requisito de pago manual en Vrbo.com, no recomendamos que los alojamientos con calendarios de pagos se reserven como intermediarios oficiales.

Apéndice 1: Comunicaciones por parte del propietario

Tienes que integrar la API de Conversation para facilitar la comunicación directa entre el anfitrión del alojamiento y el viajero.

Estos son algunos ejemplos de comunicaciones por parte del responsable del alojamiento:

  • Mensaje de bienvenida y presentación del responsable del alojamiento
  • Datos de contacto
  • Políticas e información útil
  • Dirección e indicaciones para llegar
  • Código de la caja de llaves
  • Calendario de pagos
  • Contrato de alquiler (se puede solicitar para evitar que el responsable del alojamiento cancele la reserva)
  • Solicitud de foto del pasaporte (se puede solicitar para evitar que el responsable del alojamiento cancele la reserva)
  • Respuesta del propietario a un mensaje

Apéndice 2: Comunicaciones por parte de Vrbo

Los siguientes correos electrónicos de Vrbo se eliminarán en el caso de las reservas realizadas a través de Rapid API:

  • Confirmación de la reserva
  • Reserva cancelada por el viajero
  • Reserva cancelada por el alojamiento
  • Confirmación de reembolso de una reserva
  • Guía de bienvenida
  • Remarketing
  • Solicitud de comentario
  • Solicitud de revisión del servicio de asistencia
  • Redestinación del cliente después de la cancelación

Otros correos electrónicos relacionados con pagos de Vrbo que pueden enviarse al huésped, incluido el pago de cargos adicionales por estancia (por ejemplo, tasas por mascotas), cambios (noches adicionales) o pagos por daños:

  • Solicitud de pago adicional
  • Confirmación de pago
  • Pago recibido
  • Informe de daños al alojamiento

Correos electrónicos adicionales basados en la interacción del huésped con Vrbo.com

  • Creación de cuenta
  • Restablecimiento de contraseña
  • Confirmación de restablecimiento de contraseña
  • Creación de contraseña

Plantillas de correo electrónico de Vrbo específicas para situaciones de integración avanzada:

  • Cancelación por fraude
  • Depósito de daños cobrado (solo para alojamientos con depósito de daños reembolsable)
  • Depósito de daños recibido (solo para alojamientos con depósito de daños reembolsable)
  • Depósito de daños reclamado (solo para alojamientos con depósito de daños reembolsable)
  • Pago programado vencido (solo para alojamientos con calendario de pagos)

Apéndice 3: Marcas orientadas al cliente

Punto de ventaMarca orientada al cliente
FranciaAbritel
AlemaniaFeWo-direkt
AustraliaStayz
Nueva ZelandaBookabach
OtrosVrbo

Apéndice 4: Validación de direcciones

Para validar la dirección, los siguientes países exigen un código postal.

  • Argentina
  • Australia
  • Austria
  • Brasil
  • Canadá
  • Dinamarca
  • Francia
  • Alemania
  • Gran Bretaña
  • Grecia
  • Italia
  • Países Bajos
  • Noruega
  • Polonia
  • Portugal
  • España
  • Suecia
  • Turquía

Apéndice 5: Ejemplos de tarifas de « Stay-collected »

Algunos gastos que cobra la comunidad pueden incluir:

  • Tasas administrativa
  • Aire acondicionado
  • Club
  • Electricidad
  • Calefacción
  • Bañera de hidromasaje
  • Internet
  • Servicio de lavandería
  • Sábanas
  • Toallas
  • Parking
  • Piscina
  • Tasas del alojamiento
  • Agua
¿Te ha resultado útil esta página?
¿Cómo podemos mejorar este contenido?
¡Gracias por ayudarnos a mejorar!