Billable items are the billing units that become document line items when they are due. They are the bridge between your commercial data (contracts, orders, usages) and the billing documents your customers receive.

This guide explains what billable items are, where to find them in the webportal, how processing status and processing date work, and what you can do when something fails.

What is a billable item?

A billable item is a charge that is ready to be processed into a billing document — but it is not yet the document itself.

Billable items can come from different commercial setups, for example:

one-time business (orders)
recurring contract charges
usage-based line items after aggregation

Each billable item stores a processing date. Only items whose processing date has been reached are picked up by a billing run. Items that exist but are not yet due wait for a later run.

Where to find billable items

Navigate to: Billing > Billable Items

The overview lists billable items across your tenant. Open an entry with Details to see product information, pricing structure, references, and processing details.

On the details page you can check, among other things:

Processing date — when the item becomes eligible for a billing run
Processed date — when it was actually processed (if already billed)
Processing status — for example not started, in progress, completed, or error
Status reason — additional detail when processing failed
Document — a link to the resulting document once the item has been billed

Billable items also appear in the context of a document details page, so you can see which items make up a specific invoice or credit note.

Processing status

A billable item moves through processing statuses as the billing run works on it. Typical statuses include:

NOT_STARTED — not yet picked up by a billing run
STARTED / IN_PROGRESS — currently being processed
COMPLETED — successfully processed into a document
ERROR / CONFIG_ERROR — processing failed; check the status reason
PENDING_RETRY — waiting for another processing attempt
RECALCULATION_PENDING / RECALCULATION_ERROR — recalculation is pending or failed
TERMINATED — processing was stopped

If billable items exist but no document appears, check first whether their processing date is still in the future and whether their status is still waiting — see the end-to-end process in Document Creation.

Failed billable items

When processing fails, failed billable items are highlighted in the platform — for example via dashboard widgets that open the failed billable items overview, and via indicators on the related contract or order.

From a contract or order details page, you can retry failed billable items using the contract/order actions (for example Retry failed billable items). Some failed items may need a data or configuration fix before a retry succeeds.

For recalculation errors, contracts also offer a retry for recalculation where applicable.

Correct or cancel a billable item

Individual billable items can be corrected or cancelled via the API when your process requires it — for example to adjust an amount before the next billing run or to stop an item from being billed.

See the API reference:

How billable items fit into document creation

Billable items are created from contracts, orders, or aggregated usages.
Each item becomes due according to its processing date.
A billing run collects due items and creates documents according to the billing group.
You review the result under Manage Documents.

For the full stage-by-stage picture, see Document Creation.