Invoicing
Create, send, and get paid on invoices — including recurring schedules and partial payments.
Invoicing
Invoicing in Finance Operating System is designed for the common case where you bill a customer for one or more line items, send them an emailed PDF, and record the payment when it arrives. This guide covers the full flow including the less obvious bits: partial payments, voids, credit notes, and recurring schedules.
Create
Open Invoicing → New invoice. Pick the customer (or click + New to add one inline). Pick the issue date and due date — the default due date is issueDate + 30 days, configurable per customer. Add line items: each line has a description, quantity, unit price, ledger account (which revenue account this maps to), and an optional tax rate. The totals update live and break out subtotal, tax, and grand total.
Click Save as draft to keep editing, or Send to email it to the customer immediately. Sending also locks the invoice's editable fields — you can no longer change the customer or the lines without first issuing a credit note. The status moves from DRAFT to SENT.
What happens behind the scenes
When you send an invoice, two things happen atomically: an email is queued via the outbound email worker, and a journal entry is posted. The entry is Dr Accounts Receivable, Cr Sales Revenue for the subtotal, plus Cr Sales Tax Payable for the tax portion. You can inspect the entry on the invoice's Journal entry tab. If you ever need to reverse the invoice entirely (customer cancelled the order), use Void — this posts a perfectly mirrored reversal entry that nets to zero.
Record a payment
When the customer pays, open the invoice and click Record payment. Enter the amount (default: the full outstanding balance), the method, and the date. If the amount is less than the outstanding balance, the invoice transitions to PARTIAL. Repeat as more payments arrive until the balance is zero — at which point the invoice automatically moves to PAID.
If you have a bank feed connected, the payment will also surface in Banking → Inbox as soon as the bank reports it (typically next business day for ACH, same-day for card). Click Match to link the bank transaction to the payment, avoiding any double-entry.
curl -X POST https://app.financeoperatingsystem.com/api/v1/invoices/{id}/payments \
-H "Authorization: Bearer fak_live_xxx" \
-H "Content-Type: application/json" \
-d '{ "amount": "500.00", "method": "ACH", "receivedAt": "2026-05-23T14:32:00Z" }'Recurring invoices
For retainer customers, set up a recurring schedule from Invoicing → Recurring → New schedule. Pick the customer, the template (or paste in line items), and the cadence (weekly / monthly / quarterly / annual). Each cycle the schedule fires, we generate a new draft invoice or — if you check Auto-send — send it directly. We retry the email up to three times if delivery fails and surface a notification if all retries are exhausted.
Credit notes
A credit note is a negative invoice — used to refund or apply credit to a previous invoice. From any PAID or PARTIAL invoice, click ⋯ → Issue credit note. We pre-fill the line items as negatives; you can edit before issuing. The credit note posts a mirror journal entry. If the original invoice was paid by card, you can simultaneously issue a refund via Stripe Connect from the same screen.

