Preguntas frecuentes sobre Airbnb API

Objetivo Comprender el funcionamiento habitual de la conexión mediante la API de Airbnb en Cloudbeds PMS, incluidas las diferencias de sincronización, el funcionamiento de Reserva inmediata, las funciones compatibles, las tarifas, la comunicación con los huéspedes, la disponibilidad de los teléfonos de los huéspedes y los saldos pendientes de las reservas.
Dirigido a Administrador del establecimiento · Gerente del establecimiento · Titular
Cuándo usar este artículo Cuando necesites comprender cómo funciona la API de Airbnb con Cloudbeds PMS, comparar la API de Airbnb con Airbnb iCal, confirmar qué funciones admite la API de Airbnb o resolver dudas frecuentes sobre esta conexión.
Qué necesitas Acceso a la página de Distribución y una cuenta o un anuncio de Airbnb activo, conectado o listo para conectarse mediante la API de Airbnb.
Resultado esperado Comprendes qué puede sincronizar la API de Airbnb, en qué se diferencia de Airbnb iCal, cómo funciona Reserva inmediata con la API de Airbnb y qué artículo relacionado consultar para obtener instrucciones de configuración, detalles sobre el funcionamiento de iCal o pasos para desconectar el canal.
Limitación importante La API de Airbnb activa automáticamente Reserva inmediata. Actualmente, Cloudbeds PMS no procesa las solicitudes de reserva de Airbnb, las solicitudes pendientes ni los bloqueos temporales como reservas pendientes a través de la conexión mediante la API de Airbnb.

Introducción

Airbnb puede conectarse a Cloudbeds PMS mediante la API de Airbnb o Airbnb iCal. Estos tipos de conexión funcionan de manera diferente. Consulta estas preguntas frecuentes para confirmar qué funcionamiento corresponde a la API de Airbnb, en qué se diferencia Airbnb iCal y qué guía relacionada debes seguir cuando necesites instrucciones de configuración o detalles de la conexión.

Este artículo se centra en las preguntas frecuentes sobre la conexión mediante la API de Airbnb. Para obtener instrucciones de conexión paso a paso, consulta la guía Conectar Airbnb API a Cloudbeds PMS.

Índice

Conceptos básicos de la conexión mediante la API de Airbnb

Consulta esta sección para comprender las diferencias entre la API de Airbnb y Airbnb iCal, cuándo cambiar de iCal a API y cómo eliminar la conexión anterior de Airbnb iCal si todavía está activa.

¿Cuál es la diferencia entre la API de Airbnb y Airbnb iCal?

Airbnb iCal y la API de Airbnb son dos formas diferentes de conectar Airbnb con Cloudbeds PMS.

iCal significa especificación de objetos básicos de calendario y programación de Internet, también conocida como iCalendar. API significa interfaz de programación de aplicaciones.

Tipo de conexión Cómo funciona Qué debes saber
Airbnb iCal Utiliza fuentes de datos de calendario para sincronizar eventos de disponibilidad, como fechas bloqueadas o reservas, entre Airbnb y Cloudbeds PMS. iCal no es exclusivo de los sistemas de hotelería ni se desarrolló específicamente para los flujos de trabajo de gestión de hoteles o establecimientos. Las actualizaciones no son instantáneas, ya que el canal debe consultar la información nueva del calendario. Esto puede aumentar el riesgo de overbookings. Además, las conexiones iCal no permiten actualizar las tarifas.
API de Airbnb Proporciona una conexión directa entre Cloudbeds PMS y Airbnb para sincronizar varios tipos de datos entre ambos sistemas. La API de Airbnb ofrece una sincronización más completa que iCal y reduce el período durante el cual podría producirse una reserva duplicada. Cloudbeds PMS puede actualizar tarifas, disponibilidad, restricciones, cancelaciones y modificaciones. La API de Airbnb también admite tipos de habitación con varias unidades, descuentos, reglas de precios, reglas de disponibilidad e impuestos o tasas.

Para obtener más información sobre las conexiones basadas en calendarios, consulta Canales basados en calendarios y conexiones iCal en Cloudbeds PMS.

Si todas mis habitaciones están conectadas a Airbnb iCal, ¿cuándo puedo cambiar a la API de Airbnb?

Puedes cambiar de Airbnb iCal a la API de Airbnb de inmediato. Si antes utilizabas Airbnb iCal, desactiva esa conexión para evitar conflictos entre las actualizaciones.

Para cambiar la conexión, sigue los pasos de Conectar Airbnb API a Cloudbeds PMS.

¿Cómo puedo desactivar la conexión anterior de Airbnb iCal?

