- Open Invoices from the left menu. The list shows all existing invoices.
- Click Create.
- Quick invoice opens by default. Use it to bill a customer one amount, such as a setup fee or a one-off service. You can also click New Invoice on a customer page (the customer is filled in) or in the + menu.
- Choose the Customer if it isn't filled in.
- Check the Due Date. It's pre-filled from your account's default payment term.
- Enter the Amount. The customer's currency symbol is shown beside it.
- Optionally enter a Description. Left blank, the invoice line reads "One-Off Charge".
- Click Create Invoice to issue it (status Due; the card on file is charged automatically if auto-charge is on), or Save as Draft to finish it later (no charge).
The invoice opens on its detail page once saved.
To use catalog products, coupons, a specific status or custom fields, click Advanced invoice at the top of the form. The customer and due date you entered stay. Advanced invoice holds catalog products only: to bill a plain amount, switch back to Quick invoice (an amount you typed there is kept). Bookmark …/invoices/create?mode=advanced to always open the full form.
- On Advanced invoice, search for and select the Customer and set the Due Date. Under Invoice Terms, set Status to Due, or to Draft to save the invoice as a draft.
- Under Products & Charge Types, click + Line Item. Choose the Product and its Charge Type. Click Edit Details to change the price or quantity.
- If applicable, choose a Coupon for the line.
- Click + Line Item again to add another product to the invoice.
- Review the details and click Save, or Save & New to start another invoice. A confirmation message appears at the top right, and the new invoice is added to the Invoices list.
Editing an invoice
Every invoice has one Edit Invoice page. It only allows changes that are safe for the invoice's status and payments, and says why when something is locked.
- Open the invoice and click Actions, then Edit Invoice. (Classic view: the dropdown at the top right.) You need the Edit Invoices permission.
- The edit page is the invoice form, already filled in. Change what you need and save.
What you can change:
| Invoice | Line items | Dates and terms | Additional info and custom fields | Status (Draft / Due) |
|---|---|---|---|---|
| One-off, open (Draft, Due, Overdue, Unpaid, Bounced), nothing paid or credited | Editable | Editable | Editable | Editable |
| One-off with any payment, credit note, pending payment, payment schedule or refund (incl. Partially Paid) | Read-only | Editable | Editable | — |
| Created from a sales order, or synced in with no lines (e.g. QuickBooks, Xero) | Read-only | Editable | Editable | — |
| Subscription invoice, open | Read-only | Editable | Editable | — |
| Projected invoice | Read-only | Editable | Editable | — |
| Paid or Void | Read-only | Read-only | Editable | — |
Line items on a subscription invoice come from the subscription: change the subscription instead. To change the amount of an invoice that already has a payment, issue a credit note. On a paid or void invoice, the page shows "This invoice is closed. Only additional info and custom fields can be changed."
What happens when you save an edit
Saving an edit never charges the customer. To collect payment, use Process Payment.
- The invoice number and coupons stay the same. Coupons already on the invoice aren't counted as used again.
- Totals (tax, discount, shipping, balance) are recalculated when line items change.
- Choosing a payment term, or changing the invoice date, recalculates the due date. Typing a due date by hand switches the term to Custom due date.
- Fields that can't be edited for that invoice are ignored.
Status after saving:
| Situation | Status after save |
|---|---|
| Draft, not switched to Due | Stays Draft |
| Nothing left to pay, and a payment or credit was applied | Paid |
| Due date moved into the past on an open invoice | Overdue; the overdue notification and dunning start |
| Due or Overdue invoice with a due date today or later | Due |
| Unpaid, Bounced or Partially Paid with a due date today or later | Unchanged |
| Projected, Paid or Void | Unchanged |
If someone else saved the same invoice after you opened it, your save is refused with "This invoice was changed by someone else after you opened it. Reload the page and try again." If a payment arrives while the form is open, a line-item change is refused and the lines lock.
Creating invoices through the API
In POST /api/v1/invoices, each item can be a catalog item (product_id + plan_id) or a plain amount (amount, with an optional description of up to 191 characters, default "One-Off Charge"). An item can't carry both. "invoice_status": "Draft" creates a draft; a request with nothing billable returns an error. The endpoint only creates invoices: an id sent in the request is ignored.
{
"customer_id": "<customer id>",
"items": [
{ "amount": 50 },
{ "amount": 12.5, "description": "Travel" },
{ "product_id": "<product id>", "plan_id": "<plan id>" }
]
}
Comments
0 comments
Please sign in to leave a comment.