Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.techfootintl.com/llms.txt

Use this file to discover all available pages before exploring further.

Metered Billing enables customer billing based on actual consumption captured through physical meters such as Electric, Gas, or Water meters. The system supports:
  • Meter assignment to subscriptions or connections
  • Meter reading uploads
  • Consumption-based billing
  • Active and inactive meter management
  • Batch-based billing processing Lifecycle

​
Create Meter

1- Go to Billspree → Pricing Templates →Meters
Screenshot From 2026 05 25 12 55 47
2- Use the “New” action to open Add New Meter
Screenshot From 2026 05 25 16 39 50
3- Fill: Meter Number_, Brand, Meter Type (from dropdown), Purchase Date, _MF. 4- Click the Save buttonNew meters start as unassigned and InActive until you assign them to a connection.

​
Where do we assign meters?

1- Go on Subscription screen click new Button
Screenshot From 2026 05 25 17 09 09
2- Click on the settings tab Select pricing template, plan variant, and batch
Screenshot From 2026 05 25 17 15 55
4- Meter tab appears Select Meter from the dropdown
Screenshot From 2026 05 25 17 16 40

​
Upload Meter Readings

Before billing can be processed, meter readings must first be uploaded into the system. These readings represent the customer’s actual utility consumption for a billing cycle. 1- Go to Billspree →Billing →Meter Readings
Screenshot From 2026 05 25 16 42 18
2- Select Reference type Meter Usage 3- Fill all fields and click on save button. Post Meter Readings After readings are uploaded, they must be posted from the billing term before billing execution. Posting validates and finalizes the readings for downstream billing calculations.

​
Assigning Meters

Meters are assigned from the Subscription screen.

​
Steps

  1. Open the Subscription screen\
  2. Navigate to the Settings tab\
  3. Select:
    • Pricing Template
    • Plan Variant
    • Batch\

  4. Open the Meter tab\

  5. Select the required meter from the dropdown\

​
Meter Connection Types

The platform supports two meter assignment flows.

​
New Connection Flow

During creation of a new connection, meters can be assigned directly from the Meters tab. Supported meter types:

  • Electric\

  • Gas\

  • Water\
For each meter:

  • Meter Number is provided\

  • Initial Reading is captured\
These details are submitted together with the connection request.

​
Existing Connection Flow

Meters can also be assigned to existing customer connections.

​
Steps


  1. Open Connection Details\

  2. View Active Meters\

  3. Use the Assign Meter flow\

​
Meter Assignment API

POST billspree/meters/make-connection-meter

​
Request Body

FieldDescription
connectionIDCustomer connection identifier
meterNumberMeter to assign
connectionDateMeter activation date
statusAssignment status

​
Assign Meter Component Behavior

The Assign Meter flow:

  • Loads all inactive/unassigned meters\

  • Filters meters by type:\

    • Electric\

    • Gas\

    • Water\

  • Allows selection and assignment to the connection\

​
Active vs Inactive Meters

​
Active Meter

An active meter is:

  • Currently linked to a customer connection\

  • Used for billing calculations\

  • Displayed under Active Meter Details\
Active meters participate in consumption billing.

​
Inactive Meter

An inactive meter is:

  • Not assigned to a connection\

  • Available for future assignments\

  • Excluded from billing operations\
Inactive meters typically appear in the available meter inventory.

​
Metered Billing Processing

Billing is generated using: 
Current Reading
        -
Previous Reading
        =
Consumption
Consumption is then evaluated through:

  • Rate Lists\

  • Charge Rules\

  • Plans\

  • Add-ons\
to generate customer charges.

​
Metered Billing Architecture

Meter
   ↓
Connection
   ↓
Meter Readings
   ↓
Billing Term Posting
   ↓
Consumption Calculation
   ↓
Charge Rules
   ↓