Skip to main content
SubscriptionFlow Docs
Managing Invoices

Create Invoices

Updated
  1. Open Invoices from the left menu. The list shows all existing invoices.

Invoices list

  1. Click Create.

Create button on the Invoices list

  1. 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.
    1. Choose the Customer if it isn't filled in.
    2. Check the Due Date. It's pre-filled from your account's default payment term.
    3. Enter the Amount. The customer's currency symbol is shown beside it.
    4. Optionally enter a Description. Left blank, the invoice line reads "One-Off Charge".
    5. 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).

Create Invoice: Quick invoice

The invoice opens on its detail page once saved.

The new invoice

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.

  1. 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.

Advanced invoice: customer, due date and status

  1. Under Products & Charge Types, click + Line Item. Choose the Product and its Charge Type. Click Edit Details to change the price or quantity.

Line item with product and charge type

  1. If applicable, choose a Coupon for the line.

Coupon column on the line item

  1. Click + Line Item again to add another product to the invoice.

+ Line Item button

  1. 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.

Save and Save & New buttons

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.

  1. Open the invoice and click Actions, then Edit Invoice. (Classic view: the dropdown at the top right.) You need the Edit Invoices permission.

Edit Invoice in the Actions menu

  1. The edit page is the invoice form, already filled in. Change what you need and save.

Edit Invoice page

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."

Edit Invoice on a paid invoice

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>" }
  ]
}
Was this article helpful?0 out of 0 found this helpful
Have more questions? Submit a request

Comments

0 comments

Please sign in to leave a comment.