Integraciones de PMS (Beds24 y Hostfully)
Si su empresa ya administra sus villas en otro sistema de gestión de propiedades (PMS), puede conectarlo a Argonautas en lugar de volver a ingresar todo manualmente. Argonautas es compatible con Beds24 y Hostfully. Una vez conectado, sus propiedades, reservas, tarifas y disponibilidad, y los mensajes de huéspedes fluyen desde el PMS hacia Argonautas y se mantienen actualizados automáticamente.
Su PMS sigue siendo el responsable de los registros que envía. Argonautas los lee y usted no puede editarlos en Argonautas. Realice los cambios en el PMS y se reflejarán en la próxima sincronización.
Quién Puede Ver Esto
La integración de PMS es activada para cada empresa por el equipo de soporte de Argonautas. La tarjeta Sistema de gestión de propiedades solo aparece en Configuración > Integraciones una vez que soporte la haya activado para su empresa. Si usted usa Beds24 o Hostfully y no ve la tarjeta, comuníquese con soporte.
Los administradores y gerentes de propiedades pueden conectar, revisar e importar. Cada empresa puede conectar un PMS.
Cómo Conectar Su PMS
Abra Configuración > Integraciones y busque la tarjeta Sistema de gestión de propiedades. En ¿Qué sistema?, elija Beds24 o Hostfully.
Beds24
Beds24 se conecta con un código de invitación de un solo uso que usted genera en Beds24. La tarjeta enumera los pasos en Antes de comenzar:
- En Beds24, vaya a Settings → Marketplace → API y genere un código de invitación.
- Al generarlo, otorgue todos los ámbitos listados en Permisos a conceder:
read:bookings,read:bookings-personal,read:bookings-financial,read:properties,read:inventory,write:inventoryywrite:properties. - Pegue el código en Código de invitación y haga clic en Conectar.
El código vence 24 horas después de generarlo y funciona solo una vez. Si la conexión falla, genere un código nuevo en Beds24 y pegue ese. Intentar con el mismo código otra vez no funcionará.
Otorgue todos los ámbitos la primera vez. Beds24 fija los ámbitos cuando usted crea el código, y no se pueden agregar después. Si omite uno, la única solución es desconectar y conectar de nuevo con un código nuevo. Sin read:bookings-personal, las estadías importadas muestran un huésped genérico en lugar de nombres, correos electrónicos y números de teléfono reales. Sin read:bookings-financial, no se pueden leer los precios de las reservas ni la comisión. Sin write:inventory, no puede fijar el precio de una villa de Beds24 desde Argonautas (vea Cómo Fijar un Precio de Beds24 Desde el Calendario).
Hostfully
Hostfully se conecta con las credenciales de API de su cuenta:
- En Hostfully, abra Settings → API y copie su clave de API y el UID de agencia.
- Ingréselos en Clave de API y UID de agencia en la tarjeta.
- Haga clic en Conectar.
Argonautas verifica las credenciales con Hostfully antes de guardar cualquier cosa. Si son rechazadas, la tarjeta muestra el error en el lugar. Verifique ambos valores en Hostfully e intente de nuevo.
Qué Sucede Inmediatamente Después de Conectar
Tan pronto como se conecta, Argonautas busca las unidades rentables en su PMS. Aún no se importa nada. Solo encuentra las unidades y le pregunta qué es cada una (vea la siguiente sección).
Cómo Revisar las Unidades Detectadas
Cada unidad encontrada en su PMS necesita una decisión antes de que se importen sus reservas. Cuando hay unidades pendientes, la tarjeta muestra un aviso amarillo ({count} unidad(es) necesitan una decisión) y el estado cambia a Necesita revisión. Haga clic en Revisar unidades para abrir Revisar unidades detectadas.
Para cada unidad, elija una de las opciones en ¿Qué es? y haga clic en Aplicar:
| Opción | Qué hace |
|---|---|
| Crear una nueva propiedad | Argonautas crea una nueva propiedad para esta unidad en la próxima importación. |
| Esta es mi "…" existente | Vincula la unidad a una propiedad que usted ya tiene en Argonautas. La propiedad conserva su descripción, fotos y amenidades. A partir de entonces, su PMS controla su disponibilidad, fechas y estado de reserva. |
| No importar esta | Deja la unidad fuera. No se importa ninguna de sus reservas. |
Argonautas puede sugerir una posible coincidencia para una unidad. Esa sugerencia solo compara nombres, así que verifíquela antes de elegir.
Cómo Importar Reservas
Cuando cada unidad tenga una decisión, haga clic en Importar reservas. La importación se ejecuta en segundo plano, y la fecha de Última importación de la tarjeta se actualiza cuando termina. No puede iniciar una importación mientras haya unidades pendientes. La tarjeta muestra "Termine de revisar las unidades de arriba antes de importar."
La fila de cifras en la tarjeta muestra cuántas unidades están Vinculadas, Pendientes de revisión e Ignoradas, además de la fecha de la Última importación.
Otros botones en la tarjeta:
- Actualizar unidades consulta su PMS de nuevo en busca de unidades nuevas. Las nuevas aparecen en la lista de revisión.
- Probar conexión confirma que Argonautas aún puede comunicarse con su PMS.
- Desconectar detiene todas las importaciones futuras y elimina la credencial almacenada. Sus propiedades y decisiones de vinculación se conservan. Para reconectar una cuenta de Beds24, necesitará un nuevo código de invitación.
Cómo Mantener las Reservas Sincronizadas
Después de la primera importación, Argonautas se mantiene al día con su PMS de tres maneras:
- Consulta de reservas: aproximadamente cada 5 minutos, Argonautas le pregunta a su PMS por reservas nuevas, modificadas o canceladas.
- Reconciliación nocturna: una revisión completa cada noche detecta todo lo que la consulta haya pasado por alto.
- Alertas instantáneas de reservas (webhooks): su PMS le informa a Argonautas en el momento en que se hace o cancela una reserva.
Las alertas instantáneas son importantes porque las villas importadas aún se pueden reservar directamente a través de Argonautas. Cuanto más rápido se entere Argonautas de una venta en su PMS, menor será la ventana en la que las mismas noches podrían venderse dos veces. Configúrelas tan pronto como se conecte.
Alertas Instantáneas de Reservas para Beds24
Beds24 no tiene forma de configurar esto de manera remota, así que usted lo agrega manualmente. El panel Alertas instantáneas de reservas de la tarjeta muestra una URL de webhook y un segundo valor (un nombre de encabezado y su valor), cada uno con un botón de copiar. En Beds24, vaya a Settings → Properties → Access → Booking Webhook, pegue ambos valores y elija version 2 (with personal data).
Haga esto una vez por cada propiedad de Beds24, es decir, el contenedor que agrupa sus tipos de habitación, no una vez por villa.
Alertas Instantáneas de Reservas para Hostfully
Hostfully se puede configurar desde Argonautas. En el panel Alertas instantáneas de reservas de la tarjeta, haga clic en Registrar webhooks. Cuando tenga éxito, el botón cambia a Webhooks registrados. y no necesita hacer clic de nuevo.
Qué Se Sincroniza Desde Su PMS
| Dato | Beds24 | Hostfully | Notas |
|---|---|---|---|
| Propiedades (nombre, habitaciones, baños, cantidad de huéspedes, dirección, ubicación en el mapa) | Sí | Sí | Se mantienen sincronizadas con el PMS. Estos campos no se pueden editar en Argonautas. |
| Reservas (fechas, estado, huésped) | Sí | Sí | Solo lectura en Argonautas. |
| Tarifas por noche y fechas bloqueadas | Sí | Sí | Se actualizan en cada importación y en la reconciliación nocturna. De aquí es de donde cotiza su sitio web de reservas directas. |
| Fotos y descripciones | — | Sí | Se incorporan cuando una importación crea una nueva propiedad. Las fotos se copian a Argonautas, no se enlazan. Una descripción solo llena un campo vacío y nunca sobrescribe el texto que usted haya escrito. |
| Amenidades | — | Sí | Las amenidades coincidentes se agregan a las nuevas propiedades. Las amenidades que usted haya configurado nunca se eliminan. |
| Mensajes de huéspedes y anfitriones | Sí | Sí | Una copia de solo lectura en su bandeja de entrada. Vea Mensajes Desde Su PMS. Para Beds24, esto requiere el ámbito read:bookings-personal. |
Cómo Se Etiquetan las Reservas
Cada reserva importada conserva el canal del que provino (Airbnb, Booking.com, VRBO, etc.) como su origen, para que sus informes muestren de dónde viene su negocio. Dos detalles:
- Las reservas de Airbnb que Airbnb ya ha pagado se muestran como Pagadas. Se registran como pagadas fuera de Argonautas, así que nunca muestran un saldo pendiente.
- Las reservas de VRBO que llegan a Beds24 a través de un feed iCal se etiquetan como VRBO, no como "Otras". Un feed iCal solo contiene fechas, así que estas reservas no tienen precio en Argonautas.
Cómo Se Comportan las Propiedades Importadas
Las propiedades importadas son propiedades Directas comunes. No son propiedades de socios:
- Pertenecen a su empresa. Una nueva propiedad importada se asigna a un registro de propietario con el nombre de su empresa, y sus reservas aparecen en sus informes financieros. No se crea acceso al portal de propietarios con ella.
- Se pueden reservar directamente. Su sitio web de reservas directas lee sus tarifas y disponibilidad desde Argonautas.
- Sin channel manager. Su PMS ya distribuye estas villas a las OTA, así que Argonautas nunca envía sus tarifas ni disponibilidad hacia afuera. En la pestaña Canales de la propiedad, el channel manager se reemplaza por una tarjeta de Distribución que dice Los canales son administrados por Beds24 (o Hostfully). Administre sus anuncios en las OTA desde su PMS.
- Precios de solo lectura. En la pestaña Precios, la lista de temporadas y el calendario de tarifas son de solo lectura. Configure las tarifas en su PMS. En una villa de Beds24 también puede fijar el precio por noche desde el calendario (vea Cómo Fijar un Precio de Beds24 Desde el Calendario). Las tarifas de Hostfully solo se pueden cambiar en Hostfully.
- Los campos propiedad del PMS están bloqueados. Editar un campo que el PMS controla, como el nombre, la cantidad de habitaciones o la dirección, se rechaza con "Estos campos son administrados por la importación externa del PMS y no se pueden editar aquí". Las reservas importadas también son de solo lectura. Cámbielas en su PMS.
- Sin mensajes automáticos a huéspedes. Argonautas no envía confirmaciones de reserva, mensajes de ciclo de vida ni otros correos automáticos a huéspedes para reservas importadas. Su PMS ya se encarga de esa relación.
Cómo Fijar un Precio de Beds24 Desde el Calendario
Si su código de invitación de Beds24 otorgó write:inventory, un administrador de propiedades puede fijar el precio por noche de una villa de Beds24 desde Argonautas sin abrir Beds24. Las villas de Hostfully no tienen esta opción: sus tarifas son de solo lectura en Argonautas.
- Abra Calendario, cambie a Vista Matricial y asegúrese de que se muestre la fila de tarifas (el botón Tarifas junto a la leyenda). Vea Vista matricial.
- Haga clic en la tarifa de una noche de una villa de Beds24. El diálogo Fijar precio en Beds24 se abre en esa noche.
- Ajuste Desde y Hasta (última noche) si quiere un rango, e ingrese el Nuevo precio por noche. Precio actual muestra el precio que Argonautas leyó por última vez de Beds24 para esas noches.
- Haga clic en Guardar.
Beds24 guarda un solo precio por noche, así que un rango deja todas sus noches al mismo precio, incluidos los precios de fin de semana o de eventos que haya configurado en Beds24. Cuando se afecta más de una noche, el diálogo le avisa antes: "Las {count} noches quedarán a {price} en Beds24."
Puede fijar hasta 62 noches a la vez. Las noches pasadas no se pueden cambiar, y las noches a más de aproximadamente un año se rechazan ("Demasiado adelante para confirmarlo con Beds24.").
Después de guardar, Argonautas vuelve a leer el precio de Beds24 y le indica qué pasó:
| Mensaje | Qué significa |
|---|---|
| Guardado en Beds24. | Beds24 ya tiene el nuevo precio. El diálogo se cierra. |
| Beds24 aceptó el cambio, pero reporta … para estas noches (pediste …). | Puede que una regla de precios de Beds24 lo esté reemplazando. Revise la configuración de precios en Beds24. |
| Guardado en Beds24. Aún no se pudo volver a leer; el calendario se actualiza en la próxima sincronización. | El cambio se envió, pero la relectura no. No tiene que hacer nada. |
| Beds24 no respondió a tiempo. Puede que se haya guardado; revisa el calendario. | Revise la noche de nuevo antes de volver a intentarlo. |
Si ya hay una sincronización del calendario en curso, verá "A calendar sync is running; try again in a minute." (este mensaje aparece en inglés).
Cuando la conexión no puede escribir precios, al hacer clic en la tarifa de una villa de Beds24 se muestra como solo lectura con el motivo, por ejemplo "Beds24 connection lacks rate access." si el código de invitación no incluía write:inventory. No se pueden agregar ámbitos a una conexión existente: desconecte y conecte de nuevo con un código de invitación nuevo que otorgue todos los ámbitos.
Mensajes Desde Su PMS
Los mensajes de huéspedes y anfitriones de su PMS aparecen en la Bandeja de entrada como una copia de solo lectura, verificada aproximadamente cada 15 minutos. Cada hilo se adjunta a su reserva y muestra el nombre del huésped, con el canal de la reserva (por ejemplo, Airbnb) como el canal.
Estos hilos son para contexto. Responda al huésped desde su PMS o desde la OTA. Una respuesta escrita en Argonautas no llegará al huésped.
Preguntas Frecuentes
No veo la tarjeta Sistema de gestión de propiedades. El equipo de soporte de Argonautas activa la integración para cada empresa. Comuníquese con soporte para que la activen.
Mi código de invitación de Beds24 fue rechazado. Los códigos de invitación funcionan una sola vez y vencen 24 horas después de crearlos. Genere un código nuevo en Beds24 (Settings → Marketplace → API) y pegue ese.
La tarjeta dice "A esta conexión le faltan permisos." El código de invitación de Beds24 se generó sin uno de los ámbitos listados en la tarjeta. No se pueden cambiar los ámbitos en una conexión existente. Desconecte, genere un nuevo código de invitación con todos los ámbitos marcados y conéctese de nuevo.
¿Por qué no se importan algunas reservas? Las reservas solo se importan para las unidades que están Vinculadas. Las unidades que están Pendientes de revisión o Ignoradas no se importan. Abra Revisar unidades y tome una decisión para cada una.
¿Puedo cambiar el nombre de una propiedad importada? El nombre proviene de su PMS y se actualiza en cada sincronización. Cambie el nombre de la unidad en su PMS. Si necesita un nombre para mostrar diferente en Argonautas que en su PMS, comuníquese con soporte.
¿Puedo conectar una propiedad importada a Airbnb o Booking.com desde Argonautas? No. Su PMS ya la tiene listada en las OTA, y conectarla dos veces generaría riesgo de reservas duplicadas. La pestaña Canales le indica qué PMS la administra.
¿De dónde vienen las reseñas de Airbnb para las propiedades importadas? Vea Reseñas de Huéspedes.
Relacionado
- Guía de Configuración: la sección de Integraciones donde se encuentra esta tarjeta.
- Reseñas de Huéspedes: cómo llegan las reseñas de propiedades importadas a Argonautas.
- Guía de Mensajería: la bandeja de entrada unificada donde aparecen los mensajes del PMS.
- Integración de Canales: distribución para propiedades que Argonautas administra directamente.
- Propiedades Administradas por Socios: en qué se diferencian las propiedades de socios de las importadas.