Como conectar la API de Airbnb a myfrontdesk

Seguir

¡Nos complace anunciar la integración bidireccional de la API de Airbnb y Cloudbeds!

Esta integración incluye:

  1. Sincronización completa entre los anuncios (o listados) de Cloudbeds y Airbnb. Juntos actualizaremos de manera automática sus:
    • tarifas
    • disponibilidad
    • restricciones (estadía mínima o máxima y mucho más)
    • cancelaciones
    • modificaciones
  2. La sincronización es inmediata. En el momento que usted actualiza su información, esta se actualiza en sus anuncios.
  3. Soporte de sincronización para las categorías de alojamientos que cuentan con  varias unidades de disponibilidad.
  4. Soporte de los descuentos, reglas de precios, reglas de disponibilidad e impuestos / tarifas.

Nota: al conectarse a Airbnb mediante la API, no es posible utilizar la función de Smart Pricing debido a que las tarifas se establecen directamente en myfrontdesk.

Antes de realizar la conexión

Asegúrese que 

  • En la extranet de Airbnb, el estado de su anuncio figure como Listed [publicado] (la sincronización no funcionará si el anuncio no se encuentra activo o publicado en Airbnb).
  • La configuración de sus habitaciones en myallocator coincida con la de Airbnb (en términos de ocupación máxima y categoría de la habitación).
  • La divisa y el huso horario de la propiedad fijadas por defecto en myallocator y Airbnb también coinciden.
  • La propiedad no esté conectada a otro administrador de canales. De no ser así, acceda a la extranet de Airbnb y diríjase a Cuenta> Privacidad y uso compartido> Aplicaciones conectadas y seleccione el botón de «Eliminar acceso».

Para más información o si encuentra problemas al realizar este proceso, véase los siguientes artículos:

Guía de conexión a la API de Airbnb
Paso 1. Habilite el uso de la API de Airbnb API en la página de «Canales» de myfrontdesk
  1. Por defecto, el canal Airbnb (API) estará en estado «Sin configuración» para todas las propiedades. Se debe hacer clic en la barra de «Sin configuración».
  2. Haga clic en SIGUIENTE para autorizar la conexión a Airbnb.

Cómo autorizar a Cloudbeds administrar sus anuncios de Airbnb

Ahora debe autorizar a myallocator (el administrador de canales de Cloudbeds) administrar sus anuncios:

3. Ingrese su usuario y contraseña de propietario de Airbnb (no las credenciales de anfitrión). Si se presenta un error, cierre sesión en todas las cuentas de Airbnb que se encuentren abiertas en su navegador y repita este procedimiento de autorización.
4. 
Acepte los términos y condiciones de Airbnb y confirme que autoriza a myallocator haciendo clic en Allow [Autorizar].

Si conecta una cuenta de Airbnb a varias cuentas de myfrontdesk, verá una alerta en color amarillo. Puede ignorarla y proceder con la autorización.

  • Asegúrese que la divisa configurada en myfrontdesk para el canal Airbnb sea igual a la divisa utilizada en los anuncios publicados en la extranet de Airbnb. Se lo contrario, se presentará un error en la conexión y no se actualizará el precio en el canal.
  • Asegúrese que el uso horario predeterminado de su propiedad sea el mismo en myfrontdesk y en la extranet de Airbnb.
Paso 2. Realice el mapeo de las habitaciones

El proceso de mapeado de la API de Airbnb es similar al de otros canales, como Booking.com o Expedia. 

Para ello debe:

1) Enlazar cada una de sus categorías de habitaciones de myfrontdesk con su anuncio equivalente en Airbnb.

2. Pinchar en ACTUALIZAR para configurar la información de cada uno de sus anuncios. Para obtener más información sobre este proceso, consulte el Paso 3: «Establezca o edite la información relacionada con la configuración de sus habitaciones».

