Apply Liquidated Damages to an invoice¶
As a member of Accounting Functions, I want to add a Liquidated Damages (LD) charge to an already-saved invoice, so that the penalty is billed correctly and traceable on reports.
Screen: Accounting > Generate Invoices, continuing from an already-saved invoice.
Prerequisite: the invoice must already be saved at least once — the Liquidated Damages button is disabled on an unsaved/in-progress invoice.
Steps¶
- With the saved invoice loaded, click Liquidated Damages.
- In the "Add Liquidated Damages" popup, fill Liquidated Damages Amount (numeric spinner — click, select-all, then type) and Description (both required).
- Click Save inside the popup.
The LD charge doesn't show up where you'd expect it to
The invoice's running total updates (a small "Amount: $X" badge next to the button, and the overall Total Amount), but no new row appears in the main member grid on this screen. The charge only becomes visible on reports — see Reconcile an invoice discrepancy report and the Journal Entry by GL Code report — or on the rendered/printed invoice itself.
Things to watch out for¶
The LD line must never show when LD is zero
This took multiple rounds of fixes to get right across the invoice footer and the LD line itself (IUOE-2818, IUOE-2820) — the rule to actually teach is "the LD line should never appear at all when LD = 0," not each individual symptom that surfaced while chasing it down.
The invoice footer text is hardcoded per fund
Despite the FDD implying a config entity should drive it, the footer wording is hardcoded per fund today. A future wording change needs a deploy, not a config edit — set that expectation with anyone asking for a footer tweak.
A GL Code reporting gap exists for LD amounts
The LD Change Order (CO 4073/1899 — add/remove/stand-alone LD invoice lines) is fully delivered, but surfaced a separate reporting gap: LD amounts don't appear on the GL Code journal report, tracked as its own follow-on ticket rather than fixed as part of this workflow. Don't expect the GL Code report to reconcile an LD charge until that's resolved. (IUOE-2617)