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

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

Version 1.0.1 Änderungen zur Vorversion:

  • Änderung der Feldlänge für Lagebeschreibung von 10 auf 20 Zeichen
  • Einheitliche URLs:  billingunitdata/v1/…

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

Version 2.0.1 Änderungen zur Vorversion: 

  • keine siehe Technische Änderungen bei allen Schnittstellen

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.

Version 1.0.1 Änderungen zur Vorversion:

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

Version 1.0.1 Änderungen zur Vorversion:  

  • Korrekturen bei Datumsfeldern
  • Einheitliche Benennungen wie Billing Input
  • Korrekturen bei Pflichtfeldern