Ir para conteúdo principal
Todas as coleçõesManual do utilizadorOutros
Integração API com uma OTA (Online Travel Agency) ou Operadores Turísticos (TO)
Integração API com uma OTA (Online Travel Agency) ou Operadores Turísticos (TO)

Como permitir que uma agência se ligue automaticamente à tee sheet via API.

Atualizado há mais de 6 meses

Índice

Perguntas Frequentes

Introdução

Quer que os operadores turísticos possam verificar a disponibilidade do campo e fazer reservas sem a necessidade de e-mails? Quer que um software externo se ligue ao Golfmanager?

Golfmanager está ligado às agências e softwares mais importantes do sector (consulte a lista completa) o que pode ajudar a trazer mais negócios para o clube.

As "APIs Consumer " do Golfmanager permitem OTAs e Operadores Turísticos:

  • Verificar a disponibilidade do campo

  • Obter automaticamente a sua tarifa para esse dia e hora

  • Reservar e pagar

  • Cancelar se necessário e desde que estejam dentro do período de cancelamento permitido pelo clube.

As "APIs Admin" do Golfmanager permitem a softwares de terceiros consultar, editar e criar registos no Golfmanager do clube, tais como:

  • Ver preços de ocupação e editar preços de green fees (por exemplo, Priswing).

  • Importação de faturas emitidas para contabilidade (por exemplo, Navision)

  • Consultar dados gerais para enviar campanhas de marketing (por exemplo, inOne)

  • E qualquer outro serviço que necessite de automatizar através de software externo.

O que é uma API?

A documentação API é um conjunto de códigos que permitem que dois softwares falem um com o outro automaticamente e se mantenham em sincronia ou ligados pela tecnologia sem manipulação humana. Com estas APIs, pode ligar o seu Golfmanager a agências de viagens, softwares de marketing ou de contabilidade, por exemplo.

Existem 2 tipos de API:

  • API Consumer. Estas APIs destinam-se apenas a reservas online (OTAs, TO, etc.). A agência, em vez de entrar no seu website e reservar para os seus clientes, fá-lo a partir do seu próprio programa e interage com o Golfmanager como se entrassem no website do clube, mas sem o fazer.

  • API Admin. Estas APIs permitem-lhe gerir a configuração completa do seu Golfmanager como se fosse um colaborador do clube, mas em vez de entrar através de um browser, é feito digitalmente através do software de terceiros (Priswing, inOne, SAGE, etc.).

Qual é a diferença entre uma OTA e um operador turístico tradicional?

Um operador turístico tradicional é a agência típica, mais ou menos moderna, a que o jogador vai com a intenção de organizar as suas férias. Para além de organizar o voo e o hotel, o operador turístico contacta o clube para confirmar os preços e a disponibilidade. Tradicionalmente este contacto entre a agência e o campo era feito via e-mail ou fax, mas o Golfmanager oferece-lhe a possibilidade destes operadores turísticos entrarem no seu website, identificarem-se e verificarem eles próprios a disponibilidade e os preços sem o incomodar via e-mail ou telefone. Graças ao Golfmanager pode poupar muito tempo a lidar com todas estas agências! Portanto, um operador turístico tradicional é uma agência que lhe envia jogadores "manualmente", sem qualquer tecnologia.

Uma OTA é um tipo de agência que vende green fees através de um portal ou de uma aplicação. O jogador que quiser reservar um green fee, fá-lo através de uma OTA, nunca visitará o website do clube ou enviará um e-mail. Ele irá ao website da OTA ou APP e fará a sua reserva a partir daí. Esse website ou APP proporcionará uma experiência de reserva muito boa ao jogador, verificando a disponibilidade em tempo real e confirmando a sua reserva. Exemplos de OTA no golfe seriam: GF365, Leadingcourses, OnTee, Golfee, Golfspain, etc. Exemplos de OTA em outros sectores seriam: El Tenedor, Booking, etc. Portanto, uma OTA é uma agência que tem a tecnologia para automatizar o processo de reserva para o seu cliente.

Documentação técnica sobre a API

Bem-vindo à documentação técnica da API do Golf Manager. Neste artigo vamos compilar toda a informação necessária para trabalhar com os serviços do Golf Manager.

A documentação técnica da API pode-se encontrar no seguinte link: https://github.com/golfmanager/api_v1

Nesta ligação encontram-se todos os detalhes técnicos necessários para trabalhar com a nossa API.

