Octibiz
Demo

Durchsucht Website und Dokumentation gemeinsam. Enter zeigt alle Treffer, Esc schließt.

Billing

Billing screen in Octibiz

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

FieldRequiredValues / formatWhat it does
Customer customerIdyesan existing customerWho is billed.
Amount amountAmountyesamount, 0 or moreWhat is charged per period.
Cycle cycleyesmonthly, quarterly, yearlyHow often.
Run mode runModenoFor review (default) or Fully automaticWhat 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 anchorDayno1 to 31The 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 contractIdnoan existing contractWhich contract stands behind it.
Article productIdnoan existing articleWhat is charged.
Brand brandIdnoone of your brandsUnder which brand.
Price adjustment note priceIndexNotenotext, max. 255 charactersWhat 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

FieldValues / formatWhat it does
Text descriptionrequired; text, max. 500 charactersHow the line appears on the invoice.
Quantity qtyrequired; greater than 0, at most four decimal placesTogether with the unit price the line total (rounded to the cent). Reduced = goodwill, see above.
Unit unittext, max. 50 characters; only when addingShown after the quantity.
Unit price unitPriceAmountrequired; amount, negative for a discountPrice per unit.
Tax rate taxRateIdrate from the catalogue, default the standard rate; only when addingThe customer's tax treatment (tax-exempt, reverse charge) applies as for every other line.

Settings & permissions

  • Module module.finance.
  • finance.billing.view for previews, finance.recurring.manage for 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 (itemUlid and 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.

billing.billing · Available from version 0.5.0