> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinksale.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Recurring Invoices

> Learn how to create, view, manage, and automate recurring invoices in Blinksale

<div className="relative w-full my-16 px-4">
  <div className="absolute -top-10 -right-10 w-60 h-60 bg-gradient-to-br from-blue-300/30 to-teal-300/30 dark:from-blue-600/20 dark:to-teal-600/20 rounded-full blur-3xl" />

  <div className="absolute -bottom-10 -left-10 w-60 h-60 bg-gradient-to-br from-purple-300/30 to-pink-300/30 dark:from-purple-900/20 dark:to-pink-900/20 rounded-full blur-3xl" />

  <div className="relative">
    <div className="absolute inset-0 bg-white dark:bg-zinc-800 rounded-[2.5rem] transform rotate-1 translate-x-2 translate-y-2 shadow-xl" />

    <div className="absolute inset-0 bg-gradient-to-br from-blue-50 to-teal-50 dark:from-blue-900/30 dark:to-teal-900/30 rounded-[2.5rem] transform -rotate-1 translate-x-1 translate-y-1" />

    <div className="relative bg-white dark:bg-zinc-900 rounded-[2.5rem] shadow-2xl overflow-hidden p-4 md:p-6 z-10">
      <div className="absolute inset-0 rounded-[2.5rem] p-0.5">
        <div className="h-full w-full rounded-[2.5rem] bg-gradient-to-br from-blue-400 via-teal-400 to-purple-400 opacity-50 dark:opacity-30 blur-sm" />
      </div>

      <div className="relative z-10 rounded-[2rem] overflow-hidden bg-white dark:bg-zinc-900 border border-zinc-100 dark:border-zinc-800">
        <div className="overflow-hidden">
          <video className="w-full aspect-video object-cover" controls src="https://synthesia-ttv-data.s3-eu-west-1.amazonaws.com/video_data/3a09f922-13f5-42bb-85a9-8620c828d8c7/transfers/rendered_video.mp4" />
        </div>

        <div className="p-4 bg-gradient-to-r from-zinc-50 to-white dark:from-zinc-900 dark:to-zinc-800 flex justify-between items-center">
          <div className="flex items-center space-x-3">
            <div className="w-8 h-8 rounded-full bg-gradient-to-r from-blue-500 to-teal-500 flex items-center justify-center text-white shadow-md">
              <svg xmlns="http://www.w3.org/2000/svg" className="h-4 w-4" viewBox="0 0 20 20" fill="currentColor">
                <path fillRule="evenodd" d="M10 18a8 8 0 100-16 8 8 0 000 16zM9.555 7.168A1 1 0 008 8v4a1 1 0 001.555.832l3-2a1 1 0 000-1.664l-3-2z" clipRule="evenodd" />
              </svg>
            </div>

            <span className="text-zinc-800 dark:text-zinc-200 font-medium">Recurring Invoice Management</span>
          </div>
        </div>
      </div>
    </div>
  </div>
</div>

## Introduction

Recurring invoices automate your billing process by generating invoices at specified intervals. This powerful feature streamlines your workflow, ensures consistent cash flow, and reduces the administrative burden of manual invoice creation. This guide explains how to set up, manage, and optimize recurring invoices in Blinksale.

## Understanding Recurring Invoices

Blinksale's recurring invoice system consists of two primary components:

1. **Recurring Invoice Template**: Contains all the invoice information, including client details, line items, pricing, and schedule parameters.
2. **Recurring Invoice**: The system component that manages the schedule, tracks occurrences, and generates actual invoices based on the template.

When you create a recurring invoice, you're creating a template along with the scheduling rules that determine when new invoices will be generated.

## Recurring Invoice Status Lifecycle

Recurring invoices have a specific lifecycle with four possible statuses:

1. **Active** - Generating invoices according to the schedule
2. **Paused** - Temporarily stopped generating invoices
3. **Completed** - The recurring schedule has ended (reached max occurrences or end date)
4. **Canceled** - Manually stopped generating invoices

