Integración PMS

La disponibilidad de Apaleo en el evento que presupuestas

Llega una solicitud de seminario con alojamiento. Las habitaciones libres durante toda la estancia, y sus precios, aparecen en la ficha del evento. Joinways lee Apaleo sin escribir nada en él, y Apaleo sigue siendo la referencia.

Logotipo de Apaleo
Joinways

Leer, nunca escribir

Ninguna reserva, ningún bloqueo, ningún cambio de tarifa en Apaleo. Joinways consulta y muestra; el inventario solo cambia en Apaleo.

Una aplicación que solo lee

Creas en Apaleo una aplicación Joinways limitada a tres permisos de lectura. El client ID y el secreto se guardan cifrados y no se vuelven a mostrar.

Nada copiado en nuestro lado

La disponibilidad se lee para las fechas del evento en el momento del clic y se muestra. No guardamos ninguna copia de tu inventario.

Qué muestra la conexión con Apaleo

Una solicitud de seminario residencial tiene dos partes, las salas y las camas, y la conexión trae a la ficha del evento la que guarda Apaleo.

Habitaciones vendibles durante toda la estancia

Cada categoría de habitación, con las habitaciones libres cada noche y el número que puede venderse para toda la estancia, sin contar el margen de sobreventa. Todo en el bloque Alojamiento del evento.

Precios de un plan tarifario de Apaleo

Precio por noche y total de la estancia leídos del plan tarifario elegido en los ajustes, para un adulto, impuestos incluidos, en la divisa del establecimiento.

El establecimiento correcto, el espacio correcto

Si tu cuenta de Apaleo agrupa varios establecimientos, Joinways te pregunta cuál conectar. La conexión cubre todo el espacio de trabajo o un solo espacio de Joinways.

De un vistazo

Categoría
Software hotelero (PMS)
Disponibilidad
Disponible
Configuración
Unos minutos, aplicación de Apaleo incluida
Quién puede conectarla
El propietario o un administrador del espacio. Luego cada miembro ve la disponibilidad
Qué circula
En un sentido: Joinways lee Apaleo y no escribe nada
Actualizaciones
Bajo demanda: se lee en directo al pulsar Ver disponibilidad
Necesario en la herramienta
Una cuenta de Apaleo con permisos de administración para crear una aplicación personalizada
Desarrollada por
Joinways (integración nativa)

Antes de empezar

  • Eres propietario o administrador del espacio de Joinways. Los demás roles no pueden conectar Apaleo.
  • En Apaleo, tienes permisos para crear una aplicación personalizada con los scopes availability.read, setup.read y offers.read.
  • El establecimiento de Apaleo tiene una zona horaria configurada y al menos una categoría de habitación. Joinways comprueba ambas antes de guardar.
  • Para mostrar precios, el establecimiento tiene un plan tarifario que quieres usar en tus presupuestos. Sin plan elegido, solo se muestra la disponibilidad.

Qué lee la conexión con Apaleo

  • Las categorías de habitación, con nombre y capacidad
  • Las habitaciones libres cada noche de la estancia
  • Las habitaciones vendibles durante toda la estancia, categoría por categoría, sin el margen de sobreventa
  • Los precios por noche y el total de la estancia, del plan tarifario elegido, para un adulto
  • La zona horaria y la divisa del establecimiento
  • Nada en sentido contrario: solo lectura por diseño

Seguridad y acceso

  • El client ID y el secreto se verifican con Apaleo, se cifran antes de guardarse y no se vuelven a mostrar.
  • Solo el propietario y los administradores del espacio pueden conectar Apaleo, cambiar el plan tarifario usado para los precios o desconectarlo.
  • Cada miembro puede consultar la disponibilidad en los eventos de su espacio, sin ver nunca las credenciales.
  • Joinways solo pide tres permisos de lectura: availability.read, setup.read y offers.read.
  • Si a la aplicación de Apaleo le falta un permiso, Joinways lo avisa al conectar y recuerda los tres que hay que marcar.

Lo que no hace

  • No crea reservas, bloqueos ni cambios de tarifa o inventario en Apaleo.
  • No se actualiza sola: la disponibilidad se lee al pulsar Ver disponibilidad o Actualizar. Cada consulta cubre una estancia de 90 noches como máximo.
  • Los precios vienen de un solo plan tarifario a la vez, para un adulto.
  • La pantalla de ajustes gestiona una sola conexión de Apaleo a la vez.
  • Si Mews y Apaleo están conectados a la vez, la ficha del evento muestra Mews.

Cómo conectar Apaleo a Joinways

