Billing Input
Ablösung B/K Sätze, Ablösung L/M Sätze, sofern nicht in OSR enthalten
Diese Schnittstelle dient dem Austausch von Daten zur Abrechnung zwischen Hausverwaltungen und Messdienstleistern.
- Wir stellen für jeden Abrechnungszeitraum ein Template mit voreingestellten Daten bereit
- ERP übermittelt analog dem Template die Rechnungswerten, Verteilwerten etc. an uns
- Test-Übertragungen für Plausibilisierungen sind bei uns immer, beliebig oft und mit direkter Rückmeldung möglich
- Die Abrechnung wird mit der finalen Übertragung (kein Test-Modus) der Daten beauftragt
- Sollten die Abrechnungsdaten im Sofort-Check Fehler enthalten, wird keine Abrechnung ausgelöst
Für die Nutzung von Billing Input ist die Verwendung der OSR2.0 empfehlenswert!
Billing Input Beispiel-Szenario
Übertragung der Abrechnungsinformationen (ehemals B/K-Satz, so wie Teile des L/M Satzes)
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.
- 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).
Quelle: https://bved.info