Skip to main content

Billing Determinants Calculation

Overview​

The Billing Determinants package calculates billing components using interval data or register reads and prepares messages for billing systems. This module ensures accurate and complete data is available for customer billing processes.

Process Flow​

Receive Billing Request

  • Request received from third-party billing system or
  • Triggered internally according to billing schedule and datasource tags

Load Data

  • Loads all data requested for the billing period
  • Rule: standard_load_data_preparation. See detailed description: standard_load_billing_data

Validate Data

  • Checks if all required data exists
  • Ensures data quality is measured or estimated See detailed description: standard_billing_validation

Calculate Billing Determinants

  • For register-based billing: calculates end register read for the period
  • For interval-based billing: aggregates data according to:
    • Contract periods
    • Meter change events
    • Time-of-use slices as defined in datasource tags *Rule: standard_billing_determinants_calculation. See detailed description: standard_billing_determinants_calculation

See detailed test cases: Billing Test Scenarios

Billing Collective Trigger

  • Sends message to the Billing Collective Trigger.
  • Rule: standard_billing_collective_trigger_forwarding

Billing Message Creation

  • Receives messages from collective trigger and sends to defined Pub/Sub topic
  • Rule: standard_billing_message_creation

Business Rules​

Billing Rules​

  1. Load Data Preparation

    • Rule: standard_load_data_preparation
    • Purpose : Loads data for the period needed for the billing

  2. Standard Billing Validation

    • Rule: standard_billing_validation
    • Purpose : Loads data for the period needed for the billing

  3. Billing Determinants Forwarding

  • Rule : standard_billing_determinants_calculation
  • Purpose : Formats and transmits billing determinants to billing systems
  • Customization : Configure message formats, delivery methods, and retry logic

Implementation Considerations​

Billing Cycles

  • Different customers may have different billing cycles
  • Configure billing triggers to match customer-specific schedules

Contract Changes

  • Handle mid-cycle contract changes appropriately
  • Prorate calculations across contract boundaries when needed

Meter Replacements

  • Account for meter changes during billing periods
  • Handle different meter multipliers correctly

Configuration Components​

Flow Designs​

  • Standard_Billing_Calculation_Flow
  • Standard_Billing_Forwarding_Flow

Transformation Configurations​

  • Standard_Billing_Tc

Market Adapter Configurations​

  • Standard_Billing_Request_From_Json_Ma

Billing Determinant Types​

The system can calculate various billing determinants including:

  • Consumption within specific time periods i.e. timeslices (Time-of-use TOU)
  • Peak demand values (Pmax)

Customization Opportunities​

Partners can customize this module by:

  1. Implementing market-specific billing determinant calculations
  2. Creating custom billing request triggers
  3. Adding specialized validation rules for billing data
  4. Configuring custom billing response formats
  5. Implementing customer-specific proration rules