Moody's EVA Operation
This section describes how users interact with the EVA integration during Entity Onboarding and Periodic Review workflows within Fenergo.
EVA sources can be used with both the External Data Combined and External Data Entity Enrichment tasks. The operational process is similar to other providers such as Orbis and Kompany — for general task execution guidance, refer to the Selecting the Match and Import sections in the Using External Data Sources guide.
Triggering an EVA Data Request
EVA data requests are triggered manually or automatically when a journey step includes an External Data task — either External Data Combined or External Data Entity Enrichment. Fenergo queries all active External Data Providers, including EVA Curated and EVA Register, and presents the results for review.
To trigger a data request manually from the External Data Combined or External Data Entity Enrichment task:
- Open the task and click the Request button, or configure the automatic step in the task configuration.
- The system makes a search call to Moody's based on the configured search criteria, and returns either a list of results or a single match from each EVA source.
Selecting a Data Profile
The External Data task presents search results from each provider in separate expandable sections. Users select the most accurate match from each source before proceeding.
Understanding the Results Display
| Indicator | Meaning |
|---|---|
| Profile Retrieved (green badge) | The full data profile has been fetched and cached from EVA. |
| Exact Match (green badge) | The result was matched on the primary search key (e.g. registered number). |
| Profile retrieved N Days (label) | The number of days since the profile was last retrieved. Click Refresh to fetch an updated version. |
| Select (radio button) | Click to designate this result as the profile to import for this provider. |
Selecting Profiles
- Review the search results from each source.
- Click Select next to the most accurate match for each provider. The system makes a call to EVA to return the full data profile for that record.
- If the profile shown is stale, click Refresh on the relevant provider row to retrieve an updated profile from EVA.
Reviewing and Importing Retrieved Data
After profile selection, the EVA Data Profile screen displays differently depending on the task in use.
The External Data Combined task organises retrieved data into tabs. Tab labels include a count of records retrieved.
| Tab | Contents |
|---|---|
| Client Data | Core entity fields: legal name, registered number, country and date of incorporation, legal form, SIC/NACE codes, registry source. |
| Shareholders | Shareholders or Persons with Significant Control (PSC), with ownership percentages, roles, and nationality. |
| Company Officials | Current directors, secretaries, and other officers, with appointment dates, nationalities, and dates of birth. |
| Documents | Associated documents where available from the provider. |
When the Entity Enrichment task is in use, the returned profile, data, hierarchy, and documents are arranged in steps. Where retrieved data conflicts with existing Fenergo entity data, the affected field is highlighted for the user to accept or reject the incoming value.
For the External Data Combined task, once all tabs have been reviewed, click IMPORT to write the selected profile data into the Fenergo entity record, or COMPLETE to finalise the task without importing.
For the Entity Enrichment task, once all steps have been reviewed, click COMPLETE on the Summary step to write the selected profile data into the Fenergo entity record.
Tabs marked with a blue indicator circle contain data pending review or import. Working through each tab systematically ensures all retrieved data is actioned before completing the task.
EVA Data Source Reference
EVA Curated — Key Fields
| Fenergo Field | EVA Attribute | Description |
|---|---|---|
| Legal Entity Name | legalEntityName | Registered legal name of the entity. |
| Registered Number | registeredNumber | National company registration number. |
| LEI | Lei | Legal Entity Identifier (ISO 17442). |
| Country of Incorporation | countryOfIncorporationEstablishment | ISO country code of incorporation. |
| Trading / Company Status | TradingStatus / calculatedStatus | Active, Dissolved, or equivalent. |
| Legal Form | companyType / standardisedLegalForm | Standardised legal form (e.g. Private limited company). |
| Website | website | Company website URL. |
| Shareholders | shareholders | List of shareholders with direct ownership percentages. |
| Beneficial Owners | calculatedBeneficialOwners1010 / 1050 / 2525 | UBOs calculated under three ownership threshold definitions. |
| Directors / Officers | currentOfficers (Director) | Active director appointments with dates, DOB, and nationality. |
EVA Register — Key Fields
| Fenergo Field | EVA Attribute | Description |
|---|---|---|
| Legal Entity Name | name | Legal name as filed with the registry. |
| Registered Number | registeredNumber / localNumber | Company number issued by the registry. |
| Company Status | calculatedStatus / providedStatus | Active. |
| Registered Address | formattedAddress / addressLine | Registered office address from the registry. |
| Date of Incorporation | dateOfIncorporation | Incorporation date as filed. |
| Legal Form | nationalLegalForm / normalizedLegalForm | Legal form string from the registry (e.g. private-limited-guarant-nsc-limited-exemption). |
| Registration Authority | registrationAuthority | Registering body (e.g. Companies House). |
| Current Directors | currentOfficers (Director) | Active director appointments with dates and date of birth. |
| Company Secretary | currentOfficers (Secretary) | Active secretary appointment. |
| UBO / PSC | ultimateBeneficialOwners | PSC data as filed: name, DOB, ownership band, nationality, means of control. |
Using Ongoing Monitoring
Ongoing monitoring is supported for EVA Register and, once configured in the journey, allows clients to subscribe an entity for ongoing monitoring.
Subscribe
The automated External Data Monitoring Subscription task is executed directly after the External Data Combined or External Data Entity Enrichment task. When successfully completed, it creates a Subscription ID for that entity.
Clicking back into the External Data Combined task will indicate the current monitoring status for the user — for example, Already Active, Unsubscribed, and so on.
Consuming Updates
Once subscribed, the Fenergo system listens for notifications from EVA. If a change is detected on a field configured for updates (see the configuration guide), EVA sends the notification back to Fenergo.
When configured correctly, the update journey launches automatically. The update journey should have an External Data Combined or External Data Entity Enrichment task configured to call for the updated data profile.
The user can use the Review functionality in Entity Enrichment or a Proposed Changes task to highlight differences in the changed data.
Unsubscribe
To unsubscribe an entity from monitoring, the automated External Data Monitoring Unsubscription task with EVA Register configured is executed.
The user can check the status by clicking back into the External Data Combined task to view the indicator chip.
EVA Troubleshooting
Authentication Status Shows Unverified
If the Authentication Status for EVA Curated or EVA Register shows Unverified:
- Confirm that the
apiKeyvariable is correctly set in the Global Variables tab of Flow Studio, and thatapiUrlandApiUrlV2are correctly set in the Variables tab of the EVA Curated and EVA Register Flows. - Verify that the Fenergo SaaS tenant has network connectivity to the Moody's EVA API endpoint.
- Verify that the EVA API key has not expired and that the Moody's subscription is active.
- Review the relevant Studio Flow for any configuration errors in the authentication step.
Mapping Status Shows Mapping In Progress
"Mapping In Progress" indicates that field mapping has been started but not completed. To resolve:
- Open the provider in the External Data Providers screen and navigate to the mapping canvas.
- Complete mappings across all four tabs: Entity Data, Hierarchy Link, Company Related Parties, and Individual Related Parties.
- Click SAVE on each tab after completing mappings. The Mapping Status updates to Mapped once all tabs are saved.
No Results Returned for a Search
If an EVA search returns no results:
- Verify that the entity's registered number and legal name are correctly entered in Fenergo — these are the primary search keys.
- Confirm the correct country of incorporation is set, as some registries are jurisdiction-specific.
- Open the relevant Studio Flow and review the Search Request step to confirm search parameters are correctly mapped.
- Note that recently incorporated entities may not yet be available in the EVA Curated dataset. EVA Register data is typically more current as it draws directly from registry filings.
Flow Status Shows Draft
A Flow in Draft status is not available for data retrieval. To publish:
- Navigate to Flow Studio > Flows and open the relevant Flow (EVA Curated or EVA Register).
- Review each step tab for validation warnings and resolve any issues highlighted.
- Click Publish. The Current Status updates to Published.
Profile Retrieval Date Is Stale
EVA profiles are cached after initial retrieval. If the profile shown on the Select Data Profiles screen is outdated, click the Refresh button on the relevant provider row to fetch an updated profile from EVA.
Support and Escalation
| Issue Type | Contact |
|---|---|
| EVA API connectivity or data quality issues | Moody's Analytics Support — provide your EVA client ID and the relevant entity identifiers. |
| Fenergo configuration issues (Flows, mapping, providers, journeys) | Fenergo Customer Support — reference the affected Flow or provider name. |