# Power Billing Module

> Symcon documentation · English · generated on 2026-09-26  
> Index: https://www.symcon.de/en/llms.txt

Source: https://www.symcon.de/en/service/documentation/module-reference/energy/power-billing-module/

_Requires Symcon >= 5.0_

The module provides a cost statement similar to the annual statement from the energy provider.

### Scope of functions
- Generates a cost statement using some key data.

### Software installation
- Via the [Module Store](https://www.symcon.de/en/service/documentation/components/management-console/module-store/) install the 'Power Billing' Module.

### Setting up the instances in IP-Symcon
- Under "Add Instance" the 'Power Billing Module' can be found using the quick filter.
  - More information about adding instances in the [Instances documentation](https://www.symcon.de/en/service/documentation/basics/instances/)

#### Configuration Page:

| Name                | Description                                              |
| ------------------- | -------------------------------------------------------- |
| Source              | The variable of the main meter, which is logged as meter |
| Base price          | The base price                                           |
| Energy price        | The energy price                                         |
| Meter reading date  | Date of last meter reading                               |
| Last meter reading  | The meter reading on the last meter reading date         |
| Planned consumption | The planned electricity consumption/year                 |

### status variables and profiles
The status variables/categories are created automatically. Deleting individual ones can lead to malfunctions.

#### Status variables

| Name                                    | Type    | Description                                                                |
| --------------------------------------- | ------- | -------------------------------------------------------------------------- |
| Energy price                            | Float   | Energy price including basic price                                         |
| Days until next meter reading           | Integer | Days until next meter reading (1 year starting from last meter reading)    |
| Days since last meter reading           | Integer | Days since last meter reading                                              |
| Meter Reading(Target)                   | Float   | The target value of today's meter reading based on the planned consumption |
| Planned Consumption/Day                 | Float   | The planned consumption per day based on the planned annual consumption    |
| Average consumption of the last 30 days | Float   | The average value of the consumption of the last 30 days                   |
| Deviation                               | Float   | The deviation of the actual meter reading from the target value            |
| Credit/Repayment                        | Float   | The amount of repayment or credit calculated by the deviation              |

#### Profile:

| Name           | Type    |
| -------------- | ------- |
| SAM.EuroRating | Float   |
| SAM.PowerPrice | Float   |
| SAM.Calendar   | Integer |

### Visualization
All important calculated values are displayed here.

## SAM_UpdateCalculations

Source: https://www.symcon.de/en/service/documentation/module-reference/energy/power-billing-module/sam-updatecalculations/

`bool SAM_UpdateCalculations(int $InstanceID)`

_Requires Symcon >= 5.0_

**Parameters**

- `$InstanceID` (int): ID of the Instance

**Returns** (bool): If the command could be executed successfully, it returns __TRUE__ as result, otherwise __FALSE__.

ID of the Instance

**Example**

```text
SAM_UpdateCalculations(12345);
```