63 lines
2.4 KiB
Markdown
63 lines
2.4 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
|
|
|
|
## QR-Zahlteil
|
|
|
|
Der QR-Zahlteil verwendet strukturierte Adressen (`S`) nach SIX SPS 2.3.
|
|
Er wird nur bei hinterlegter normaler CH/LI-IBAN und positivem Gesamtbetrag
|
|
erzeugt. QR-IBANs werden abgelehnt, da der Report keine QR-Referenz führt.
|
|
Benutzer- und Zahlungsempfängeradresse benötigen Name, PLZ, Ort und ISO-2-Land.
|
|
|
|
## 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` | Name des Zahlungsempfängers |
|
|
| `CreditorStreet` | Strasse des Zahlungsempfängers |
|
|
| `CreditorBuildingNumber` | Hausnummer des Zahlungsempfängers |
|
|
| `CreditorPostalCode` | PLZ des Zahlungsempfängers |
|
|
| `CreditorTown` | Ort des Zahlungsempfängers |
|
|
| `CreditorCountry` | ISO-2-Ländercode des Zahlungsempfängers |
|
|
| `BankIBAN` | normale CH/LI-IBAN für den QR-Zahlteil |
|
|
|
|
Bei einem Update müssen bisher kombinierte Benutzer- und Empfängeradressen einmalig
|
|
in die strukturierten Felder aufgeteilt und kontrolliert werden. Bei aktiver IBAN
|
|
verhindern fehlende QR-Pflichtfelder die Reporterzeugung.
|
|
|
|
## Bedienung
|
|
|
|
| Ident/Action | Beschreibung |
|
|
|---|---|
|
|
| `FromDate` | Startdatum |
|
|
| `ToDate` | Enddatum |
|
|
| `CreateReport` | erzeugt das PDF |
|
|
| `LastResult` | letzter Lauf |
|
|
| `ReportPDF` | erzeugtes PDF-Dokument |
|