Si Airbnb iCal está activo, desactiva la conexión anterior de iCal antes de usar la API de Airbnb para evitar conflictos entre las actualizaciones.

  1. Accede a la página de Distribución.
  2. Busca Airbnb (iCal).
  3. Elimina todos los enlaces añadidos a la conexión de Airbnb iCal.
  4. Regresa al canal y desmarca la casilla.

Página de Distribución de Cloudbeds PMS que muestra la opción de conexión del canal Airbnb iCal.

Configuración de la conexión de Airbnb iCal en Cloudbeds PMS, donde puedes eliminar los enlaces iCal existentes.

Funciones compatibles con la API de Airbnb y funcionamiento de los anuncios

Consulta esta sección para confirmar qué funciones admite la API de Airbnb, con cuánta anticipación Cloudbeds PMS envía tarifas y disponibilidad y qué características de los anuncios de Airbnb pueden afectar el inventario múltiple.

¿Qué funciones del canal admite la API de Airbnb?

Funciones compatibles con la API de Airbnb Funciones no compatibles con la API de Airbnb
  • Días cerrados
  • Cerrado para llegadas
  • Cerrado para salidas
  • Duración mínima de la estancia
  • Duración máxima de la estancia
  • Mensajería con huéspedes
  • Cancelaciones
  • Modificaciones
  • Tarifas avanzadas en canales
  • Tarjetas de crédito
  • Días límite para reservar
  • Reservas de última hora
  • Precios por persona
  • Tarifas de uso único

¿Cuántas fotos podemos subir a Airbnb?

Puedes subir tantas fotos como quieras.

¿Qué tipos de anuncios de Airbnb no admiten inventario múltiple?

Airbnb proporcionó las siguientes pautas para el inventario por tipo de habitación:

Políticas de inventario por tipo de habitación:

El inventario por tipo de habitación permite a los anfitriones ofrecer varias unidades disponibles en un mismo anuncio para un mismo día. Los anfitriones pueden agrupar varias habitaciones en un único conjunto representativo y gestionar la disponibilidad del anuncio mediante el número de unidades disponibles por día.

Esta función solo debe implementarse cuando el anuncio tenga más de una habitación disponible por día y estas compartan características similares que permitan ofrecerlas como alternativas equivalentes. Las habitaciones deben tener los mismos servicios y comodidades, configuración de camas, tamaño, decoración y dirección.

Los anuncios cuyo tipo de propiedad sea Casa no pueden publicarse con inventario por tipo de habitación.

¿Con cuánta anticipación puede Cloudbeds PMS actualizar las tarifas y la disponibilidad de Airbnb?

Cloudbeds PMS envía a Airbnb las tarifas y la disponibilidad de los próximos tres años. Airbnb muestra 365 días.

Funcionamiento de Reserva inmediata y de las reservas con la API de Airbnb

Consulta esta sección para confirmar cómo funciona Reserva inmediata cuando Airbnb está conectado mediante API y cómo se diferencia la API de Airbnb de Airbnb iCal en cuanto a las solicitudes de reserva, las solicitudes pendientes y los bloqueos temporales.

¿Cómo funciona Reserva inmediata con la API de Airbnb?

Qué es Reserva inmediata de Airbnb

Reserva inmediata es una función de Airbnb que permite a los huéspedes que cumplen los requisitos del anuncio reservar las fechas disponibles sin que el titular o anfitrión revise la solicitud antes de que se confirme la reserva.

Funcionamiento de Reserva inmediata con la API de Airbnb

Cuando tu anuncio está conectado mediante la API de Airbnb, Reserva inmediata se activa automáticamente en Airbnb. No puedes desactivarla mientras la conexión mediante la API de Airbnb esté activa. Para dejar de usar Reserva inmediata, debes desconectar la conexión mediante la API de Airbnb de Cloudbeds PMS.

Requisitos del huésped de Airbnb que puedes seguir editando

Aunque Reserva inmediata se activa automáticamente mediante la conexión con la API de Airbnb, puedes seguir editando los requisitos del huésped en Configuración de reservas al editar tus anuncios en la extranet de Airbnb.

Pestaña Configuración de reservas de Airbnb que muestra las secciones Cómo pueden reservar los huéspedes y Requisitos del huésped.

Elige qué requisitos deben cumplir los huéspedes con reservas confirmadas:

  • Foto de perfil
  • Documento de identidad oficial
  • Recomendación de otros anfitriones
  • Mensaje previo a la reserva: agrega un mensaje que el huésped deba leer y responder antes de confirmar la reserva.

Configuración de Requisitos del huésped de Airbnb que muestra las opciones Foto de perfil, Documento de identidad oficial, Recomendación de otros anfitriones y Mensaje previo a la reserva.

