Billing

Overview
Billing produces previews, not invoices: what could be invoiced right now?
Two sources feed it — approved time from time tracking and due plans from recurring billing. The emphasis is on approved: time that has not been approved does not appear, and that is why a billing preview sometimes comes out smaller than expected.
Core tasks
Review the preview. What time and plans would make billable, before invoicing.
Bill from a project or contract. Bill on the project or contract builds the customer's usual preview for a period (default: last month). The lines of this project or contract are preselected; what you deselect drops out of the preview and stays open for a later billing. After that you continue in the preview as usual.
Adjust lines. As long as the preview is a draft, every line can be corrected: the pencil icon opens Adjust line for text, quantity and unit price, Add line above the table adds a free line (for instance travel expenses, or a discount with a negative price), and the bin icon removes a line after a confirmation. The line and the totals are recalculated at once. Adjusted and added lines are marked (adjusted) and stay in place when the preview is rebuilt; the same work then does not appear a second time. Deposit and final lines are changed in the deposit schedule, not here. After Mark as ready the preview is fixed — to change it, use Reopen for editing first.
Reduce or remove — the difference. A reduced quantity or a lower price counts as a goodwill reduction: the times or usage behind the line still count as billed at handover and do not come back. If the work is to be billed later, remove the line instead — it then stays open and appears in the next preview.
Run recurring plans. Plans arise from licences, contracts and retainers — the three sources of regular revenue. A plan states what falls due when.
Hand over to invoicing. From the preview comes the invoice — where it is finalised and thereby becomes a document.
Fields in detail
Billing plan
| Field | Required | Values / format | What it does |
|---|---|---|---|
Customer customerId | yes | an existing customer | Who is billed. |
Amount amountAmount | yes | amount, 0 or more | What is charged per period. |
Cycle cycle | yes | monthly, quarterly, yearly | How often. |
Run mode runMode | no | For review (default) or Fully automatic | What happens when the plan falls due: For review creates a preview that someone checks and releases; Fully automatic hands the preview over to its target with no intermediate step. |
Anchor day anchorDay | no | 1 to 31 | The day of the month. Careful with 29 to 31: in shorter months the run moves to the last day — unlike the recurring invoice, which caps at 28 for that reason. |
Contract contractId | no | an existing contract | Which contract stands behind it. |
Article productId | no | an existing article | What is charged. |
Brand brandId | no | one of your brands | Under which brand. |
Price adjustment note priceIndexNote | no | text, max. 255 characters | What an adjustment rests on. On an increase this is the sentence the customer gets to read — a wording that can stand up in a mail pays off here. |
Preview
The preview shows before the run what would be created: per customer the items, the amounts and what comes in from quotas and contracts. It is not decoration — it is the only chance to notice a wrong bill before it reaches the customer.
Adjust or add a line
| Field | Values / format | What it does |
|---|---|---|
Text description | required; text, max. 500 characters | How the line appears on the invoice. |
Quantity qty | required; greater than 0, at most four decimal places | Together with the unit price the line total (rounded to the cent). Reduced = goodwill, see above. |
Unit unit | text, max. 50 characters; only when adding | Shown after the quantity. |
Unit price unitPriceAmount | required; amount, negative for a discount | Price per unit. |
Tax rate taxRateId | rate from the catalogue, default the standard rate; only when adding | The customer's tax treatment (tax-exempt, reverse charge) applies as for every other line. |
Settings & permissions
- Module
module.finance. finance.billing.viewfor previews,finance.recurring.managefor plans and to adjust,
release and reopen previews — in the preview's brand, finance.lexoffice.sync for reconciliation with bookkeeping.
- API:
POST /api/v1/billing-previews/{ulid}/update-item(itemUlidand the fields to
change), …/add-item (description, qty, unitPriceAmount, optionally unit, taxRate or taxRateId), …/remove-items (itemUlids) — each only on a draft.
- Only approved time counts, see Timesheets.
- Billing does not invoice. It prepares.
FAQ & troubleshooting
The preview is empty. Then no time is approved and no plans are due.
A service is missing. Check whether the time is billable and approved — both are required.
A plan keeps running although the contract ended. Check the end date on the contract or the licence.
"Lines can only be changed, added or removed in a draft preview." The preview is already marked as ready. Reopen for editing brings it back to draft.
I reduced the quantity — why is the time still billed? Reducing is goodwill: the work counts as done with the handover. To bill it later, remove the line instead of reducing it.
Where does the invoice arise? In invoicing — only the preview arises here.