n8n-nodes-golfmanager

Este paquete contiene nodos para n8n que permiten la integración con la API de GolfManager.

Desarrollado por: Carlos Presa CTO Dialia
Fecha: 30 de mayo de 2024

Descripción

Este paquete provee nodos personalizados para n8n que facilitan la integración con la API V3 de GolfManager, permitiendo automatizar operaciones como:

• Gestión de campos de golf
• Reservas de green fees
• Gestión de clientes
• Ventas y facturación
• Gestión de membresías
• Torneos
• Clases y profesores
• Y más...

Instalación

Para usar estos nodos en tu instalación de n8n, puedes seguir estos pasos:

1. Navega a tu directorio de instalación de n8n
2. Ejecuta npm install n8n-nodes-golfmanager
3. Reinicia n8n

Configuración

Para utilizar los nodos de GolfManager, necesitarás:

1. Una API Key de GolfManager
2. Un identificador de tenant
3. La URL base de la API (por defecto: https://eu.golfmanager.app/api)

Puedes obtener estos datos contactando con el soporte de GolfManager.

Uso

El nodo principal GolfManager by Dialia te permite realizar operaciones sobre diferentes recursos:

Recursos Disponibles

• Reservas (Booking): Gestión de reservas de green fees y otros recursos
• Facturación (Billing): Gestión de ventas y pagos
• Tenant: Información del tenant y configuración
• Recursos (Resource): Gestión de recursos disponibles para reservas
• Clientes (Customer): Gestión de clientes/miembros
• Áreas (Area): Gestión de áreas (Golf, Padel, etc.)
• Bloqueos (Booking Blocking): Gestión de bloqueos de reservas

Funcionalidades por Recurso

Reservas (Bookings)

• Cancelar Grupo de Reservas: Cancelar una o varias reservas con opciones de notificación
• Guardar Grupo de Reservas: Crear un grupo de reservas nuevas o actualizar existentes
• Buscar Disponibilidad: Buscar horarios disponibles para reservas en un área específica

Facturación (Billing)

• Cancelar Venta: Cancelar una o varias ventas
• Crear Enlace de Pago: Generar URLs de pago para ventas pendientes
• Crear/Actualizar Venta: Crear nuevas ventas o actualizar existentes
• Pagar Ventas: Registrar pagos para una o varias ventas

Tenant

• Obtener Información: Obtener detalles del tenant actual
• Listar Todos: Obtener lista de todos los tenants disponibles

Recursos (Resources)

• Obtener Recursos de Reserva: Listar todos los recursos disponibles para reservas
• Obtener Recurso por ID: Obtener detalles de un recurso específico
• Obtener Tipos de Recurso: Listar los tipos de recursos disponibles

Clientes (Customers)

• Obtener Todos: Listar todos los clientes con opciones de filtrado
• Obtener por ID: Obtener detalles de un cliente específico
• Crear: Crear un nuevo cliente en el sistema

Áreas (Areas)

• Obtener Todas: Listar todas las áreas disponibles
• Obtener por ID: Obtener detalles de un área específica

Bloqueos (Booking Blocking)

• Obtener Todos: Listar todos los bloqueos de reservas
• Obtener por ID: Obtener detalles de un bloqueo específico
• Crear: Crear un nuevo bloqueo de reservas para un recurso específico

Pruebas

El directorio /scripts contiene herramientas para probar la integración con la API de GolfManager:

• test-auth.js: Verifica que las credenciales funcionan y permite probar los endpoints
• test-blockings.sh: Prueba específica para los endpoints de bloqueos
• test-resources.sh: Prueba específica para los endpoints de recursos
• test-customers.sh: Prueba específica para los endpoints de clientes

Para más información, consulta el README del directorio de scripts.

Licencia

Este proyecto está licenciado bajo los términos de la licencia MIT.

Soporte

Si tienes alguna pregunta o necesitas ayuda con la integración, puedes contactar a:

• Carlos Presa, CTO Dialia