Se pretender trabalhar conosco por favor contacte: Daniel Sillari -dsillari@golfmanager.com

Configuração do sistema - a realizar pelo clube

Passos para ligar uma OTA via API:

  1. A partir de Configurações > Configuração Geral > App Center descarregar o plugin chamado API V1. Para mais informações consulte o seguinte link.

    Se não tiver permissões para instalar o plugin por favor contacte o suporte.

  2. A partir do Menu Principal > Clientes deve ser criada uma ficha de cliente para a OTA.

    NOTA: recomendamos que antes de criar a nova ficha de cliente se verifique se o cliente já existe na base de dados.

  3. A partir do Menu Principal > Clientes > Secção Perfil ativar a opção É API

    NOTA: Esta é a maneira de dizer ao Golfmanager que o campo permite a ligação a esta OTA

  4. Ativar a opção A crédito ou adicionar uma Configuração de Reserva.

    Mesmo que não se ative a opção a crédito ou que se aplique uma configuração de reserva de pagamento a 100% a reserva é feita sem ser paga, porque as apis reservam sempre sem pagar.

  5. Opcionalmente, pode adicionar-se um Alias na ficha do cliente.

    NOTA: as reservas ficam assinaladas na tee sheet e permite que se veja mais rapidamente quais as reservas que vêm dessa OTA.

  6. Na ficha de cliente da OTA deve ser adicionada uma Etiqueta, esta etiqueta deve ser a mesma que está no tipo de reserva a que a agência tem acesso.

  7. Depois da ficha de cliente estar criada e configurada, o clube deve informar o suporte Golfmanager que pretende ligar-se a essa agência, também deve enviar o formulário assinado por ambos os proponentes.

  8. A partir de Configurações > Reservas > Tipos de Reserva > Nome

    NOTA: A Leadingcourses faz as reservas através do nome do tipo de reserva.

  9. A partir de Configurações > Reservas > Tipos de Reserva > Secção Outros > Etiquetas API

    A Leadingcourses, Zest e GolfSpain Tours necessitam que se adicionem as etiquetas API aos tipos de reservas que estão online e acessíveis a estes TO:

    • 18holes

    • 9holes

    • tee1

    • tee10

    • buggy

    Ficando como no exemplo abaixo:

    • 18holes tee1 buggy

    • 18holes tee10

    • 9holes tee1

    • 9holes tee10 buggy

Leadingcourses

As disponibilidades fornecidas através do sistema Golfmanager são carregadas automaticamente no seu motor de reservas. O seu motor de reservas utiliza tags API para identificar os produtos à venda, como 18 buracos, 9 buracos ou buggies. No entanto, eles notaram duas coisas:

  1. Que os clubes por vezes se esquecem de adicionar as etiquetas API ou API Tags.

  2. Que os clubes oferecem mais tipos de reserva do que os que vendem atualmente.

O que modificaram?

Para melhorar a identificação da disponibilidade e, em última análise, vender mais green fees, o seu motor de reservas terá agora em conta tanto as etiquetas API como o nome do tipo de reserva. Se no nome aparecerem termos como almoço, jantar, trolley, twilight, early bird, júnior ou sénior, o seu sistema irá reconhecê-los e oferecê-los. É importante continuar a mencionar 18 buracos ou 9 buracos nas etiquetas API ou no nome do tipo de reserva, para que o cliente saiba quantos buracos estão disponíveis.

Abaixo está um exemplo de disponibilidade de reserva que eles recebem através da API. Na implementação atual do seu sistema, este objeto de disponibilidade não seria vendido porque não existem etiquetas API disponíveis. No entanto, na nova abordagem, o seu sistema identificará este produto como tal devido aos nomes 18, buggy e almoço.

Exemplo de objeto de disponibilidade:

Nome: 18 buracos + buggy + almoço

Etiquetas API: [nenhum]

Que significa esta modificação para o campo?

Se a configuração do tipo de reserva se enquadrar nas diretrizes, eles asseguram um processo mais fácil e apresentarão mais da sua disponibilidade aos seus clientes, acabando por vender mais green fees. É fundamental que os produtos que lhes fornece sejam especificamente destinados à venda no âmbito do seu acordo com a Leading Courses. A mistura de produtos TTOO com produtos de outro tipo pode levar a complicações.

