Cost Center

Tracking — Commodities, locations & users for billing and cost tracking
🎯 Purpose

The Cost Center module defines the building blocks for customer billing and cost tracking — Commodities (what is being billed), Locations (where), and Users to Bill (who). These items are selected and configured with cost rates in the Customer Billing tab, and the resulting data feeds into the Cost Tracker. Cost Center is a configuration module; it creates the vocabulary that billing uses.

👤 Roles & Access
RoleAccess
AdminFull access — create, edit, delete commodities, locations, and users to bill.
Super UserCreate and edit cost center items.
End UserNo access.
CustomerNo access.
SupplierNo access.
🔗 Dependencies
Upstream (requires)
Organisation must exist. Regions must be configured in Organisation → Catalogs.
Downstream (feeds into)
Customer Billing — Commodities, Locations, Users to Bill are selected in the Billing tab.
Cost Tracker — Billing data (using Cost Center items) feeds cost reporting.
🚀 Related Flows
Cost Tracking — Step 1 — Cost Center items are defined first.

1. Overview

The Cost Center module is a configuration module used to define the building blocks for customer billing and cost tracking. It contains three tabs — Commodity, Location, and User To Bill — each managing a different dimension of cost allocation.

Items created here are used in the Customer module's Billing tab, where commodities, locations, and users to bill are selected and configured with cost and scheduling details. The billing data then feeds into the Cost Tracker module for cost reporting.

Prerequisites

Important: Each tab displays a banner ("Please add Region before adding...") if no Regions exist in Catalogs. Create Region values in Organisation → Catalogs first.

2. Commodity Tab

Commodities represent the items, services, or assets being tracked for billing. Each commodity is assigned to a region and can have a description.

2.1 Commodity Listing

The Commodity tab shows a listing of all commodities with columns for Name, Region, and Description. Use the filter dropdowns and Search button to locate a commodity.

Cost Center Commodity

Cost Center Commodity

2.2 Adding a Commodity

  1. On the Commodity tab, the add form appears below the listing (or click the grid icon to switch views).
  2. Enter an Asset ID — an optional identifier for the commodity/asset.
  3. Enter an Asset Name (required) — the name of the commodity or service.
  4. Select a Region (required) — from Organisation → Catalogs (Type = Region).
  5. Enter a Description — optional notes about the commodity.
  6. Click Save.
Commodity

Commodity

2.3 Commodity Fields

FieldRequiredDescription
Asset IDNoAn identifier for the asset or commodity (e.g. internal asset code).
Asset NameYesThe name of the commodity or service (e.g. "Printing", "Cloud Storage", "Office Supplies").
RegionYesThe region this commodity belongs to. From Organisation → Catalogs (Type = Region).
DescriptionNoFree text description of the commodity.

3. Location Tab

Locations represent the physical or logical locations where commodities are consumed or services are delivered. Locations are used in the Customer Billing tab to associate billing items with specific sites.

  1. Click the Location tab.
  2. Enter a Name (required) — the location name (e.g. "Head Office", "Warehouse A", "Remote Site").
  3. Enter a Description — optional notes.
  4. Select a Region (required) — from Organisation → Catalogs (Type = Region).
  5. Click + Add Location to add another row, or click Save to save.
  6. Click the delete icon (red bin) to remove a row before saving.
Cost Center Location

Cost Center Location

3.1 Location Fields

FieldRequiredDescription
NameYesThe location name.
DescriptionNoFree text description of the location.
RegionYesThe region this location belongs to. From Organisation → Catalogs (Type = Region).
Note: Multiple locations can be added at once using the + Add Location button. Each row is a separate location entry. Click Save to save all rows together.

4. User To Bill Tab

Users To Bill represent the individuals or accounts that billing should be attributed to. These are used in the Customer Billing tab to assign billing responsibility.

  1. Click the User To Bill tab.
  2. Enter a Name (required) — the user or account name.
  3. Enter a Description — optional notes.
  4. Select a Region (required) — from Organisation → Catalogs (Type = Region).
  5. Click + Add User to add another row, or click Save to save.
  6. Click the delete icon (red bin) to remove a row before saving.
Cost Center User to bill

Cost Center User to bill

4.1 User To Bill Fields

FieldRequiredDescription
NameYesThe name of the user or billing account.
DescriptionNoFree text description.
RegionYesThe region this user belongs to. From Organisation → Catalogs (Type = Region).

5. How Cost Center Connects to Other Modules

Cost Center ItemUsed InPurpose
CommodityCustomer → Billing TabSelected as billable items. Each commodity is assigned a Minimum Cost and Cost Per Unit in the billing configuration.
LocationCustomer → Billing TabAssigned to each commodity in the billing table to indicate where the service is delivered or consumed.
User To BillCustomer → Billing TabAssigned to each commodity in the billing table to indicate who is responsible for the cost.

Billing data configured in the Customer module (using Cost Center items + Data Connector + Schedule) feeds into the Cost Tracker module for cost reporting and analysis.

6. Tips

7. Troubleshooting

IssueResolution
"Please add Region" bannerNo Regions exist in Catalogs. Navigate to Organisation → Catalogs and add Region values (Type = Region).
Region dropdown is emptySame as above — create Region values in Catalogs first.
Commodity not appearing in Customer BillingEnsure the commodity is saved. Check that the commodity's Region matches the customer's region if region-based filtering applies.
Cannot delete a commodity/location/userThe item may be in use in a customer's billing configuration. Remove the reference in the Customer Billing tab first.