Skip to main content

FIG (Italy) WHS Integration

(Note: This feature is only available for customers in the Italy region and must be enabled for your account by Golf Genius. Contact your Golf Genius Account Manager to get started.)
​

The FIG WHS Integration adds the Italian Golf Federation (FIG, Federazione Italiana Golf) as a supported WHS network for customers in the Italy region. With the FIG WHS Integration, customers will be able to:

  • Connect an event/league to a FIG competition

  • Look up golfers in FIG and import them onto the event/league roster

  • Import golfers registered in a FIG competition onto the event/league roster

  • Post scores to FIG

  • Cancel a round in FIG

  • Send documents to a FIG competition

  • Look up and update Handicap Indexes using FIG

In this article, we will discuss:

  • Enabling the FIG integration

  • Connecting an event/league to a FIG competition

  • Looking up golfers in FIG

  • Importing the event/league roster from FIG

  • Importing FIG courses

  • Posting scores to FIG, including registering golfers in the FIG competition

  • Cancelling a round in FIG

  • Sending documents to FIG

Enabling the FIG Integration

Once Golf Genius has enabled the Italy (WHS) region for your account, to connect your account to FIG, follow these directions:

  1. From the Customer Center, navigate to Customer Settings > Default Settings > Handicap Settings.

  2. Scroll down to the Handicap Index Service section and set the dropdown to FIG WHS (as shown below).

  3. Enter your FIG Credentials (as shown below):

    • Username: Enter the username provided to you by FIG.

    • Password: Enter the password provided to you by FIG. Once saved, this field will not display the value again and will read “Will not change if empty” on later edits.

    • API Key: Enter the API Key issued by FIG along with your club account.

    • Club Code: Enter the Club Code that identifies your club in FIG. This is used when refreshing your roster and listing competitions.

  4. Click “Save” to apply the settings.

Connecting an Event/League to a FIG Competition

Every event/league for a FIG customer includes a FIG Integration section in the Event/League menu. This section shows the current connection status and the available actions for that status (as shown below):

  • Not Connected: Displays “Not connected.” You can click:

    • Create Competition to FIG

    • Pull National Competition from FIG

  • Pending Confirmation: Displays “Pending confirmation.” No actions are available until FIG confirms the competition.

  • Connected: Displays “Connected” along with the FIG competition ID.

  • Rejected: Displays “Rejected” along with FIG’s reason when FIG rejects the competition details sent to it. The next time the competition is synced (for example, when you post scores) or the event/league is linked to a competition, the status clears.

Creating a New Competition in FIG

To create a new competition in FIG from your event/league, follow these directions:

  1. Navigate to Event/League > FIG Integration.

  2. Click “Create Competition to FIG.” This sends the event/league’s name, date, number of rounds, and competition mode to FIG.

  3. The section updates to “Pending confirmation” while FIG processes the request.

  4. Once FIG confirms, the section updates to “Connected” and displays the FIG competition ID.

Note: The “Create Competition to FIG” link disables itself while the request is in progress, so it cannot be clicked twice.
​

Connect to an Existing Competition from FIG

To link your event/league to an existing FIG competition instead, follow these directions:

  1. Navigate to Event/League > FIG Integration.

  2. Click “Pull National Competition from FIG.” Tournament Management loads the federation’s calendar.

  3. In the “Pull a National Competition from FIG” dialog, select the competition from the dropdown, shown as the competition name and date (as shown below).

  4. Click “Save.” The event/league is linked immediately, and the section updates to “Connected.”

Notes:

  • A competition pulled from FIG belongs to the federation, and its details are never sent back to FIG.

  • For competitions created from Tournament Management, the event/league’s current details (name, dates, and rounds) are sent to FIG automatically each time you post scores, so FIG always has the latest version of the competition.

Looking Up Golfers in FIG

