Added Kivra delivery to the Mass Printing Service

The Mass Printing Service (Payslip) now supports delivering letters to recipients’ Kivra digital mailboxes. Before a letter is sent to print, Maventa automatically looks up the recipient in the Kivra consumer registry. If a match is found, the letter is delivered to Kivra instead of being printed. The Mass Printing Service is available only for Finnish companies.

Kivra lookup matching

Kivra delivery works with both the JSON API (POST /input_json) and the IPOST XML API (POST /input_public). The available Kivra lookup criteria depend on which API you use.

IPOST XML API — Kivra matching is based on the recipient data available in the iPost XML metadata:

• Full name + street address + postal code + post office

JSON API (recommended) — In addition to name and address matching, the JSON API supports optional parameters that enable more lookup methods and improve match rates:

• recipient[ssn] — social security number (highest priority match)
• recipient[email] — email address
• Full name + street address + postal code + post office (from the required recipient fields)
• recipient[phone] + full name — phone number combined with name

The JSON API is the recommended way to send letters through the Mass Printing Service. It removes the need to build iPost XML metadata files and ZIP packages, making the integration more straightforward — you simply send a PDF with recipient details as request parameters. The JSON API also supports features like additional Kivra lookup parameters and custom letter subjects that are not available in the IPOST XML API. If you are currently using the IPOST XML API, we recommend switching to the JSON API.

Other changes

• Added optional letter_subject parameter (JSON API only) to customise the subject shown to the recipient in Kivra (default: “Kirje lähettäjältä [company name]”)
• The prevent_digital_post parameter now also opts out of Kivra delivery (in addition to OmaPosti)
• Kivra deliveries are billed with action EINVOICE_KIVRA_FI
• Maximum PDF size for Kivra delivery is 15 MB — larger files fall through to print automatically

Sender setup

A Kivra sender account (tenant) is created automatically on first delivery. The tenant name is based on the company’s official name from the YTJ registry. No manual setup is required.