

 BVED Billing Input API
 =======================

	Allgemeine Informationen
    ------------------------
   Diese Schnittstelle dient dem Austausch von Daten zur Abrechnung zwischen Hausverwaltungen (Property Manager, PM) und Messdienstleistern (Measuring Service Company, MSC).

   Sie soll die B/K-Sätze und L/M-Sätze ablösen, sofern die Daten nicht in On-Site-Roles enthalten sind( z.B.  Vorauszahlungen; Flächenänderungen ) 
   Der Messdienstleister stellt für jeden Abrechnungszeitraum eine „Schablone“ mit voreingestellten Daten bereit. 
   Der Kunde füllt über sein ERP-System die Schablone mit Rechnungen, Verteilwerten etc. aus und sendet sie an den Messdienstleister
   Eine Plausibilisierung beim Messdienstleister erfolgt immer sofort, mit direkter Rückmeldung.
   Test-Plausibilisierung sind beliebig oft möglich.
   Nach Senden mit erfolgreicher Plausibilisierung gilt der Abrechnungszeitraum für die Abrechnung als beauftragt

   Details sind er openapi Dokumentation "bved-billing-input-1-0-RC2.openapi.yaml" zu entnehmen.


    Datenmodell  und Prüfungen
    --------------------------
   Abruf Abrechnungszeiträume:
   Mit der Operation 'getBillingPeriods` können verfügbare Abrechnungszeiträume für eine Abrechnugseinheit abgefragt werden.

   Abrechnungs-Schablone: Für eine Liegenschaft und dazugehörigen Abrechnungszeitraum kann mit der Operation `getBillingTemplate`eine sog. Abrechnungs-Schablone beim MSC abgefragt werden.
   Diese enthält Information über beim MSC definierte Dienstleistungen und dient so als Vorlage für den Abrechnungsauftrag, in dem die konkreten Daten ausgefüllt werden
	 * currency: Währung der Abrechnung wie beim MSC hinterlegt
	 * expectedvat: Mehrwertsteuerart der Abrechnung wie beim MSC hinterlegt 
	 * energysources: Brennstoff wie beim MSC hinterlegt mit Einstellungen und Kostenschlüsseln
	 * co2configuration: CO2-Einstellungen gemäß deutscher Gesetzgebung basierend auf ARGE 3.10 wie beim MSC hinterlegt
	 * heatingsystemcosts: Erwartete Kostenschlüssel für Heiznebenkosten 
     * ancillarycosts: Erwartete Kostenschlüssel für Hausnebenkosten
     * billingrecipients: Beim MSC hinterlegte Abrechnungsempfänger, wie sie vorab über die ARGE On-Site-Roles-API 2.0 übermittelt wurden
	 * riskallocationdefaultpercentage: Standard-Prozentsatz UAW für die Abrechnungseinheit
	
   Abrechnungs-Auftrag:
   Der eigentliche Abrechnungs-Auftrag basierend auf der Schablone enthält folgende Informationen für den Abrechnungszeitraum:
	 * currency: Währung der Abrechnung
     * expectedvat: Mehrwertsteuerart der Abrechnung
     * energysources: Daten zu Brennstoffkosten, insbesondere Rechnungen und Lagerbestände
     * co2configuration: CO2-Einstellungen gemäß deutscher Gesetzgebung basierend auf ARGE 3.10
     * heatingsysteminvoices: Rechnungen zu Heiznebenkosten
     * ancillaryinvoices: Rechnungen zu Hausnebenkosten 
     * billingrecipients`: Abrechnungsinformationen zur Abrechnungsempfängern, wie sie vorab über die ARGE On-Site-Roles-API 2.0 übermittelt wurden; insbesondere 
                       Verteilschlüssel, Vorauszahlungen,Mehrwertsteuer-Informationen, 
     * riskallocationdefaultpercentage: Standard-Prozentsatz UAW für die Abrechnungseinheit

   Der Abrechnungsauftrag kann mit der Operation `sendBillingInput` übermittelt werden.
     * Aktion `VALIDATE`: Der Abrechnungsauftrag kann jederzeit plausibilisiert werden . Es werden ggf. Fehlermeldungen zurückgegeben, aber keine Daten beim MSC gespeichert.
     * Aktion `SEND`: Übermittlung des Abrechnungsauftrags, aber mit Abbruch im Fall von Warnungen und Fehlermeldungen. Gibt es weder Warnungen noch Fehler gilt die Abrechnung als beauftragt.
     * Aktion `SEND_AND_IGNORE_WARNINGS`: Übermittlung des Abrechnungsauftrags hier werden Warnungen ignoriert eine ein Abbruch erfolgt nur in Fehlerfällen treten keine Fehler auf, gilt die Abrechnung als beauftragt.

    Sicherheit
    ----------

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