---
title: "Settle a credit note against open invoices (Verrechnung)"
method: POST
path: "/invoices/{id}/credit-allocations"
tags: ["Invoices"]
---

# Settle a credit note against open invoices (Verrechnung)

`POST /invoices/{id}/credit-allocations`

## Request

- Base URL: `https://api.lumabill.ch/v1`
- URL: `https://api.lumabill.ch/v1/invoices/{id}/credit-allocations`
- Auth: HTTP bearer

`{id}` is an issued credit note. Each allocation sets part of its credit off against an issued invoice of the same client and currency. No money moves and no journal entry is posted (the receivable already nets out); both documents' payment status is recomputed. An omitted amount takes as much as both sides allow, in list order. The date must lie in an open fiscal year.

## Request body

- object
  - `allocations` object[], required
    - `invoiceId` string, uuid, required
    - `amount` number
  - `date` string, date

## Response `201`

Settled

- object
  - `allocations` CreditAllocation[]
    - `id` string, uuid
    - `creditNoteId` string, uuid
    - `creditNoteNumber` string
    - `invoiceId` string, uuid
    - `invoiceNumber` string
    - `amount` number
    - `date` string, date
  - `creditRemaining` number

## Other responses

- `400`: Validation error
- `404`: Resource not found

---

[API](https://skmtc.dev/lumabill/apis/lumabill-api.md) · [All operations](https://skmtc.dev/lumabill/apis/lumabill-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lumabill/apis/lumabill-api/revisions/e48e7099b545?raw)