Skip to main content

Invoices

Create itemized invoices, track payments, send them to clients, and share secure public links for online viewing and payment.

billing/invoices.md

Overview

The Invoices module lets you:

  • Create invoices with line items, per-item and overall discounts
  • Track invoice status from draft through paid
  • Publish invoices to make them visible in the client portal
  • Email (and re-email) invoices to clients
  • Record payments and watch the balance update automatically
  • Download or print a PDF of any invoice
  • Generate a secure public share link so clients can view and pay without signing in
  • See a view history of when an invoice was opened

The Billing section in the sidebar (including Invoices) requires the usage-based-billing license feature on your plan. Invoice actions are gated by the invoices permission (read, create, update, delete, plus publish, email, void, and duplicate); recording payments uses a separate invoice payments permission.

Go to BillingInvoices in the left sidebar.

Invoice List

The list shows the following columns:

ColumnDescription
InvoiceInvoice number and the number of line items
ClientThe billed client (links to the client record)
StatusCurrent status badge
TotalInvoice total
PaidAmount paid so far
Due DatePayment due date (shown in red when overdue)

Use the Search invoices... box to search, and the Status dropdown to filter the list. The filter offers All Statuses, Draft, Sent, Viewed, Partial, Paid, Overdue, and Void. Results are paginated 25 per page. If you have a global client filter active, the list is scoped to that client.

Invoice Statuses

StatusDescription
DraftBeing prepared; not yet visible to the client
PublishedFinalized and visible in the client portal
SentDelivered to the client by email
ViewedThe client has opened the invoice
PartialPartially paid (a balance remains)
PaidFully paid
OverduePast the due date with a balance remaining
Cancelled / VoidCancelled invoice; cannot be modified or paid

Creating an Invoice

  1. From the Invoices list, click Create Invoice.
  2. Select the Client (required).
  3. Optionally choose a Bill To Contact. If you leave this blank, the invoice goes to the client's billing or primary contact.
  4. Set the Due Date (required). It defaults to 30 days out.
  5. Add Line Items (at least one is required) — see below.
  6. Optionally apply an overall Discount (percentage or fixed amount) in the sidebar.
  7. Optionally add Notes for the client (payment terms, instructions, etc.).
  8. Click Create Invoice.

A new invoice is created in Draft status and opens on its detail page. You publish or email it as a separate step.

Linking an invoice to a project

When you start an invoice from a project's Create Invoice quick action (on the project detail page), the new-invoice form pre-selects the project's client and shows the Project read-only — the invoice is linked to that project when you save. The project must belong to the same client as the invoice, so changing the Client removes the link. Invoices created directly from the Invoices list have no project link.

You can also generate invoices automatically from recurring billing schedules and convert billable time into invoices. See the Recurring and Time to Invoice pages.

Line Items

Each line item supports:

FieldDescription
ProductOptionally pick a product from your catalog to auto-fill the description and unit price
DescriptionFree-text description of what's being billed
QuantityNumber of units or hours
Unit PricePrice per unit
Discount TypePercentage or Fixed Amount, applied to this line
Discount % / Discount AmountThe per-line discount value
AmountCalculated line total after the per-line discount

Click Add Item to add more lines and the trash icon to remove a line (at least one line must remain).

Invoice Detail Page

The detail page header shows the invoice number, client, and status, along with stat cards for Total, Paid, Balance Due, and Due Date.

Tabs

TabContents
Line ItemsItemized charges with subtotal, tax, discount, and total; plus any notes
PaymentsPayment history (date, method, reference, amount)
View HistoryA log of each time the invoice was viewed, including viewer, type, IP address, browser, and timestamp
  • Bill To — client and (if set) the billing contact
  • Details — invoice number, issue date, due date, and created date
  • Actions — quick access to Download PDF and Preview / Print
  • Share Link — generate, copy, open, or revoke a public link (shown for non-draft, non-void invoices)

Available actions

Which buttons appear depends on the invoice's status:

ActionWhen available
EditAny status except Paid, Void, or Cancelled
PublishDrafts only
Email InvoicePublished/active invoices (not Draft, Paid, Void, or Cancelled)
Record PaymentAny active invoice with a remaining balance (not Draft, Void, or Cancelled)
DeleteDrafts only
VoidActive invoices that are not Draft, Paid, Void, or Cancelled

Publishing and Sending

Ascent separates publishing from emailing:

  • Publish (drafts only) finalizes the invoice and makes it active and visible in the client portal. Publishing can also send an email notification to the client.
  • Email Invoice sends or re-sends the invoice email to the client. You can use it multiple times, for example to send a reminder.

To publish a draft, open it and click Publish.

PDF

From the detail page sidebar:

  • Download PDF saves the invoice as a PDF file named invoice-<number>.pdf.
  • Preview / Print opens the PDF in a new browser tab for viewing or printing.

You can share a secure, unauthenticated link that lets a client view (and, when online payments are configured, pay) an invoice without signing in.

  1. Open a published (non-draft, non-void) invoice.
  2. In the Share Link card, click Generate Share Link.
  3. Use Copy Link to copy the URL, or the globe button to open it in a new tab.
  4. To disable the link, click Revoke Link — any previously shared URL stops working immediately.

The public page shows the invoice details, your organization's branding (name and logo), line items, totals, and recorded payments. If the organization has Stripe online payments configured and a balance remains, a Pay Now button appears so the client can pay the invoice directly from this page.

Recording Payments

  1. Open the invoice and click Record Payment (or Record Payment on the Payments tab).
  2. Enter the Amount (defaults to the full balance due; it cannot exceed the balance).
  3. Choose a Payment Method: Cash, Check, Credit Card, ACH Transfer, Wire Transfer, or Other.
  4. Optionally add a Reference (for example, a check number or transaction ID).
  5. Click Record Payment.

The invoice's paid amount and status update automatically. See the Payments page for the organization-wide payments view.

Voiding and Deleting

  • Void marks an invoice as void with an optional reason. Voided invoices cannot be modified or paid. You cannot void a paid invoice.
  • Delete is available only for drafts and removes the invoice permanently.

Best Practices

  1. Write clear descriptions so clients understand each charge.
  2. Itemize properly rather than lumping everything into one line.
  3. Review before publishing — drafts are private until you publish.
  4. Use the share link for clients who don't log in to the portal.
  5. Follow up on overdue invoices using the Email Invoice action as a reminder.
  6. Void rather than delete any published invoice you need to cancel, to preserve the audit trail.