¿Cloudbeds PMS procesa solicitudes de reserva o bloqueos temporales mediante la API de Airbnb?

No. Actualmente, Cloudbeds PMS no procesa las solicitudes de reserva de Airbnb, las solicitudes pendientes ni los bloqueos temporales como reservas pendientes a través de la conexión mediante la API de Airbnb.

Si no quieres recibir reservas de Airbnb mediante Reserva inmediata, evalúa si una conexión de Airbnb iCal es adecuada para tu flujo de trabajo. Airbnb iCal funciona de manera diferente a la API de Airbnb y ofrece una sincronización más limitada. Para obtener más información, consulta Canales basados en calendarios y conexiones iCal en Cloudbeds PMS.

Tarifas, disponibilidad y precios con la API de Airbnb

Consulta esta sección para verificar cómo Airbnb muestra las tarifas y la disponibilidad que envía Cloudbeds PMS y por qué los precios pueden aparecer de forma diferente en ambos sistemas.

¿Cómo puedo verificar que las tarifas y la disponibilidad enviadas a Airbnb sean correctas?

Cuando Cloudbeds PMS gestiona las tarifas y la disponibilidad de Airbnb, verifica que Airbnb muestre los precios y la disponibilidad esperados para el tipo de habitación o anuncio mapeado.

  1. Inicia sesión en la extranet de Airbnb y ve a Anuncios.
  2. Abre el anuncio que quieras revisar y haz clic en Vista previa del anuncio.

Página de Anuncios de Airbnb que muestra la opción para ver una vista previa del anuncio seleccionado.

  1. En la nueva página, confirma que aparezca el encabezado Modo de vista previa.

Página de vista previa de un anuncio de Airbnb que muestra el encabezado Modo de vista previa.

  1. Selecciona las fechas de la estancia y el número de huéspedes.

Campos de la vista previa de un anuncio de Airbnb para seleccionar las fechas de la estancia y el número de huéspedes.

Resultado de la vista previa de un anuncio de Airbnb que muestra las tarifas y la disponibilidad para las fechas de estancia seleccionadas.

Las tarifas y la disponibilidad deben coincidir con las tarifas base y la disponibilidad de Cloudbeds PMS para el tipo de habitación o anuncio seleccionado.

¿Por qué las tarifas diarias del desembolso de la reserva difieren de las del calendario?

Aunque las tarifas diarias de tu calendario pueden variar, Airbnb toma el monto total de la reserva y lo divide entre el número de noches. Luego, muestra ese monto como tarifa diaria.

Por ejemplo, en esta reserva de siete noches, las tarifas diarias del calendario eran las siguientes:

  • Viernes: $29
  • Sábado: $23,20
  • Domingo: $23,20
  • Lunes: $18
  • Martes: $18
  • Miércoles: $18
  • Jueves: $18

Total: $147,40

Airbnb dividió el total entre el número de noches, mostró una tarifa de $21,00 por noche y redondeó el total a $148,00.

Ejemplo de un desembolso de una reserva de Airbnb que muestra el monto total de la reserva dividido entre el número de noches.

¿Por qué no puedo ver los descuentos semanales o mensuales de mis habitaciones compartidas en Airbnb?

Cuando configuras un descuento semanal o mensual para habitaciones compartidas en el mapeado de Cloudbeds PMS, no verás esos descuentos reflejados en la configuración de la extranet de Airbnb. Esto no significa que el descuento no se esté aplicando.

Cloudbeds PMS calcula el precio con descuento y envía la tarifa final a Airbnb según las fechas de la estancia, la duración de la estancia y el número de huéspedes. Como el descuento ya se calcula antes de enviar la tarifa, Airbnb puede mostrar Ninguno en los campos de descuento semanal o mensual de la extranet.

En Cloudbeds PMS, los descuentos semanales y mensuales se configuran en los ajustes de precios de las habitaciones de Airbnb:

Ajustes de precios de las habitaciones de Airbnb en Cloudbeds PMS que muestran los campos de descuentos semanales y mensuales configurados para una habitación compartida.

En la extranet de Airbnb, esos mismos campos de descuento semanal y mensual pueden mostrar Ninguno, incluso cuando Cloudbeds PMS ya envía la tarifa final con descuento:

Sección Descuentos por duración de la estancia de la extranet de Airbnb, donde los descuentos semanales y mensuales aparecen como Ninguno.

Para confirmar si se aplicó el descuento, revisa una reserva realizada con la regla de descuento semanal o mensual. La tarifa final de la reserva ya debe incluir el descuento respecto de las tarifas de tu calendario.

