UEFA Digital API

The COMET System is integrated with the UEFA system for Competition Management.

Improvements were made to the COMET’s integration with UEFA Competitions. This advancement includes the transition to the UEFA competition data through the list of new API endpoints provided by UEFA. All functionalities of the COMET system related to the import of competition and match data are adjusted to fetch the data from the New UEFA Digital API.

Now, the COMET system supports the import of both UEFA National and Club competitions. Using the same user interface and same import steps, European national associations are able to import competition such as UEFA Champions League or UEFA Europa League.

The user roles that have access to this functionality are System Administrators, SUPERUSERS of national associations, Administrators of International Affairs, and National Team Administrators.

List of UEFA Competitions

• Select the menu item New UEFA Competitions under the Competitions menu on the left nav-bar

• This opens the list of UEFA competitions available for import from the UEFA site.

You can search through the list of competitions by Name, Short Name, UEFA ID.

• Now, the list of available competition seasons appears on demand: click the 🔎 Load button to open a drop-down list of seasons.

The latest competition season is preselected automatically

• Click on the ▶ arrow button, on the left side of the competition to extend the list of all competition phases in which the tenant association is participating.

• This opens the list of rounds, if applicable.

• In case some competition was previously imported into the system there will be a link (the ➡ arrow button) that takes you to the competition details.

Import Competition

• If the competition was not previously imported into the system, you can start the import by clicking the Import competition button

• Press ➡ the Import competition button to start the process.

• Confirm your intention again by clicking the Update competition data – UEFA button.

• If there are no new UEFA entities to be mapped, the competition is imported automatically ✔

• Otherwise, the system informs you it requires to map certain data detected during the import, so that this mapping can be stored in Comet and re-used for all future imports.

• The system shows a panel which allows the user to either map the UEFA entity with an existing COMET entity OR to create a new COMET entity:

The creation of a new entity is disabled for tenant-related entities as those entities already exist in the system.

💡 It is possible to update data by clicking the search button and selecting the desired entity from the list (the usual Choose dialog shows-up to select a COMET entity).

• Once you have finished mapping entities, press 💾 the Save button below the list of updated entities.

• The ➡ arrow button to access the imported competition is now displayed.

• Clicking the button with the arrow icon shows the imported UEFA competition.

• The system imports the data from the UEFA Digital API and all the mandatory fields are completed automatically.

Import Match Details

Once we have successfully completed the import of an UEFA Competition, this information also included some general data about the matches (stadium, match date and time, score) of the same competition.

On the other tabs: you can look through the list of competition teams (clubs or national teams), matches, table of standings, calendar.

To import match details:

• Open the Matches tab

• This opens a list of all imported matches available on the UEFA site at the time of import. Typical information would include the time and location of the match, home team vs away team, and final match result if available at that moment.

• If you wish to have a complete match report with all details available from UEFA, then click to chose the desired Match from the list.

• When the match screen opens, scroll down to the bottom of the first tab and click the Update match data – UEFA button to enable mapping UEFA FAME entities with COMET entities.

• Confirm your intention again by clicking the Update match data – UEFA button.

• If there are no new UEFA entities to be mapped, the match is imported automatically ✔

• Otherwise, the system informs you it requires to map certain data detected during the import, so that this mapping can be stored in Comet and re-used for all future imports.

• The system shows a panel which allows the user to either map the UEFA entity with an existing COMET entity OR to create a new COMET entity.

  • Click the search button and try to find it in Comet

  • If you find a match, then select from the list.

  • If you cannot find a match, then click the check-box “Create new entity”; in that case, only the basic information will be entered into the system.

  • Once you have finished mapping all entities, press the 💾 Save button below.

After you have successfully mapped/created new entities, a completed match report will appear on the screen with all the data imported from UEFA Digital API:

• match roles (lineups, club officials, match officials)

• stadium data

• match date and time

• attendance

• match phases

• match events

• score

• If for any reason, you wish to add or change any of the imported match details, this can be done manually by clicking on the ✏ Edit button.

Import Individual Match (e.g. International Friendly Match)

The integration of international friendly matches with the COMET system can be achieved through the utilization of match data from the UEFA Digital API. This process includes importing essential match details such as:

• Match status

• Lineups

• Match events (Goals, Yellow Cards, Red Cards, Substitutions, etc.)

1. Verify Match Report on UEFA Website

Before importing match data, ensure that the match report is created and published by UEFA. Visit the UEFA official website (http://uefa.com) to confirm the availability of the match report.

2. Retrieve UEFA Match ID

Once the match report is verified, locate the UEFA Match ID associated with the match. This ID uniquely identifies the match within the UEFA system. You can find the UEFA Match ID in the URL of the match report page on the UEFA website. For example, in the URL "https://www.uefa.com/european-qualifiers/friendlies/match/2040535--egypt-vs-croatia/lineups/ ", the UEFA Match ID is "2040535".

3. Paste UEFA Match ID

In COMET, navigate to the designated field for importing match data from the UEFA Digital API. This field is labeled as "UEFA ID" or similar. Paste the UEFA Match ID copied from the UEFA website into this field.

4. Update Match Data

After pasting the UEFA Match ID, initiate the process to update match data from the UEFA Digital API. Typically, there will be an option or button labeled "Update match data - UEFA". Click on this option to trigger the update process.

Upon clicking the update option, COMET will retrieve and import match data from the UEFA Digital API based on the provided UEFA Match ID. The match data, including match status, lineups, and match events, will be updated in your system in real time.