Cómo conectar Airbnb API a myfrontdesk

Seguir

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

Esta integración incluye:

  1. Sincronización completa entre 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 actualice su información, se actualizarán sus anuncios.
  3. Soporte de sincronización para las categorías de alojamientos que cuentan con varias unidades disponibles.
  4. Soporte de descuentos, reglas de precios, condiciones de disponibilidad y tarifas o impuestos.

Nota: La función de Smart Pricing no es compatible al conectarse a Airbnb desde su API, debido a la forma en que se manejan las tarifas al usar este sistema de gestión. La función de Smart Pricing de Airbnb consiste en un algoritmo que intenta modular el precio durante temporadas altas y bajas para maximizar ingresos y al mismo tiempo mantener precios atractivos para clientes.

Cuando un sistema de gestión como Airbnb API se conecta a Cloudbeds, esa metodología de precios ya no es aplicable porque nuestro sistema pasa a establecer todos los precios.

Antes de realizar la conexión

Asegúrese que:

  • En la extranet de Airbnb, el estado de su anuncio figure como Publicado (la sincronización no funcionará si el anuncio no ha sido publicado en Airbnb).
  • La configuración de sus habitaciones coincida con la de Airbnb
  • La divisa configurada en myfrontdesk y Airbnb sea la misma.
  • El huso horario configurado para su propiedad coincida con el de Airbnb.
  • La propiedad no esté conectada a otro administrador de canales. De ser así, inicie sesión en la extranet de Airbnb y diríjase a Cuenta> Privacidad y uso compartido> Aplicaciones conectadas y seleccione Eliminar acceso.

Para más información, véase: Airbnb API – Requisitos mínimos y preguntas frecuentes.

Guía de conexión a Airbnb API

Paso 1. Habilite o autorice Airbnb API en la sección Canales de myfrontdesk

Antes de iniciar el mapeado en Airbnb, asegúrese de estar conectado en la cuenta del anfitrión principal en la extranet de Airbnb. Todos los demás usuarios (como coanfitriones o el equipo de hospedaje) no podrán conectar el canal a myfrontdesk. Si no está seguro de cómo proceder, véase el siguiente artículo de Airbnb: ¿Qué es un anfitrión principal?

  1. Por defecto, el canal Airbnb (API) estará en estado Sin configuración para todas las propiedades. Haga clic en la barra Sin configuración.
  2. Haga clic en NEXT [SIGUIENTE] para autorizar la conexión a Airbnb.

Cómo autorizar a myallocator (el channel manager de Cloudbeds) a gestionar sus anuncios de Airbnb

Ahora debe autorizar a myallocator (el channel manager de Cloudbeds) a gestionar sus anuncios:

  1. Ingrese el usuario y la contraseña del anfitrión principal de Airbnb (no las credenciales de coanfitrión). Si se presenta un error, cierre sesión en todas las cuentas de Airbnb en su navegador y repita el procedimiento de autorización.
  2. Acepte los términos y condiciones de Airbnb y confirme que autoriza a myfrontdesk haciendo clic en ALLOW [AUTORIZAR].
Paso 2. Realice el mapeado de las habitaciones
  1. Enlace cada categoría de habitación de myfrontdesk con el correspondiente anuncio en Airbnb.
  2. Haga clic en UPDATE [ACTUALIZAR] para configurar la información de cada uno de sus anuncios. Para más información sobre este proceso, véase el Paso 3: Establezca o edite la información relacionada con la configuración de sus habitaciones.

El proceso de mapeado puede diferir dependiendo de la configuración de habitación que tenga en Airbnb (incluyendo anuncios individuales, categorías de habitación y habitaciones compartidas). Véase en este artículo la guía de mapeado para distintos escenarios.

Si administra varias propiedades bajo las mismas credenciales de inicio de sesión de myfrontdesk, verá 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. Cómo mapear varios anuncios de Airbnb a la misma categoría de habitación en myfrontdesk

Si tiene una 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 anuncia varias categorías de habitación en myfrontdesk y tiene varios anuncios individuales en Airbnb, cada uno correspondiente a una unidad específica, deberá realizar el proceso indicado a continuación.

Digamos que:

En myfrontdesk, tiene una categoría de habitación (estudio Deluxe) con 5 unidades: Studio 1, Studio 2 y así en más.