In addition to the Master Roster, other events/leagues, and the FIG competition roster, you can search FIG directly to add golfers to your event/league roster. To look up golfers in FIG, follow these directions:

  1. Navigate to Golfers > Import Golfers.

  2. Select one of the following FIG sources (as shown below):

    1. My FIG Roster: Searches your club’s members (by Club Code). Search by last name or first name (starts with), or by FIG Number. A FIG Number for a golfer outside your club returns no results.

    2. All FIG: Searches every FIG member. Search by last name or first name (at least 2 characters). The results show each golfer’s club. Searching by FIG Number is not available for this source.

    [Screenshot needed: TM-FIG-Import — Import Golfers page showing the My FIG Roster and All FIG sources, with All FIG results showing each golfer’s club]

  3. Select the golfers to add to your event/league roster.

Keep the following in mind:

  • The first My FIG Roster search for a large club can take up to about 50 seconds while FIG prepares the results. Later searches take about 2 seconds.

  • Imported golfers receive the Member Uid field (their FIG Member ID), including golfers who do not have a FIG card.

  • Looking up golfers in FIG is not available in Quick Event Setup events or team matches.

Importing the Event/League Roster from FIG

Once your event/league is connected to a FIG competition, you can add golfers registered with FIG to your event/league roster. To import the roster, follow these directions:

  1. Navigate to Golfers > FIG Integration (as shown below).

  2. Click “Import Roster from FIG.” Tournament Management begins a background import and opens the import status page.

  3. Click "Done" to view the roster.

Notes:

  • Golfers already in your Master Roster are matched by their FIG member ID. Golfers registered to the competition who are not in your Master Roster are looked up in FIG (by FIG Number or Member Uid) and added to the event/league roster. Their names come from FIG, and their Handicap Index, Subscription Id, and Member Uid come from the competition roster.

  • You can re-run the import at any time to pick up golfers who register with FIG after your first import.

  • “Import Roster from FIG” is disabled until the event/league is connected to a FIG competition.

Importing FIG Courses

FIG courses are imported from Event/League > Course Details, the same way as for other WHS networks. For more details on importing courses, Click Here. For FIG, keep the following in mind:

  • Course names: The course picker lists courses as “Club - Course - Id,” sorted by club and then course (as shown below). An imported course is named the same way.

[Screenshot needed: TM-FIG-Courses — FIG course picker listing courses as Club - Course - Id]

  • Imported courses: Once its tees are saved, an imported course is added to the event/league and shows as checked on the event/league’s courses page.

  • FIG Compliant label: A course with complete tees shows a green “FIG Compliant” label. If any of its tees are incomplete, the label is orange and reads “Not FIG Compliant.” Hover over the label to see each tee and its problem (as shown below).

[Screenshot needed: TM-FIG-NotCompliant — Orange Not FIG Compliant label with its tooltip listing tee problems]

Posting Scores to FIG

To post scores to FIG, follow these directions:

  1. Navigate to Round > Post Scores.

  2. Select who you'd like to post scores for. Use the check box on the left to select the players or click "Check All" to select all players. You can also filter players by custom field to select specific players.

  3. Click "Post Scores".

Before the scores are sent, the event/league’s current details (name, dates, and rounds) are sent to FIG, so scores are never posted against an outdated competition. If this fails, every selected golfer fails with the reason, and no scores are posted.
​

Because FIG confirms each result before the hole-by-hole strokes are sent, each golfer’s progress is shown as a status chip on the Post Scores screen:

  • White: FIG accepted the result but has not confirmed it yet (“Score sent to FIG, waiting for its confirmation”). The page keeps refreshing after posting, so the outcome shows without reloading the page.

  • Green: FIG confirmed the result and then the hole-by-hole strokes. No further action is needed.

  • Red: FIG rejected the result or the hole-by-hole strokes, or the golfer could not be posted. FIG’s reason is shown on the chip. Resolve it and post the golfer again.

Notes:

  • 18-hole rounds and 9-hole rounds on either nine are both supported; only the holes actually played are sent to FIG.

  • If you post a golfer who was already posted, the existing FIG result is updated rather than duplicated.

  • The printable score posting report is available for FIG the same way it is for other networks, and shows pending and rejected golfers the same way as the Post Scores screen.

