Bill Runs Screen

Last verified with: 10.8.6.0

Overview #

Bill runs control when billing-related processing is executed for the accounts associated with selected bill groups. A bill run can be configured to perform one or more operational tasks such as billing package charges, billing usage, generating invoices, delivering invoices, executing contract-related charges, running dunning activity, and collecting payments.

Bill runs can be used in two main ways:

• as one-time runs for a specific processing period
• as recurring schedules that run automatically on an ongoing basis

The bill run itself defines what actions should occur, while the related bill groups determine which accounts are included in the run.

Prerequisites #

• Currency exchange rates should already be configured.
• Bill groups should already be configured.
• Accounts receivable terms should already be configured if the bill run will execute dunning activity.

Functionality #

When a bill run executes, only the options enabled on that bill run are processed. Depending on the selected options, a bill run can perform actions such as:

• billing package charges
• billing usage charges
• generating invoices
• rendering invoices
• delivering invoices
• running contract-related billing activity
• running dunning activity
• collecting payments

Whether an account or account package is actually processed during a bill run still depends on the dates and billing conditions of the records being evaluated.

Bill Runs Panel #

The Bill Runs panel on the left displays the available bill runs. Selecting a bill run loads its details on the right so you can review or update it.

The list helps you identify each bill run by showing:

• Name: The label used to identify the bill run. This is typically named to reflect the bill groups being processed or the main purpose of the run.
• Bill Period Start: The beginning of the billing period associated with the bill run record shown in the list. This helps indicate the start of the billing window that the run is working with.
• Bill Period End: The end of the billing period associated with the bill run record shown in the list. Together with Bill Period Start, this helps you understand the processing window for the run.

Actions #

Icon	Description
	Deletes the selected bill run if not in use (connected to a bill group)
	Adds a new bill run

Edit Bill Run Panel #

The Edit Bill Run panel displays the selected bill run and is where its main settings are maintained.

Fields #

• Name: The descriptive name for the bill run.
• Collection Type: Defines how payment collection behaves when Collect Payments is enabled.
• Bill Run Status Type: Displays the current system status of the bill run.

Options Tab #

The Options tab defines which actions the bill run performs when it executes.

Billing #

• Bill Package: Bills package charges that are eligible in the run period.
• Bill Usage: Bills usage charges for eligible account packages.

Invoicing #

• Run Invoices: Creates invoice records from the charges produced by the bill run.
• Render Invoices: Produces the rendered invoice output for invoices that are ready to be finalized.
• Deliver Invoices: Delivers invoices according to the applicable delivery configuration.

Contract And AR Processing #

• Run Contract Commitments: Executes contract-related billing logic during the run.
• Invoice Top-up: Applies minimum-invoice top-up logic when invoicing is enabled.
• Run Dunning Process: Executes configured accounts receivable or dunning activity.

Payments #

• Collect Payments: Attempts payment collection for eligible accounts.

Option Behavior #

• Collection Type is required only when Collect Payments is enabled.
• Invoice Top-up is enabled only when Run Invoices is selected.
• Some payment retry functionality exists in the UI model but is not part of the visible live layout for this screen.

Bill Group Tab #

Use the Bill Group tab to associate bill groups with the bill run.

Add Controls #

• Bill Group To Add: Lets you select one or more bill groups that are not already attached to the bill run.
• Add: Adds the selected bill groups to the bill run.

Bill Group List #

The list on this tab shows the bill groups currently connected to the bill run. Use the delete action on a row to mark a bill group for removal.

Exchange Rates Tab #

Use the Exchange Rates tab to choose which exchange-rate set the bill run should use.

Fields #

• Exchange List: Selects the exchange-rate set applied by the bill run.

Exchange Rate List #

After an exchange list is selected, the read-only grid shows:

• Currency: The currency that can be converted during the bill run.
• Code: The currency code associated with that currency, such as USD or CAD.
• Exchange Rate: The conversion rate from the selected exchange-rate set that will be used when the bill run performs currency conversion.

Schedule Tab #

Use the Schedule tab to create, manage, and review bill run schedules.

The tab supports three views:

• Schedules: Displays upcoming one-time and recurring schedules.
• In Progress: Displays bill runs that are currently running or being canceled.
• Completed: Displays recent finished runs.

Schedule Actions #

• Schedule One-Time Bill Run: Creates a one-time scheduled run.
• Schedule Recurring Bill Run: Creates a recurring scheduled run.

Scheduled List #

The scheduled list shows upcoming one-time and recurring schedules. Depending on the row, it can display:

• Schedule Start: The first scheduled start date and time.
• Frequency: The schedule recurrence pattern.
• Status: The current schedule status for recurring schedules.

Recurring schedules can also be paused or resumed from the list.

In Progress List #

The in-progress view shows currently running schedules and includes:

• Schedule Start: The scheduled start date and time.
• Actual Start: The time the run actually began, or a pending state if it has not started yet.
• Status: The current run status.

Completed List #

The completed view shows recently finished schedules and includes:

• Schedule Start: The date and time the run was scheduled to begin.
• Actual Start: The date and time the run actually started processing.
• Completion: The date and time the run finished.
• Status: The final outcome of the run, such as completed, completed with failures, failed, or canceled.

One-Time Scheduling #

When scheduling a one-time bill run, the schedule dialog can include values such as:

• Bill Period Start: The start of the billing period the one-time run should process.
• Bill Period End: The end of the billing period the one-time run should process.
• Posting Date: The posting date that will be applied to transactions created by the run.
• Schedule Date and Time: The date and time when the one-time bill run should begin.

Recurring Scheduling #

When scheduling a recurring bill run, the schedule dialog can include values such as:

• First Schedule Run Date: The first date and time the recurring bill run should begin.
• First Bill Period Start: The starting billing period date used for the first scheduled run.
• First Bill Period End: The ending billing period date used for the first scheduled run.
• Posting Date: The posting date that will be applied to transactions created by the recurring run.
• Frequency: The numeric interval used by the schedule, such as every 1 or every 3 units.
• Unit: The unit of recurrence used with Frequency, such as days, weeks, or months.
• Relative Date: An optional scheduling mode that allows the recurring run to be based on a relative billing date instead of only a fixed recurring pattern.

Guides #

Adding Bill Runs #

• In the Bill Runs panel, click the add icon.
• Enter the bill run details.
• Select the options that the bill run should execute.
• If required, assign bill groups, exchange rates, or schedules.
• Click Save.

Editing Bill Runs #

• In the Bill Runs panel, select the bill run you want to update.
• Modify the bill run details as needed.
• Update the Options, Bill Group, Exchange Rates, or Schedule tabs if required.
• Click Save when you are finished.

Adding Bill Groups to Bill Runs #

• Select the bill run you want to update.
• Open the Bill Group tab.
• In Bill Group To Add, select one or more bill groups.
• Click Add.
• Click Save.

Removing Bill Groups from Bill Runs #

• Select the bill run you want to update.
• Open the Bill Group tab.
• Use the delete action on the bill group row you want to remove.
• Click Save to commit the removal.

Scheduling Bill Runs #

• Select the bill run you want to schedule.
• Open the Schedule tab.
• To create a one-time run, use Schedule One-Time Bill Run.
• To create a recurring run, use Schedule Recurring Bill Run.
• Complete the schedule details required for the selected schedule type.
• Click Save on the bill run after the schedule changes are staged.

Deleting Bill Runs #

• In the Bill Runs panel, select the bill run you want to delete.
• Remove any required bill groups or schedules first.
• Click the delete icon.
• On the confirmation dialog, click Yes.