Skip to main content

Detach line items from invoices and credit notes

Release a fee from its billing document, so that a bill run or a manual invoice can bill the fee again.

Written by Yasen Marinov

➤ Product: OfficeRnD Flex
➤ Who: Admins

➤ Where: Admin Portal, under Billing > Invoices
➤ Availability: All Flex plans

A voided invoice cancels what the member owes, but its line items stay linked to the voided invoice. No bill run bills those line items again until you detach them. When you detach a line item, Flex removes the link and marks the line item as not invoiced.

You can detach line items from credit notes and from any invoice: paid, unpaid, or voided. A detach changes no amounts, so to change what a member owes, void the invoice or create a credit note.


In this article:


Before you begin

The fee, booking, or membership behind each line item must still exist, because Flex bills the line item again from that fee, booking, or membership. Admins see the Detach button only if their admin role has the Detach permission. To give an admin role this permission:

  1. Edit the admin role.

  2. Open the Billing tab.

  3. For Invoices, select the Detach permission.


How detaching line items works

A line item is 1 billed entry on an invoice or a credit note, such as a membership fee, a booking fee, or a one-off fee. Each line item stays linked to its document. A void does not remove that link, so a bill run skips each line item on a voided invoice. A detach changes these things:

What

After you detach a line item

The line item

Flex marks the line item as not invoiced. The next bill run includes the line item if its date falls in the billing cycle.

The fee behind the line item

The fee shows as Not Paid.

The invoice total

The total does not change, so the member still owes the full amount on an invoice that is not voided.

The document status

The invoice or credit note keeps its status. A detach does not void the document.

The link to the document

The link is removed permanently. You cannot attach the line item to the document again.

A line item on a credit note

Flex also marks the line item as not invoiced. If you take no action, the next bill run invoices and charges the fee automatically.


Void the invoice before you detach line items

To bill a line item again, void the invoice first and detach the line item second. A void cancels the amount that the member owes on the invoice. If you detach a line item from an invoice that is not voided, the member still owes the full total. The next bill run then invoices the line item a second time.

For example, a bill run creates invoices with the wrong due date. You void the invoices, detach their line items, and run the bill run again with the correct due date.

If the member already paid the invoice, create a credit note instead of a void and a detach. The credit note keeps the original invoice and records the correction.

Important: Detach line items only from voided invoices. On a live invoice, detaching does nothing to the balance, so the member still owes the original total. Meanwhile, the detached line item counts as uninvoiced, and the next bill run puts it on a second invoice. The member now has two invoices for the same item and owes the money twice; the only way out is to void one of them and start the correction over.


Detach line items from a document

At this point the invoice is voided, so the member owes nothing on it, and the document is closed as far as your accounting is concerned. The only thing still unresolved is the line items sitting on it, because each one is marked as invoiced against a document that will never be paid. Detaching is what clears that mark.

You detach line items on the invoice page or the credit note page, and you choose which line items to detach.

  1. Go to Billing > Invoices and open an invoice or a credit note.

  2. Click Detach. The Detach button is located at the top-left of the invoice.

  3. Review the line items and select the ones you want to detach.

  4. Click Detach to confirm. The voided invoice remains void and retains its original line items. The line items you selected are now uninvoiced.

The document keeps its status and still shows the detached line items.


Bill the detached line items again

A detached line item stays not invoiced until a bill run or a manual invoice bills it. If the price or dates are wrong, edit the fee, booking, or membership behind the line item before the next bill run. The next bill run includes each detached line item whose date falls in the billing cycle. To bill a line item sooner, or on a date that you choose, create a manual invoice.

Preview the bill run before you generate it, so that you can check each detached line item before Flex charges it.

Note: With Automated Billing enabled, you may not need to do anything else. The next scheduled bill run treats the detached line items as unbilled and creates a new invoice for them. Create a manual invoice instead if you want the line items billed sooner than the next scheduled run, or on a specific date.


Best practices

Almost every problem with detaching comes from doing it in the wrong order, or from leaving part of the job unfinished. These situations cover most of what comes up:

  • If you plan to void an invoice and bill its line items again, void it first, then detach the items.

  • If the member has already paid the invoice, issue a credit note instead of voiding and detaching. Voiding a paid invoice leaves a payment recorded against a canceled document, which your accounting has to unpick by hand. A credit note keeps the original invoice intact and properly records the offset. Record a refund with a credit note →

  • If your finance team reviews invoices monthly, add a comment on the invoice or the member profile explaining why the line items were detached. A detach leaves the member with a voided invoice and a later invoice covering the same period, which can look like a billing error to anyone reviewing the account without that context.

  • Detached line items remain visible in the Data Hub until the original invoice is voided.

  • For partially paid invoices, detach specific line items, re-invoice them, and apply a credit note to the new invoice to adjust the balance. This is particularly useful for scenarios like F&B charges.


FAQs

Can I lower an invoice total by detaching a line item?
You cannot lower an invoice total with a detach. A detach changes only the billing status of the line item, and the invoice keeps the same total. To lower the amount that the member owes, create a credit note for the line item. If the member did not pay the invoice, you can also void the invoice.

Why does my bill run skip the line items from an invoice that I voided?
A bill run skips these line items because they are still linked to the voided invoice. A void cancels the amount that the member owes, but it does not remove the link. Detach the line items, and the next bill run includes them.

Can I delete an unpaid invoice instead of a void and a detach?
You can delete an invoice that is not paid or credited. When you delete the invoice, Flex returns all its line items to pending, so no detach is necessary. Deleting removes the invoice from your records and leaves a gap in the invoice number sequence. For an audit trail, void the invoice instead.

Can I edit an invoiced booking after I detach its booking fee?
After you detach the booking fee from its invoice, you can edit the price fields of the booking. The steps that keep the invoice correct depend on the invoice status. Edit or cancel invoiced or waived bookings →

Why can’t I see the Detach button?
You see the Detach button only if your admin role has the Detach permission. An admin who can edit admin roles can add this permission on the Billing tab of the admin role, for Invoices.

Did this answer your question?