On-Site Roles 2.0 für EcoTrend
Vereinfachung von OSR 1; Übertragung der Verbrauchsempfänger- Informationen
Diese Schnittstelle (kurz OSR 2) dient dem fortlaufenden Austausch von Partnern und ihren Rollen zwischen Hausverwaltungen und Messdienstleistern.
- Neue Version von OSR 1 mit vereinfachtem Datenmodell
- ERP sendet aktuelle Daten, wir erkennen und verarbeiten Änderungen im Hintergrund über einen Vollabgleich.
- Plausibilisierung bei uns immer möglich und mit sofortiger Rückmeldung
- Keine Insert/Update/Delete-Aktionen und keine Status-Abfrage mehr notwendig
- Abruf der zuletzt erfolgreich gesendeten Daten möglich
OSR 2 kann als Stand-alone Schnittstellen für die Übertragung der Verbrauchsempfänger der unterjährigen Verbrauchsinformation (uVI) in Verbindung mit EcoTrend Comfort genutzt werden.
Quelle: https://bved.info
On-Site Roles 2.0 Beispiel-Szenario
Übertragung der Abrechnungs- und Verbrauchsempfänger
Verarbeitungshindernisse
- Die API erfordert eine Authentifizierung per OAuth 2.
- Falls die Authentifizierung fehlschlägt, wird die Anfrage mit 401 Unauthorized abgelehnt.
- Der Zugriff auf Abrechnungsdaten ist nur für autorisierte Benutzer möglich.
- Falls der Benutzer keine Berechtigung für die angeforderte Abrechnungseinheit besitzt, wird die Anfrage mit 403 Forbidden abgelehnt.
- Die API setzt voraus, dass eine vertragliche Vereinbarung zwischen Property Manager (PM) und Messdienstleister (MSC) besteht.
- Die Nummer der Abrechnungseinheit (billingunit) muss ein gültiges Format haben.
- Die Nutzeinheit (residentialunit) muss existieren und für den Datenaustausch geeignet sein.
- Jeder übermittelte Vertrag muss einem gültigen Partner (pmnumber) zugeordnet sein.
- Falls eine Rolle auf einen Partner verweist, dieser aber nicht in der Anfrage enthalten ist, führt dies zu einem Validierungsfehler.
- Die Vertragszeiträume müssen gültig sein (z. B. validfrom darf nicht nach validto liegen).
- Historische Daten (bereits in der Vergangenheit beendete Verträge) bleiben beim MSC unverändert.
Falls Verbrauchsinformationsverträge übermittelt werden, muss die Abrechnungseinheit für diesen Dienst freigeschaltet sein.
- Rollen, die nicht mehr gesendet werden, werden automatisch beendet oder gelöscht, wenn sie nur für die Zukunft geplant waren.
- Alle Rollen können explizit beendet werden, indem terminateallbillingcontracts terminateallconsumptioninformationcontracts auf true gesetzt wird.
- Namen dürfen nicht nur aus Leerzeichen bestehen.
- Der Ländercode muss der ISO 3166-1 alpha-3 Norm entsprechen (z. B. DEU für Deutschland).
- Telefonnummern dürfen nur zulässige Zeichen (+, (), -, / und Ziffern) enthalten.
- IBAN-Nummern müssen dem Standardformat entsprechen (Länderkennzeichen + 20 Zahlen