Message validations

Datahub validates messages on three different levels presented below.

XML schema

In the XML schema validation, the message is validated against the schema on a technical level. The validation checks the message structure, the necessary elements and attributes, the format and maximum length of field for the data as well as the enumerations. In case of an error, a SOAP level rejection is returned (SOAP Fault).

Process validations

In the process validation, process level data and the process ID and role are checked, as well as the rights of the party to report the process event in question. Datahub validates the reporting party’s rights on two levels: the reporter’s right to use a process (e.g., DH-131) and the reporter’s right to data (e.g., a specific accounting point).

The right to data is only checked based on the juridical sender of a request. The right to perform a certain process is also based on the user rights of the juridical sender (this right is determined by market role). A juridical sender can give another party the right to report a certain event on their behalf. This requires a delegation in Datahub.

The roles allowed for message senders are listed in Events, messages and roles. In case of an error, a SOAP level rejection is returned (SOAP Fault).

Event validations

Event validation includes event-specific validations based on market processes. These events are not validated in XML schema and process validations. In the event validation, the interdependencies for the reported attributes are validated, as well as time limits. The reported values are validated against the data content of Datahub. A positive acknowledgement message is returned when an event passes the validations. A negative acknowledgement including an error report (error ID and error text) is returned for incorrect messages.

During the event validation, reported attribute values are also validated against rules specified in the data standard column permitted values. A Finnish personal identity code should, for example, meet the requirements set for it in legislation.

Event validations for each event are listed in the event-specific descriptions in the section Datahub events and business processes.