
  BVED billing-unit-data API
  ==========================
 
 
     Allgemeine Informationen
    ------------------------

    Diese Schnittstelle dient dem Abgleich von Stammdaten der Abrechnungseinheiten zwischen Hausverwaltungen
    (Property Manager, PM) und Messdienstleistern (Measuring Service Company, MSC) und ersetzt den A-Satz Abgleich:

    * Der Messdienstleister stellt Informationen über verfügbare Abrechnungseinheiten für den aktuellen Benutzer bereit
    * Hausverwaltungen senden Informationen über neue oder aktualisierte Wohneinheiten an den Messdienstleister,
      der im Anschluss seine Ordnungsbegriffe dazu bereitstellt
	* Die Liste der Abrechnungseinheiten sollte regelmäßig abgefragt werden und den Verarbeitungsstatus der Abrechnungseinheiten zu aktualisieren und ggf aktualisierte Objekte abzurufen. 
 
    Details sind der openapi Dokumentation "bved-billing-unit-data-1-0.openapi.yaml" zu entnehmen.
	
	 Datenmodell und Prüfungen
    -------------------------
     Abruf der verfügbaren Objekte :
     Mit der Operation 'getBillingunits' können verfügbare Abrechnungseinheiten abgefragt werden.
	 Die Response enthält eine Liste mit allen verfügbaren Objekten inkl. ihrem Einrichtungs- bzw. Verarbeitungsstatus
	 
	 Übertragung der zuzuordnenden Nutzeinheiten:
	 Mit der Operation 'postBillingunitsSetup' kann die Liste der abzugleichenden Nutzeinheiten einer Abrechnungseinheit an den MSC übertragen werden.  
     Der Request enthält Details zur Lage der Nutzeinheit und zum aktuellen Nutzer, sowie Flächenangaben. Diese Daten dienen nur Zuordnung der Objekte zu den beim MSC vorliegenden Objekten und werden nicht gespeichert.  
	 
	 Abruf der fertig zugeordneten Objekte:
	 Mit der Operation  'getBillingunitsSetup' können fertige zugeordnete Ordnungsbegriffe für eine Abrechnungseinheit abgefragt werden.
     Die Response enthält eine Liste mit allen zugeordneten Nutzeinheiten und optional eine Liste mit Nutzeinheiten die im System des MSC vorhanden sind aber nicht vorher vom PM an den MSC übertragen wurden. 
	

    Sicherheit
    ----------

    Die Schnittstelle ist mit OAuth 2 -Verfahren gesichert.
	Dei Endpunkte sind beim jeweiligen MSC zu erfragen.
    Die Datenübertragung muss über einen sicheren Kanal erfolgen (HTTPS/SSL).