Registering Golfers in the FIG Competition

FIG only accepts scores for golfers who are registered in the FIG competition. Golfers added to your event/league in Tournament Management (rather than imported from the FIG competition roster) are not registered yet, so Post Scores registers them for you before sending their scores. This is only available for club competitions in FIG. When you post scores for a golfer who is not registered:

  1. Tournament Management checks the competition’s registrations in FIG and saves the registration details of any golfers FIG already has.

  2. The remaining golfers with a FIG Number or Member Uid are sent to FIG to be registered. Golfers without a FIG card are registered as foreign golfers.

  3. While FIG confirms the registrations, the golfers show as pending: “Waiting for FIG to confirm the golfer registrations before sending the score” (as shown below).

  4. Once FIG confirms, their scores are sent.

[Screenshot needed: TM-FIG-Pending — Post Scores with golfers waiting for their FIG registration]

Keep the following in mind:

  • Golfers can only be registered until the competition’s first result reaches FIG. After that, FIG does not accept registration changes for the competition.

  • Removing a golfer from your event/league does not update FIG right away. Their FIG registration is canceled with the next registration request.

Canceling a Round in FIG

If a round in a connected event/league will not be played or scored in the FIG competition, you can cancel it in FIG directly from Tournament Management. To cancel a round in FIG, follow these directions:

  1. Navigate to Round > Round Settings.

  2. In the FIG Integration section, click “Cancel Round in FIG.”

  3. Confirm the cancellation when prompted.

  4. Once canceled, the section displays “Canceled in FIG,” and the “Cancel Round in FIG” link is disabled (as shown below).

Note: Canceling a round in FIG only affects the round in FIG — the round remains active in Tournament Management and can still be scored there.
​

Sending Documents to FIG

FIG publishes a competition’s documents (such as tee times, leaderboards, and Handicap Index changes) alongside the competition. You can send these documents to FIG from the FIG Documents page, see what has been sent, and delete documents. Nothing is uploaded automatically. To send a document to FIG, follow these directions:

  1. Navigate to Event/League > Report Center, or to the Report Center of a round.

  2. Click “FIG Documents” (as shown below). This button appears when the event/league is connected to a FIG competition.

    [Screenshot needed: TM-FIG-DocsButton — FIG Documents button on the Report Center]

  3. Click “Upload document.”

  4. Enter the following (as shown below):

    1. File: Choose a PDF from your computer or drag it onto the dialog. The maximum file size is 8MB.

    2. Category: Select the FIG document type. Categories are grouped under Whole event (Tee times, Tee times (alphabetical), Leaderboard, Match play bracket, Individual leaderboard (team events), and Handicap Index changes) and under each round (Tee times, Tee times (alphabetical), Leaderboard, Net leaderboard, and Handicap Index changes).

    [Screenshot needed: TM-FIG-Upload — Upload document dialog with a file and a category selected]

  5. Click “Send to FIG.” This button is available once both fields are set.

The FIG Documents page lists every document sent for the event/league, newest first (as shown below). Each row shows the file name and size, the FIG category and its round (or Whole event), the status, the time it was sent, and a Delete link.

[Screenshot needed: TM-FIG-DocsPage — FIG Documents page listing the event’s documents and their statuses]

Document statuses include:

  • Sending (blue): The document is waiting for FIG to confirm the upload.

  • Sent (green): FIG confirmed the upload.

  • Failed / Delete failed (red): FIG could not upload or delete the document. FIG’s reason is shown underneath.

  • Deleting: FIG is removing the document.

Deleting a Document

To delete a document, click “Delete” in the Actions column and confirm. Keep the following in mind:

  • A Sent document is deleted in FIG and leaves the list once FIG confirms.

  • A Failed document never reached FIG, so it is only removed from the list.

  • Documents that are Sending or Deleting cannot be deleted.

  • Each upload adds a new document in FIG. To replace a document, delete the old one.

Manual Individual Lookup

