Bill Run History Screen

Last verified with: 10.8.6.0

Overview #

The Bill Run History screen is used to monitor completed and in-progress bill runs and to review the results of each billing step. It helps administrators understand what happened during a bill run, how far each step progressed, and whether any errors occurred during billing, invoicing, or related processing.

This screen is especially useful when a bill run is still in progress, when a run needs to be reviewed after completion, or when troubleshooting is required after a bill run has failed or produced unexpected results.

Prerequisites #

At least one bill run must exist before bill run history can be displayed.

Bill Run History Panel #

The Bill Run History panel on the left lists the available bill run history entries. Select a history entry to review its details in the panel on the right.

Actions #

Icon	Description
	Reloads the bill run history list and current details. This is useful when monitoring a run that is still in progress
	Stops the selected scheduled bill run when that action is available
	Retries the selected bill run when retry is supported for that history entry

Bill Run History List #

The list on the left shows the bill runs that have been executed. Each row represents a recorded bill run history entry and helps users identify which run they want to inspect.

Edit Bill Run History Panel #

The Edit Bill Run History panel displays the overall details for the selected bill run and the status of its individual processing steps.

Bill Run Summary Fields #

• Name: Identifies the bill run history entry.
• Bill Run History ID: Displays the internal identifier of the history record.
• Start Date: Displays when the bill run started.
• Completed Date: Displays when the bill run finished, if it has completed.

Bill Run Step List #

The step list shows the individual processing stages for the selected bill run. Selecting a step updates the metrics and errors shown on the right.

Step Details #

The selected step displays operational details such as:

• Start: When the selected step began.
• End: When the selected step completed.
• Elapsed Time: How long the step has been running or how long it ran.
• Estimated Time: The estimated completion time for the step, when available.
• Total: The total number of records or units involved in the step.
• Queued: The number of items waiting to be processed.
• Processed: The number of items already processed.
• Skipped: The number of items skipped, when that metric is available for the selected step.
• Errors: The number of errors recorded for the selected step.

Errors Tab #

The Errors tab lists any errors recorded for the selected bill run step.

If no errors were recorded, the screen shows an empty-state message instead of an error list.

Billing Error Codes & Resolutions #

Below is a summary of common billing-related errors and their typical resolution paths.

Billing Error Type Name	Description	Resolution
BILLING_001	InvoiceItem which is Tax Inclusive with Quantity > 1 must have a ServiceTaxCategory that is Lines based.	Correct the service tax category used by the service or manual charge.
BILLRUN_001	The BillRun Step did not receive a response and has timed out.	Retry the bill run.
BILLRUN_002	Bill Run Posting Date falls within a closed Fiscal Period.	Reopen the fiscal period or rerun the bill run with a valid posting date.
CONTRACT_001	Could not evaluate Contract Commitment charge from subaccounts with different currencies.	Review the aggregate commitment and subaccount currency setup.
DELIVERY_001	Account does not have a valid email address and is configured for email delivery model.	Add or correct the billing contact email address.
DELIVERY_002	Transfer Location is not active.	Activate the configured transfer location.
DELIVERY_003	SMTP Email Service is not configured.	Create or activate the required email service configuration.
INVOICING_001	Account address is invalid or missing a tax jurisdiction code.	Review and correct the billing or service contact address.
INVOICING_002	Invoice item has tax codes across different tax vendors.	Review the account tax setup and tax category configuration.
RENDER_001	Invoice render is too large.	Use an alternate template or reduce the rendered invoice size.
TERM_001	Dunning Rule penalty fee does not have a value for an account’s currency.	Add the missing late-fee value for the required currency.
Unknown	An unexpected error has occurred. Please contact support to review logging and root cause.	Investigate the run further and contact LogiSense Support if needed.
USAGE_001	No usage rate tiers found for tiered usage rate group.	Review the rate group and ensure the required rate tiers are configured.

Guides #

Monitoring A Bill Run #

1. In the Bill Run History panel, select the bill run you want to review.
2. Review the bill run summary fields.
3. Select an individual step from the step list.
4. Review the step metrics and the Errors tab.
5. Use Refresh if the run is still in progress.

Retrying A Bill Run #

1. In the Bill Run History panel, select the bill run you want to retry.
2. Review the step details and errors to understand why the prior run failed or stalled.
3. Click Retry Bill Run when the action is available.

Stopping A Scheduled Bill Run #

1. In the Bill Run History panel, select the scheduled bill run you want to stop.
2. Click Stop Schedule when the action is available.