Amili Perintä is introducing a new v2 endpoint for transferring invoices to the reminder and debt collection process. The v2 endpoint captures structured debtor, co-debtor, assignment subject, and assignment type information up front, so Visma Amili can start collection without manual follow-up for missing details.
Endpoints
-
Current (v1, deprecated):
POST /v1/invoices/{id}/assignment -
New (v2):
POST /v2/invoices/{id}/assignment/amili
The v2 request body adds structured fields: collection_type, receivables_type (b2b, b2c, b2b_rental, or b2c_rental), amounts (capital_amount and reminder_amount), payers (main debtor and any co-debtors with full address details), assignment_summary, and reminder_date. Check the transfer status with GET /v2/invoices/{id}/assignment.
Action required
The v1 endpoint is deprecated and will be shut down in Summer 2027. Migrate your integration to the v2 endpoint before then. Until the shutdown, v1 and v2 run in parallel. The exact shutdown date will be confirmed at the beginning of 2027 — we recommend migrating as early as possible.
See the Amili Perintä integration guide for the full parameter reference and a request body example.