30.06.2026 - Upcoming changes to the Amili Perintä debt collection service

What is Amili Perintä?

Amili Perintä lets Finnish companies hand over overdue invoices to Visma Amili for professional reminder handling and debt collection. Customers can use it directly in the Maventa user interface, or you can bring it into your own product through the API.

More about the integration is available in the Maventa integration guide: documentation.maventa.com/integration-guide/accounts-receivable/amili-perinta.

What is changing

Maventa is making important changes to the Amili Perintä debt collection service. Two dates matter:

• 1 September 2026: The new form for transferring invoices to Amili Perintä becomes mandatory in the Maventa UI.
• Summer 2027: The v1 assignment API will be shut down. All API integrators must move to use the v2 API before that date.

Why this change

Today, many invoices are transferred to Amili Perintä without all the information needed to start the collection process. That means Visma Amili has to do manual research or contact the sender to ask for the missing details, which delays the process and adds extra manual steps on both sides.

The new version of the service captures the necessary information up front: full debtor details, any co-debtors, what the assignment concerns, and what type of assignment it is (rental, B2C, or B2B). With this information available from the start, cases can move forward without unnecessary back-and-forth, and the collection process gets going faster.

For API integrators

Action required by Summer 2027: migrate your integration from the v1 assignment endpoint to the new v2 endpoint. The v1 endpoint will be shut down in Summer 2027 and will stop accepting requests after that date.

Maventa will confirm the exact shutdown date at the beginning of 2027. Even so, starting the migration as soon as possible is strongly recommended to avoid last-minute pressure.

Endpoints

Current (v1, being deprecated): POST /v1/invoices/{id}/assignment (https://swagger.maventa.com/#/invoices/getV1InvoicesIdAssignment)

New (v2, to migrate to): POST /v2/invoices/{id}/assignment/amili (https://swagger.maventa.com/#/invoices/postV2InvoicesIdAssignmentAmili)

For UI users

A new form is now available in the Maventa UI for transferring invoices to Amili Perintä from the sent invoice details. It includes additional fields to support a smoother and more efficient reminder and collection process: full debtor information, co-debtor information, the summary of the assignment, and the assignment type (e.g. rental, B2C, or B2B). You can use either the current form or the new form until 1 September 2026. After that date, the new form is mandatory.

What you should do now

• Start using the new form for every new invoice transfer. The earlier you switch, the smoother the transition.
• Make sure the people transferring invoices have access to the additional details the new form asks for.
• Update any internal guides, templates, or training material so the new form is part of the standard process before 1 September 2026.

Timeline

Questions and support

If anything in this letter is unclear, or if you would like help planning the migration, please contact your usual Maventa partner contact.

Thank you for your cooperation in making the Amili Perintä service better for everyone.

Best regards
Maventa Customer Care