Index
Introduction
The tour operation API will help them search for availability in a tenant and make reservations.
Authorization form
In order for a TO or another company to connect through an API, the club will first need to send the document completed and signed by both parties to Golfmanager. For more information, go to the following link.
The fields to fill in the form are the following:
Course name. Name of the club or venue requesting the integration
Phone number. Phone numebr of the club or venue requesting the integration
Email. Main email address of the club or venue requesting the integration
Address. Full address of the club or venue requesting the integration
Consumer API. These APIs are intended for online bookings only (OTAs, TOs, etc.). The agency, instead of entering your website and booking for their clients, they do it from their own program and interact with Golfmanager as if they were entering the club's website, but without doing it (Leadingcourses, Golf Breaks, Yourgolftravel,...).
Partial admin API. These APIs allow you to manage the partial configuration of your Golfmanager as if you were an employee of the club, but instead of entering through a browser, it is done digitally through the third party software (Priswing, Golfdirecto, SAGE, etc.). The club has to contact that company to specify which functionalities 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 an employee of the club, but instead of entering through a browser, it is done digitally through the third party software (inOne, Smartpanel, etc.).
IP's Addresses. The club has to contact the external company to specify the IPs from which they will work.
Company name. Name and details of the external company to whom you want to give the authorisation for the connection.
Contact Name (Integrated Co). Name of the contact person of the external company to whom you want to authorize the connection.
Phone Number (Integrated Co). Contact phone number of the external company to whom you want to authorize the connection.
Email (Integrated Co). Email of the external company to whom you want to give the authorization for the connection.
COMPANY GM NAME (Company name in Club Tenant). Company name of the club tenant requesting integration.
TAX ID Number. Tax ID number of the club company requesting integration.
Date. Date this document was completed and signed.
Name. Full name of the person from the club completing and signing this document.
Title. Position in the company of the club member completing and signing this document.
Configuration by the club
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.
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.
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.
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:
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.
From superadmin: Go to Main > Multitenant API
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