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 (Property Manager, PM) und Messdienstleistern (Measuring Service Company, MSC).
- Wir stellen für jeden Abrechnungszeitraum eine „Schablone“ mit voreingestellten Daten bereit
- ERP füllt die Schablone mit Rechnungen, Verteilwerten etc. aus und sendet sie an uns
- Plausibilisierung sind bei uns immer und mit direkter Rückmeldung möglich.
- Test-Plausibilisierung beliebig oft möglich
- Nach Senden mit erfolgreicher Plausibilisierung gilt der Abrechnungszeitraum für die Abrechnung als beauftragt
Für die Nutzung von Billing Input ist immer ebenfalls
OSR2.0 notwendig!
Quelle: https://bved.info
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).