Este proceso puede diferir dependiendo de la configuración de la habitación que tenga en Airbnb (incluyendo anuncios individuales, categorías de habitaciones o habitaciones compartidas). Consulte la guía de mapeado para los siguientes escenarios.

Si administra varias propiedades bajo las mismas credenciales de inicio de sesión de myfrontdesk, se le mostrará la siguiente advertencia. Puede ignorarla y continuar el proceso.

Paso 2.1. Realice el mapeo de anuncios individuales de Airbnb con habitaciones individuales de myfrontdesk

Este tipo de mapeado es de utilidad si tiene una (1) categoría de habitación en myfrontdesk con una (1) habitación correspondiente al anuncio de Airbnb.

Seleccione el anuncio de Airbnb del menú desplegable para que corresponda con la categoría de habitación en myfrontdesk. 

Paso 2.2. Realice el mapeado de distintos anuncios de Airbnb a una misma categoría de habitación en myfrontdesk

Si tiene una (1) categoría de habitación con varias unidades en myfrontdesk y un (1) anuncio en Airbnb, puede mapearlo usando la categoría de habitación correspondiente de myfrontdesk. 

Pero si alquila distintas categorías de habitaciones en myfrontdesk y tiene varios anuncios individuales en Airbnb, cada uno correspondiente a una unidad específica, puede asignar su categoría de habitación de myfrontdesk a cualquiera de los anuncios correspondientes en Airbnb (si estos anuncios de Airbnb coinciden entre sí en términos de configuración y descripción).

Veamos un ejemplo:

En myfrontdesk, usted tiene un estudio Deluxe (categoría de habitación) con 5 unidades: Studio 1, Studio 2...

En Airbnb tiene 5 anuncios separados y estas habitaciones tienen la misma configuración y descripción: Studio 1, Studio 2, Studio 3 ...

Al llegar al mapeado de habitaciones, podrá asignar sólo un (1) anuncio a su categoría de habitación. La forma de hacerlo es la siguiente:

1) Diríjase a la extranet de Airbnb y mantenga solo un (1) anuncio correspondiente a una (1) categoría de habitación (el resto de los anuncios de esta categoría de habitación deben quedar como «no publicados»).

2) En la página de mapeado de habitaciones de myfrontdesk, vincule la categoría de habitación al anuncio que aparece con el estado de «Publicado».

3) Después de pinchar en Actualizar, myfrontdesk enviará las tarifas y disponibilidad al anuncio asignado.

Si la categoría de habitación en myfrontdesk tiene disponibilidad (sin importar el número de habitaciones) el anuncio se podrá reservar en Airbnb.

Si el tipo de habitación en myfrontdesk no tiene disponibilidad, el anuncio no se podrá reservar en Airbnb.

Paso 2.3. Realice el mapeado de las camas de dormitorios compartidos de Airbnb con su equivalente, las habitaciones compartidas de myfrontdesk

Escenario A. Si comparte la categoría de habitación con 8 camas en myfrontdesk y 1 anuncio compartido en Airbnb que corresponde a la categoría de habitación que anuncia en myfrontdesk, puede asignar esa categoría de habitación de myfrontdesk a un anuncio de Airbnb. Sus huéspedes podrán seleccionar múltiples reservas de habitaciones o camas en Airbnb.

No es necesario crear anuncios adicionales en Airbnb.

Escenario B. Supongamos que usted tiene una categoría de habitación compartida en myfrontdeskcon 2 unidades y 2 camas en cada una. En este caso: si ya tiene un (1) anuncio en Airbnb para esta habitación compartida correspondiente a la misma en myfrontdesk, no necesita crear anuncios adicionales.

Pero si tiene varios anuncios en Airbnb, cada uno de ellos representa una cama en una habitación compartida y necesita mapearlos en una habitación compartida (la categoría de la habitación) en myfrontdesk. Para ello, deverá seguir el siguiente proceso.

Paso 1. Mantenga publicado sólo uno de los anuncios correspondientes a la habitación compartida

