Upcoming changes to the Suomi.fi Messages print, enveloping and distribution service

The provider of the Suomi.fi Messages print, enveloping and distribution service (TKJ service) will change to Edita Prima in early 2027. The technical changes required by the provider transition will require certain actions from your organisation or your system provider if the TKJ service is in use.

What does the provider change mean in practice?

For standard paper mail, the TKJ service provider will change to Edita Prima

• New TKJ service credentials (user IDs and passwords) will be required for Edita Prima and must be updated in the sending systems. The Digital and Population Data Services Agency will provide separate instructions on this at a later stage.
• For standard paper mail, the position of the address window in window envelopes will change to comply with the standard used by Edita Prima. More information about the required changes to the address page is provided below.
• Prices for standard paper mail will decrease somewhat.
• The target is for organisations to be able to send paper letters through the service provided by Edita Prima by the end of March 2027.

For verifiable service by paper mail, the provider will remain Posti Messaging

• When sending messages as verifiable service by paper mail, the existing Posti Messaging TKJ-service credentials (identifiers and passwords) will remain unchanged.
• For verifiable service by paper mail, the position of the address window in window envelopes will remain unchanged and continue to comply with the current requirements of Posti Messaging.
• Prices for verifiable service by paper mail will increase slightly.

What technical changes can be expected?

The Edita Prima interface will be released to the production environment in early 2027. The Digital and Population Data Services Agency recommends familiarising yourself with the upcoming changes in advance and ensuring that sufficient time is reserved for implementing the required updates.

Standard paper mail (Edita Prima)

At present, paper mail is routed using the following REST API endpoints:

• /v2/messages
• /v2/paper-mail-without-id

These endpoints currently route paper mail to the printing, enveloping and distribution service provided by Posti Messaging.

"printingAndEnvelopingService": {
      "costPool": "XUEY3CX5MDDU07S",
      "postiMessaging": {
        "contactDetails": {
          "email": "str@ing.com"
        },
        "password": "stri",
        "username": "string"
      }

In early 2027, support for Edita Prima will be introduced through new endpoint versions. The goal is for all organisations using the TKJ service to migrate to the v3 endpoints during the transition period and no later than the end of March 2027:

• /v3/messages
• /v3/paper-mail-without-id

"printingAndEnvelopingService": {
      "costPool": "XUEY3CX5MDDU07S",
      "editaPrima": {
        "contactDetails": {
          "email": "str@ing.com"
        },
        "password": "pass1234Word!",
        "username": "tunnus1"
      }

Verifiable service by paper mail (Posti Messaging)

In the v3 versions of the endpoints used for verifiable service by paper mail, the postiMessaging configuration will remain unchanged from the current v2 endpoints. These endpoints can only be used for sending verifiable service by paper mail.

When sending a message as verifiable service by paper mail:

• The value of the messageServiceType element under the paperMail element must be Verifiable.
• Under the printingAndEnvelopingService element, only the postiMessaging element and its child elements may be used.

Changes to the address page for standard paper mail

Content sent as paper mail is submitted to Suomi.fi Messages as a single PDF file.

There are two ways to generate the address page. Your organisation can either:

• create the layout of the address information itself; or
• ask Suomi.fi Messages to create the address page if the message is sent as paper mail. This can be enabled by setting the value of the createAddressPage element to true.

Please determine which approach your organisation currently uses.

• If your organisation creates the layout of the address information itself, the address information layout must be updated to meet the requirements of Edita Prima when sending standard paper mail. When sending verifiable service by paper mail, the current Posti requirements will continue to apply.
• If your organisation uses the address page generation provided by Suomi.fi Messages, no action is required regarding the address page.

You can review the new address page requirements in advance here: Edita Priman vaatimukset osoitesivun asettelulle (PDF, 447.22 kB)Opens in a new window.

The new API and the new address page layouts can only be adopted after the API has been released in early 2027 and tested in the system used by your organisation. However, the Digital and Population Data Services Agency recommends starting the planning and preparation work well in advance.

Further information:

Suomi.fi Messages organisation onboarding support

viestit-kayttoonotot@dvv.fi