DE/EN/PT

Finance

Invoices

Invoices are payment requests sent to your members. They group one or more transactions into a single document with a due date, making it clear what a member owes and when payment is expected. Omoplata generates invoices automatically when membership charges are created, but you can also manage them manually when needed.


How invoices are generated

Automatic generation

When Omoplata creates transactions from active memberships, an invoice is generated at the same time. Each invoice bundles the transactions for a given payer and includes:

  • A unique invoice ID with a prefix (for example, INV-1000042).
  • A title built from the titles of all included transactions, joined with a + sign.
  • The total amount (net, VAT, and gross).
  • A due date calculated from the charge date plus a grace period.
  • Line items corresponding to each transaction on the invoice.

The invoice title is limited to 140 characters because SEPA remittance information has this maximum length.

Invoice due dates

The due date is calculated by adding your configured grace period to the charge date. This gives members a few extra days to pay. If the calculated date would be less than one day in the future, Omoplata sets it to tomorrow to ensure a reasonable payment window. You can adjust the grace period in Settings > Billing.

Zero-amount invoices

If a membership charge results in a zero-amount invoice (for example, a free trial period), the invoice is automatically marked as paid and its transactions are completed. No action is required from you or the member.


Invoice statuses

Invoices follow a defined lifecycle. The current status determines what actions are available and what happens to the related transactions.

StatusMeaning
PendingNewly created, awaiting processing or payment.
ProcessingBeing prepared for invoicing (legacy status, kept for backward compatibility).
Waiting to sendIncluded in a SEPA XML file that has been generated but not yet uploaded to the bank.
Sent to bankIncluded in a SEPA XML file that has been uploaded to the bank for collection.
On holdTemporarily paused. Useful when you need to investigate an issue before collecting.
Pending retryA previous collection attempt failed. The invoice is queued for another attempt.
OverdueThe due date has passed without payment.
PaidNothing is left open. Omoplata sets this on its own once payments cover the full amount.
CanceledThe invoice will not be collected. Can be reactivated by setting back to pending.
RefundedWas paid but later refunded to the member.
VoidPermanently voided. Unlike canceled, a voided invoice cannot be reactivated under normal circumstances.

There is no separate status for an invoice that is paid in part. It keeps its status (for example pending or overdue) and is shown as Partially paid until nothing is open -- see Partial payments.

Status side effects

When you change an invoice's status, Omoplata automatically updates the related transactions to keep everything in sync:

StatusDescription
Paidtransactions become completed and whatever is still open is recorded as one payment.
Pendingtransactions revert to invoiced. Setting a paid invoice back to pending by hand cancels its payments.
Canceledtransactions are marked as canceled.
Refundedtransactions are marked as refunded.
Overduetransactions are marked as overdue.
Pending retrytransactions are marked as failed so they can be retried.
On holdtransactions stay as invoiced but the invoice is paused.
Voidtransactions are marked as void.

The SEPA payment workflow

When your club uses SEPA direct debit, invoices follow a specific path through the system:

  1. Pending -- the invoice is created and waiting for the next SEPA batch.
  2. Waiting to send -- a SEPA XML file has been generated that includes this invoice.
  3. Sent to bank -- the SEPA file has been uploaded to the bank.
  4. Paid -- the bank has processed the debit successfully, or the automatic fallback has confirmed payment after a waiting period.

The direct debit always collects the invoice's open amount, so a part-paid invoice is only debited for what it still owes.

If a SEPA file is deleted before being uploaded, any invoices in "waiting to send" status are automatically reverted to pending.


Viewing and managing invoices

Navigate to Finance > Invoices to see all invoices. The list shows each invoice's ID, member name, amount, due date, and status. You can search by invoice ID, member name, or description. The Partially paid view lists every open invoice that has received part of its amount.

Changing invoice status

Select an invoice to see its details and available actions. The status dropdown shows only the transitions that are valid from the current state. System-managed statuses (waiting to send, sent to bank, processing) cannot be set manually -- they are controlled by the SEPA workflow.

