Package Information
Released: 4 mo ago
Downloads: 27 weekly / 387 monthly
Latest Version: 0.3.29
Author: Kleyver Benitez - Calma Celesti
Documentation
n8n-nodes-cloudbeds
Este paquete contiene un nodo de n8n para integrarse con la API de Cloudbeds - el sistema de gestión hotelera (PMS) líder en la industria.
Cloudbeds es una plataforma de gestión hotelera todo-en-uno que ayuda a hoteles, hostels y propiedades de alquiler a gestionar reservas, huéspedes, habitaciones y más.
Instalación
En n8n (Community Nodes)
- Ve a Settings → Community Nodes
- Selecciona Install
- Ingresa
n8n-nodes-cloudbeds - Acepta los riesgos y haz clic en Install
Manual
cd ~/.n8n/nodes
npm install n8n-nodes-cloudbeds
Reinicia n8n después de la instalación.
Credenciales
Este nodo soporta dos métodos de autenticación:
API Key
- Inicia sesión en tu cuenta de Cloudbeds
- Ve a Settings → API → API Credentials
- Genera una nueva API Key
- Copia la API Key y pégala en las credenciales de n8n
OAuth2
- Registra tu aplicación en el portal de desarrolladores de Cloudbeds
- Obtén el Client ID y Client Secret
- Configura las credenciales OAuth2 en n8n
Recursos y Operaciones
📅 Reservation (Reservas)
| Operación | Descripción |
|---|---|
| Create | Crear nueva reserva |
| Get | Obtener una reserva por ID |
| Get Many | Listar reservas con filtros |
| Update Room | Actualizar la asignación de habitación |
| Update Status | Cambiar el estado de la reserva |
👤 Guest (Huéspedes)
| Operación | Descripción |
|---|---|
| Create | Crear nuevo huésped |
| Get | Obtener huésped por ID |
| Get Many | Listar huéspedes |
| Search | Buscar huéspedes |
| Update | Actualizar huésped |
🛏️ Room (Habitaciones)
| Operación | Descripción |
|---|---|
| Block Room | Bloquear una habitación en un rango de fechas |
| Get Available | Obtener tipos de habitación disponibles |
| Get Many | Listar habitaciones |
| Get Room Types | Obtener tipos de habitación |
| Get Unassigned | Obtener habitaciones no asignadas |
| Unblock Room | Desbloquear una habitación |
🏨 Property (Propiedad)
| Operación | Descripción |
|---|---|
| Get System Info | Obtener versiones de componentes del sistema |
🧹 Housekeeping (Limpieza)
| Operación | Descripción |
|---|---|
| Get Status | Ver estado de limpieza |
| Get Assignments | Ver asignaciones |
| Update Room Condition | Actualizar condición de la habitación |
➕ Addon (Extras)
| Operación | Descripción |
|---|---|
| Get Many | Listar addons |
| Add to Reservation | Agregar a reserva |
📦 Item (Inventario)
| Operación | Descripción |
|---|---|
| Add to Reservation | Agregar item a una reserva |
| Get | Obtener item por ID |
| Get Categories | Obtener categorías de items |
| Get Many | Listar artículos |
📅 Event (Eventos)
| Operación | Descripción |
|---|---|
| Create | Crear evento |
| Delete | Eliminar evento |
| Get | Obtener evento por ID |
| Get Many | Listar eventos |
| Update | Actualizar evento |
🔐 Door Lock (Cerraduras)
| Operación | Descripción |
|---|---|
| Create Key | Crear llave digital |
| Delete Key | Eliminar llave |
| Delete Keys (Batch) | Eliminar múltiples llaves |
| Delete Settings | Eliminar configuración |
| Get Keys | Listar llaves |
| Get Settings | Obtener configuración |
| Update Key | Actualizar llave |
| Upsert Settings | Crear/actualizar config |
📊 Market Segmentation
| Operación | Descripción |
|---|---|
| Create Group / Segment | Crear grupos y segmentos |
| Get Group / Groups | Consultar grupos |
| Get Segment / Segments | Consultar segmentos |
| Get Segment Reservations | Obtener reservas ligadas a un segmento |
| Update Group / Segment | Actualizar grupos y segmentos |
| Delete Group / Segment | Eliminar grupos y segmentos |
| Enable / Disable Group / Segment | Activar o desactivar grupos y segmentos |
| Set Default Segment | Marcar un segmento por defecto |
🔗 Integration Event
| Operación | Descripción |
|---|---|
| Create | Crear evento de integración |
| Get Many | Listar eventos de integración |
| Retry | Reintentar evento fallido |
| Update | Actualizar evento de integración |
💳 Payment
| Operación | Descripción |
|---|---|
| Create Pay By Link | Generar link de pago para una reserva |
| Get Pay By Link | Consultar un link de pago existente |
🪝 Webhook
| Operación | Descripción |
|---|---|
| Create | Crear suscripciones de webhook en Cloudbeds |
| Get Many | Listar suscripciones existentes |
| Delete | Eliminar una suscripción por ID |
El recurso Webhook permite seleccionar varios eventos en una sola ejecución. El nodo crea una suscripción independiente por cada evento seleccionado.
Ejemplo de Uso
Obtener reservas del día
- Agrega el nodo Cloudbeds
- Selecciona recurso: Reservation
- Selecciona operación: Get Many
- Configura filtros de fecha
Automatizar check-in
Webhook → Cloudbeds (Get Reservation) → Cloudbeds (Assign Room) → Email
Registrar webhooks de Cloudbeds
- Agrega el nodo Cloudbeds
- Selecciona recurso: Webhook
- Selecciona operación: Create
- Elige uno o varios eventos
- Ingresa la URL de tu endpoint de n8n
Compatibilidad
- n8n versión: 1.0.0 o superior
- API de Cloudbeds: v1.3
Documentación
Autor
Kleyver Benitez - Calma Celesti
🌙 Calma Celesti - Automatización Hotelera Inteligente
- 🌐 Web: calmacelesti.mx
- 📧 Email: direccion@calmacelesti.mx
- 💻 GitHub: @KleyverBenitez-AutomatizaiconIsep
Licencia
Contribuir
Las contribuciones son bienvenidas. Por favor, abre un issue o pull request en el repositorio de GitHub.
¿Problemas o sugerencias? Abre un issue en GitHub