Recurring Customer Invoices
Set up a customer invoice that Muin generates on a monthly, quarterly, semi-annual, or annual schedule, as a draft for review or sent automatically.
Recurring Customer Invoices let you define a billing schedule, such as a monthly retainer, a quarterly service fee, or an annual membership, and have Muin generate each invoice for you. You set it up once, and each billing period produces a new invoice.
How Recurring Invoices Work
A recurring invoice is a template with a schedule. On each scheduled date Muin generates a real customer invoice from it, with its own invoice number.
Template (schedule + line items) → Occurrence 1 (INV-0045) → Occurrence 2 (INV-0046) → ...
Each generated invoice is independent. It appears in the Customer Invoices list like any other invoice, and you can edit a draft, send it, or void it there without affecting the template or future invoices.
Creating a Recurring Invoice Template
Navigate to Finance > Money In > Recurring Invoices and click New Recurring.
| Field | Description |
|---|---|
| Customer Name | Required. The name printed on each generated invoice. |
| Customer Email | Optional. Where auto-sent invoices go. Without an email, invoices are always generated as drafts. |
| Frequency | Monthly, Quarterly, Semi-Annual, or Annual |
| First Issue Date | The date the first invoice is generated. Later invoices follow the frequency from this date. |
| Line items | Description, quantity, and unit price. At least one line item is required. |
| Auto-send invoice when generated | When checked, each generated invoice is emailed to the customer. When unchecked, it is created as a Draft for your review. |
Click Create Recurring Invoice. The template is active right away. Each generated invoice is due 30 days after its issue date.
Generation Behavior
Muin checks for due templates once a day and generates the invoice for each one whose date has arrived. Idempotency guarantee: each scheduled date produces at most one invoice, even if generation runs twice for the same date.
If a scheduled date is missed (for example, during an outage), it is not skipped: the following daily runs generate each missed invoice in turn until the template is caught up.
The Next Issue column on the Recurring Invoices list shows when the next invoice will be generated, and Generated shows how many invoices the template has produced so far.
Auto-Send vs. Draft Review
- Auto-send checked: the invoice is generated and emailed to the customer email on the template.
- Auto-send unchecked: the invoice is generated as a Draft in the Customer Invoices list. Open it, adjust it if needed, then send it yourself.
Draft review is the better choice when amounts vary between cycles (for example, a time-and-materials engagement where you add hours each month before billing).
Managing an Existing Recurring Schedule
Each row on the Recurring Invoices list has its actions in the Actions column. Click a row to see the template’s details.
| Action | Shown when | Effect |
|---|---|---|
| Pause | Active | Stops generation without removing the template. |
| Resume | Paused | Restarts generation from the next scheduled date. |
| Cancel | Active or paused | Stops all future generation, after you confirm. A cancelled template cannot be resumed; create a new one if billing restarts. |
Pause is the better choice when you expect billing to restart (for example, a project on hold).
Statuses
| Status | Meaning |
|---|---|
| Active | Generating on schedule |
| Paused | Temporarily stopped; can be resumed |
| Cancelled | Stopped for good; no further invoices |
| Completed | Reached the end of its schedule |
Permissions
Recurring invoices use the same Invoicing feature permission in Finance as one-off Customer Invoices:
| Action | Required Invoicing permission |
|---|---|
| See the Recurring Invoices list and a template’s details | View |
| Create a template (the page creates it and switches it on in one step) | Create and Manage |
| Pause or cancel a template | Edit |
| Resume a paused template | Manage |
Users without View see an Access Denied state on the Recurring Invoices page and a 403 on direct API calls.
Common Questions
Can I change the amount for one month only? Leave auto-send unchecked so each invoice is generated as a draft, then edit that month’s draft before you send it. The template and future invoices are not affected.
What if generation was missed on a scheduled date? The missed invoice is generated on the next daily run, and each further missed date follows on the runs after that.
Can I set different rates for different periods? Not on a single template. Cancel the old template and create a new one with the new rate and its own first issue date.
How do I stop billing a customer permanently? Cancel the recurring template. Invoices already generated stay in the Customer Invoices list until they are paid or voided.