Neue Spezifikationen
Neue Spezifikationen
Hier finden Sie die neuen Spezifikationen für den Datenaustausch. Diese sorgen künftig für mehr Einheitlichkeit, Kontrolle und effizientere Prozesse. Bei Fragen können Sie jederzeit Kontakt mit uns aufnehmen.
Hier können Sie den aktuellen Stand der Servicespezifikation als OpenAPI yaml-Dateien herunterladen.
Achtung eine neue Version der hier vorgestellten Schnittstellen ist veröffentlicht
Änderungen zur Vorversion für alle Schnittstellen:
- Einheitliche URLs
- billingunitdata/v1/…
- billinginput/v1/…
- billingresult/v1/…
- onsiteroles/v2/…
- Header X-API-VERSION in allen Antworten ergänzt
- Einheitliche Antwort-Strukturen, um den Header zu ergänzen
- Behebung von Inkonsistenzen und Fehlern bei Dokumentation und Pflichtfeldern
- Einheitliche Bezeichnungen für Warmwasser / Hot Water
- OAuth Flow wurde in Version x.0.2 auf Client Credentials Flow angepasst
Billing Unit Data
Ablösung des Ordnungsbegriff-Tauschs für Abrechnungs- und Nutzeinheiten über PDF-/Excel-Dateien
- ERP sendet Liste der Nutzeinheiten mit eigenen Ordnungsbegriffen, Namen, Flächen etc.
- Messdienstleister ordnet die Daten zu und stellt eigene Ordnungsbegriffe bereit
- Asynchron, da ggf. manueller Prozess notwendig
- Ersetzt den A-Satz Austausch
Änderungen zur Vorversion:
v1.0.2
- Service-Pfad-Präfix ergänzt: /billingunitdata/v1/
- X-API-VERSION Response-Header an allen Endpunkten
- Vereinheitlichte Fehler-Antworten via gemeinsame Definitionen
- Positionsfeld (position): maximale Länge von 10 auf 20 Zeichen erhöht
v1.0.1
- Korrektur: Werttyp des Beispiels für das Positionsfeld
v1.0
- Erstveröffentlichung
On-Site-Roles 2
Neue Version mit vereinfachtem Datenmodell
- ERP sendet aktuelle Daten, Messdienstleister erkennt und verarbeitet Änderungen im Hintergrund
- Plausibilisierung beim Messdienstleister immer sofort mit direkter Rückmeldung
- Keine Insert/Update/Delete-Aktionen und keine Status-Abfrage mehr notwendig
- Abruf der zuletzt erfolgreich gesendeten Daten möglich
Änderungen zur Vorversion:
v2.0.2
- Service-Pfad-Präfix ergänzt: /onsiteroles/v2/
- X-API-VERSION Response-Header an allen Endpunkten
- Vereinheitlichte Fehler-Antworten via gemeinsame Definitionen
- 404-Response für PUT-Endpunkt ergänzt
- Verarbeitung nicht mehr gesendeter Rollen: Klarstellung, dass das Verhalten vom MSC abhängt (Fehler, Beenden oder Löschen möglich)
- Abrechnungsempfänger: Übermittlung muss lückenlos und überschneidungsfrei sein; für nicht vermietete Zeiträume wird ein Partner mit Leerstandskennzeichen erwartet
- Empfehlung: Rollen für verschiedene Dienstleistungen sollen getrennt gesendet werden
- Beendigungsdatum ist Pflichtfeld, wenn terminateallbillingcontracts bzw. terminateallconsumptioninformationcontracts auf true gesetzt wird
v2.0
- Erstveröffentlichung der v2-API (ersetzt arge-spec-on-site-roles 1.x)
- Separate optionale Rollen für Abrechnungsempfänger (billingcontracts) und Verbrauchsinformationsempfänger (consumptioninformationcontracts)
- Beende-alle-Flags für Abrechnungs- und Verbrauchsinformationsverträge
- Eigentümer-Kennzeichen
- OAuth 2 Sicherheit
Billing Input
API zur Beauftragung der Abrechnung (Ablösung B/K-Sätze und L/M-Sätze, sofern nicht in On-Site-Roles enthalten).
Messdienstleister stellt für jeden AZ „Schablone“ mit voreingestellten Daten bereit.
ERP füllt die Schablone mit Rechnungen, Verteilwerten etc. aus und sendet sie an den Messdienstleister.
Plausibilisierung beim Messdienstleister immer sofort mit direkter Rückmeldung Test-Plausibilisierung beliebig oft möglich. Nach Senden mit erfolgreicher Plausibilisierung gilt der Abrechnungszeitraum für die Abrechnung als beauftragt.
Änderungen zur Vorversion:
v1.0.3
- allocationkey ist nun Pflichtfeld bei Kostenzuordnungen
- amounts ist nun Pflichtfeld bei Rechnungen (Energieträger, Heiznebenkosten, Nebenkosten)
- Kostenschlüssel-Gruppe V05 eingeführt
- Gesamtemissionsfaktor CO2 (factor) auf Abrechnungseinheitsebene ist kein Pflichtfeld mehr
v1.0.2
- Service-Pfad-Präfix ergänzt: /billinginput/v_1/
- X-API-VERSION Response-Header an allen Endpunkten
- Vereinheitlichte Fehler-Antworten via gemeinsame Definitionen
- Doku: Verarbeitungslogik für beendete Partner ergänzt
v1.0.1
- Einheitliche Benennung des Feld "text" (statt "customtext")
- Einheitliche Bennung der Liste "allocations" (statt "allocation"
- Einheitliche Benennung des Feld "cost" (statt "costkey")
- Einheitliche Benennung des Feld "invoicedate" (statt "date" oder "invoiceDate")
- Einheitliche Benennung des Feld "vatdisplay" (statt "vatDisplay")
- Änderung der Feldlänge für Kostenbezeichnungen von 19 auf 25 Zeichen
- Gültigkeitszeitraum für Nutzer-Verteilschlüssel ergänzt
- Gemeinsame Vorauszahlung Heizung und Warmwasser ergänzt
- Lagerbestände im Template ergänzt
- Neue Struktur für Fehlermeldungen, die jetzt den gesendeten Objekten zugeordnet werden
- Enum-Konstante ergänzt für kein MwSt.-Ausweis
- Negative Rechnungsbeträge für Lagerbestände und Gutschriften möglich
- Lagerbestände haben eine Einheit und sind CO2-bewertet
- Neue Fehler Struktur für detaillierte Rückgabe von Fehlermeldungen
Billing Result
Messdienstleister stellt Liste der Abrechnungszeiträume pro Liegenschaft bereit, für die Abrechnungsergebnisse vorliegen.
Pro Abrechnungseinheit und Abrechnungszeitraum werden nutzerbezogen Abrechnungsergebnisse bereitgestellt.
Änderungen zur Vorversion:
v1.0.3
- Aufnahme von updated in Liste der verfügbaren Abrechnungseinheiten, um die Aktualität der Abrechnung zu kennzeichnen
v1.0.2
- Service-Pfad-Präfix ergänzt: /billingresult/v1/
- X-API-VERSION Response-Header an allen Endpunkten
- Vereinheitlichte Fehler-Antworten via gemeinsame Definitionen
v1.0.1
- Struktur des Results für getBillingPeriods an die äquivalente Funktion des billing-input angepasst
- Strukturen von Elementen in billingbalances (totalcosts, balances, budgetpayments) an amounts-Struktur entsprechend billing-input angepasst
- costpositionspar35a umbenannt zu wagecosts
- amounts in CO2-Kosten entsprechend billing-input angepasst
- vatMode in billingbalance entfällt