The Mass Printing Service (Payslip) now supports Kivra as a digital delivery channel. When you send a letter through the Mass Printing API, Maventa automatically checks whether the recipient has a Kivra digital mailbox. If a match is found, the letter is delivered to Kivra instead of being printed and mailed — saving printing and postage costs while reaching recipients in their preferred channel.
The Mass Printing Service is available only for Finnish companies.
How it works
Before handing a letter over to the print provider, Maventa performs a lookup against the Kivra consumer registry using the recipient’s information. If a match is found, the letter is delivered digitally. If no match is found, the letter continues to the normal print route — no changes are needed on your end.
The lookup uses the following recipient data, in priority order:
- Social security number (SSN)
- Email address
- Full name + street address + postal code + post office
- Full name + phone number
To improve match rates, provide as much recipient information as possible in your API calls. The JSON API supports optional recipient[email], recipient[phone], and recipient[ssn] parameters that enable additional lookup methods beyond name and address matching. If you are still using the IPOST XML API, we recommend switching to the JSON API — it removes the need to build iPost XML metadata and ZIP packages, supports more Kivra matching criteria, and offers additional features like custom letter subjects.
Kivra has a maximum PDF size limit of 15 MB. If the letter exceeds this limit, it falls through to the normal print route automatically.
Automatic sender setup
Each company can have only one sender account (tenant) in Kivra. If a tenant does not already exist, Maventa automatically creates one when the company’s first letter is delivered via Kivra — no action is required. The tenant name is based on the company’s official name from the YTJ registry.
Custom letter subject
When using the JSON API, you can customise the subject that recipients see in their Kivra inbox using the letter_subject parameter. By default, the subject is “Kirje lähettäjältä [company name]”.
Opting out of digital delivery
If a specific letter requires guaranteed physical delivery — for example, when a paper trail is needed — set the prevent_digital_post parameter to true. This opts out of both Kivra and OmaPosti delivery for that letter.
Billing
Kivra deliveries are billed as consumer invoices. The billing action name is EINVOICE_KIVRA_FI.
Learn more
For full technical details, see the Mass Printing Service documentation.