On-Site Roles 2.0 für die Heizkostenabrechnung

• 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