<img className="rounded-lg border border-zinc-200 dark:border-zinc-700" src="https://example.com/images/recurring-invoice-lifecycle.png" alt="Diagram showing the recurring invoice lifecycle stages" />

## Recurring Invoice Dashboard

The recurring invoices dashboard provides a comprehensive view of all your recurring templates and their schedules. From this central hub, you can:

* View all recurring invoices with their status
* Filter recurring invoices by client
* See next generation dates for active templates
* Access template details
* Create new recurring templates

<img className="rounded-lg border border-zinc-200 dark:border-zinc-700" src="https://example.com/images/recurring-invoices-dashboard.png" alt="Recurring invoices dashboard showing a list of templates" />

## Creating a New Recurring Invoice

To set up a new recurring invoice:

1. Navigate to the Recurring Invoices section from the main sidebar
2. Click the "New Recurring Invoice" button in the top right corner
3. Complete the form with invoice details and scheduling parameters

<Note>
  You must have at least one client in your account before creating a recurring invoice. If you don't have any clients yet, you'll be prompted to create one first.
</Note>

### Essential Information

When creating a recurring invoice, you'll provide information in two main categories:

<img className="rounded-lg border border-zinc-200 dark:border-zinc-700" src="https://example.com/images/create-recurring-invoice-form.png" alt="Recurring invoice creation form showing various fields" />

#### Template Information

Similar to standard invoices, you'll need to provide:

* **Client** - Select the client who will be billed
* **Name** (optional) - A descriptive name for the recurring template
* **Currency** - Choose the currency for this invoice series
* **Line Items** - Products or services included in each invoice
* **Tax Settings** - Apply appropriate tax rules
* **Discount Settings** - Apply any recurring discounts
* **Payment Terms** - Specify when payment will be due for each generated invoice
* **Late Fee Settings** - Configure late fees for overdue invoices
* **Notes** - Any standard note text to include on each invoice

#### Schedule Parameters

The scheduling section is what makes recurring invoices unique:

* **Frequency** - How often invoices will be generated:
  * Daily
  * Weekly
  * Every 2 weeks
  * Monthly
  * Quarterly
  * Every 6 months
  * Annually

* **Start Date** - When the first invoice should be generated

* **End Criteria** (at least one is required):
  * **End Date** - A specific date when recurring invoices will stop
  * **Max Occurrences** - A specific number of invoices to generate

## Viewing Recurring Invoice Details

To access detailed information about a recurring invoice template, click on its name in the list. The detail page provides:

### Template Overview

The top section displays key template information:

* Template name or number
* Status of the recurring schedule
* Client information
* Available actions based on the current status

<img className="rounded-lg border border-zinc-200 dark:border-zinc-700" src="https://example.com/images/recurring-invoice-details.png" alt="Recurring invoice details showing comprehensive information" />

### Line Items Section

This section lists all products or services included in the recurring template, displaying:

* Item name and description
* Quantity and unit of measurement
* Unit price
* Tax information (when applicable)
* Line item total

### Schedule Information

The schedule details section shows:

* Frequency of invoice generation
* Start date
* End date (if specified)
* Maximum occurrences (if specified)
* Current number of occurrences (how many invoices have been generated)
* Date of last invoice generation
* Date of next scheduled invoice

### Generated Invoices

This section shows all invoices that have been created from this recurring template, including:

* Invoice number
* Status (draft, sent, paid, overdue, etc.)
* Issue date
* Due date
* Total amount
* Links to view the full invoices

## Managing Recurring Invoices

Depending on the current status of a recurring invoice, you can perform various actions:

### Preview Next Invoice

Before the next invoice is generated, you can preview exactly what it will look like:

1. Navigate to the recurring invoice's detail page
2. Click the "Preview Next Invoice" button
3. Review the invoice details that will be created on the next generation date

This feature is especially useful for verifying that your recurring template is correctly configured before invoices are sent to clients.

### Generate Invoice Now

If you need an invoice immediately rather than waiting for the next scheduled date:

1. Navigate to the recurring invoice's detail page
2. Click the "Generate Invoice Now" button
3. Confirm the action
4. The system will create a new invoice immediately and update the schedule for the next generation

<Note>
  When you manually generate an invoice, the next scheduled date will be calculated based on the current date, not the original schedule. This prevents duplicate invoices if you generate an invoice shortly before its scheduled date.
</Note>

### Pause a Recurring Invoice

To temporarily stop invoice generation:

1. Navigate to the recurring invoice's detail page
2. Click the "Pause" button
3. Confirm the action

While paused, no invoices will be generated from this template. The template can be edited while in the paused state.

### Resume a Recurring Invoice

To restart invoice generation for a paused template:

1. Navigate to the recurring invoice's detail page
2. Click the "Resume" button
3. Confirm the action

The system will recalculate the next generation date based on the current date and frequency settings.

### Cancel a Recurring Invoice

If you need to permanently stop a recurring invoice:

1. Navigate to the recurring invoice's detail page
2. Click the "Cancel Recurring Invoice" button
3. Confirm the action

<Warning>
  Canceling a recurring invoice is permanent and can't be undone. If you need to use the template again in the future, consider pausing it instead.
</Warning>

## Editing Recurring Invoices

To modify an existing recurring invoice template:

1. Navigate to the template's detail page
2. Click the "Edit" button
3. Make your desired changes
4. Click "Save Template" to apply your updates

<Note>
  You can only edit templates with Active or Paused status. Templates with Completed or Canceled status can't be modified.
</Note>

When editing a recurring template, you can update:

* All template information (client, line items, prices, etc.)
* Frequency settings
* End criteria (end date or max occurrences)

<Warning>
  Editing a recurring invoice template will affect all future generated invoices, but will not affect any invoices that have already been created.
</Warning>

## Deleting Recurring Invoices

If you need to remove a recurring invoice template:

1. Navigate to the template's detail page
2. Click the "Delete" button
3. Confirm the deletion in the dialog that appears

<Warning>
  Deleting a recurring template will cancel any active recurring schedule and remove the template from your account. This action cannot be undone. However, any invoices already generated from this template will be retained.
</Warning>

## Automated Notifications

When invoices are generated automatically from recurring templates, the system can optionally send notifications:

* **Client Notifications** - Automatically email new invoices to clients when generated
* **Admin Notifications** - Notify you when recurring invoices are generated

These settings are controlled through the notification preferences in your account settings.

## Best Practices

### Setting Up Recurring Invoices

* **Use descriptive template names** to easily identify different recurring invoices
* **Carefully select the start date** considering your billing cycles
* **Set appropriate end criteria** to avoid generating too many invoices
* **Review the template carefully** before activating it
* **Consider using the preview feature** before the first invoice is generated

### Managing Multiple Recurring Invoices

* **Establish a consistent billing schedule** to create predictable cash flow
* **Organize recurring invoices by client or service type**
* **Regularly review active recurring templates** to ensure information is current
* **Pause rather than cancel** templates you might need again

### Common Use Cases

**Subscription Billing**

* Monthly membership fees
* Software-as-a-Service subscriptions
* Ongoing service retainers

**Regular Services**

* Maintenance contracts
* Cleaning services
* Consulting retainers

**Installment Payments**

* Breaking large projects into multiple payments
* Payment plans for clients

## Troubleshooting

### Common Issues

**Invoice not generated on expected date:**

* Verify that the recurring template has Active status
* Check that you haven't reached the maximum occurrences or end date
* Confirm that the next generation date is correct

**Cannot edit recurring invoice:**

* Verify that the invoice has Active or Paused status
* Completed or Canceled templates cannot be edited

**Duplicate invoices generated:**

* Avoid manually generating invoices close to scheduled dates
* Be cautious when adjusting frequency settings on active templates

**Need to make changes to already-generated invoices:**

* Edit the individual invoices directly, not the recurring template
* The recurring template only affects future invoices, not past ones

By effectively leveraging recurring invoices, you can automate your billing process, save administrative time, and create a more predictable cash flow for your business.