La conexión usa una aplicación personalizada que creas en Apaleo. La configuración está reservada al propietario y a los administradores del espacio de trabajo.

  1. 1

    Crea la aplicación en Apaleo

    En Apaleo, abre Apps, Connected apps, Add a new app y luego Add custom app. Llámala Joinways, marca los scopes availability.read, setup.read y offers.read, y copia el client ID y el secreto.

  2. 2

    Pégalos en Joinways

    Como propietario o administrador, ve a Ajustes, Integraciones, PMS y luego Apaleo, y pega el client ID y el secreto. Se verifican con Apaleo, se guardan cifrados y no se vuelven a mostrar.

  3. 3

    Elige el establecimiento y, si hace falta, un espacio

    Si la cuenta de Apaleo tiene varios establecimientos, Joinways te pregunta cuál conectar. También puedes limitar la conexión a un espacio de tu cuenta.

  4. 4

    Revisa el plan tarifario

    Abre los ajustes de Apaleo y revisa el plan tarifario del que salen los precios, por ejemplo BAR. El plan público base del hotel viene preseleccionado cuando existe; cámbialo si vendes a grupos con otro plan.

Tres situaciones en las que sirve

El seminario residencial respondido en una pantalla

Treinta personas, dos noches en marzo. El bloque Alojamiento indica cuántas habitaciones quedan libres ambas noches y por qué total, mientras se presupuesta la sala.

La marca de apartamentos con tres establecimientos

La solicitud llega al espacio de Berlín. La conexión está limitada a ese espacio y lee el establecimiento de Berlín; nadie presupuesta por error el inventario de Hamburgo.

La tarifa de grupo, sin errores

En los ajustes de Apaleo, elige el plan tarifario con el que vendes a grupos. Cada categoría de habitación muestra entonces su precio por noche y el total de la estancia, impuestos incluidos, junto a la disponibilidad.

Por qué conectar Apaleo con tu software de eventos

Apaleo se presenta como una plataforma abierta: una API central para tarifas, reservas, inventario y contabilidad, y una tienda de aplicaciones conectadas. Es, por diseño, un PMS que espera que otras herramientas lo lean.

Joinways es una de esas herramientas para la parte de eventos. Cuando llega una solicitud de seminario de dos días con treinta habitaciones, quien responde necesita el estado de las habitaciones en ese instante, no una captura de pantalla de recepción. Un clic en Ver disponibilidad lo lee en Apaleo y lo muestra en el bloque Alojamiento de la ficha del evento. Apaleo conserva el inventario; Joinways conserva la solicitud.

¿Y sin la integración de Apaleo?

La respuesta sobre habitaciones sale de Apaleo directamente, la consulta alguien con acceso y se copia en el mensaje. Funciona; es más lento y la cifra caduca antes de que el cliente la lea.

Todo lo demás en Joinways funciona sea cual sea tu PMS: solicitudes, presupuestos, contratos, órdenes de servicio, calendario de salas.

Integración con Apaleo: preguntas frecuentes

¿Joinways crea reservas o bloqueos en Apaleo?

No. La conexión es de solo lectura. Disponibilidad y precios se leen y se muestran; ninguna reserva, bloqueo, tarifa ni inventario se crea o modifica en Apaleo.

¿Se puede conectar Apaleo hoy?

Sí. El propietario o un administrador del espacio de trabajo va a Ajustes, Integraciones, PMS y luego Apaleo, y pega el client ID y el secreto de una aplicación creada en Apaleo. Lleva unos minutos.

Tenemos varios establecimientos en Apaleo

Joinways te pregunta cuál conectar. La conexión puede limitarse a un espacio de Joinways, para que sus eventos lean el establecimiento donde se celebran. La pantalla de ajustes gestiona una conexión de Apaleo a la vez.

¿Qué datos de Apaleo se leen?

Las categorías de habitación (los grupos de unidades de tipo habitación en Apaleo) con nombre y capacidad, la disponibilidad por noche, los precios del plan tarifario elegido, y la zona horaria y la divisa del establecimiento para que noches e importes cuadren.

¿Cómo se autoriza la conexión?

Con una aplicación personalizada creada en Apaleo: Apps, Connected apps, Add a new app y luego Add custom app. Llámala Joinways, marca los scopes availability.read, setup.read y offers.read, y copia el client ID y el secreto. Si falta un permiso, Joinways lo avisa al conectar y recuerda los tres que hay que marcar.

¿Se copia nuestro inventario en Joinways?

No. La disponibilidad se lee para las fechas del evento al pulsar Ver disponibilidad y se muestra. Nada se guarda en nuestra base de datos.

¿Y Cloudbeds?

Cloudbeds tiene su propia página y su propia conexión, en preparación, con el mismo alcance de solo lectura sobre el bloque Alojamiento.

¿Cómo guarda Joinways nuestras credenciales de Apaleo?

El client ID y el secreto se verifican con Apaleo y se guardan cifrados. No se vuelven a mostrar. Los demás miembros del espacio ven la disponibilidad en los eventos sin ver nunca las credenciales.