Software companies can use the IXBRL application programming interface to submit digital financial statements to the Trade Register
This instruction is intended for service providers who maintain financial administration software.
Software companies can use the PRH application programming interface (API) to send digital IXBRL financial statements and their metadata to the Finnish Trade Register.
The API (interface) can be used free of charge.
The PRH does not provide a customer software to use the API (interface). Therefore, the software companies must create a sufficient function in their own financial administration system to be able send the IXBRL financial statements to the Trade Register.
What kind of financial statements can I send through the API (interface)?
The API (interface) currently accepts IXBRL financial statements from limited liability companies and IXBRL annual reports from foundations.
In the future, the API (interface) may also accept financial statements from other company types and in various taxonomies.
Financial statements must be filed using IXBRL (Inline eXtensible Business Reporting Language). In IXBRL financial statements, the XBRL details are embedded in the HTML content. The information is displayed in a uniform manner according to standards and classifications, but in a visual format the users are accustomed to.
There are no other requirements for showing the details. The financial statements can therefore be visualised as you wish, as long as they are based on the IXBRL standards.
Financial statements in IXBRL format are copies. The signed versions remain in the possession of the reporting entity. The IXBRL financial statements therefore do not need to include electronic signatures. Information about the signatories can be embedded in the financial statements in a free-form manner.
What kind of API (interface)?
The API (interface) is a REST API. Users identify themselves via a separate authentication server and receive an access token to be used in the API (interface) calls.
In the API (interface), a separate query is used to retrieve information about what kind of company types or taxonomy versions the API (interface) is currently supporting.
Metadata, such as the Business ID and the start date and end date of the financial period, are submitted together with the financial statements or the annual report. Metadata are given in the URL parameters and in the call body in JSON format. The body is sent in multipart/form-data format, where the metadata are given as well as an attached IXBRL file.
The API (interface) checks that the given metadata are correct and are matching up with the IXBRL file content. In addition, the API (interface) checks that the financial statements or annual report has the correct structure. In the future, the API (interface) will also check the IXBRL file content more carefully.
If the validation of the submission is successful, the API (interface) returns a successful response. In other cases, an error code and a more accurate description of the error reason are returned.
The API (interface) is primarily open around the clock.
How can I start to use the API (interface)?
To become a user of the API (interface), you have to set up a contract with the PRH.
The PRH will provide a test server to test the API (interface).
Based on the experiences of companies that use the API (interface) and have tested it, implementation takes 10–15 person-workdays. The PRH will provide support and guidance for your implementation.
For the taxonomy for financial statements of limited liability companies, visit the website of the State Treasury.Avautuu uuteen välilehteen
Do you need more information?
Please contact us for further details about the API (interface) or ask for our terms of contract and a description of the API (interface) to be sent to your email.
digitilinpaatos(at)prh.fi