Search
Product changelog Developer Changelog

Amili Perintä: new transfer form and v2 API

We are improving how invoices are transferred to Amili Perintä, Visma Amili’s reminder and debt collection service for Finnish companies. Both the Maventa user interface and the API are getting an updated transfer experience that captures everything Visma Amili needs to start collection straight away — full debtor details, any co-debtors, what the assignment concerns, and the assignment type (rental, B2C, or B2B).

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 research the missing details or contact the sender, which delays the process and adds manual work on both sides. By capturing the right information up front, cases move forward without unnecessary back-and-forth and collection gets going faster.

What this means for you

In the Maventa UI

A new form for transferring invoices to Amili Perintä is now available from the sent invoice details. You can use either the current form or the new form until 1 September 2026, after which only the new form is available.

What you should do now:

For API integrators

A new v2 endpoint, POST /v2/invoices/{id}/assignment/amili, replaces the current v1 endpoint. The v1 endpoint is deprecated and will be shut down in Summer 2027. Until then, both versions run in parallel. The exact shutdown date will be confirmed at the beginning of 2027 — we recommend starting the migration as early as possible. See the integration guide for parameters and a request body example.

Timeline

Date Who What
24 June 2026 UI users New form available alongside the current form
1 September 2026 UI users New form becomes mandatory; current form removed
Now – Summer 2027 API integrators v1 and v2 run in parallel — migration window
Summer 2027 API integrators v1 assignment endpoint shut down; only v2 accepted

Questions, or would you like help planning the migration? Contact your usual Maventa contact.

Published
Tags
Internal Links
Related Developer Changelogs
Back to top

AI Chat Support 24/7

  • Get help via AI chat available 24/7 whenever it suits you
  • Chat extensively uses Maventa support pages, websites, and blogs in its answers
  • If you need assistance that the AI cannot provide, you can also ask a customer service agent to join the conversation
  • Support requests processed Monday to Friday
Cancel Open chat

Got feedback?

Did you not find what you were looking for? Or was something explained unclearly? Or just want to share your thoughts? We are happy to hear your feedback!

Note: This form is not a way to get support, this is only for feedback for the documentation website. If you need support, please contact Maventa support.

Integration Guide Services & Reach API Specification Changelogs Integration guide Getting Started Invoice sending Consumer Invoicing Printing Email invoicing Invoice receiving Scanning Detect Fraud reporting Webhooks Reference implementations Maventa Connector Embeddable User Interface Peppol Network Document Exchange Invoice Response Self-billing support Invoicing formats Validation Peppol BIS 3.0 Finvoice 3.0 Document types and type codes Maventa JSON (table) Maventa JSON (json schema) Companies and Settings Department Company Users Billing Accounts receivable Ropo's reminder and collection service Amili Kassavirta Amili Perintä Services and reach Maventa services and reach e-invoicing in Finland Mass Printing Service e-invoicing in Sweden e-invoicing in Norway e-invoicing in Denmark e-invoicing in the Netherlands e-invoicing in Belgium e-invoicing in Germany e-invoicing in Estonia e-invoicing in Latvia e-invoicing in Poland e-invoicing in Italy e-invoicing in France e-invoicing in Spain Api specification API overview Getting Started Common & authentication API Invoices API Documents API Companies & settings API Lookups API Detect API Validator API Receivables API Billing API Scanning API B2CFI API B2CNO API B2CSE API Partner API Getting Started Account Configuration API Methods Invoice Sending API Methods Invoice Receiving API Methods B2C Norway API Methods B2C Finland API Methods Other API Methods Changelogs Product changelog Developer Changelog
Clear Send

Enter your credentials to Maventa testing environment, to authenticate and try things out with the Swagger UI. This will fetch a Bearer token using OAuth2 with the endpoint POST https://ax-stage.maventa.com/oauth2/token. The token is stored in your browser's session storage (cleared when you close the tab) and used in Swagger calls done from this documentation website. The token is valid for 1 hour.

Never use your production credentials here. This is only for testing the Maventa test environment in the Swagger UI.
Reset All None
eui global company lookup document:receive document:send invoice:receive invoice:send company:read company:write validate receivables:assignments analysis billing:reports partner:invoice_delivery_actions partner:lookups partner:takeovers partner:lyanthe_scan_service fi_bank_message:send fi_bank_message:receive
Cancel Sign In