Índice
Preguntas Frecuentes
Response: Plugin not found api"
Response: Plugin not found api"
INTRODUCCIÓN
¿Quieres que los turoperadores puedan consultar tu disponibilidad y realizar reservas sin necesidad de emails? ¿Quieres que un software externo conecte con tu Golfmanager?
Golfmanager está conectado a las agencias y softwares más importantes del sector, consulta aquí el listado completo, y que te pueden ayudar y traer mucho negocio al club.
Las "APIs Consumer" de Golfmanager les permite a OTAs y turoperadores:
Mirar disponibilidad de tu plano horario
Obtener su tarifa para ese día y hora de manera automática
Reservar y pagar
Cancelar si fuese necesario y siempre que estén dentro del periodo de cancelación permitido por el club.
Las "APIs Admin" de Golfmanager les permite a softwares de terceros consultar, editar, crear registros en el Golfmanager del club como:
Mirar ocupación y editar precios de green fees (ej. Priswing)
Importar las facturas emitidas para contabilidad (ej. Navision)
Consultar datos generales para mandar campañas de marketing (ej. inOne)
Y cualquier otro servicio que necesites automatizar a través de un software externo.
¿Qué es una API y diferencias entre una conexión tipo "consumer" o tipo "admin"?
La documentación API es una serie de códigos que permiten a dos softwares hablar entre si de manera automática y mantenerlos sincronizados o conectados mediante tecnología sin manipulación humana. Con estas APIs podrás conectar tu Golfmanager a agencias de viaje, programas de marketing o de contabilidad, por ejemplo.
Hay 2 tipos de conexiones API:
API Consumer. Estas APIs están destinadas para hacer reservas online únicamente (OTAs, TO, etc.). La agencia, en vez de entrar en tu web y reservar para sus clientes, lo hacen desde su propio programa y interactúan con Golfmanager como si se metiera en la página web del club, pero sin hacerlo.
API Admin. Estas APIs te permiten gestionar la configuración completa de tu Golfmanager como si de un empleado del club se tratara, sólo que en vez de entrar a través de un navegador, se hace digitalmente a través del software del tercero (Priswing, inOne, SAGE, etc.).
¿Qué diferencia hay entre una OTA y un turoperador tradicional?
Un turoperador tradicional es la típica agencia de toda la vida, más o menos moderna, al que el jugador acude con la intención de organizar sus vacaciones. Además de gestionar el avión y el hotel, el turoperador se pone en contacto con el club para confirmar precios y disponibilidades. Tradicionalmente este contacto entre agencia y campo era via email o fax, pero Golfmanager te ofrece la posibilidad de que estos turoperadores entren en tu web, se identifiquen, y consulten por ellos mismos la disponibilidad y precios sin molestar via email o teléfono. ¡Gracias a Golfmanager podrás ahorrar mucho tiempo atendiendo a todas estas agencias! Por lo tanto, un turoperador tradicional es una agencia que te manda jugadores de "manera manual", sin tecnología de por medio.
Una OTA es un tipo de agencia que vende green fees a través de un portal o una app. El jugador que quiere reservar un green fee, y lo hace a través de una OTA, nunca va a visitar la página web del club o mandar un email. Este va a ir a la web o APP de la OTA y va a reservar desde allí mismo. Esa web o APP le proporcionará una experiencia de reserva al jugador muy buena, consultando la disponibilidad a tiempo real y confirmando su reserva. Ejemplos de OTA en golf sería: GF365, Leadingcourses, OnTee, Golfee, Golfspain, etc. Ejemplos de OTA en otros sectores serían: El Tenedor, Booking, etc. Por lo tanto, una OTA es una agencia que posee tecnología para automatizar el proceso de reserva de su cliente.
Documentación técnica sobre la Api
Bienvenidos a la documentación técnica de la API de Golf Manager. En este artículo recopilaremos toda la información requerida para trabajar con los servicios de Golf Manager.
Para consultar la documentación técnica de la API, puedes visitar el siguiente enlace: https://github.com/golfmanager/api_v1
Dicho enlace te proveerá de todos los detalles técnicos y adicionales que necesitas para trabajar con nuestra API.
Si necesitas trabajar con nosotros anexamos la información de contacto para una segunda persona que pueda asignar tareas y proyectos, aunque por recomendación siempre será mejor contactar con Daniel Sillari, el encargado directo. El email de contacto es: dsillari@golfmanager.com
Esperamos que encuentres útil la información proporcionada y que sepas darle el mejor uso a todos el material técnico entregado.
Configuración en el sistema por parte del club
Pasos para conectar una OTA vía API:
Hay que descargar el plugin especial llamado API V1 desde la App Center del sistema. Para más información, dirígete a este link.
Tienes que crear una ficha de cliente de esta OTA en la base de datos de tu listado de cliente en tu Golfmanager,
Sección: Menú Principal > Clientes
Selecciona el botón Nuevo
NOTA. Es buena práctica siempre antes de crear una ficha nueva, buscar si ese cliente ya existe.
En la ficha del cliente > Sección Perfil > activar la opción Es API
NOTA. Esta es una manera de decir a Golfmanager que quieres permitir a esta OTA conectarse vía API
Opcionalmente puedes activar la opción A crédito
NOTA. Esto le permite a la OTA reservar sin necesidad de pagar en ese momento. Al final de mes, podrás hacer una factura a la OTA con todas sus reservas pendientes de pago. En caso de que se quiera tener una Configuración de Reserva con prepago a 100%, no tiene sentido, ya que las apis siempre van a reservar sin pagar, por lo que:
hay que activar el campo de a crédito en la ficha del cliente o añadir un prepago a 0 en la Configuración de Reservas
y enviar un link de pago
Opcionalmente puedes añadir un Alias en la ficha de ese cliente
NOTA. Es una buena práctica porque verás claramente en el plano de reservas qué reservas han venido a través de esta OTA
Probablemente tengas que añadir una Etiqueta a esta ficha de cliente, la misma etiqueta que haya en el Tipo de Reserva que deseas que visualice para reservar. Como ya sabrás, la etiqueta es imprescindible para mostrar el precio correcto a esa agencia. El funcionamiento del precio con una agencia se suele hacer de dos formas:
Vacío. Si no añades ninguna etiqueta a la ficha de esta OTA, se les mostrará los mismos precios que vería un visitante que entra en tu web. Ellos venderán en su APP al mismo precio que en tu web. Al final de mes te pasarán una factura con su comisión.
Con una etiqueta que signifique un descuento. En este caso la OTA va a recibir el precio de agencia y es importante que ellos añadan su margen acordado en su APP para que se venda al mismo precio que en la web del club. Si lo configuras para que la OTA reciba su precio de agencia, al final de mes le pasarás tú una factura a ellos con las reservas que te tienen que pagar a su respectivo precio.
Una vez que ya tengas la ficha del cliente configurada, es el club el que tiene que comunicar al equipo de soporte técnico de Golfmanager, que desea conectarse a esta OTA. Nos vale un simple email o chat en la burbuja de soporte, adjuntando el formulario relleno y firmado por ambas partes. Para más información, dirígete a este link.
NOTA:
El TO Leadingcourses y GolfSpain Tours obligatoriamente necesitan que el club añada a sus Tipos de Reserva online > en la sección Otros > en el campo Tags API, los siguientes nombres dependiendo del Tipo de Reserva:
18holes
9holes
tee1
tee10
buggy
Quedando así como en el ejemplo que sigue:
18holes tee1 buggy
18holes tee10
9holes tee1
9holes tee10 buggy
Pricing por parte de la OTA
Puesto que las OTAs suelen mostrar el mismo precio en su web que en la del club, y el jugador paga lo mismo en un sitio que en otro, hay 2 opciones:
Cada vez que una OTA haga una reserva:
el club le cobra la tarifa completa que ha pagado el jugador a la OTA.
la OTA te pasa una factura por ese total y ellos añaden el concepto de - 15% de comisión (o lo acordado).
Cada vez que una OTA haga una reserva:
el club le cobra la tarifa - 15% (o lo acordado) de lo pagado a la OTA.
la OTA te pasa una factura con la misma cantidad que aparece en GM pues estas ya vienen sin el 15% de comisión.
Formulario de autorización
Para que un TTOO o empresa pueda conectarse a través de una API, previamente tendrá que enviar el documento cumplimentado y firmado por ambas partes a Golfmanager. Selecciona en el Documento siguiente para descargarlo:
Comprobar la disponibilidad de una OTA
Una vez realizado los pasos previos de configuración de OTA, si deseas comprobar la disponibilidad online de dicha OTA online, tienes varias opciones:
Desde el Menú Principal > listado de Clientes:
Selecciona en el ID del cliente de la OTA correspondiente
En su ficha de cliente, desactiva la pestaña Es Api
Selecciona en el botón de Guardar
Ahora dirígete a la web de reservas de consumer (también puedes sustituir “/admin” por “/consumer” en la URL de tu navegador) e inicia sesión con el usuario de esa OTA
Comprueba que está bien configurado y que muestra los Tipos de Reserva correctamente
IMPORTANTE. Una vez comprobado que está bien, dirígete a la ficha de cliente y vuelve a activar la opción Es API.
Realizar un Depurador para obtener más información.
Realizar una prueba en la web de reservas de consumer con un cliente-test que tengas creado en tu base de datos de clientes y con la misma configuración que tiene esa OTA en su ficha de cliente. Excepto el campo Es Api, ese campo tiene que estar desactivado en tu cliente-test.
TTOO y Agencias conectadas a Golfmanager
On Tee. Henrik Andersson, henrik.andersson@ontee.com.
Leadingcourses. Joep Oude Egbrink, j.oudeegbrink@leadingcourses.com.
Golfscape. Sara Engsig, sara@ golfscape.com.
Green Fee 365. Philip Ekeberg, philip.ekeberg@greenfee365.com,
Marcus Ekeberg, marcus.ekeberg@greenfee365.com.Ocean Side Golf (República Dominicana). Patrick Hafner, phafner@gt4b.com.
Tee Times Golf Agency (Portugal - Spain). Jorge Padinha, reception@teetimes.pt.
Your Golf Travel. Neil Crossland, reservations@yourgolftravel.com.
Golf Breaks. Adam Shan, customerservice@golfbreaks.com.
PAGS (Portugal). Phil Moran, phil.moran@pagsgolf.com.
Playinone. Miguel Girbes, miguelgirbes@playinone.golf.
GolfSpain Tours. Esperanza Navarro, espenavarro@golfspain.com.
Mundo Golf Travel / Go Golf Travel. Elen Ober, elenober@mundogolftravel.com.
Golfee / Golf to me. Victor Zorita, victor@golfeeapp.com.
Andalucía Golf Hub. Nacho, soporte@rfga.org.
Golf On Costa del Sol / Corner Nineteen. John Walker, john.walker@golfoncostadelsol.com.
Golf in Spain (próximamente). Jose Luis Moya, joseluis@alsur.es.
URL de acceso a Apis
Demo APP: https://mt.golfmanager.app
Europa AWS: https://mt-aws-europa.golfmanager.com
Asia AWS: https://mt-aws-asia.golfmanager.com
America AWS: https://mt-aws-america.golfmanager.com
Marriott AWS: https://mt-aws-marriott.golfmanager.com
Golf Santander AWS: https://mt-aws-santander.golfmanager.com (la api tienen que darnos una IP fija y se la pasamos al departamento de Sistemas)
Ayuda técnica para la conexión
Si eres un integrador que comienza a usar las APIs, te pasamos los conocimientos básicos para que puedas comenzar:
1. Solicita credenciales test al equipo de Golfmanager.
2. Accede a la documentación API.
Si tienes problemas con la conexión, prueba lo siguiente usando Postman. Crea una cuenta y sigue los pasos:
3. Copia y pega este texto en la función GET https://mt.golfmanager.es/api/tenants.
Podrías usar más funciones detalladas en la documentación API del punto 2.
NOTA. La terminación de .es podrá cambiar según el servidor al que se haya pedido acceso. Existe .es y .app para pruebas, y .com para producción. Es importante sepas en qué servidor se ha dado acceso. Tienes todos los accesos en los links de la sección anterior.
4. Rellena los datos de acceso con aquellos facilitados por Golfmanager.
5. Haz clic en "Send"...
Si obtienes una respuesta abajo significa que todo empieza a funcionar correctamente.
Facturar OTA a fin de mes cuando cobra la OTA precio Rack y el club factura
Tienes que crear un producto de Comisión que valga XX€.
A final de mes, cuando sepas el total de las ventas de esa OTA, creas la comisión de -XX% con ese producto Comisión desde el TPV. (En el TPV añades -1 unidad con el botón del teclado del TPV y el precio se modificará en negativo automáticamente).
Genera la factura del mes, con el total de las reservas del mes, más la línea creada en el TPV en negativo de la Comisión, y esa será la diferencia que la OTA tiene que pagar al club.
Mensaje error en la api: "La línea '(Descripción de la línea de venta), Nombre del club Nombre del club’ no es a crédito ni precio cero"
Para más información, dirígete a este link.
Mensaje error en la api: "[RealizarReserva] Error al realizar la reserva. Código 2: The remote server returned an error: (500) Internal Server Error."
Para más información, dirígete a este link.
Mensaje error en la api: "Request: resources?tenant=xxxxxxxx&offset=0
Response: Plugin not found api"
Para más información, dirígete a este link.
Mensaje error en la api: "Request: availabilityTypes?tenant=xxxxxxxx
Response: Plugin not found api"
Para más información, dirígete a este link.