This article explains the concept and usage of a System ID. It may be important for you in 2 cases which are described separately:
- you are a standard (primary) system provider for a Member Association and you are about to implement a deduplication screen (e.g. as described here)
- you are a system provider for a Member Association but a registration system already exists (i.e. your system comes 2nd)
In other words: you either need to register persons and mark them by your System ID or you want to successfully recognize records registered like that.
Deduplication of person records registered by/with a System ID
|DeduplicationResult -> PersonDuplicateWithDetails -> RequestRecipientOrganisationId||Id of MA a player plays in|
|DeduplicationResult -> PersonDuplicateWithDetails -> RequestRecipientOrganisationSystemId||SystemID|
|DeduplicationResult -> PersonDuplicateWithDetails -> RequestRecipientOrganisationId||Id of MA registering a player|
|DeduplicationResult -> PersonDuplicateWithDetails -> RequestRecipientOrganisationSystemId||null|
Secondary system provider for a Member Association
By default, all registrations are stored in a single national registration system. It is however possible to connect additional system(s) to FIFA Connect ID service. As an example we may consider the [main] national registration system being responsible for Amateur players only and an additional, external system – for Professionals. In such a setup it is important that Connect ID is able to properly route requests for player details sent by other MAs via Service Bus.
In order for this routing to work correctly, an external system, for each of registrations it manages (professional ones), must provide its unique identifier (System ID).
System ID should be set for each registration by using SystemId property. Use the value you received from the Connect ID Support Team. See below example:
var organisationId = "105C8LX";
var systemId = "105C8LX_SystemName";
var newPlayerRegistration = new PlayerRegistrationType();
newPlayerRegistration.Level = "Pro";
newPlayerRegistration.Discipline = "Football";
newPlayerRegistration.RegistrationNature = "Registration";
newPlayerRegistration.Status = "Active";
newPlayerRegistration.OrganisationFIFAId = organisationId;
newPlayerRegistration.SystemId = systemId; // The system identifier is created and passed along with the access credentials.
There is no need of setting SystemId if registration is added by a default/primary registration system. In this case the <null> value should be used.
In connection to the topic of this article we highly recommend to read more about transfer / taking over an existing player here: https://support.id.ma.services/support/solutions/articles/7000052312-transfer-taking-over-an-existing-player