1) ANTES de establecer la conexión con myfrontdesk, ingrese a Airbnb y acceda a sus anuncios. Entre todos los anuncios que representan las camas de 1 habitación compartida, mantenga sólo uno de los anuncios como «Publicado». El resto de las camas de la habitación compartida deben permanecer como «No publicadas».

2) Diríjase al anuncio que se encuentra «Publicado»> abra la opción Listing Details [Detalles del anuncio]> Rooms and Guests [Habitaciones y huéspedes]>Edit [Editar]

Establezca el número total de camas en el dormitorio para los campos Beds [Camas] y Guests [Huéspedes]. En el siguiente ejemplo hay 4 camas.

Paso 2. Cómo mapear un anuncio para mi habitación compartida en myfrontdesk

Diríjase a myfrontdesk> Canales> Airbnb API y realice el mapeado de la habitación compartida en myfrontdesk con el respectivo anuncio de Airbnb:

Si se presentan errores durante los pasos del mapeado, consulte este artículo: Errores durante y después del mapeado y la conexión a la API de Airbnb.

De no resolverse el error, por favor contacte a nuestro equipo de soporte a support@cloudbeds.com.

Paso 3. Establezca o edite la información relacionada con la configuración de sus habitaciones

Después de hacer clic en el botón ACTUALIZAR, sera dirigido a la siguiente página, donde podrá seleccionar una de las siguientes dos opciones. Las opciones son:

1) Importar la configuración de la extranet de Airbnb (recomendada): si previamente ha establecido descuentos, reglas de precios, reglas de disponibilidad, impuestos o tarifas en la extranet de Airbnb, podrá importar estas configuraciones seleccionando esta opción.

2) Usar la configuración en este sistema: seleccione esta opción si desea sobrescribir su configuración de extranet de Airbnb con nuevos valores configurados en myfrontdesk.

Luego de seleccionar su opción preferida, será dirigido a la página «Exportar habitación».

1. Reglas de disponibilidad

  • Previo aviso:
    • Los huéspedes pueden reservar: esta opción le permite a su calendario bloquear de manera automática las solicitudes del mismo día y otras opciones.
    • Permitir que los huéspedes envíen solicitudes de reserva sin previo aviso: esta opción le permite elegir entre permitir o no que sus huéspedes envíen solicitudes de reserva sin previo aviso.
  • Ventana de disponibilidad: determina cuáles fechas se bloquean automáticamente y cuáles se mantienen disponibles. Por ejemplo, si autoriza a los huéspedes reservar con 3 meses de antelación, se bloquearán las fechas posteriores a esos 3 meses y las fechas dentro de esos 3 meses estarán disponibles. La ventana de disponibilidad avanza todos los días, por lo que con el paso del tiempo, las fechas siguientes se volverán disponibles de manera automática.
  • Duración mínima de  estadía (en noches): esta opción le permite ingresar la duración mínima de estadía que se aplicará a todos los días de la semana para su anuncio.
  • Días de la semana en los que se permite hacer check-in: esta opción le permite configurar los días de la semana en que los huéspedes pueden registrarse.
  • Tiempo de preparación: esta opción le permite establecer un tiempo de preparación entre la estancia de sus huéspedes. Las opciones incluyen «Sin tiempo de preparación», «1 noche antes y después de cada reserva bloqueada» o «2 noches antes y después de cada reserva bloqueada».
  • Duración máxima de estadía (en noches): esta opción le permite ingresar la duración máxima de estadía para su anuncio.
  • Días de la semana en los que se permite hacer check-out: esta opción le permite configurar los días de la semana que sus huéspedes pueden realizar el check-out.
  • Estadía mínima por día de la semana: esta opción le permite ingresar la duración mínima de la estadía para cada día de la semana.

