Files
Enelix-Utils/Verbrauchskostenreport/README.md
T
dh d36bd29c31
Tests / test (push) Successful in 1m10s
Verbrauchskostenreport implementieren
2026-09-17 08:56:38 +00:00

49 lines
1.6 KiB
Markdown

# Verbrauchskostenreport
IP-Symcon-Modul zur Aufbereitung von Energie- und Nebenkosten als PDF-Report.
Das Modul verwendet eine eigenständige, neutrale öffentliche API mit dem
Präfix `VKR`. Aus Enelix 1 wurde ausschließlich die fachliche Berechnungslogik
adaptiert. Alte Modulnamen, Aktionen und Medien-Idents werden nicht angeboten.
Technische Anpassungen für IP-Symcon 8.0 und PHP 8.3 umfassen einen
deklarierten Laufzeit-Cache, ausgabefreie `RequestAction`-Aufrufe und das
Abmelden des WebHooks beim Löschen einer Instanz.
## Funktion
- erstellt pro Benutzer einen Verbrauchskostenreport
- berechnet Stromkosten aus Archivwerten in 15-Minuten-Schritten
- berücksichtigt Netz-, Solar- und Einspeisetarife
- berechnet zusätzliche Zählerkosten für Warmwasser, Kaltwasser und Wärme
- erzeugt optional einen Schweizer QR-Zahlteil
- unterstützt den konfigurierbaren MWST-Ausweis
## Konfiguration
| Property | Beschreibung |
|---|---|
| `Users` | Benutzerliste |
| `PowerMeters` | Stromzählerliste |
| `WaterMeters` | Nebenkostenzähler |
| `Tariffs` | Tarifliste |
| `LogoMediaID` | Logo für PDF-Kopf |
| `PropertyText` | Liegenschaftstext |
| `FooterText` | PDF-Fusszeile |
| `EnableVAT` | aktiviert MWST |
| `VATPercentage` | MWST-Satz |
| `CreditorName` | Zahlungsempfänger |
| `CreditorAddress` | Adresse Zahlungsempfänger |
| `CreditorCity` | PLZ/Ort Zahlungsempfänger |
| `BankIBAN` | IBAN für QR-Zahlteil |
## Bedienung
| Ident/Action | Beschreibung |
|---|---|
| `FromDate` | Startdatum |
| `ToDate` | Enddatum |
| `CreateReport` | erzeugt das PDF |
| `LastResult` | letzter Lauf |
| `ReportPDF` | erzeugtes PDF-Dokument |