Skip to main content

Validation Profiles

When you send data to Fenergo using Verified Import, the platform normally applies the same field rules it would enforce in the UI — mandatory fields must have values, read-only fields cannot be overridden, and calculated fields are derived from other data on the entity. In most cases this is exactly the right behaviour.

Validation profiles let you change that behaviour for a specific request. By including a validationProfile in your request, you tell the platform to apply a named set of rules instead of the defaults. This is useful when your source system holds authoritative data that should be stored exactly as sent, without the platform recalculating or restricting any of it.


The forceSave profile​

The forceSave profile is the first validation profile supported by Verified Import. When you use it, the platform stores field values exactly as provided in your request. The following are bypassed for that import:

  • Mandatory field validation — fields that are required in the UI may be left empty.
  • Read-only field validation — values can be written to fields that are otherwise locked.
  • Calculated field derivation — instead of calculating a value from other data, the platform stores whatever you send.
  • Default value population — fields are not pre-filled with their configured defaults.
  • Conditional logic — field visibility and value rules driven by other field values are not applied.
  • Collection item-count validation — minimum or maximum item counts on data groups are not enforced.
  • External adapter validation — calls to external validation services are skipped.

The following validators continue to run regardless of the profile:

  • Format validation — values must match the expected data type (for example, a date field must receive a valid date).
  • Character, numeric, and date limits — maximum and minimum length, value, and date constraints still apply.
  • Lookup validation — values for lookup fields must appear in the configured lookup list.

This means forceSave does not disable all validation — it disables the rules that govern whether a field can be set, while keeping the rules that govern what a valid value looks like.


Request format​

The ValidationProfile field is set inside EventConfig.EntityProcessingRules on a Verified Import event:

{
"correlationId": "{{$guid}}",
"entityId": null,
"eventSubtype": "verifiedimport",
"eventType": "externaldata",
"payload": {
"Entities": [
{
"collectionProperties": {},
"EntityResolver": null,
"EntityType": "Company",
"Id": "fca8cee1-6026-410a-9a31-61a2b2dcb4c9",
"singleProperties": {
"companyCategory": "Partnership",
"countryOfIncorporation": "Albania",
"dateOfIncorporationEstablishment": "2002-09-09",
"formationDate": "2001-08-08",
"legalEntityName": "Musgraves LTD",
"productRiskRating": "Medium",
"productRiskScore": "Low"
},
"TargetEntity": "Client"
}
],
"EventConfig": {
"EntityProcessingRules": {
"Categories": [
"Basic Details",
"Business Details"
],
"ValidationProfile": "forceSave",
"WaitForSearchPropagation": false
},
"ImportBehaviors": {}
},
"EventIdentifier": "MDMImport",
"Integration": "forceSave validation test",
"IntegrationStatus": "Success",
"MessageId": "<message-id>"
}
}

ValidationProfile is optional within EntityProcessingRules. If omitted, the request is processed using the standard validation rules.

ValidationProfile must be a non-empty alphanumeric name of at most 64 characters, otherwise the request is rejected. If you send a profile name that is not recognised, the request will be rejected with an error indicating that the profile is invalid. The value is case-sensitive.


Products​

The validation profile set in EventConfig.EntityProcessingRules also applies to products. Every product nested under an entity in the request is processed with the same profile as its owner entity — there is no separate profile setting for products. For the product payload, see VerifiedImport Overview — Products.

What forceSave changes for products:

RuleUnder forceSave
Read-only fieldsValues sent for read-only fields are written.
Mandatory fieldsMandatory fields left out of the request do not block the update.
Trigger conditionsA field sent in the request is written even when its trigger condition is not met, and no field is cleared because its trigger condition is not met.
Calculated and default valuesCalculated and default values are not applied to the product.
Validation warningsA warning does not cause the product update to be rejected.
Stored reference data valuesA stored value that is no longer in the current reference data does not cause the update to be rejected.

What still applies:

  • Format and field type — a value must match the field's data type.
  • Requirement set and categories — a field that is not in the product's requirement set and the categories listed in ProductProcessingRules is rejected.
  • Date validations — No Past Dates, No Future Dates, Disallow Today and Date Range still apply.
  • Lookup values — for products (unlike entities), lookup values are only validated when Validate Existing Reference Data Values is enabled via its configuration toggle.

Only the product fields included in the request are updated. Fields inside product data groups follow the same rules.

Not included:

  • A separate validation profile for products. The entity's profile always applies to its products.
  • Applying the profile to individual fields or to selected categories only.
  • Updates to product drafts in open journeys.
  • Re-evaluating related entities, related parties or other products after a product is updated.
  • Data Import. Only Verified Import supports validation profiles.

Audit trail​

Every field change made through Verified Import is recorded in the entity audit trail. This applies to imports that use a validation profile as well as standard imports. The audit entry includes the imported value, the timestamp, the source of the change, and — where a validation profile was used — the name of the profile that was active at the time of import.

For products, the profile name is recorded in the product audit record and returned through the audit API.

This means you can always trace what was imported, when, under which conditions, and whether any field-level rules were bypassed — even when values were written to fields that would normally be read-only or calculated.


Considerations​

  • Source data quality — because forceSave bypasses field-level validation rules, the values stored on the entity or product reflect what your source system provided. It is the responsibility of the calling integration to ensure the data is complete and accurate before import.
  • Downstream processes — some platform workflows and rules run after data is saved. These are not affected by the validation profile and will execute as normal against the imported values.
  • Calculated fields — if a calculated field is given a value under forceSave, that value will be stored as sent. If the entity is subsequently updated through a UI workflow or another import without forceSave, the platform may recalculate and overwrite it.