2. Configuración de precios

  • General
    • Divisa del anuncio: ingrese la divisa de su anuncio.
    • Listado de precios base por noche: si elige importar la configuración de Airbnb, deje este número tal y como está. Si elige usar la configuración en myfrontdesk, ingrese su tarifa estándar / base. Tenga en cuenta que esta NO es la tarifa de su anuncio. Las tarifas de su anuncio son las que ha configurado en myfrontdesk (con ajustes en la página de mapeado, siempre y cuando configure esa opción).
    • Precios de fin de semana: este precio por noche reemplazará su tarifa de myfrontdesk para cada viernes y sábado.
  • Descuentos por duración de estadía
    • % por descuentos semanales: si corresponde, agregue este descuento en un porcentaje.
    • % por descuentos mensuales: si corresponde, agregue este descuento en una cantidad porcentual.
  • Precio por huéspedes adicionales
    • Número de huéspedes incluidos en el precio: ingrese cuántos huéspedes están incluidos en el precio.
    • Tarifa por persona adicional (por noche): si corresponde, agregue esta tarifa en un monto fijo.
  • Tarifas estándar
    • Depósito de seguridad: si corresponde, agregue esta tarifa en un monto fijo.
    • Tarifa de limpieza: si corresponde, agregue esta tarifa en un monto fijo.
  • Otras tarifas: para cada una de las tarifas enumeradas, puede ingresar un porcentaje o un monto fijo.

3. Impuestos trasladables

  • Impuestos
    • Tipo de impuesto: sus opciones incluyen el impuesto hotelero, impuesto de hospedaje, impuesto de habitación, impuesto de ocupación de ventas, tasa de evaluación turística, impuesto turístico, impuesto de ocupación transitoria y el IVA o GST.
    • Tipo de importe: sus opciones incluyen importe fijo por huésped, fijo por huésped por noche y porcentaje por reserva.
    • Identificación fiscal de la empresa: su identificación fiscal es un número único relacionado directamente con su empresa.
    • Número de registro: este es el número de registro de impuestos de su alojamiento, que es el número único que le asignó su jurisdicción fiscal local.
    • Monto: ingrese el monto de sus impuestos.
    • Exención para estadías a largo plazo:
      • Una reserva puede ser elegible para una exención de estadía a largo plazo si cumple con ciertos requisitos. Lo que califica como estadía a largo plazo depende de la jurisdicción en la que se encuentre el anuncio. Por ejemplo:
      • Jurisdicción X: una reserva de más de 30 días no está gravada.
      • Jurisdicción Y: una reserva de más de 45 días no está gravada.
      • Jurisdicción Z: en reservas mayores a 30 días, los impuestos solo aplican para los primeros 30 días.
      • Solicite a la autoridad fiscal de su jurisdicción más información sobre la exención de estancias de larga duración.

Para más información, consulte el artículo: ¿Cómo puedo agregar impuestos personalizados a mis anuncios?

  • Confirmación: si su anuncio incluye impuestos, deberá hacer clic en el cuadro de confirmación antes de hacer clic en GUARDAR Y SINCRONIZAR.

Estos impuestos no se aplicarán a las tarifas que myfrontdesk envía a Airbnb. Airbnb tomará estos valores y los aplicará a las reservas a medida que entren.

Veamos un ejemplo: supongamos que la tarifa de su habitación (en su página de disponibilidad) es de $ 100.00 y ha configurado un impuesto del 10%. Myfrontdesk envía una tarifa de $ 100 a Airbnb y Airbnb muestra una tarifa de $ 100.00 a sus huéspedes. Una vez que el huésped solicita la reserva, Airbnb agrega automáticamente $ 10.00 (el impuesto del 10%) al total de la reserva, y envía ambos valores ($ 100.00 por ingresos de la habitación y $ 10.00 por impuestos) a myfrontdesk.