En Airbnb tiene 5 anuncios separados y estas habitaciones tienen la misma configuración y descripción: Studio 1, Studio 2, Studio 3 y así en más.

Al llegar al mapeado de habitaciones, sólo podrá mapear un (1) anuncio a su categoría de habitación. ¿Qué se puede hacer?

  1. Inicie sesión en la extranet de Airbnb y cambie sólo un (1) anuncio en esa categoría a Publicado (el resto de los anuncios en esta categoría de habitación deben quedar como No publicados).
  1. En la página de mapeado de habitaciones de myfrontdesk, enlace la categoría de habitación al anuncio que está Publicado.
  1. Luego de hacer clic 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 los dormitorios compartidos de myfrontdesk

Escenario A.

Si tiene una categoría de dormitorio compartido con ocho (8) camas en myfrontdesk y un (1) anuncio compartido en Airbnb que corresponde a la categoría de habitación anunciada en myfrontdesk, sencillamente mapee la categoría de habitación al anuncio en Airbnb. Sus huéspedes podrán reservar varias camas o dormitorios en Airbnb.

No es necesario crear varios anuncios en Airbnb.

Veamos el siguiente ejemplo:

Configuración del anuncio en la extranet de Airbnb: una (1) habitación con ocho (8) camas para alojar a ocho (8) huéspedes.

Recuerde que el número de camas debe ser igual al número de huéspedes. El dormitorio (que corresponde a la categoría de habitación) siempre es 1, aunque tenga varias habitaciones en esta categoría (como se indica en el Escenario B), myfrontdesk enviará la disponibilidad al mismo anuncio.

Escenario B. 

Supongamos que tiene una (1) categoría de dormitorio compartido en myfrontdesk con dos (2) o más unidades y dos (2) camas en cada una. En dado caso: si ya tiene un (1) anuncio en Airbnb para este dormitorio compartido que corresponde a esa categoría en myfrontdesk, no necesita crear anuncios adicionales.

Pero si tiene varios anuncios en Airbnb, cada uno de ellos representa una cama en un dormitorio compartido y quiere mapearlos en un dormitorio compartido (la categoría de la habitación) en myfrontdesk, deberá:

1. Publique sólo uno de los anuncios que representa  el dormitorio compartido
  1. ANTES de mapearlo en myfrontdesk, inicie sesión en Airbnb y acceda a sus anuncios. Entre todos los anuncios que representan las camas de un (1) dormitorio compartida, cambie sólo uno de los anuncios a Publicado.

    Las demás camas del dormitorio compartido deben quedar como No publicadas.
  1. Diríjase al anuncio que se encuentra Publicado > seleccione Detalles del anuncio haciendo clic en el nombre del anuncio. Por ejemplo, de tener seis (6) camas en un dormitorio:
  1. A la derecha de Habitaciones y espacios, haga clic en Editar.
  1. En la sección Habitación, haga clic en Editar la sección Distribución de las camas.
  1. Seleccione el número y tipo de camas.

Preste atención a la configuración de camas en Airbnb.

De tener literas en las habitaciones (un alojamiento común en dormitorios), Airbnb multiplicará el número de camas de literas para obtener el número equivalente de camas. De seleccionar tres (3) camas de litera, el número total de camas será seis (6).

  1. Haga clic en Guardar para guardar los cambios.
  1. Vuelva a Información del anuncio y avance a la sección Propiedad y huéspedes.
  2. Seleccione el mismo número de huéspedes que camas. En el presente ejemplo, 6 camas.

El número de camas debe ser igual al número de huéspedes. El dormitorio, que corresponde a la categoría de habitación, siempre es 1, aunque tenga varias habitaciones o tipos de habitación en esa categoría.

2. Realice el mapeado el anuncio del dormitorio compartido en myfrontdesk

Inicie sesión en 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, véase: 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. Seleccione o edite la información de la configuración de sus habitaciones

Después de hacer clic en 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 (opción recomendada): si ya 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 para sobrescribir su configuración de extranet de Airbnb con los nuevos valores establecidos en myfrontdesk.

Luego de seleccionar una de las dos opciones, será dirigido a la página Exportar habitación.

1. Reglas de disponibilidad

