Billing Input

• 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.

• Die Abrechnung muss eine gültige Währung (currency) enthalten.
• Die Mehrwertsteuerart (expectedvat) muss angegeben und korrekt sein.

• Alle erwarteten Kosten für Energiequellen (energysources) müssen vollständig erfasst sein.
• Fehlende Kosten für Energiequellen mit REQUIRED-Markierung führen zu einer Fehlermeldung.
• Falls vorhanden, müssen Heizöl-Rechnungen und Lagerbestände korrekt sein.

• Die Konfiguration für CO₂-Abgaben muss den gesetzlichen Vorgaben entsprechen.
• Werte wie Gesamtwohnfläche, gewerbliche Nutzung und mögliche Verbesserungen müssen plausibel sein.

• Erwartete Kostenschlüssel für Heizsysteme (heatingsystemcosts) und Betriebskosten (ancillarycosts) müssen angegeben sein.
• Fehlende Werte für REQUIRED-Markierungen verursachen Validierungsfehler.

• Empfänger müssen vorher über die bved On-Site-Roles-API registriert worden sein.
• Daten wie Gültigkeitszeiträume, Partnernummern und Verteilungsschlüssel müssen vollständig sein.

• Rechnungen für Heiznebenkosten (heatingsysteminvoices) und Hausnebenkosten (ancillaryinvoices) müssen vollständig sein.
• Beträge müssen korrekt berechnet und mit dem entsprechenden Mehrwertsteuersatz versehen sein.

Falls aktiviert, muss der Standard-Prozentsatz für die Risikoverteilung (riskallocationdefaultpercentage) angegeben sein.

• Möglichkeit zur Überprüfung der Daten ohne Speicherung (VALIDATE).
• Übermittlung mit Abbruch bei Warnungen (SEND).
• Übermittlung unter Ignorieren von Warnungen (SEND_AND_IGNORE_WARNINGS).