> ## Documentation Index
> Fetch the complete documentation index at: https://wiki.distribution-os.ch/llms.txt
> Use this file to discover all available pages before exploring further.

# Record and review payments

> Use To collect on the Invoices page to see what is open, import a camt.054 bank file, confirm which invoices a payment covers, and mark or unmark it paid.

Payments from cinemas are handled on the **Invoices** page, in the **To collect** tab and on each invoice's **Payments** tab. This page shows how to see what is still open, bring in a bank file, and record a payment by hand.

## Before you start

* Recording or reversing a payment needs edit access to **Invoices**. Without it you can see payments but not record one.
* A payment can be recorded once the invoice is issued, with status **Invoiced** or **Sent**.
* **Settings → Invoicing** holds the **Payment tolerance (CHF)**: a payment short of an invoice by no more than this closes it, and the difference is noted.

## See what is still to collect

Open **Invoices**, then **To collect**. The cards at the top show **Still to collect**, **Overdue**, **Due in 7 days** and **Bank credits to look at**. Click one to filter the list.

The **Open invoices** list has the columns **Invoice**, **Due**, **Total**, **Received**, **Open**, **Payment reference** and **Bank**. Filters are **All open**, **Overdue**, **Due in 7 days**, **Part payments** and **Bank credit waiting**. A badge shows how many days late an invoice is, or how soon it is due. An older invoice without a stored total is listed without an amount and is left out of the totals.

The **Due** date is the one printed on the invoice. For older invoices it is the invoice date plus the payment terms, and the card says so.

## Import a bank file

**1. Click Import bank file**

In **To collect**, click **Import bank file**. You can also use **Bank file** in the **More** menu of the **Invoices** tab. Choose a camt.054 file (XML) or a bank statement CSV.

**2. Let DOS apply what is clear**

For a camt.054 file, DOS pays an invoice by itself only when the payment reference points to exactly one issued CHF invoice and the amount fits the open amount plus the tolerance. DOS then shows how many were "paid by their payment reference", how many are "waiting for you", and how many were "kept on hold" or "already imported".

**3. Review the rest**

Everything else opens in the **Bank payments** window. DOS proposes invoices, looking first at the payment reference, then at the amount and at who paid. A bank statement CSV has no reference, so you always review it. One payment can cover several invoices. Nothing is paid until you confirm.

**4. Confirm**

Tick the payments to include, choose another invoice if the proposal is wrong, and click **Confirm ... invoices paid**.

Credits that DOS could not tie to one invoice wait under **Bank credits without an invoice**. Click **Find invoice...** to see proposals, or **Dismiss** a credit that is not an invoice payment, such as a refund. The **Bank payments** view lists the latest 500 credits with their status, and **Connect...** opens the same review window.

## Mark an invoice paid by hand

**1. Open the Payments tab**

Open the invoice and go to **Payments**. In **To collect** you can also click **Mark paid...** on the row.

**2. Click Mark paid...**

Fill in **Date the money arrived** and **Amount received (CHF)**. Pick **How**: **Bank transfer**, **Cash**, **Set off against another invoice** or **Other**. A **Note (optional)** is allowed.

**3. Read the outcome line**

DOS says **Closes the invoice.**, **Part payment.** with the amount that stays open, or **More than is open.** In the last case, enter the open amount and add a note.

**4. Click Mark as paid**

The invoice reads **Paid**, or **Part payment** if money is still open.

## Undo a payment

* **Unmark paid...** takes a paid invoice back to **Invoiced**. It needs a reason of at least a few characters. The payment stays on the invoice marked as reversed, and a bank credit that paid it becomes free to assign again. This is written to the Logs.
* **Reverse payment** on a single payment works the same way and also needs a reason.

## If something looks wrong

> [accordion] I cannot mark an invoice paid
>
> The card gives the reason. For example: "A payment can be recorded once the invoice is issued (status Invoiced).", "This invoice is already paid.", "This invoice was replaced by a newer one." or "Historical invoices are read-only."

> [accordion] The bank file was refused
>
> DOS says "Not a camt.054 file (a payment notification was expected)." or that the file is larger than 2 MB. Split large files and import the parts.

## Related

* [Understand invoice statuses](https://wiki.distribution-os.ch/invoices/invoice-statuses.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.