La configuración en esta sección reúne los valores predeterminados de Airbnb y muestra los valores predeterminados en la extranet de Airbnb. Puede que esos valores no sean iguales a los establecidos en su cuenta de myfrontdesk o myallocator. Sin embargo, ahora que se ha conectado a Airbnb desde myfrontdesk o myallocator, puede modificar la disponibilidad desde nuestro sistema, así que no importa si los valores en la extranet de Airbnb (en la pestaña de Disponibilidad) no son iguales a los de myfrontdesk.

Notificación previa

Los huéspedes pueden reservar: dado que dirige su disponibilidad desde myfrontdesk, sus huéspedes pueden reservar en cualquier fecha que su anuncio esté disponible en el calendario.

  • Ventana de disponibilidad: por defecto, y debido a que el calendario de myfrontdesk controla la disponibilidad de su anuncio, todas las fechas que no cuenten con disponibilidad en el calendario no se podrán reservar. Solo se podrán reservar aquellas fechas que se encuentren disponibles según el calendario.
  • Duración mínima de estadía (en noches): la duración mínima de estadía está configurada según los valores indicados en su cuenta myfrontdesk para la estadía mínima (MinLOS). A todas las fechas a las que no se les haya fijado una restricción, se les asignará una estadía mínima de 1 noche.
  • Días de la semana en los que se permite hacer check-in: esta casilla es gestionada por la configuración de Cerrado para llegadas en myfrontdesk.
  • Tiempo de preparación: esta función no se encuentra disponible.
  • Duración máxima de estadía (en noches): la duración máxima de la estadía es controlada por los valores indicados en su cuenta de myfrontdesk para la estadía máxima (MaxLos). A todas las fechas a las que no se les haya fijado una restricción, no se les asignará estadía máxima.
  • Días de la semana en los que se permite hacer check-out: este campo está controlado por la configuración de Cerrado para salidas en myfrontdesk.
  • Estadía mínima por día de la semana: la duración mínima de estadía está configurada según los valores indicados en su cuenta myfrontdesk para la estadía mínima (MinLOS). A todas las fechas a las que no se les haya fijado una restricción, se les asignará una estadía mínima de 1 noche.
  • Reservas para el mismo día: consiste en aceptar reservas para el mismo día que se realizan. Algunas propiedades prefieren desactivar esta función para así contar con el tiempo suficiente para preparar las habitaciones de sus huéspedes. Para más información sobre cómo habilitar o deshabilitar esta función, véase este artículo.

Las configuraciones que no modifica nuestro sistema luego de conectarse tienen la opción de Editar. Eso sí, debe configurarlos en la extranet de Airbnb.

Por ejemplo, para administrar sus horas de entrada y salida, siga los siguientes pasos:

  1. Seleccione su anuncio y haga clic en Configuración de la reserva.
  2. Avance hasta la sección Políticas y haga clic en Editar.
  3. Configure las horas de registro o check-in.
  4. Configure las horas de salida o check-out.
  5. Haga clic en Guardar.

2. Configuración de precios

  • General
    • Moneda del anuncio: la moneda seleccionada debe coincidir con la que anunciará sus tarifas.
    • Precios base por noche para los anuncios: las tarifas son gestionadas por el calendario de myfrontdesk. Todas las fechas a las que no se les haya fijado una tarifa específica en myfrontdesk se configurarán automáticamente con esta tarifa.
    • Precios de fin de semana: las tarifas (incluyendo los fines de semana) son controladas por el calendario de myfrontdesk. Todas las fechas a las que no se les haya fijado una tarifa específica se configurarán automáticamente con esta tarifa.
  • Descuentos por la duración de la estadía
    • % de descuento semanal: Airbnb calculará la tarifa semanal con base en este porcentaje de descuento si su huésped selecciona 7 noches o más.
    • % de descuento por mes: Airbnb calculará la tarifa mensual con base en este porcentaje de descuento si su huésped selecciona un mes entero.
  • Precio por huéspedes adicionales
    • Agregue el número de huéspedes incluidos en el precio.
  • Tarifa de huésped adicional (por noche): agregue (en caso de aplicar) esta tarifa a modo de monto fijo por noche. Sólo aplica a habitaciones privadas.
  • Los dormitorios compartidos deben incluir la tarifa de huésped adicional en cero en el mapeado y en la extranet del canal.
  • El número de huéspedes incluidos debe ser uno (1). El sistema multiplicará la tarifa según el número de huéspedes o camas de la reserva.
  • Tarifas estándar
    • Depósito de seguridad: en caso de aplicar, agregue esta tarifa como monto fijo.
    • Tarifa de limpieza: en caso de aplicar, agregue esta tarifa como monto fijo.
  • Otras tarifas: para las demás tarifas enumeradas, puede ingresar un porcentaje o monto fijo.