4. Reglas de precios y descuentos

  • Reglas de precios
    • Tipo de regla: sus opciones incluyen reserva anticipada (días mínimos del anticipo), reserva de último minuto (días máximos del anticipo), estadía prolongada (por noches) y de temporada.
    • Cambio de precio: ingrese el monto de su descuento.
    • Tipo de cambio de precio: sus opciones son porcentaje o monto fijo.
    • Lapso de días / noches: ingrese la cantidad de días / noches para las que aplicará el descuento que está agregando.
    • Para las fechas de llegada / check-in: ingrese el rango de fechas para el descuento que está agregando.

Airbnb solo acepta un valor de descuento para una fecha específica. Por lo tanto, si tiene múltiples descuentos configurados, myfrontdesk aplicará el descuento que resulte en el precio más alto. Tenga en cuenta que los descuentos basados en porcentajes anularán los descuentos de monto fijo.

Ejemplo 1: la tarifa de la habitación es de $100, los descuentos disponibles son: 30% de descuento y $25 de descuento.

• 30% de descuento da como resultado una nueva tarifa de habitación de $70
• $25 de descuento resulta en una nueva tarifa de habitación de $75

Sin embargo, dado que los descuentos basados en porcentajes anulan los descuentos de monto fijo, myfrontdesk enviará la tarifa de $70 a Airbnb (aunque el descuento de monto fijo resulte en una tarifa de habitación más alta).

Ejemplo 2: la tarifa de la habitación es de $100, los descuentos disponibles son: 30% de descuento y 20% de descuento.

• 30% de descuento da como resultado una nueva tarifa de habitación de $70
• 20% de descuento resulta en una nueva tarifa de habitación de $80

En este caso, myfrontdesk enviará la tarifa de $80 a Airbnb (ya que es la tarifa más alta).

5. Pinche en GUARDAR Y SINCRONIZAR

6) Haga clic en SIGUIENTE luego de mapear y actualizar todos los anuncios.

Una vez que haga clic en SIGUIENTE, si ve un mensaje de advertencia en la parte superior de la página indicándole que algunas habitaciones quedan sin asignar, haga clic en OK para continuar.

Paso 4. Configure un ajuste para la tarifa base

De ser necesario, ingrese un descuento o aumento de su tarifa base para las categorías de habitaciones asignadas.

Por ejemplo, si desea que un canal tenga un 5% de descuento en su tarifa en comparación con otros canales, debe ingresar - 5% para cada habitación. El proceso es el mismo (aunque al revés) para aumentar las tarifas.

Cabe destacar que las diferencias en las tarifas se pueden establecer en valores porcentuales o montos fijos.

Para más información, véase: Cómo realizar ajustes en la tarifa base o enviar tarifas distintas a ciertos canales.

Paso 5. Actualice la página

Esta es la última pantalla del proceso de mapeado: aquí puede ver todas las funciones compatibles para la conexión entre myfrontdesk y la API de Airbnb.

Ingrese a la página de «Canales» y pinche en ACTUALIZAR.

Paso 6. ¡La sincronización ha sido habilitada!

En la página de canales, verá que el estado del canal Airbnb (API) cambia a HABILITADA:

Puede volver a la sección de mapeado cuando lo desee para editar el mapeado de las habitaciones o para agregar ajustes a la tarifa base. En la pantalla del mapeado de habitaciones, verá cuáles han sido mapeadas.

Luego de completar la conexión, notará que el estado de sincronización en la extranet de Airbnb se mostrará como Limited [Limitado]. Esto es normal. Significa que myallocator no anulará sus fotos y descripciones, sino que sólo actualizará sus tarifas y disponibilidad.

Paso 7. Verifique la sincronización de la disponibilidad y tarifas enviadas a Airbnb

Ahora que sus tarifas y disponibilidad en Airbnb están siendo dirigidas por myfrontdesk, conviene asegurarse que las tarifas y la disponibilidad se muestren de forma correcta en el canal.

Para obtener una vista previa de su anuncio en Airbnb, incluyendo precios y disponibilidad (como lo verá el huésped), siga los pasos a continuación.

