Recurring Invoices

Recurring invoices allow you to automatically generate invoices on a defined schedule. This is useful for subscription services, retainers, rent, and other periodic billing.

How It Works

1. Create a recurring invoice template with client, lines, and schedule
2. Storno.ro generates invoices automatically on the scheduled dates
3. Optionally, invoices are emailed to the client automatically

Frequencies

Frequency Day

The frequencyDay parameter (1-31) specifies which day of the month (or week for weekly) the invoice should be generated. If the month has fewer days (e.g., February), the last day of the month is used.

Frequency Month

For annual frequency, frequencyMonth (1-12) specifies the month.

Creating a Recurring Invoice

curl -X POST https://api.storno.ro/api/v1/recurring-invoices \
  -H "Authorization: Bearer {token}" \
  -H "X-Company: {company_uuid}" \
  -H "Content-Type: application/json" \
  -d '{
    "clientId": "{client_uuid}",
    "seriesId": "{series_uuid}",
    "frequency": "monthly",
    "frequencyDay": 1,
    "nextIssuanceDate": "2026-03-01",
    "currency": "RON",
    "dueDateType": "relative",
    "dueDateDays": 30,
    "notes": "Servicii lunar de mentenanță IT",
    "lines": [
      {
        "description": "Mentenanță IT - lunar",
        "quantity": 1,
        "unitPrice": 2000,
        "vatRateId": "{vat_rate_uuid}",
        "unitOfMeasure": "buc"
      }
    ]
  }'

Due Date Configuration

Stop Date

Set a stopDate to automatically stop generating invoices after a certain date:

{
  "stopDate": "2026-12-31"
}

After the stop date, no more invoices will be generated, but the recurring invoice remains in the system.

Auto-Email

When enabled, generated invoices can be automatically emailed to the client:

{
  "autoEmailEnabled": true,
  "autoEmailTime": "09:00",
  "autoEmailDayOffset": 0
}

Price Rules

Recurring invoice lines support dynamic pricing:

Exchange Rate Example

Bill in RON but base price on EUR rate:

{
  "lines": [
    {
      "description": "Hosting - monthly",
      "quantity": 1,
      "unitPrice": 100,
      "priceRule": "exchange_rate",
      "referenceCurrency": "EUR"
    }
  ]
}

The actual price will be calculated using the BNR exchange rate on the day of generation.

Managing Recurring Invoices

Toggle Active/Inactive

curl -X POST https://api.storno.ro/api/v1/recurring-invoices/{uuid}/toggle \
  -H "Authorization: Bearer {token}" \
  -H "X-Company: {company_uuid}"

Manual Trigger

Generate an invoice immediately without waiting for the schedule:

curl -X POST https://api.storno.ro/api/v1/recurring-invoices/{uuid}/issue-now \
  -H "Authorization: Bearer {token}" \
  -H "X-Company: {company_uuid}"

Tracking

Each recurring invoice tracks:

Document Type

Recurring invoices can generate either regular invoices or credit notes:

{
  "documentType": "invoice"
}