The invoice lifecycle
1
Draft
A new invoice starts as a draft — visible only to your team, no email sent, no due date enforced. Iterate until it’s right.
2
Sent
Click Send and the client receives an email with a link to view and pay the invoice online. The status flips to
sent and the due-date clock starts ticking.3
Paid
A card payment from the invoice’s pay page or the client portal marks the invoice paid straight away. If the client paid by check or wire, record it with Collect payment → Record a payment and add the reference for the audit trail.
4
Overdue
An invoice past its due date with a balance owing. Hiveku emails the client payment reminders while the invoice’s Send automatic payment reminders setting is on (it is by default).
5
Void
Voiding cancels the invoice without deleting it. Used for billing errors or canceled work — historical record stays, but the balance no longer counts toward AR.
Creating an invoice
- From scratch
- From an estimate
- From a subscription
- From a schedule
Click New Invoice, pick a client (CRM contact or company), and start adding line items. The most common path.
Line items
Each line item has:- Product reference (optional) — pulls name, description, price, and tax flag from your Products catalog
- Description — overridable per line; what the client sees
- Quantity — defaults to 1
- Unit price — override the catalog price for this client
- Discount — percentage or fixed amount, per line
- Tax — applied if the line is taxable and the client isn’t tax-exempt
Tax handling
Tax rates come from your account settings (per-jurisdiction) and apply to taxable line items at send time.- Tax-exempt clients — Set the flag on the contact or company. Their invoices skip tax automatically and surface the exemption in the PDF.
- Per-jurisdiction rates — Configure separate rates for the regions you sell in. The invoice picks the right rate based on the client’s billing address.
- Multi-rate invoices — A single invoice can mix tax rates if line items are flagged differently (rare, but supported).
Discounts
The Discount field under Subtotal takes a fixed amount off the whole invoice, before tax. There’s no per-line or percentage discount; to discount one item, lower its price on the line.Payment terms
Pick from Due upon receipt, Net 7, Net 15, Net 30, Net 45 or Net 60. Net terms make the invoice due that many days after its invoice date; Due upon receipt makes it due the day the client gets it. Overdue reminders count from the due date: see Find and Chase Overdue Invoices.Sending the invoice
When you click Send, three things happen:- The invoice transitions from
drafttosent. - An email goes to the client with a View and pay online button that opens the invoice’s pay page.
- A PDF is generated and attached to the email by default (and stored against the invoice for download later).
Marking paid
- Auto (online payment)
- Manual (check, wire, ACH outside processor)
- Partial payment
A card payment from the pay page or the client portal records the payment on the invoice and marks it paid the moment it goes through. No manual step needed. If the invoice sends receipts (the default), the client is emailed one.
Reconciliation
Online payments are recorded against the invoice when the client pays, so there’s nothing to match by hand. Your processor’s webhooks also bring in refunds or voids made in the processor’s own dashboard. For money that arrives outside Hiveku, use Record a payment.Charging a saved card
When a client has a card on file, open the invoice and choose Collect payment → Charge card on file, pick the card, and click Charge. It charges the full balance due. Clients save cards in the client portal; if they haven’t, send them a card-update link (Send card update link on their contact record).Automatic charges
Some invoices charge a saved card by themselves: subscription renewals, and invoices from a recurring schedule or installment plan that is set to charge a card. When the charge is set for the due date, the invoice page shows which card will be charged and when, and the invoice email tells the client too (its button then reads View invoice). To stop it, click Don’t charge automatically on the invoice. If an automatic charge is declined, the invoice stays open and Hiveku tries the card again 3 days later, then 7 days after that. If the card still fails, the invoice is marked Uncollectible 14 days after the last try. Meanwhile, the invoice page shows the decline, and you can collect sooner with Charge card on file or Send card update link; if a retry is still to come when the client saves a new card, the retry uses it. For renewals, see Subscriptions.PDFs and customization
Every invoice has a downloadable PDF that uses your account’s invoice template — logo, colors, footer text, payment instructions. To customize:- Logo and colors: Set in account settings; applies to all invoices and the client portal.
- Footer / payment instructions: Free-text block on each invoice or default for the account.
- Invoice templates: Under Invoices, Templates, save invoices you send often (their lines and payment terms), set one as the default, and click Customize design to change its layout.
Recurring invoices
Two ways to bill on a recurring cadence:- Subscriptions — Best for ongoing retainers and SaaS plans. Handles plan changes and MRR roll-up.
- Schedules (Commerce → Schedules) — Best for milestone billing or fixed-date charges that aren’t a true subscription (e.g., quarterly check-in fees).
- Turn into subscription — Puts the client on a plan, with this invoice as the first period, so billing starts at the first renewal.
- Make recurring — Repeats this invoice’s own lines, discount, and tax on a schedule, optionally charging a saved card. The invoice counts as the first run. These repeating invoices are listed under Recurring invoices in the Commerce menu.
Bulk operations
From the invoice list:- Bulk void — Tick several invoices and void them together with Void selected. Invoices that already have a payment are skipped.
- Export CSV — Download the invoices in your current view, with its filters, as a CSV for your accountant.
API patterns
Common API operations against/api/crm/invoices:
POST /api/crm/invoices— create a draftPOST /api/crm/invoices/:id/send— transition to sent and email the clientPOST /api/crm/invoices/:id/record-payment— record a manual paymentPOST /api/crm/invoices/:id/void— void an invoiceGET /api/crm/invoices?aging=1-30— list open invoices 1–30 days past due (also31-60,61-90,90%2Bfor more than 90 days, orcurrentfor ones not yet due)
Troubleshooting
Client says they never got the invoice email
Client says they never got the invoice email
Check the invoice’s activity log — you’ll see whether the email was sent and whether it bounced. Common causes: the client’s billing-contact email is wrong, the email landed in spam (have them search for your domain), or your sending domain isn’t verified — see Email Domains.
Payment went through but the invoice isn't marked paid
Payment went through but the invoice isn't marked paid
Online payments mark the invoice paid as soon as they go through. When one doesn’t, the processor’s answer usually never arrived, so Hiveku can’t tell whether the card was charged. The client is told the payment is being confirmed and not to pay again, and shortly after, the invoice shows On hold for review; nobody can pay it online until you act. Check the charge in your processor: if it went through, record it with Record a payment and put the transaction ID in the reference (this also lifts the hold); if it didn’t, click Release hold. For automatic charges, Commerce → Settings → Defaults → Unconfirmed charges decides whether Hiveku first re-sends the same charge (your processor refuses a true duplicate) or holds the invoice straight away. If the client paid in your processor’s own dashboard instead of through Hiveku, record that payment the same way.
Tax is wrong on the PDF
Tax is wrong on the PDF
Three things to check: the line items’ taxable flag, the client’s tax-exempt flag, and the configured tax rate for the client’s billing jurisdiction. Edit the draft, fix whichever is off, and re-send.
Invoice number skipped a value
Invoice number skipped a value
Voided invoices keep their number, so you’ll see gaps in the sequence — that’s expected and audit-friendly. Don’t try to renumber; auditors prefer to see the void.
Overdue reminders aren't going out
Overdue reminders aren't going out
Check that the invoice’s due date has passed, it still has a balance, and Send automatic payment reminders is on for the invoice. Reminders also wait while a card charge on the invoice is scheduled, being confirmed, or on hold. Workflows can’t start from an invoice being sent, viewed or overdue; an invoice trigger fires only when a client pays it online (the pay link or the portal) or that payment fails. See Workflows for the trigger model.
What’s next?
Create and Send an Invoice
Build an invoice from your products, save or send it, and download the PDF.
Find and Chase Overdue Invoices
See who owes you, open each overdue invoice, and record the payment.
Estimates
Pre-sales quotes that convert to invoices.
Subscriptions
Recurring billing for retainers and plans.