Airbnb envía el monto total, incluyendo tarifas (menos las tarifas del huésped y los servicios del anfitrión), a nuestro sistema como ingresos por habitación. Por lo tanto, esas tarifas no se incluyen en su desglose de tarifas. A modo de solución, puede establecer tarifas inclusivas para el canal de Airbnb, de manera que el desglose de los ingresos por reservas incluya esas tarifas.

Si requiere asistencia para establecer sus tarifas en Airbnb, contacte al servicio al cliente de Airbnb en https://es.airbnb.com/help/home.

Para los dormitorios:

3. Impuestos trasladables

  • Impuestos
    • Tipo de impuesto: las opciones incluyen impuesto a hoteles, 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: las 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.
    • ID de registro: es el número de registro de impuestos de su alojamiento o el número que le ha asignado su jurisdicción fiscal local.
    • Monto: ingrese el monto de sus impuestos.
    • Exención a estadías a largo plazo:
      • Una reserva puede ser elegible para recibir 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 a los anuncios?
    • Confirmación: si su anuncio incluye impuestos, deberá hacer clic en el cuadro de confirmación antes de seleccionar GUARDAR Y SINCRONIZAR.

Estos impuestos no aplican a las tarifas que myfrontdesk envía a Airbnb. Airbnb toma estos valores y los aplica a las reservas al momento de recibirlas.

Veamos un ejemplo

  • La tarifa de habitación (en su sección de disponibilidad) es de $ 100.00.
  • Su impuesto es del 10%.

¿Cómo funciona?

  • Myfrontdesk envía una tarifa de $ 100 a Airbnb.
  • Airbnb muestra una tarifa de $ 100.00 a sus huéspedes.
  • Cuando el huésped finaliza el proceso de reserva, Airbnb agrega de manera automática $ 10.00 (el impuesto del 10%) al total de la reserva y envía ambos valores ($ 100.00 por la habitación y $ 10.00 por impuestos) a myfrontdesk.

Si Airbnb paga los impuestos por la propiedad:

  • Los impuestos se configuran de manera automática en la extranet de Airbnb, por lo que no es necesario agregarlos durante el mapeado de nuestras habitaciones.
  • Airbnb envía el total del pago estimado (el monto transferido a la propiedad) a nuestro sistema, por lo que esos impuestos no se incluyen en su desglose de tarifas.

Si requiere asistencia para configurar sus impuestos de Airbnb, contacte al servicio al cliente de Airbnb en https://es.airbnb.com/help/home.

4. Reglas de precios y descuentos

  • Reglas de precios
    • Tipo de regla: sus opciones incluyen reserva anticipada (días mínimos de anticipo), reserva de último minuto (días máximos de anticipo), estadía prolongada (por noches) y temporada.
    • Cambio de precio: ingrese el monto de su descuento en valores porcentuales.
    • Tipo de cambio de precio: seleccione la opción porcentaje (Airbnb ya no acepta descuentos con valores absolutos).
    • Umbral de días y noches: ingrese el número del umbral de días y noches para los que aplicará el descuento agregado.
    • Fechas de llegada: ingrese las fechas del descuento agregado.

Si agrega varios descuentos al mismo tipo de descuento y las mismas fechas pero con diferentes valores, Airbnb sólo aceptará uno de los descuentos. Por lo tanto, si agrega varios descuentos, myfrontdesk aplicará el descuento que resulte en el precio más alto.
Recuerde que los descuentos porcentuales anulan los descuentos de monto fijo.

Ejemplo 1: tienes tres descuentos para el mismo tipo, período y fecha:

  • Estadías prolongadas (noches): más de 10 días = 20% por período x
  • Estadías prolongadas (noches): más de 10 días = 10% por período x
  • Estadías prolongadas (noches): más de 10 días = 24% por período x

Solo se aplicará el descuento Estadías prolongadas (noches): más de 10 días = 10% por período x, porque es el descuento de mayor valor.