You can manually look up individual golfer Handicap Indexes in the Master Roster Profile and Event/League Roster Profile by following these directions:

  1. Navigate to the roster:

    1. Master Roster: From the Customer Center, navigate to Master Roster > View Master Roster.

    2. Event/League Roster: Within the event/league, navigate to Golfers > Event/League Roster.

  2. Find and select the golfer whose Handicap Index you wish to look up.

  3. Select the “H.I. Summary” tab.

  4. Click “FIG Lookup.”

  5. Enter the golfer’s FIG Number or Name and click “Search” (as shown below).

  6. Click “Select” to import the golfer’s Handicap Index.

  7. Click “Save” to apply the changes to the golfer’s profile.

Manual Bulk Handicap Index Lookup for Master Roster

To update Handicap Indexes for multiple golfers in the Master Roster at once, follow these directions:

  1. From the Customer Center, navigate to Master Roster > Access FIG WHS to Update Handicap Indexes.

  2. Select specific golfers or all golfers using the checkboxes.

  3. Select the update method:

    1. Current Handicap Index: Retrieve Handicap Indexes as of the current date.

    2. Handicap Index on a specific date: Retrieve Handicap Indexes from a specific past date.

  4. Click “Update” to apply the changes.

The Handicap Indexes for the selected golfers will then be updated (as shown below).

Note: The “Status” column indicates whether the golfer’s Handicap Index was successfully updated. The “H.I.” column displays the change in Handicap Index before and after the update.
​

Manual Bulk Handicap Index Lookup for Event/League Roster

To update Handicap Indexes for multiple golfers in an event/league roster at once, follow these directions:

  1. Within your event/league, navigate to Event/League > Event/League Profile > Handicap Settings.

  2. Scroll down to the Handicap Index Service section and verify FIG WHS is selected in the first dropdown (as shown below).

  3. If desired, check the box to “Automatically update Handicap Indexes from the Master Roster into Event/League Roster.”

  4. Click “Save” to apply the settings.

  5. Navigate to Golfers > Access FIG WHS to Update Handicap Indexes.

  6. Select specific golfers or all golfers using the checkboxes.

  7. Select the update method:

    1. Current Handicap Index: Retrieve Handicap Indexes as of the current date.

    2. Handicap Index on a specific date: Retrieve Handicap Indexes from a specific past date.

  8. If your event/league has multiple rounds, select the round you would like to update Handicap Indexes for. That round and all following rounds will be updated unless updates have been turned off for a specific round. For more details on turning off Handicap Index updates for a specific round, Click Here.

  9. Click “Update” to apply the changes.

The Handicap Indexes for the selected golfers will then be updated for the event/league (as shown below).

Note: If you run a weekly league and meet the following parameters, you can use the automatic re-fill feature:

  • Created divisions/flights using Playing Handicap or Handicap Index.

  • Re-fill the divisions/flights after every Handicap Index update.

For more details, Click Here.
​

Automatic Updates

There are several options to automatically update Handicap Indexes in the Master Roster and event/league roster. Click on the following articles for more details:

Lookup During Master Roster Registration

When using Master Roster Registration, you can allow golfers to look up their details using the FIG WHS Integration. For complete details, Click Here.
​

Relevant Articles

The following standard network capabilities are also available for FIG, the same way they work for other WHS networks in Tournament Management:

  • Course Import: Available from Event/League > Course Details. Lists FIG’s certified courses; importing one brings its tees into Tournament Management. Covered above in Importing FIG Courses.

  • Master Roster Refresh: Available from the Master Roster. Pulls your club’s members by Club Code. For more details, Click Here.

  • Handicap Lookup: Available from the Master Roster and event/league roster. Finds a golfer by FIG Number. Covered above in Manual Individual Lookup.

  • Handicap Index Update: Available from the Master Roster and event/league. Retrieves each golfer’s current Handicap Index. Automatic updates can be turned on per customer and are off by default. Covered above in Automatic Updates.

  • Score Posting: Available from Round > Post Scores. Sends round results and hole-by-hole strokes to FIG. Covered above in Posting Scores to FIG.

Did this answer your question?