Payment attempts

When an invoice goes through multiple collection attempts (for example, after a SEPA return), its ID is suffixed with a counter: INV-1000042-1, INV-1000042-2, and so on. This makes it easy to see how many times collection has been attempted.

If a SEPA debit is returned unpaid, the member may be charged an additional fee. The fee amount is configured in Settings > Billing.


Partial payments

An invoice can be paid in parts. Every invoice tracks what has been paid and what is still open, and it becomes Paid on its own once nothing is open. Reminders, direct debits and collection hand-overs always ask for the open amount, never the full total again.

How a part payment arrives

WayWhat happens
Bank transferWhen you upload a bank statement under Finance > Bank transactions, transfers are compared with each invoice's open amount. If a member identified by their IBAN sends less than their oldest open invoice, Omoplata suggests the transfer as a Part payment. It is never confirmed automatically -- you confirm it.
Recorded by handCash, a transfer you checked yourself, or money the collection agency passed on: record it in the invoice -- see Recording a payment.
Direct debit, card and PixSEPA direct debits, card charges and Pix charges collect the open amount.

One transfer can be split across several invoices. It never covers more than an invoice's open amount or more than the transfer brought in; what is left stays visible on the bank transaction as Unallocated and is never credited to a member.

Recording a payment

  1. Open the invoice from Finance > Invoices.
  2. In the Payments section, click Record payment.
  3. Enter the Amount (prefilled with what is still open), choose Paid by (Bank transfer, Cash, Collection agency or Other), set Paid on and add an optional Note, such as a receipt number.
  4. Click Save payment.

The amount can be anything above zero up to what is still open. When it covers the rest, the invoice is marked as paid.

To link a bank transfer instead, use Link bank transaction in the same invoice. Amount to allocate is optional: left empty, it takes what is still open, up to what the transfer has left.

When you cannot record a payment

Omoplata refuses a payment while the invoice is in a SEPA file that has not been sent yet (take it out of the file first), while a card or online charge for it is still being processed, and on invoices that are paid, canceled, refunded or void. While a direct debit is with the bank, only the full open amount can be recorded. Payments also cannot be undone during a SEPA collection.

  • Invoice list -- a line such as "€30.00 open" under the amount of a part-paid invoice, and the Partially paid view.
  • Invoice details -- a Partially paid badge, Paid and Open under the total, and every payment with its source, date and amount. Reversed payments stay in the list, struck through.
  • Member profile -- in Billing, part-paid invoices show the open amount under the total, and each payment shows its source, amount and date.
  • Invoice PDF -- Paid and Amount due rows under the total.

When a payment is taken back

If a payment is returned -- a SEPA return, a card dispute or a refund -- it stays on the invoice as reversed and no longer counts. A paid invoice then reopens as pending, or overdue if its due date has passed. A SEPA return only reverses the direct debit: transfers and cash already on the invoice keep counting, so the retry collects just the returned amount (plus any return fee).

When you remove a bank transaction match from an invoice, you choose between Remove match, keep invoice paid (the amount is kept as a manual payment) and Remove match, revert to pending (the payment is canceled).


Downloading invoice PDFs

You can download a PDF version of any invoice. In the member portal, members can also download their own invoices from the billing section. The download link appears next to the invoice amount wherever invoices are displayed.


Invoice statistics

At the top of the invoices page, a summary widget shows the key figures for the current month:

MetricMeaning
Total duethe total amount of all invoices due this month.
Paidthe amount already received on this month's invoices, including part payments.
Outstandingthe amount still open on this month's invoices.
Countthe total number of invoices for the month.

These statistics are updated periodically throughout the day.


Invoices in the member portal

Members can view their own billing history in the self-service portal. The portal billing page shows the five most recent transactions from the payer, with each entry displaying the description, formatted amount, and transaction date. If an invoice exists for a transaction, a download link is shown so the member can retrieve the PDF directly.

Was this page helpful?

Previous
Transactions