Sin embargo, de seleccionar varios tipos de descuentos en las mismas fechas, se aplicarán ambos:

Ejemplo 2

  • Estadías prolongadas (noches): más de 10 días = 24% por período x
  • Descuento por reserva anticipada: más de 20 días de anticipación = 15% por período x

Se aplicarán ambos descuentos.

Ejemplo 3:

La tarifa de la habitación es $100 y los descuentos disponibles son: 30% y 20%.

• 30% de descuento reduce la tarifa de habitación a $70.
• 20% de descuento reduce la tarifa de habitación a $80.

En este caso, myfrontdesk envía la tarifa de $80 a Airbnb (porque es la más alta).

5. Haga clic en GUARDAR Y SINCRONIZAR

  1. Haga clic en SIGUIENTE luego de mapear y anunciar todos los anuncios.

Luego de hacer clic en SIGUIENTE, se verá un mensaje de advertencia en la parte superior de la página que indica que algunas habitaciones no han sido mapeadas. Haga clic en OK para continuar.

Paso 4. Modifique la tarifa base

De ser necesario, en esta sección puede reducir o aumentar su tarifa base en todas las categorías de habitaciones mapeadas.

Por ejemplo, si desea que un canal tenga 5% de descuento en comparación a otros canales, modifique su valor -5% en cada habitación. El proceso es igual (aunque al revés) para aumentar las tarifas.

Las diferencias en las tarifas pueden agregarse como 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í se muestran todas las funciones que permite la conexión entre myfrontdesk y Airbnb API.

Diríjase a la sección Canales del menú desplegable Distribución de canales y haga clic en ACTUALIZAR.

DEMO - El Bolsón - Configuración - Myallocator (Distribución) - Canales - Google Chrome
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:

DEMO - El Bolsón - Configuración - Myallocator (Distribución) - Canales - Google Chrome

Cuando lo considere conveniente, puede volver a la sección de mapeado para editar el mapeado de habitaciones o modificar las tarifas base. En la pantalla de mapeado de habitaciones verá cuáles ya han sido mapeadas:

Al finalizar la conexión, verá que el estado de sincronización en la extranet de Airbnb indica que es Limited [Limitado]. Eso es normal. Significa que myallocator no anulará sus fotos y descripciones, sino que se limitará a actualizar las tarifas y disponibilidad de sus habitaciones.

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

Ahora que sus tarifas y disponibilidad en Airbnb son modificadas desde myfrontdesk, conviene asegurarse que las tarifas y la disponibilidad se vean de manera correcta en el canal.

Para ver sus anuncios, precios y disponibilidad en Airbnb (tal como lo verán los huéspedes), siga los pasos a continuación:

  1. Inicie sesión en Airbnb y diríjase a la pestaña Anuncios.
  2. Seleccione el anuncio que desea visualizar y haga clic en Vista previa.
  1. En la pestaña emergente verá un encabezado indicándole que está en modo vista previa.
  1. Seleccione las fechas de estadía y el número de huéspedes.

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

Paso 8. De ser necesario, agregue impuestos, tasas o comisiones
  1. Diríjase a la sección Fuentes de reserva en el menú desplegable Configuración de la propiedad en myfrontdesk.
  2. Seleccione la pestaña de Fuentes externas.
  3. Haga clic en Añadir nueva OTA en la casilla OTA y seleccione Airbnb (API) de la lista desplegable. De ser necesario, agregue una tasa o impuesto a las reservas de esa OTA.
  4. Haga clic en GUARDAR.

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

Paso 9. Deshabilite la conexión de Airbnb iCal (si ha sido habilitada)

Si tiene una conexión habilitada a Airbnb iCal, deberá deshabilitarla.

  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.

Si se generan errores durante la conexión, véase: Errores durante y después del mapeado y la conexión a Airbnb API o contacte a nuestro servicio al cliente enviando un correo electrónico a support@cloudbeds.com.

Información de servicio al cliente:

¡Estamos aquí siempre para prestarle asistencia! Si requiere ayuda para conectar Airbnb a myfrontdesk, no dude en comunicarse con nuestro equipo dedicado:

También puede contactar al servicio al cliente de Airbnb para modificar su cuenta de Airbnb:

Tecnología de Zendesk