¿Por qué el precio de la habitación que aparece en Airbnb difiere del de Cloudbeds PMS?

Los precios de las habitaciones pueden diferir entre Airbnb y Cloudbeds PMS por varios motivos. Las causas más comunes son las siguientes:

  • Los impuestos y las tasas no están configurados de la misma manera en Cloudbeds PMS y Airbnb. Debes configurarlos de forma coherente en ambos sistemas para que el total de la reserva se muestre correctamente.
  • Airbnb tiene descuentos o reglas de precios aplicados, como descuentos por duración de la estancia, por política de cancelación o de última hora.
  • Las tarifas base no están incluidas en el desglose de la tarifa. Debes añadirlas como incluidas.

Consulta los siguientes artículos para obtener más información:

Comunicación con los huéspedes y saldo pendiente con la API de Airbnb

Consulta esta sección para comprender cómo Airbnb comparte la información de contacto de los huéspedes mediante la API, cómo comunicarte con ellos cuando no hay un teléfono disponible y por qué las reservas de Airbnb pueden mostrar un saldo pendiente en Cloudbeds PMS.

¿Por qué no puedo enviar correos a los huéspedes de Airbnb?

Debido a sus políticas, Airbnb no envía las direcciones de correo de los huéspedes de las reservas mediante la API. Usa las herramientas de mensajería disponibles en Airbnb para comunicarte con los huéspedes. Los teléfonos de los huéspedes también pueden no estar disponibles o aparecer sustituidos por números temporales, según las normas de privacidad de Airbnb. Consulta la siguiente pregunta frecuente para obtener más detalles.

Para obtener más información, consulta este recurso de Airbnb: Una actualización para los anfitriones que usan la función de alias de correo.

¿Por qué falta el teléfono de un huésped de Airbnb o aparece sustituido por un número temporal?

Airbnb limita los teléfonos de los huéspedes que comparte en las reservas mediante la API para proteger a los anfitriones y huéspedes de la suplantación de identidad y del uso indebido de la información personal. A partir de la semana del 26 de octubre de 2026, Airbnb comenzó a implementar números de teléfono temporales para determinadas reservas en lugar de compartir los números reales de los huéspedes.

¿Cuándo proporciona Airbnb un número de teléfono temporal? Deben cumplirse todas las condiciones siguientes:

  • La reserva se aceptó el 26 de octubre de 2026 o después de esa fecha.
  • El alojamiento anunciado en Airbnb está ubicado en Estados Unidos o Canadá.
  • Tanto el anfitrión como el huésped tienen un teléfono.
  • Tanto el anfitrión como el huésped residen en el mismo país, ya sea Estados Unidos o Canadá.

¿Cuándo no se proporciona ningún número de teléfono? Airbnb no envía el teléfono del huésped ni un número temporal mediante la API para las reservas que no cumplan todas las condiciones anteriores. Esto incluye las reservas aceptadas antes del 26 de octubre de 2026, los alojamientos anunciados fuera de Estados Unidos y Canadá y las reservas en las que el anfitrión y el huésped residen en países diferentes.

 Airbnb puede mostrar los últimos cuatro dígitos del teléfono real del huésped en la página de datos de la reserva para procesos como la gestión de códigos de acceso a las puertas. Esto no significa que Airbnb envíe el número real ni esos dígitos a Cloudbeds PMS mediante la API.

¿Cómo puedo comunicarme con un huésped si no tengo un teléfono? Usa la mensajería de Airbnb u otro método de mensajería con huéspedes disponible y compatible, en lugar de depender del campo de teléfono de la reserva en Cloudbeds PMS.

Esta restricción depende de la política de intercambio de datos de la API de Airbnb, no de una configuración de teléfono de Cloudbeds PMS. Para obtener más información, consulta Cómo funcionan los números de teléfono temporales - Centro de asistencia de Airbnb.

¿Por qué aparece un saldo pendiente en Cloudbeds para las reservas de Airbnb?

Los huéspedes de Airbnb pagan directamente a Airbnb, y Airbnb paga al establecimiento mediante transferencia bancaria. Debido a este flujo de pago, Cloudbeds PMS importa la reserva de Airbnb con un saldo pendiente.

Para saldar el saldo pendiente, añade manualmente un pago en Cloudbeds PMS que refleje los fondos que el establecimiento recibe de Airbnb.


Consulta estos artículos cuando necesites pasos de configuración, detalles sobre el funcionamiento de iCal, pasos para desconectar el canal u orientación sobre la configuración de impuestos y tasas relacionados con Airbnb.

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 0

Comentarios

0 comentarios

Inicie sesión para dejar un comentario.