1) Inicie sesión en Airbnb y diríjase a la pestaña Listings [Anuncios].

2) Abra el anuncio que desea revisar y haga clic en Preview listing [Vista previa del anuncio].

3) En la pestaña emergente verá un encabezado indicándole que está observando la vista previa de su anuncio.

4) Seleccione las fechas de estadía y el número de huéspedes.

Verifique las tarifas y la precisión de la disponibilidad. Estas deben coincidir con las tarifas base y la disponibilidad en myfrontdesk para la categoría de la habitación seleccionada.

Paso 7. De ser necesario, agregue impuestos / tasas o comisiones

1. Diríjase a la sección «Fuentes de reserva» en myfrontdesk.

2. Seleccione la pestaña de «Canales Externos».

3. Seleccione la opción «Airbnb (API)» de la lista desplegable y, de ser necesario, aplique una tasa o impuesto a las reservas de Airbnb.

4. Haga clic en GUARDAR.

En adelante, los impuestos y las tasas aplicables se agregarán automáticamente a las reservas de Airbnb (conexión API).

Paso 9. Deshabilite la conexión de Airbnb iCal (si esta se habilitó anteriormente)

Si antes de conectar la API de Airbnb tenía la conexión de Airbnb activa, deberá desactivarla.

  1. Diríjase a «Canales».
  2. Seleccione el canal «Airbnb (ical)».
  3. Elimine todos los enlaces.
  4. Vuelva al canal y desmarque la casilla que se muestra a continuación.
Posibles errores durante la conexión

Si encuentra algún error durante la conexión, consulte el artículo: Errores durante y después del mapeado y la conexión a Airbnb API o contacte a nuestro equipo de soporte enviando un correo electrónico a support@cloudbeds.com.

¿Cómo detengo la sincronización entre myfrontdesk y los anuncios de Airbnb?

Cómo detener solamente la sincronización de los anuncios

Entre los posibles motivos por los que necesite detener la sincronización entre los anuncios de Airbnb y myfrontdesk, se encuentran:

  • La información en Airbnb después de la sincronización es incorrecta.
  • Algunas configuraciones no se pueden editar.

Para detener la sincronización entre los anuncios de Airbnb y myfrontdesk, siga los pasos a continuación.

  1. Diríjase a la extranet de Airbnb y abra la pestaña de anuncios.
  2. Seleccione la opción «Cloudbeds (MyAllocator)».
  3. Haga clic en el menú de los tres puntos suspensivos cerca del anuncio.
  4. Haga clic en Stop sync [Detener sincronización].

Luego de seguir estos pasos, contacte a nuestro equipo de soporte al correo electrónico support@myallocator.com para desconectar myallocator de la API de Airbnb en nuestro sistema.

Cabe recordar que se deben realizar ambos pasos (desconectar la API de Airbnb en myfrontdesk y en la extranet de Airbnb). Si sólo se interrumpe la conexión en myallocator, no se detendrá la sincronización con Airbnb.

Desconectar toda la cuenta

Si por alguna razón necesita desconectar toda la cuenta de la API de Airbnb, siga las siguientes indicaciones.

Después de este proceso, podrá editar todo en la extranet de Airbnb sin tener que contactar a su equipo de soporte.

1) Ingrese a la pestaña de Account [Cuenta].

2) Seleccione la sección de Privacy & Sharing [Privacidad y datos compartidos].

3) Baje hasta encontrar las aplicaciones conectadas.

4) Haga clic para eliminar el acceso a Cloudbeds (myallocator).

Contacto de equipos de soporte:

¡Estamos aquí para ayudarle en todo momento! En caso de que requiera asistencia para conectar Airbnb a myfrontdesk, no dude en comunicarse con nuestro dedicado equipo:

También puede contactar al equipo de Airbnb si requiere asistencia al realizar cambios en su cuenta de Airbnb:

Have more questions? Enviar una solicitud

Comentarios

Tecnología de Zendesk