Skip to main content
Adjustments & Pay Runs

Pay Run Invoicing — the invoice-only scheduler job

Pay Run Invoicing — the invoice-only scheduler job

What it does

Creates pay-run invoices on a schedule (typically out of hours), without emailing them. Emailing is a separate step, so invoices can be reviewed before they go out.

How it differs from Pay Run Reports

The Pay Run Reports job can either invoice and email in one pass (its default) or email only. Use this job to create the invoices, then run Pay Run Reports with Invoice set to No to email them once they’ve been checked.

The Delivery setting

Choose which pay runs to invoice: Email (email-delivery clients only), Post (post-delivery clients only), or --All-- (all clients).

  • Note: this job never emails, whatever you pick — Delivery only controls which pay runs are selected.

Which pay runs are invoiced

The job invoices regular pay runs at Open status whose invoice date is today and whose client matches the Delivery setting.

It does not select:

  • ad-hoc pay runs

  • pay runs already at Pending, which are never invoiced a second time

  • pay runs whose reporting date is today but whose invoice date is later

  • pay runs for inactive clients

  • clients with no Packaging defaults set up.

When it runs

Always invoices the pay runs due on their invoice date. It runs on its schedule only — there is no button to run it on demand, because creating invoices briefly locks billing for the whole organisation, which is why the job is scheduled outside business hours.

Recommended timing

Schedule this job outside business hours, and don’t run it during the working day. Creating invoices locks billing for your whole organisation while the job runs. During that time:

  • nobody can invoice from the Pay Runs screen

  • an email-only Pay Run Reports pass can’t run.

Schedule it early in the morning so invoices are ready for your team to review before they’re emailed.

The exception report

Emailed to the recipient(s) you nominate, and only when there is something to report. Nominate someone who manages the client's settings, since the warnings are settings fixes.

Each row names the pay run, its outcome (Error or Warning) and the reason.

  • Error: the pay run could not be invoiced and stays at Open. Causes include:

    • billing locked by another process, for example an invoice left unfinished on the Pay Runs screen

    • no billing transactions for the period

    • the invoice failing to create or post.

  • Warning: an Email-delivery pay run was invoiced but is missing an email recipient, a report selection, or both, so it can’t be emailed yet. Each pay run gets one row, naming everything that’s missing.

Setup

In System Administration > Scheduler Jobs, add a new job and select the job type sp / billings / payRun. The Description fills in as Pay Run Invoicing. Set Delivery and complete the mail settings. All of these are required before the job will save:

  • a Delivery value

  • a mail subject

  • a mail sender

  • at least one exception-report recipient (only once the job is Active).

If more than one is missing, only the first is reported, in that order.

Choosing a sender

  • Nominate a user account whose email address is a shared operations mailbox rather than an individual’s, since the report is recurring and replies go to whoever is nominated.