---
title: "Deprecated the v1 Amili Perintä assignment endpoint in favour of POST /v2/invoices/{id}/assignment/amili"
canonical: https://documentation.maventa.com/changelogs/developer-changelog/2026-06-24-amili-perinta-moves-to-v2-assignment-endpoint/
---

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`](https://swagger.maventa.com/?urls.primaryName=STAGE+-+AutoXChange+API#/invoices/postV1InvoicesIdAssignment)
- **New (v2):** [`POST /v2/invoices/{id}/assignment/amili`](https://swagger.maventa.com/?urls.primaryName=STAGE+-+AutoXChange+API#/invoices/postV2InvoicesIdAssignmentAmili)

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`](https://swagger.maventa.com/?urls.primaryName=STAGE+-+AutoXChange+API#/invoices/getV2InvoicesIdAssignment).

## 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](https://documentation.maventa.com/integration-guide/accounts-receivable/amili-perinta/) for the full parameter reference and a request body example.