Por conseguinte, certifique-se de que ativa apenas os produtos indicados no seu acordo com eles. Além disso, é da sua responsabilidade garantir que a disponibilidade e os preços são corretamente atualizados através da ligação API.

Verificar e assegurar que a disponibilidade, os produtos e os preços estão correctos o mais rapidamente possível.

Formulário de autorização:

Para que um TO possa ligar-se através de uma API, terão de enviar previamente o documento preenchido e assinado por ambas as partes ao Golfmanager, clicar no Documento para o descarregar:

Documento

Os campos a preencher no formulário são os seguintes:

  • Course name: nome e dados do clube que solicita a integração.

  • Consumer API: Estas APIs destinam-se apenas a reservas online (OTAs, TOs, etc.). A agência verifica a disponibilidade e faz as reservas a partir do seu próprio programa e interage com o Golfmanager como se estivesse a entrar no site do clube, mas sem o fazer (Leadingcourses, Golf Breaks, Yourgolftravel,...).

  • Partial admin API: Estas APIs permitem gerir a configuração parcial do Golfmanager através do software de terceiros (Priswing, Golfdirecto, SAGE, etc.). O clube tem de contactar essa empresa para especificar quais as funcionalidades que precisa de adicionar nesta secção.

  • Full admin API: Estas APIs permitem gerir a configuração completa do Golfmanager através do software de terceiros (inOne, Smartpanel, etc.).

  • IP's Addresses: esta informação deve ser solicitada à empresa com quem o clube vai fazer a integração, a empresa deve especificar de quais IP's vai trabalhar.

  • Company name: Nome e dados da empresa com quem o clube vai fazer a integração.

Verificar a disponibilidade de uma OTA

Para verificar a disponibilidade online da OTA:

  1. A partir do Menu Principal > lista de Clientes

    1. Clicar no ID do Cliente da OTA correspondente.

      1. Na ficha do cliente, desativar a opção "É Api".

    2. Clicar em Guardar.

    3. Ir ao consumer (substituir "/admin" por "/consumer" no URL do navegador) e iniciar a sessão com o utilizador da "OTA".

    4. Verificar se está devidamente configurado e que exibe os Tipos de Reserva corretamente.

    5. IMPORTANTE. Depois de verificar que está tudo bem, ir à ficha do cliente e reativar a opção "É API".

  2. Ir ao Debugger para obter mais informações.

  3. Realizar um teste no consumer utilizando um cliente teste que tenha as mesmas características da OTA (excepto o É API).

Alguns contatos de TO e Agências ligadas ao Golfmanager

URL de acesso às API

Demo: https://mt-es.golfmanager.com

Demo APP: https://mt.golfmanager.app

Europa AWS: https://mt-aws-europa.golfmanager.com

Asia AWS: https://mt-aws-asia.golfmanager.com

América AWS: https://mt-aws-america.golfmanager.com

Marriott AWS: https://mt-aws-marriott.golfmanager.com

Ajuda técnica para a ligação

Se é um integrador que começa a utilizar as APIs, aqui estão as bases para começar:

  1. Solicitar as credenciais de teste à equipa de Golfmanager.

  2. Aceder à documentação API.

Se tiver problemas com a ligação, tente o seguinte usando o Postman. Criar uma conta e seguir os passos:

3.Copiar e colar este texto para a função GET https://mt.golfmanager.es/api/tenants

Pode utilizar mais funções detalhadas na documentação API no ponto 2.

Nota, o .es final pode mudar dependendo do servidor ao qual tenha solicitado acesso. Há .es e .app para testes, e .com para produção. É importante que saiba a que servidor lhe foi dado acesso. Tem todos os acessos nos links da secção anterior.

4. Preencha os dados de login com as credenciais fornecidas pelo Golfmanager.

5. Clique em "Send"...

Se obtiver a resposta abaixo significa que tudo está a começar a funcionar corretamente.

Mensagem de erro na API: "A linha '(Descrição da linha de venda), Nome do clube Nome do clube' não tem crédito nem preço zero".

Para mais informações, siga o link.

Mensagem de erro na api: "[RealizarReserva] Error ao realizar a reserva. Código 2: The remote server returned an error: (500) Internal Server Error."

Para mais informações, siga o link.

Mensagem de erro na api: "Request: resources?tenant=xxxxxxxx&offset=0Response: Plugin not found api"

Para mais informações, siga o link.

Isto respondeu à sua pergunta?