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_subjectparameter (JSON API only) to customise the subject shown to the recipient in Kivra (default: “Kirje lähettäjältä [company name]”) - The
prevent_digital_postparameter 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.