FinanceQuotations

Quotations

A quotation in Novex is a priced proposal you send to a client before they commit. Cost lines, VAT, discount, validity date, terms — all on one document. On acceptance, one click converts it to an ACTUAL invoice.

Create a quotation

  1. From the event’s left nav, click Quotations → + New quotation.
  2. Pick a client — pre-filled if the event already has one attached.
  3. Set the validity date (default 30 days) — the public portal page locks acceptance after this date.
  4. Choose the language (en / ar-SA) — the PDF renders in that language.
  5. Save the empty quotation — you’re on the detail page, ready to add lines.

Add cost lines

Each line has:

  • Description (free text, required)
  • Category — Venue, AV / Production, Catering, Transport, Hospitality, … (pick “Other” + a free-text name for anything not in the list)
  • Vendor — searchable dropdown of your tenant vendors; “Create new vendor” inline creates a stub
  • Quantity / Unit price / VAT % — feed into the line total
  • Internal cost (Finance role only) — your cost per unit, never shown to the client. Drives margin reporting.

The page recomputes subtotal, VAT, and grand total live as you add lines.

Discount

The discount input accepts amount or percent via the toggle next to the field. Percent is resolved against the subtotal at submit time and stored as the absolute SAR amount; the percent value is preserved in the audit log.

Status flow

StatusAction that moves it
DRAFTInitial state. Edit freely.
PENDING_APPROVAL”Submit for approval” — internal review by another team member with the quotes.approve permission.
APPROVEDCleared internally; ready to send.
SENTSent to the client via email + a magic-link portal page.
VIEWEDClient opened the portal page (automatic timestamp).
ACCEPTEDClient clicked “Accept” on the portal OR an operator manually marked it accepted.
DECLINEDClient clicked “Decline”.
EXPIREDValidity date passed without acceptance.

Send to client

When the quote is APPROVED, click Send. Novex emails the client a magic link to a portal page. The link is tenant-scoped, single-use after acceptance, and expires on the validity date. The portal page renders the quotation, the itemised cost lines, the totals, and the Accept / Decline buttons.

Convert to invoice

Once a quotation reaches APPROVED, SENT, VIEWED, or ACCEPTED, the detail page exposes Build invoice from this quote. One click creates an ACTUAL invoice that:

  • Copies every quote cost line into a new invoice line.
  • Carries the discount and VAT logic forward unchanged.
  • Back-links to the quotation (you can navigate either direction).

The conversion is idempotent — clicking twice does not create a duplicate invoice; the second click navigates to the existing one.

Permissions

ActionRole required
Create / editquotes.write (Sales, Admin)
Submit for approvalquotes.write
Approvequotes.approve (Admin, Ops Lead)
Sendquotes.send (Sales, Admin)
Mark acceptedquotes.win (Sales, Admin)
Convert to invoicequotes.win

Next