How to Set Up Batch Scheduling and Blackout Calendars

 Batch Scheduling

Batch scheduling lets you limit how many items a job processes each time it runs, so large jobs don't try to process everything at once.

Currently available for the following billing invoice jobs:

• Create Customer Billing Invoices
• Attempt Billing Charges
• Handle Customers to Suspend

How to set it up

1. Go to Scheduled Jobs in the top menu.
2. Find the job you want to configure and select Batch settings.
3. Set the following:
   • Enabled: turns batching on or off for this job.
   • Batch size: the maximum number of items processed each time the job runs.
   • Batch interval (minutes): if there are items left over after a run, the job will automatically run again after this many minutes to continue working through the rest. Leave empty if you don't want automatic follow up runs.
4. Save your changes.

Note on timing: the job's own schedule (its cron cadence, e.g. hourly) still determines how often it fires normally. The batch interval only controls automatic follow up runs when a batch is capped and work remains.

Blackout Calendars

Blackout calendars let you block a job from running on specific dates, for example public holidays. You create a calendar once and can attach it to as many scheduled jobs as you like.

How to create a calendar

1. Go to Settings > System > Blockout Calendars.
2. Select New and give the calendar a name, for example "Public holidays 2026".
3. Add dates to the calendar. For each date, choose a type:
   • One off date: blocks that exact date only.
   • Every [weekday]: blocks that weekday every week (for example, every Sunday).
   • Monthly: blocks a specific day of the month, every month (for example, the 1st).
   • Yearly: blocks a specific month and day, every year (for example, December 25).
   For monthly or yearly dates that don't exist in a given month (for example the 31st in a 30 day month, or February 29 in a non leap year), the block simply doesn't apply that month, it isn't shifted to another day.

How to attach a calendar to jobs

1. Open the blackout calendar you want to use.
2. Use the job picker to select which scheduled jobs it should apply to.
3. Save your changes. You can add or remove jobs from this picker at any time.

Once attached, any job whose calendar covers today's date will be skipped automatically. This applies whether or not the job also has batch settings enabled.

Exceptions:

• Manually starting a job with Run Now is not affected by blackout dates.
• If you only need to block a recurring weekday, you can also achieve this by adjusting the job's own schedule instead of using a blackout calendar.