Skip to main content

v3 - API (TOUR OPERATORS & OTHER THIRD PARTIES)

Updated over a week ago

Index

Introduction

The tour operation API will help them search for availability in a tenant and make reservations.

Authorization form

In order for a TTOO or company to connect via an API, the club must first fill out and sign the form.

Select the following form:

The fields to be filled in on the form are as follows:

Details of the golf course that will benefit from the integration:

  • Name of the club. Name of the club requesting integration.

  • Telephone number. Telephone number of the club requesting integration

  • Contact email. Email address of the club requesting integration

  • Address. Address of the club requesting integration

Contact details of the authorising person:

  • Your full name. Name of the person from the club who is completing and signing this document.

  • Your position in the company. Position in the club who is completing and signing this document.

  • Your telephone number. Telephone number of the person from the club who completes and signs this document.

  • Your email address. Email address of the person from the club who completes and signs this document.

  • Company name. Name of the company of the club requesting integration.

  • Tax identification number. Tax identification number of the company of the club requesting integration.

  • Date. Date on which this document is completed and signed.

Details of the company that will carry out the integration:

  • Company name (integrating company). Trade name of the external company to which you wish to grant authorisation for the connection

  • Trademark (integrating company). Tax name of the external company to which you wish to grant authorisation for the connection

  • Contact Person (Integrating Company). Name of the contact person at the external company to whom you wish to grant authorisation for the connection.

  • Telephone Number (Integrating Company). Contact telephone number of the external company to whom you wish to grant authorisation for the connection

  • Email (Integrating company). Email address of the external company you wish to authorise for connection

  • IP Addresses. The club must contact this external company to specify the IP addresses from which they will be working:

    • Leadingcourses:

      • 51.140.152.154

      • 51.140.8.92

      • 51.140.0.50

      • 51.140.2.76

      • 51.140.7.106

Please mark the corresponding options with an ‘X’:.

  • API CONSUMER. These APIs are intended for online bookings only (OTAs, TOs, etc.). Instead of going to your website and making bookings for their customers, the agency does so from its own programme and interacts with Golfmanager as if it were accessing the club's website, but without actually doing so (Leadingcourses, Golf Breaks, Yourgolftravel, etc.).

  • PARTIAL ADMIN API. These APIs allow you to manage the partial configuration of your Golfmanager as if you were a club employee, only instead of logging in through a browser, it is done digitally through third-party software (Priswing, Golfdirecto, SAGE, etc.).

    • API functions. The club must contact that company to specify which features it needs to add in this section.

  • FULL ADMIN API. These APIs allow you to manage the complete configuration of your Golfmanager as if you were a club employee, only instead of logging in through a browser, it is done digitally through third-party software (inOne, Smartpanel, etc.).

Configuration by the club

  1. From the Main Menu > CRM > Customers. You have to create a new customer. Before creating a new one, first look in the list, to see if this customer already exists.

  2. In the profile of the created customer ACTIVATE the field TO CREDIT. This allows the OTA to book without having to pay at that moment. At the end of the month, you will be able to invoice the OTA for all outstanding bookings.

  3. Optionally you can add an Alias to that customer's record.

    NOTE: This is a good practice because you will see clearly in the booking plan which bookings have come through this OTA.

  4. You will probably need to add a Tag to this customer record, the same tag that is on the Booking Type that you want to display for booking. As you may already know, the label is essential to show the correct price to that agency. The way the price works with an agency is usually done in two ways:

    • A: Empty. If you don't add any tag to this OTA's tab, they will be shown the same prices that a visitor entering your website would see. They will sell on their APP at the same price as on your website. At the end of the month they will invoice you with their commission.

    • B: With a label that means a discount. In this case the OTA will receive the agency price and it is important that they add their agreed margin in their APP so that it is sold at the same price as on the club's website. If you configure it so that the OTA receives their agency price, at the end of the month you will send them an invoice with the bookings that they have to pay you at their respective price.

5. Once you have created the client file, inform the Golfmanager technical support team via the chat in the help tool of the system that you wish to connect to this client, attaching the authorisation form.

6. From the Configuration Menu > Booking > Booking Types > API Tags section. The TTOO Leadingcourses, Zest and GolfSpainTours require the club to add the following names to their online Booking Types, depending on the Booking Type. Select those courses depending on the type of booking. For example, if it is an 18 hole greenfee, for the 1st tee, select 18 holes and 1st tee.

  • 9 Holes

  • 18 Holes

  • Tee 1

  • Tee 10

  • Buggy

  • Trolley

  • Electric trolley

  • Clubs

  • YGT

As in the example below:

  • 18holes tee1 buggy

  • 18holes tee10

  • 9holes tee1

  • 9holes tee10 buggy

Configuration by the Golfmanager team

After receiving the authorization form from the club:

  1. On tenant: From the Main Menu > Settings > App Market. Search for the APIs V1 plugin to install it. This plugin will add a field to the client tab called API Code V1.

  2. From superadmin: Go to Main > Multitenant API

  3. You have 2 options:

    a. Search for that TTOO or company record

    b. Create a new registration for the TTOO or company (you will need prior authorization from Carlos and Daniel)

    I. Select the New button

    II. Add Name and Email

    III. Select the Save button

    IV. The Code will be generated automatically when saving that record

4. Copy the Code of that TTOO or company registration

5. Go to the tenant of the club that sent you the authorization form

6. From Main Menu > CRM > Clients. Go to that client's profile

7. In the API v1 Code field, paste the Code you copied in step 3 above

NOTES:

  • The TTOO or company will have to change two things: the URL or endpoint, and the new password

  • At the moment there is no option to have a password for N tenants.

  • The email address of the client profile created in the tenant has to be the same as the one created in Main > Multitenant API > Agency/TTOO

Did this answer your question?