{"openapi":"3.1.0","info":{"title":"AssetApp API","version":"v1","description":"**Beta:** Endpunkte, Felder und Verhalten k\u00f6nnen sich noch \u00e4ndern. Dokumentation: [\/api\/v1\/docs](\/api\/v1\/docs)"},"servers":[{"url":"\/"}],"paths":{"\/api\/v1\/apartment-areas\/{id}":{"patch":{"operationId":"api_v1apartment-areas_id_patch","tags":["Einheiten"],"responses":{"200":{"description":"ApartmentArea resource updated","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/ApartmentArea.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ApartmentArea"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"},"404":{"description":"Resource not found"}},"summary":"Fassung der Fl\u00e4chen korrigieren","description":"Korrigiert eine bestehende Fassung; nicht gesendete Felder bleiben unver\u00e4ndert. F\u00fcr eine \u00c4nderung ab einem Datum eine neue Fassung erfassen. Bereits \u00fcbermittelte Abrechnungen bleiben unver\u00e4ndert.","parameters":[{"name":"id","in":"path","description":"ApartmentArea identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"requestBody":{"description":"The updated ApartmentArea resource","content":{"application\/merge-patch+json":{"example":{"personCount":3},"schema":{"$ref":"#\/components\/schemas\/ApartmentArea.AreaUpdate"}},"application\/json":{"example":{"personCount":3},"schema":{"$ref":"#\/components\/schemas\/ApartmentArea.AreaUpdate"}}},"required":true},"deprecated":false}},"\/api\/v1\/apartments":{"get":{"operationId":"api_v1apartments_get_collection","tags":["Einheiten"],"responses":{"200":{"description":"Apartment collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/Apartment.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/Apartment"}}}}}},"summary":"Einheiten auflisten","description":"Retrieves the collection of Apartment resources.","parameters":[{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":1},"style":"form","explode":false,"allowReserved":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":100,"minimum":0,"maximum":500},"style":"form","explode":false,"allowReserved":false},{"name":"identifier","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"identifier[]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true,"allowReserved":false},{"name":"label","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"property","in":"query","description":"Filtert nach der UUID von \u201eproperty\u201c.","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false,"example":"004b417e-6f8a-40bc-93c6-2b05d5bb1049"},{"name":"updatedAt[before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"changedSince","in":"query","description":"Nur Eintr\u00e4ge, die selbst oder deren mitgelieferte Daten (z. B. Adresse, Kontaktdaten) seit diesem Zeitpunkt angelegt oder ge\u00e4ndert wurden (ISO 8601).","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false,"example":"2026-10-01T00:00:00+02:00"}],"deprecated":false}},"\/api\/v1\/apartments\/{apartmentId}\/areas":{"get":{"operationId":"api_v1apartments_apartmentIdareas_get_collection","tags":["Einheiten"],"responses":{"200":{"description":"ApartmentArea collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/ApartmentArea.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/ApartmentArea"}}}}}},"summary":"Fl\u00e4chen und Personen einer Einheit","description":"Alle Fassungen, \u00e4lteste zuerst. Eine Fassung gilt ab `validFrom` bis zur n\u00e4chsten; die erste gilt von Anfang an (`validFrom` = null).","parameters":[{"name":"apartmentId","in":"path","description":"ApartmentArea identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false},{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":1},"style":"form","explode":false,"allowReserved":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":100,"minimum":0,"maximum":500},"style":"form","explode":false,"allowReserved":false}],"deprecated":false},"post":{"operationId":"api_v1apartments_apartmentIdareas_post","tags":["Einheiten"],"responses":{"201":{"description":"ApartmentArea resource created","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/ApartmentArea.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/ApartmentArea"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"}},"summary":"Neue Fassung der Fl\u00e4chen erfassen","description":"Neue Fl\u00e4chen, Anteile oder Personenzahl ab einem Datum, z. B. nach einem Umbau oder bei einem Mieterwechsel mit anderer Personenzahl. Bereits \u00fcbermittelte Abrechnungen bleiben unver\u00e4ndert. Hat die Einheit noch keine Fassung, gilt die neue von Anfang an.","parameters":[{"name":"apartmentId","in":"path","description":"ApartmentArea identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"requestBody":{"description":"The new ApartmentArea resource","content":{"application\/ld+json":{"example":{"validFrom":"2026-07-01","area":78.5,"heatingArea":78.5,"warmWaterArea":78.5,"additionalCostArea":78.5,"commercialArea":0,"ownershipShare":112.5,"personCount":2},"schema":{"$ref":"#\/components\/schemas\/ApartmentArea.AreaCreate.jsonld"}},"application\/json":{"example":{"validFrom":"2026-07-01","area":78.5,"heatingArea":78.5,"warmWaterArea":78.5,"additionalCostArea":78.5,"commercialArea":0,"ownershipShare":112.5,"personCount":2},"schema":{"$ref":"#\/components\/schemas\/ApartmentArea.AreaCreate"}}},"required":true},"deprecated":false}},"\/api\/v1\/apartments\/{id}":{"get":{"operationId":"api_v1apartments_id_get","tags":["Einheiten"],"responses":{"200":{"description":"Apartment resource","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/Apartment.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Apartment"}}}},"404":{"description":"Resource not found"}},"summary":"Einheit abrufen","description":"Retrieves a Apartment resource.","parameters":[{"name":"id","in":"path","description":"Apartment identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false},"patch":{"operationId":"api_v1apartments_id_patch","tags":["Einheiten"],"responses":{"200":{"description":"Apartment resource updated","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/Apartment.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Apartment"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"},"404":{"description":"Resource not found"}},"summary":"Stammdaten einer Einheit \u00e4ndern","description":"Bezeichnung, Lage, Etage und Partnernummer. Fl\u00e4chen, Anteile und Personenzahl werden als Fassungen unter \u201eFl\u00e4chen und Personen einer Einheit\u201c gepflegt.","parameters":[{"name":"id","in":"path","description":"Apartment identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"requestBody":{"description":"The updated Apartment resource","content":{"application\/merge-patch+json":{"example":{"label":"Wohnung 04","location":"links","floor":2},"schema":{"$ref":"#\/components\/schemas\/Apartment.ApartmentUpdate"}},"application\/json":{"example":{"label":"Wohnung 04","location":"links","floor":2},"schema":{"$ref":"#\/components\/schemas\/Apartment.ApartmentUpdate"}}},"required":true},"deprecated":false}},"\/api\/v1\/billing-costs\/{id}":{"delete":{"operationId":"api_v1billing-costs_id_delete","tags":["Abrechnungen"],"responses":{"204":{"description":"BillingCost resource deleted"},"404":{"description":"Resource not found"}},"summary":"Kostenposition l\u00f6schen","description":"Removes the BillingCost resource.","parameters":[{"name":"id","in":"path","description":"BillingCost identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false},"patch":{"operationId":"api_v1billing-costs_id_patch","tags":["Abrechnungen"],"responses":{"200":{"description":"BillingCost resource updated","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/BillingCost.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/BillingCost"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"},"404":{"description":"Resource not found"}},"summary":"Kostenposition \u00e4ndern","description":"Nur die gesendeten Felder werden ge\u00e4ndert.","parameters":[{"name":"id","in":"path","description":"BillingCost identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"requestBody":{"description":"The updated BillingCost resource","content":{"application\/merge-patch+json":{"example":{"netAmount":92.44,"grossAmount":110},"schema":{"$ref":"#\/components\/schemas\/BillingCost.CostUpdate"}},"application\/json":{"example":{"netAmount":92.44,"grossAmount":110},"schema":{"$ref":"#\/components\/schemas\/BillingCost.CostUpdate"}}},"required":true},"deprecated":false}},"\/api\/v1\/billing-documents\/{id}":{"get":{"operationId":"api_v1billing-documents_id_get","tags":["Abrechnungen"],"responses":{"200":{"description":"BillingDocument resource","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/BillingDocument.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/BillingDocument"}}}},"404":{"description":"Resource not found"}},"summary":"Abrechnungsdokument abrufen","description":"Retrieves a BillingDocument resource.","parameters":[{"name":"id","in":"path","description":"BillingDocument identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false}},"\/api\/v1\/billing-documents\/{id}\/pdf":{"get":{"operationId":"api_v1billing-documents_idpdf_get","tags":["Abrechnungen"],"responses":{"200":{"description":"PDF-Datei","content":{"application\/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"description":"Resource not found"}},"summary":"PDF eines Abrechnungsdokuments herunterladen","description":"Mit `Accept: application\/pdf` abrufen.","parameters":[{"name":"id","in":"path","description":"BillingDocument identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false}},"\/api\/v1\/billings":{"get":{"operationId":"api_v1billings_get_collection","tags":["Abrechnungen"],"responses":{"200":{"description":"Billing collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/Billing.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/Billing"}}}}}},"summary":"Abrechnungsperioden auflisten","description":"Abrechnungsperioden aller Liegenschaften, auf die die Integration Zugriff hat. Mit `state=DONE\u0026changedSince=\u2026` lassen sich neu fertiggestellte Abrechnungen abfragen.","parameters":[{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":1},"style":"form","explode":false,"allowReserved":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":100,"minimum":0,"maximum":500},"style":"form","explode":false,"allowReserved":false},{"name":"state","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"state[]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true,"allowReserved":false},{"name":"begin[before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"begin[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"begin[after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"begin[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"end[before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"end[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"end[after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"end[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"property","in":"query","description":"Filtert nach der UUID von \u201eproperty\u201c.","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false,"example":"004b417e-6f8a-40bc-93c6-2b05d5bb1049"},{"name":"changedSince","in":"query","description":"Nur Eintr\u00e4ge, die selbst oder deren mitgelieferte Daten (z. B. Adresse, Kontaktdaten) seit diesem Zeitpunkt angelegt oder ge\u00e4ndert wurden (ISO 8601).","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false,"example":"2026-10-01T00:00:00+02:00"}],"deprecated":false},"post":{"operationId":"api_v1billings_post","tags":["Abrechnungen"],"responses":{"201":{"description":"Billing resource created","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/Billing.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Billing"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"}},"summary":"Abrechnungsperiode anlegen (kostenpflichtig)","description":"**Kostenpflichtig:** bucht die Grundleistung `00001`, die Leistungen der gew\u00e4hlten Kostenarten und bei einem Zeitraum k\u00fcrzer als ein Jahr zus\u00e4tzlich `00039`; Preise unter `GET \/api\/v1\/properties\/{propertyId}\/price-list`. Es gelten die AGB der AssetEnergy GmbH (https:\/\/www.assetenergy.de\/agb). Mindestens eine Kostenart ist n\u00f6tig; Warmwasser wird mit der Heizkosten-Leistung abgerechnet und braucht eine hinterlegte Ermittlung des Warmwasseranteils (sonst 422, dann ohne Warmwasser anlegen und per `PATCH \/api\/v1\/billings\/{id}\/settings` hinzubuchen). \u00dcberschneidet der Zeitraum eine andere Abrechnungsperiode: 422 an `property`. Beginnt er in der Zukunft: 400.","parameters":[],"requestBody":{"description":"The new Billing resource","content":{"application\/ld+json":{"example":{"property":"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","begin":"2026-01-01","end":"2026-12-31","heatingCostEnabled":true,"warmWaterCostEnabled":true,"coldWaterCostEnabled":true},"schema":{"$ref":"#\/components\/schemas\/Billing.BillingCreate.jsonld"}},"application\/json":{"example":{"property":"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","begin":"2026-01-01","end":"2026-12-31","heatingCostEnabled":true,"warmWaterCostEnabled":true,"coldWaterCostEnabled":true},"schema":{"$ref":"#\/components\/schemas\/Billing.BillingCreate"}}},"required":true},"deprecated":false,"x-paid":true}},"\/api\/v1\/billings\/{billingId}\/costs":{"get":{"operationId":"api_v1billings_billingIdcosts_get_collection","tags":["Abrechnungen"],"responses":{"200":{"description":"BillingCost collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/BillingCost.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/BillingCost"}}}}}},"summary":"Kostenpositionen einer Abrechnung","description":"Heiz- und Warmwassernebenkosten sowie Kaltwasser und weitere Betriebskosten, nach Rechnungsdatum sortiert. Brennstoffe stehen unter \/fuel-deliveries.","parameters":[{"name":"invoiceNumber","in":"query","description":"Nur Positionen mit dieser Rechnungsnummer, z. B. um eine Rechnung vor dem Senden auf Dubletten zu pr\u00fcfen","required":false,"deprecated":false,"allowEmptyValue":false,"schema":[],"style":"form","explode":false,"allowReserved":false},{"name":"billingId","in":"path","description":"BillingCost identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false},"post":{"operationId":"api_v1billings_billingIdcosts_post","tags":["Abrechnungen"],"responses":{"201":{"description":"BillingCost resource created","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/BillingCost.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/BillingCost"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"}},"summary":"Kostenposition erfassen","description":"Die Kostenart (`key` aus \/api\/v1\/cost-types) bestimmt, ob die Position zu den Heiz- oder den Betriebskosten geh\u00f6rt. Nach dem \u00dcbermitteln der Kosten (Status SUBMITTED oder DONE) antwortet die API mit 409.","parameters":[{"name":"billingId","in":"path","description":"BillingCost identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"requestBody":{"description":"The new BillingCost resource","content":{"application\/ld+json":{"example":{"costType":"2030","date":"2025-11-14","invoiceNumber":"RE-2025-4711","netAmount":84.03,"grossAmount":100,"taxRate":19},"schema":{"$ref":"#\/components\/schemas\/BillingCost.CostCreate.jsonld"}},"application\/json":{"example":{"costType":"2030","date":"2025-11-14","invoiceNumber":"RE-2025-4711","netAmount":84.03,"grossAmount":100,"taxRate":19},"schema":{"$ref":"#\/components\/schemas\/BillingCost.CostCreate"}}},"required":true},"deprecated":false}},"\/api\/v1\/billings\/{billingId}\/documents":{"get":{"operationId":"api_v1billings_billingIddocuments_get_collection","tags":["Abrechnungen"],"responses":{"200":{"description":"BillingDocument collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/BillingDocument.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/BillingDocument"}}}}}},"summary":"Abrechnungsergebnisse und Dokumente","description":"Einzelabrechnungen (`APARTMENT_HEATING_BILL`) mit dem Ergebnis je Nutzer, die Gesamtabrechnung (`PROPERTY_HEATING_BILL`) und weitere Dokumente der Abrechnung. Die PDF-Datei liegt unter `pdf`.","parameters":[{"name":"billingId","in":"path","description":"BillingDocument identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false},{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":1},"style":"form","explode":false,"allowReserved":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":100,"minimum":0,"maximum":500},"style":"form","explode":false,"allowReserved":false}],"deprecated":false}},"\/api\/v1\/billings\/{billingId}\/fuel-deliveries":{"get":{"operationId":"api_v1billings_billingIdfuel-deliveries_get_collection","tags":["Abrechnungen"],"responses":{"200":{"description":"FuelDelivery collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/FuelDelivery.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/FuelDelivery"}}}}}},"summary":"Brennstoffe einer Abrechnung","description":"Anfangsbestand, Lieferungen und Endbestand mit Menge, Betrag und CO\u2082-Angaben, nach Datum sortiert.","parameters":[{"name":"billingId","in":"path","description":"FuelDelivery identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false},{"name":"invoiceNumber","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"invoiceNumber[]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true,"allowReserved":false}],"deprecated":false},"post":{"operationId":"api_v1billings_billingIdfuel-deliveries_post","tags":["Abrechnungen"],"responses":{"201":{"description":"FuelDelivery resource created","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/FuelDelivery.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/FuelDelivery"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"}},"summary":"Brennstoff erfassen","description":"Anfangsbestand, Lieferung oder Endbestand. Der Endbestand wird aus den Lieferungen bewertet (zuerst geliefert, zuerst verbraucht); Heizwert, Emissionsfaktor, CO\u2082-Menge und CO\u2082-Kosten werden erg\u00e4nzt, wenn sie fehlen. Nach dem \u00dcbermitteln der Kosten antwortet die API mit 409.","parameters":[{"name":"billingId","in":"path","description":"FuelDelivery identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"requestBody":{"description":"The new FuelDelivery resource","content":{"application\/ld+json":{"example":{"type":"PURCHASE","date":"2025-06-02","invoiceNumber":"OEL-2025-06","quantity":3000,"netAmount":2940,"grossAmount":3498.6,"taxRate":19},"schema":{"$ref":"#\/components\/schemas\/FuelDelivery.FuelDeliveryCreate.jsonld"}},"application\/json":{"example":{"type":"PURCHASE","date":"2025-06-02","invoiceNumber":"OEL-2025-06","quantity":3000,"netAmount":2940,"grossAmount":3498.6,"taxRate":19},"schema":{"$ref":"#\/components\/schemas\/FuelDelivery.FuelDeliveryCreate"}}},"required":true},"deprecated":false}},"\/api\/v1\/billings\/{id}":{"get":{"operationId":"api_v1billings_id_get","tags":["Abrechnungen"],"responses":{"200":{"description":"Billing resource","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/Billing.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Billing"}}}},"404":{"description":"Resource not found"}},"summary":"Abrechnungsperiode abrufen","description":"Retrieves a Billing resource.","parameters":[{"name":"id","in":"path","description":"Billing identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false}},"\/api\/v1\/billings\/{id}\/settings":{"get":{"operationId":"api_v1billings_idsettings_get","tags":["Abrechnungen"],"responses":{"200":{"description":"BillingSettings resource","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/BillingSettings.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/BillingSettings"}}}},"404":{"description":"Resource not found"}},"summary":"Abrechnungseinstellungen abrufen","description":"Verteilung (Grund- und Verbrauchskostenanteil, Warmwasseranteil) dieser Abrechnungsperiode sowie Heizungsanlage und Angaben zur CO\u2082-Kostenaufteilung (CO2KostAufG) der Liegenschaft.","parameters":[{"name":"id","in":"path","description":"BillingSettings identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false},"patch":{"operationId":"api_v1billings_idsettings_patch","tags":["Abrechnungen"],"responses":{"200":{"description":"BillingSettings resource updated","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/BillingSettings.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/BillingSettings"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"},"404":{"description":"Resource not found"}},"summary":"Kostenarten und Verteilung der Abrechnung \u00e4ndern (kostenpflichtig)","description":"Kostenarten, Grund- und Verbrauchskostenanteil, Umlagema\u00dfst\u00e4be und Warmwasseranteil dieser Abrechnungsperiode; nur die gesendeten Felder werden ge\u00e4ndert. **Kostenpflichtig**, wenn eine Kostenart hinzukommt (`*CostEnabled: true`): bucht deren Leistung, Preise unter `GET \/api\/v1\/properties\/{propertyId}\/price-list`; eine abgew\u00e4hlte Kostenart storniert ihre Leistung. Schl\u00e4gt eine Buchung fehl, werden bereits gebuchte Leistungen wieder storniert. Wer Warmwasser hinzubucht, braucht eine `warmWaterShareMethod` au\u00dfer NO_HOT_WATER. Kostenarten k\u00f6nnen f\u00fcr Abrechnungsperioden mit Beginn in der Zukunft nicht hinzugebucht werden (400). Brennstoff und CO\u2082-Angaben \u00e4ndert `PATCH \/api\/v1\/properties\/{id}\/settings`.","parameters":[{"name":"id","in":"path","description":"BillingSettings identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"requestBody":{"description":"The updated BillingSettings resource","content":{"application\/merge-patch+json":{"example":{"heatingBaseCostPercentage":30,"warmWaterShareMethod":"PERCENTAGE","warmWaterSharePercentage":18},"schema":{"$ref":"#\/components\/schemas\/BillingSettings.BillingSettingsUpdate"}},"application\/json":{"example":{"heatingBaseCostPercentage":30,"warmWaterShareMethod":"PERCENTAGE","warmWaterSharePercentage":18},"schema":{"$ref":"#\/components\/schemas\/BillingSettings.BillingSettingsUpdate"}}},"required":true},"deprecated":false,"x-paid":true}},"\/api\/v1\/cost-types":{"get":{"operationId":"api_v1cost-types_get_collection","tags":["Abrechnungen"],"responses":{"200":{"description":"CostType collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/CostType.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/CostType"}}}}}},"summary":"Kostenarten auflisten","description":"Alle aktiven Kostenarten. Kostenpositionen werden \u00fcber `key` zugeordnet; `argeKey` ist nicht eindeutig (z. B. teilen sich mehrere Heiznebenkosten den Schl\u00fcssel 228).","parameters":[],"deprecated":false}},"\/api\/v1\/devices":{"get":{"operationId":"api_v1devices_get_collection","tags":["Ger\u00e4te"],"responses":{"200":{"description":"Device collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/Device.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/Device"}}}}}},"summary":"Ger\u00e4te auflisten","description":"Mit `number` wird ein Z\u00e4hler \u00fcber seine Seriennummer gefunden.","parameters":[{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":1},"style":"form","explode":false,"allowReserved":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":100,"minimum":0,"maximum":500},"style":"form","explode":false,"allowReserved":false},{"name":"number","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"number[]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true,"allowReserved":false},{"name":"state","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"state[]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true,"allowReserved":false},{"name":"type","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"type[]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true,"allowReserved":false},{"name":"updatedAt[before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"property","in":"query","description":"Filtert nach der UUID von \u201eproperty\u201c.","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false,"example":"004b417e-6f8a-40bc-93c6-2b05d5bb1049"},{"name":"apartment","in":"query","description":"Filtert nach der UUID von \u201eapartment\u201c.","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false,"example":"004b417e-6f8a-40bc-93c6-2b05d5bb1049"},{"name":"changedSince","in":"query","description":"Nur Eintr\u00e4ge, die selbst oder deren mitgelieferte Daten (z. B. Adresse, Kontaktdaten) seit diesem Zeitpunkt angelegt oder ge\u00e4ndert wurden (ISO 8601).","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false,"example":"2026-10-01T00:00:00+02:00"}],"deprecated":false}},"\/api\/v1\/devices\/{deviceId}\/values":{"get":{"operationId":"api_v1devices_deviceIdvalues_get_collection","tags":["Z\u00e4hlerst\u00e4nde"],"responses":{"200":{"description":"DeviceValue collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/DeviceValue.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/DeviceValue"}}}}}},"summary":"Z\u00e4hlerst\u00e4nde eines Ger\u00e4ts","description":"Aktuelle und historische Z\u00e4hlerst\u00e4nde. `isBillingRelevant=true` liefert nur die abrechnungsrelevanten Werte.","parameters":[{"name":"deviceId","in":"path","description":"DeviceValue identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false},{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":1},"style":"form","explode":false,"allowReserved":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":100,"minimum":0,"maximum":500},"style":"form","explode":false,"allowReserved":false},{"name":"reportDate[before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"reportDate[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"reportDate[after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"reportDate[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"isBillingRelevant","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"boolean"},"style":"form","explode":false,"allowReserved":false},{"name":"order[reportDate]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string","enum":["asc","desc"]},"style":"form","explode":false,"allowReserved":false}],"deprecated":false},"post":{"operationId":"api_v1devices_deviceIdvalues_post","tags":["Z\u00e4hlerst\u00e4nde"],"responses":{"201":{"description":"DeviceValue resource created","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/DeviceValue.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/DeviceValue"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"}},"summary":"Z\u00e4hlerstand erfassen","description":"Erfasst einen manuellen Z\u00e4hlerstand. Manuelle Werte sind abrechnungsrelevant; das Datum muss im Einbauzeitraum des Ger\u00e4ts liegen.","parameters":[{"name":"deviceId","in":"path","description":"DeviceValue identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"requestBody":{"description":"The new DeviceValue resource","content":{"application\/ld+json":{"example":{"reportDate":"2026-06-30T12:00:00+02:00","value":1234.567},"schema":{"$ref":"#\/components\/schemas\/DeviceValue.ReadingCreate.jsonld"}},"application\/json":{"example":{"reportDate":"2026-06-30T12:00:00+02:00","value":1234.567},"schema":{"$ref":"#\/components\/schemas\/DeviceValue.ReadingCreate"}}},"required":true},"deprecated":false}},"\/api\/v1\/devices\/{id}":{"get":{"operationId":"api_v1devices_id_get","tags":["Ger\u00e4te"],"responses":{"200":{"description":"Device resource","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/Device.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Device"}}}},"404":{"description":"Resource not found"}},"summary":"Ger\u00e4t abrufen","description":"Retrieves a Device resource.","parameters":[{"name":"id","in":"path","description":"Device identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false}},"\/api\/v1\/fuel-deliveries\/{id}":{"delete":{"operationId":"api_v1fuel-deliveries_id_delete","tags":["Abrechnungen"],"responses":{"204":{"description":"FuelDelivery resource deleted"},"404":{"description":"Resource not found"}},"summary":"Brennstoff l\u00f6schen","description":"Removes the FuelDelivery resource.","parameters":[{"name":"id","in":"path","description":"FuelDelivery identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false},"patch":{"operationId":"api_v1fuel-deliveries_id_patch","tags":["Abrechnungen"],"responses":{"200":{"description":"FuelDelivery resource updated","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/FuelDelivery.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/FuelDelivery"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"},"404":{"description":"Resource not found"}},"summary":"Brennstoff \u00e4ndern","description":"Nur die gesendeten Felder werden ge\u00e4ndert.","parameters":[{"name":"id","in":"path","description":"FuelDelivery identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"requestBody":{"description":"The updated FuelDelivery resource","content":{"application\/merge-patch+json":{"example":{"quantity":3100},"schema":{"$ref":"#\/components\/schemas\/FuelDelivery.FuelDeliveryUpdate"}},"application\/json":{"example":{"quantity":3100},"schema":{"$ref":"#\/components\/schemas\/FuelDelivery.FuelDeliveryUpdate"}}},"required":true},"deprecated":false}},"\/api\/v1\/properties":{"get":{"operationId":"api_v1properties_get_collection","tags":["Liegenschaften"],"responses":{"200":{"description":"Property collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/Property.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/Property"}}}}}},"summary":"Liegenschaften auflisten","description":"Alle Liegenschaften, auf die die Integration Zugriff hat.","parameters":[{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":1},"style":"form","explode":false,"allowReserved":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":100,"minimum":0,"maximum":500},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"label","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"identifier","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"identifier[]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"array","items":{"type":"string"}},"style":"form","explode":true,"allowReserved":false},{"name":"changedSince","in":"query","description":"Nur Eintr\u00e4ge, die selbst oder deren mitgelieferte Daten (z. B. Adresse, Kontaktdaten) seit diesem Zeitpunkt angelegt oder ge\u00e4ndert wurden (ISO 8601).","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false,"example":"2026-10-01T00:00:00+02:00"}],"deprecated":false}},"\/api\/v1\/properties\/{id}":{"get":{"operationId":"api_v1properties_id_get","tags":["Liegenschaften"],"responses":{"200":{"description":"Property resource","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/Property.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Property"}}}},"404":{"description":"Resource not found"}},"summary":"Liegenschaft abrufen","description":"Retrieves a Property resource.","parameters":[{"name":"id","in":"path","description":"Property identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false}},"\/api\/v1\/properties\/{id}\/settings":{"get":{"operationId":"api_v1properties_idsettings_get","tags":["Liegenschaften"],"responses":{"200":{"description":"PropertySettings resource","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/PropertySettings.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PropertySettings"}}}},"404":{"description":"Resource not found"}},"summary":"Einstellungen der Liegenschaft abrufen","description":"Heizungsanlage, Brennstoff und Angaben zur CO\u2082-Kostenaufteilung sowie die Verteilung, mit der neue Abrechnungsperioden angelegt werden.","parameters":[{"name":"id","in":"path","description":"PropertySettings identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false},"patch":{"operationId":"api_v1properties_idsettings_patch","tags":["Liegenschaften"],"responses":{"200":{"description":"PropertySettings resource updated","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/PropertySettings.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/PropertySettings"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"},"404":{"description":"Resource not found"}},"summary":"Einstellungen der Liegenschaft \u00e4ndern","description":"Nur die gesendeten Felder werden ge\u00e4ndert. Brennstoff und CO\u2082-Angaben gelten f\u00fcr alle Abrechnungen der Liegenschaft; die Verteilung nur f\u00fcr k\u00fcnftig angelegte Abrechnungsperioden, bestehende \u00e4ndert `PATCH \/api\/v1\/billings\/{id}\/settings`.","parameters":[{"name":"id","in":"path","description":"PropertySettings identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"requestBody":{"description":"The updated PropertySettings resource","content":{"application\/merge-patch+json":{"example":{"commercialUse":false,"heatingBaseCostPercentage":30},"schema":{"$ref":"#\/components\/schemas\/PropertySettings.PropertySettingsUpdate"}},"application\/json":{"example":{"commercialUse":false,"heatingBaseCostPercentage":30},"schema":{"$ref":"#\/components\/schemas\/PropertySettings.PropertySettingsUpdate"}}},"required":true},"deprecated":false}},"\/api\/v1\/properties\/{propertyId}\/price-list":{"get":{"operationId":"api_v1properties_propertyIdprice-list_get_collection","tags":["Liegenschaften"],"responses":{"200":{"description":"ServicePrice collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/ServicePrice.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/ServicePrice"}}}}}},"summary":"Preisliste abrufen","description":"Preise der Leistungen, die f\u00fcr diese Liegenschaft neu gebucht werden; bereits gebuchte Leistungen behalten ihren Preis. Antwortet AssetWork nicht, kommt 503 mit `Retry-After`. Kostenpflichtige Aufrufe buchen: `00001` Grundleistung Liegenschaft je Abrechnungsperiode, `00002` Heiz- und Warmwasserkosten, `00003` weitere Betriebskosten, `00004` Kaltwasserkosten, `00039` Zuschlag f\u00fcr einen Abrechnungszeitraum k\u00fcrzer als ein Jahr.","parameters":[{"name":"propertyId","in":"path","description":"ServicePrice identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false}},"\/api\/v1\/tenants":{"get":{"operationId":"api_v1tenants_get_collection","tags":["Mieter"],"responses":{"200":{"description":"Tenant collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/Tenant.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/Tenant"}}}}}},"summary":"Mieter auflisten","description":"Mietverh\u00e4ltnisse der Einheiten. `end[after]=\u003Cheute\u003E` liefert die aktuellen Mieter; ein offenes Ende z\u00e4hlt als aktuell.","parameters":[{"name":"page","in":"query","description":"The collection page number","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":1},"style":"form","explode":false,"allowReserved":false},{"name":"itemsPerPage","in":"query","description":"The number of items per page","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"integer","default":100,"minimum":0,"maximum":500},"style":"form","explode":false,"allowReserved":false},{"name":"apartment","in":"query","description":"Filtert nach der UUID von \u201eapartment\u201c.","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false,"example":"004b417e-6f8a-40bc-93c6-2b05d5bb1049"},{"name":"apartment.property","in":"query","description":"Filtert nach der UUID von \u201eapartment.property\u201c.","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false,"example":"004b417e-6f8a-40bc-93c6-2b05d5bb1049"},{"name":"begin[before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"begin[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"begin[after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"begin[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"end[before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"end[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"end[after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"end[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[strictly_before]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"updatedAt[strictly_after]","in":"query","description":"","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false},{"name":"changedSince","in":"query","description":"Nur Eintr\u00e4ge, die selbst oder deren mitgelieferte Daten (z. B. Adresse, Kontaktdaten) seit diesem Zeitpunkt angelegt oder ge\u00e4ndert wurden (ISO 8601).","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false,"example":"2026-10-01T00:00:00+02:00"},{"name":"reference","in":"query","description":"Exakte \u00dcbereinstimmung","required":false,"deprecated":false,"allowEmptyValue":true,"schema":{"type":"string"},"style":"form","explode":false,"allowReserved":false}],"deprecated":false},"post":{"operationId":"api_v1tenants_post","tags":["Mieter"],"responses":{"201":{"description":"Tenant resource created","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/Tenant.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Tenant"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"}},"summary":"Einzug erfassen","description":"Legt das Mietverh\u00e4ltnis an. Mit `vacant: true` wird stattdessen ein Leerstand ohne Person erfasst, z. B. nach einem Auszug ohne Nachmieter; erst danach ist die Einheit f\u00fcr die Abrechnung vollst\u00e4ndig. Die Person wird wiederverwendet, wenn sie bekannt ist: \u00fcber `personId`, sonst \u00fcber `reference`, sonst \u00fcber `email` (nur Mieter der eigenen Liegenschaften; deren Kontaktdaten bleiben unver\u00e4ndert). Andernfalls wird sie neu angelegt. Mit `adjustOverlappingTenancies` wird ein \u00fcberschneidendes Mietverh\u00e4ltnis automatisch angepasst (Mieterwechsel). Der Mieter erh\u00e4lt keine Einladung.","parameters":[],"requestBody":{"description":"The new Tenant resource","content":{"application\/ld+json":{"example":{"apartment":"6f1c2b2e-0d7e-4a8f-9a51-0d0c8f1e2a33","begin":"2026-07-01","name":"Erika Mustermann","email":"erika.mustermann@example.com","phone":"+49 89 1234567","reference":"MK 4711","prepaymentGrossAmount":1140,"adjustOverlappingTenancies":true},"schema":{"$ref":"#\/components\/schemas\/Tenant.TenantCreate.jsonld"}},"application\/json":{"example":{"apartment":"6f1c2b2e-0d7e-4a8f-9a51-0d0c8f1e2a33","begin":"2026-07-01","name":"Erika Mustermann","email":"erika.mustermann@example.com","phone":"+49 89 1234567","reference":"MK 4711","prepaymentGrossAmount":1140,"adjustOverlappingTenancies":true},"schema":{"$ref":"#\/components\/schemas\/Tenant.TenantCreate"}}},"required":true},"deprecated":false}},"\/api\/v1\/tenants\/{id}":{"get":{"operationId":"api_v1tenants_id_get","tags":["Mieter"],"responses":{"200":{"description":"Tenant resource","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/Tenant.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Tenant"}}}},"404":{"description":"Resource not found"}},"summary":"Mieter abrufen","description":"Retrieves a Tenant resource.","parameters":[{"name":"id","in":"path","description":"Tenant identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false},"delete":{"operationId":"api_v1tenants_id_delete","tags":["Mieter"],"responses":{"204":{"description":"Tenant resource deleted"},"404":{"description":"Resource not found"}},"summary":"Mietverh\u00e4ltnis l\u00f6schen","description":"F\u00fcr falsch erfasste Mietverh\u00e4ltnisse; ein Auszug wird mit \u201eMietverh\u00e4ltnis \u00e4ndern\u201c (`end`) gemeldet. Die L\u00fccke im Zeitraum der Einheit bleibt bestehen, bis sie mit einem Einzug oder einer \u00c4nderung des benachbarten Mietverh\u00e4ltnisses geschlossen wird. Die Person selbst und ihr Konto bleiben unver\u00e4ndert. Bereits \u00fcbermittelte Abrechnungen bleiben unver\u00e4ndert.","parameters":[{"name":"id","in":"path","description":"Tenant identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false},"patch":{"operationId":"api_v1tenants_id_patch","tags":["Mieter"],"responses":{"200":{"description":"Tenant resource updated","content":{"application\/ld+json":{"schema":{"$ref":"#\/components\/schemas\/Tenant.jsonld"}},"application\/json":{"schema":{"$ref":"#\/components\/schemas\/Tenant"}}},"links":{}},"400":{"description":"Invalid input"},"422":{"description":"Unprocessable entity"},"404":{"description":"Resource not found"}},"summary":"Mietverh\u00e4ltnis \u00e4ndern","description":"Auszug (`end`), Korrektur des Zeitraums, neue Vorauszahlung oder Kennzeichen (`reference`). \u00dcberschneidungen mit anderen Mietverh\u00e4ltnissen werden abgelehnt; ein Mieterwechsel wird mit \u201eEinzug erfassen\u201c gemeldet.","parameters":[{"name":"id","in":"path","description":"Tenant identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"requestBody":{"description":"The updated Tenant resource","content":{"application\/merge-patch+json":{"example":{"end":"2027-06-30","prepaymentGrossAmount":1200},"schema":{"$ref":"#\/components\/schemas\/Tenant.TenantUpdate"}},"application\/json":{"example":{"end":"2027-06-30","prepaymentGrossAmount":1200},"schema":{"$ref":"#\/components\/schemas\/Tenant.TenantUpdate"}}},"required":true},"deprecated":false}},"\/api\/v1\/tenants\/{tenantId}\/move-out-readings":{"get":{"operationId":"api_v1tenants_tenantIdmove-out-readings_get_collection","tags":["Mieter"],"responses":{"200":{"description":"MoveOutReading collection","content":{"application\/ld+json":{"schema":{"type":"object","properties":{"hydra:member":{"type":"array","items":{"$ref":"#\/components\/schemas\/MoveOutReading.jsonld"}},"hydra:totalItems":{"type":"integer","minimum":0},"hydra:view":{"type":"object","properties":{"@id":{"type":"string","format":"iri-reference"},"@type":{"type":"string"},"hydra:first":{"type":"string","format":"iri-reference"},"hydra:last":{"type":"string","format":"iri-reference"},"hydra:previous":{"type":"string","format":"iri-reference"},"hydra:next":{"type":"string","format":"iri-reference"}},"example":{"@id":"string","type":"string","hydra:first":"string","hydra:last":"string","hydra:previous":"string","hydra:next":"string"}},"hydra:search":{"type":"object","properties":{"@type":{"type":"string"},"hydra:template":{"type":"string"},"hydra:variableRepresentation":{"type":"string"},"hydra:mapping":{"type":"array","items":{"type":"object","properties":{"@type":{"type":"string"},"variable":{"type":"string"},"property":{"type":["string","null"]},"required":{"type":"boolean"}}}}}}},"required":["hydra:member"]}},"application\/json":{"schema":{"type":"array","items":{"$ref":"#\/components\/schemas\/MoveOutReading"}}}}}},"summary":"Z\u00e4hlerst\u00e4nde zum Auszug pr\u00fcfen","description":"Zeigt je Ger\u00e4t der Einheit, welcher Z\u00e4hlerstand beim Auszug (`end` des Mietverh\u00e4ltnisses) f\u00fcr die Abrechnung z\u00e4hlt: `ON_DATE` = Stand vom Auszugstag, `NEARBY` = n\u00e4chstgelegener Stand innerhalb von 7 Tagen, der beim \u00dcbermitteln der Abrechnung auf den Auszugstag \u00fcbernommen wird, sobald ein Nachmieter oder Leerstand folgt, `MISSING` = kein Stand; bitte mit \u201eZ\u00e4hlerstand erfassen\u201c zum Auszugsdatum melden. Mehrere St\u00e4nde am Auszugstag: der letzte z\u00e4hlt; bei gleichem Abstand der sp\u00e4tere. Rauchmelder haben keine Z\u00e4hlerst\u00e4nde und fehlen hier.","parameters":[{"name":"tenantId","in":"path","description":"MoveOutReading identifier","required":true,"deprecated":false,"allowEmptyValue":false,"schema":{"type":"string"},"style":"simple","explode":false,"allowReserved":false}],"deprecated":false}}},"components":{"schemas":{"ApartmentArea.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"ID der Fassung","example":812,"type":"integer"},"apartment":{"description":"Einheit","$ref":"#\/components\/schemas\/ApartmentReference.jsonld"},"validFrom":{"description":"G\u00fcltig ab; null = von Anfang an (erste Fassung)","example":"2026-07-01T00:00:00+02:00","type":["string","null"],"format":"date-time"},"area":{"description":"Wohn- bzw. Nutzfl\u00e4che in m\u00b2","example":78.5,"type":"number"},"heatingArea":{"description":"Beheizte Fl\u00e4che in m\u00b2 (Heizkostenverteilung)","example":78.5,"type":"number"},"warmWaterArea":{"description":"Fl\u00e4che f\u00fcr die Warmwasserkosten in m\u00b2","example":78.5,"type":"number"},"additionalCostArea":{"description":"Fl\u00e4che f\u00fcr die Nebenkosten in m\u00b2","example":78.5,"type":"number"},"commercialArea":{"description":"Davon gewerblich genutzt in m\u00b2","example":12.5,"type":"number"},"ownershipShare":{"description":"Miteigentumsanteil (z. B. in Tausendsteln)","example":112.5,"type":["number","null"]},"personCount":{"description":"Anzahl der Personen","example":2,"type":["integer","null"]}}},"ApartmentReference.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"UUID der Einheit","example":"6f1c2b2e-0d7e-4a8f-9a51-0d0c8f1e2a33","type":"string","format":"uuid"},"label":{"description":"Bezeichnung der Einheit","example":"Wohnung 04","type":["string","null"]}}},"ApartmentArea":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"ID der Fassung","example":812,"type":"integer"},"apartment":{"description":"Einheit","$ref":"#\/components\/schemas\/ApartmentReference"},"validFrom":{"description":"G\u00fcltig ab; null = von Anfang an (erste Fassung)","example":"2026-07-01T00:00:00+02:00","type":["string","null"],"format":"date-time"},"area":{"description":"Wohn- bzw. Nutzfl\u00e4che in m\u00b2","example":78.5,"type":"number"},"heatingArea":{"description":"Beheizte Fl\u00e4che in m\u00b2 (Heizkostenverteilung)","example":78.5,"type":"number"},"warmWaterArea":{"description":"Fl\u00e4che f\u00fcr die Warmwasserkosten in m\u00b2","example":78.5,"type":"number"},"additionalCostArea":{"description":"Fl\u00e4che f\u00fcr die Nebenkosten in m\u00b2","example":78.5,"type":"number"},"commercialArea":{"description":"Davon gewerblich genutzt in m\u00b2","example":12.5,"type":"number"},"ownershipShare":{"description":"Miteigentumsanteil (z. B. in Tausendsteln)","example":112.5,"type":["number","null"]},"personCount":{"description":"Anzahl der Personen","example":2,"type":["integer","null"]}}},"ApartmentReference":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"UUID der Einheit","example":"6f1c2b2e-0d7e-4a8f-9a51-0d0c8f1e2a33","type":"string","format":"uuid"},"label":{"description":"Bezeichnung der Einheit","example":"Wohnung 04","type":["string","null"]}}},"ApartmentArea.AreaUpdate":{"type":"object","description":"","deprecated":false,"properties":{"validFrom":{"description":"G\u00fcltig ab; bei der ersten Fassung nicht \u00e4nderbar","type":["string","null"],"format":"date-time"},"area":{"minimum":0,"description":"Wohn- bzw. Nutzfl\u00e4che in m\u00b2","type":["number","null"]},"heatingArea":{"minimum":0,"description":"Beheizte Fl\u00e4che in m\u00b2 (Heizkostenverteilung)","type":["number","null"]},"warmWaterArea":{"minimum":0,"description":"Fl\u00e4che f\u00fcr die Warmwasserkosten in m\u00b2","type":["number","null"]},"additionalCostArea":{"minimum":0,"description":"Fl\u00e4che f\u00fcr die Nebenkosten in m\u00b2","type":["number","null"]},"commercialArea":{"minimum":0,"description":"Davon gewerblich genutzt in m\u00b2","type":["number","null"]},"ownershipShare":{"minimum":0,"maximum":10000,"description":"Miteigentumsanteil (z. B. in Tausendsteln), 0 bis 10.000","type":["number","null"]},"personCount":{"minimum":0,"maximum":12,"description":"Anzahl der Personen, 0 bis 12","type":["integer","null"]}}},"Apartment.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"UUID der Einheit","example":"6f1c2b2e-0d7e-4a8f-9a51-0d0c8f1e2a33","type":"string","format":"uuid"},"identifier":{"description":"Nummer der Einheit in der AssetApp","example":"W-123456789","type":"string"},"number":{"description":"Laufende Nummer innerhalb der Liegenschaft","example":4,"type":["integer","null"]},"label":{"description":"Bezeichnung, z. B. \u201eWohnung 04\u201c","example":"Wohnung 04","type":["string","null"]},"floor":{"description":"Etage","example":2,"type":"integer"},"location":{"description":"Lage, z. B. \u201elinks\u201c","example":"links","type":["string","null"]},"partnerNumber":{"description":"Eigene Nummer der Hausverwaltung bzw. des ERP-Systems","example":"000003802700001 0008","type":["string","null"]},"state":{"description":"Ausstattungsstatus","type":"string","enum":["OPEN","DONE","ARCHIVED"]},"address":{"description":"Anschrift der Einheit","$ref":"#\/components\/schemas\/PostalAddress.jsonld"},"property":{"description":"Liegenschaft der Einheit","$ref":"#\/components\/schemas\/PropertyReference.jsonld"},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"PostalAddress.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"street":{"description":"Stra\u00dfe","example":"Waldfriedhofstra\u00dfe","type":"string"},"streetNumber":{"description":"Hausnummer","example":"12","type":"string"},"postcode":{"description":"Postleitzahl","example":"81377","type":"string"},"city":{"description":"Ort","example":"M\u00fcnchen","type":"string"},"country":{"description":"Land (ISO 3166-1 alpha-2)","example":"DE","type":"string"},"additional":{"description":"Adresszusatz","example":"Hinterhaus","type":["string","null"]}}},"PropertyReference.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"UUID der Liegenschaft","example":"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","type":"string","format":"uuid"},"label":{"description":"Bezeichnung der Liegenschaft","example":"Waldfriedhofstra\u00dfe 12","type":"string"},"address":{"description":"Anschrift der Liegenschaft","$ref":"#\/components\/schemas\/PostalAddress.jsonld"}}},"Apartment":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"UUID der Einheit","example":"6f1c2b2e-0d7e-4a8f-9a51-0d0c8f1e2a33","type":"string","format":"uuid"},"identifier":{"description":"Nummer der Einheit in der AssetApp","example":"W-123456789","type":"string"},"number":{"description":"Laufende Nummer innerhalb der Liegenschaft","example":4,"type":["integer","null"]},"label":{"description":"Bezeichnung, z. B. \u201eWohnung 04\u201c","example":"Wohnung 04","type":["string","null"]},"floor":{"description":"Etage","example":2,"type":"integer"},"location":{"description":"Lage, z. B. \u201elinks\u201c","example":"links","type":["string","null"]},"partnerNumber":{"description":"Eigene Nummer der Hausverwaltung bzw. des ERP-Systems","example":"000003802700001 0008","type":["string","null"]},"state":{"description":"Ausstattungsstatus","type":"string","enum":["OPEN","DONE","ARCHIVED"]},"address":{"description":"Anschrift der Einheit","$ref":"#\/components\/schemas\/PostalAddress"},"property":{"description":"Liegenschaft der Einheit","$ref":"#\/components\/schemas\/PropertyReference"},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"PostalAddress":{"type":"object","description":"","deprecated":false,"properties":{"street":{"description":"Stra\u00dfe","example":"Waldfriedhofstra\u00dfe","type":"string"},"streetNumber":{"description":"Hausnummer","example":"12","type":"string"},"postcode":{"description":"Postleitzahl","example":"81377","type":"string"},"city":{"description":"Ort","example":"M\u00fcnchen","type":"string"},"country":{"description":"Land (ISO 3166-1 alpha-2)","example":"DE","type":"string"},"additional":{"description":"Adresszusatz","example":"Hinterhaus","type":["string","null"]}}},"PropertyReference":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"UUID der Liegenschaft","example":"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","type":"string","format":"uuid"},"label":{"description":"Bezeichnung der Liegenschaft","example":"Waldfriedhofstra\u00dfe 12","type":"string"},"address":{"description":"Anschrift der Liegenschaft","$ref":"#\/components\/schemas\/PostalAddress"}}},"ApartmentArea.AreaCreate.jsonld":{"type":"object","description":"","deprecated":false,"required":["validFrom","area","heatingArea","warmWaterArea","additionalCostArea","commercialArea","ownershipShare","personCount"],"properties":{"validFrom":{"description":"G\u00fcltig ab","type":["string","null"],"format":"date-time"},"area":{"minimum":0,"description":"Wohn- bzw. Nutzfl\u00e4che in m\u00b2","type":["number","null"]},"heatingArea":{"minimum":0,"description":"Beheizte Fl\u00e4che in m\u00b2 (Heizkostenverteilung)","type":["number","null"]},"warmWaterArea":{"minimum":0,"description":"Fl\u00e4che f\u00fcr die Warmwasserkosten in m\u00b2","type":["number","null"]},"additionalCostArea":{"minimum":0,"description":"Fl\u00e4che f\u00fcr die Nebenkosten in m\u00b2","type":["number","null"]},"commercialArea":{"minimum":0,"description":"Davon gewerblich genutzt in m\u00b2","type":["number","null"]},"ownershipShare":{"minimum":0,"maximum":10000,"description":"Miteigentumsanteil (z. B. in Tausendsteln), 0 bis 10.000","type":["number","null"]},"personCount":{"minimum":0,"maximum":12,"description":"Anzahl der Personen, 0 bis 12","type":["integer","null"]}}},"ApartmentArea.AreaCreate":{"type":"object","description":"","deprecated":false,"required":["validFrom","area","heatingArea","warmWaterArea","additionalCostArea","commercialArea","ownershipShare","personCount"],"properties":{"validFrom":{"description":"G\u00fcltig ab","type":["string","null"],"format":"date-time"},"area":{"minimum":0,"description":"Wohn- bzw. Nutzfl\u00e4che in m\u00b2","type":["number","null"]},"heatingArea":{"minimum":0,"description":"Beheizte Fl\u00e4che in m\u00b2 (Heizkostenverteilung)","type":["number","null"]},"warmWaterArea":{"minimum":0,"description":"Fl\u00e4che f\u00fcr die Warmwasserkosten in m\u00b2","type":["number","null"]},"additionalCostArea":{"minimum":0,"description":"Fl\u00e4che f\u00fcr die Nebenkosten in m\u00b2","type":["number","null"]},"commercialArea":{"minimum":0,"description":"Davon gewerblich genutzt in m\u00b2","type":["number","null"]},"ownershipShare":{"minimum":0,"maximum":10000,"description":"Miteigentumsanteil (z. B. in Tausendsteln), 0 bis 10.000","type":["number","null"]},"personCount":{"minimum":0,"maximum":12,"description":"Anzahl der Personen, 0 bis 12","type":["integer","null"]}}},"Apartment.ApartmentUpdate":{"type":"object","description":"","deprecated":false,"properties":{"label":{"pattern":"^((?!\\s*$).{2,255})$","description":"Bezeichnung","type":["string","null"]},"location":{"maxLength":255,"description":"Lage; null entfernt sie","type":["string","null"]},"floor":{"description":"Etage","type":["integer","null"]},"partnerNumber":{"maxLength":20,"description":"Eigene Nummer der Hausverwaltung (h\u00f6chstens 20 Zeichen); null entfernt sie","type":["string","null"]}}},"BillingCost.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"UUID der Kostenposition","example":"e5f7a9b1-3c5d-4e7f-9a1b-2c3d4e5f6a7b","type":"string","format":"uuid"},"category":{"description":"HEATING = Heiz- und Warmwassernebenkosten, ADDITIONAL = Kaltwasser und weitere Betriebskosten","example":"HEATING","type":"string","enum":["HEATING","ADDITIONAL"]},"costType":{"description":"Kostenart","anyOf":[{"$ref":"#\/components\/schemas\/CostTypeReference.jsonld"},{"type":"null"}]},"description":{"description":"Abweichende Bezeichnung der Position","example":"Kehrung und Abgasmessung 2025","type":["string","null"]},"date":{"description":"Rechnungsdatum","example":"2025-11-14T00:00:00+01:00","type":"string","format":"date-time"},"invoiceNumber":{"description":"Rechnungsnummer","example":"RE-2025-4711","type":["string","null"]},"netAmount":{"description":"Betrag netto","example":84.03,"type":["number","null"]},"grossAmount":{"description":"Betrag brutto","example":100,"type":"number"},"taxRate":{"description":"Umsatzsteuersatz in Prozent, z. B. 19; null = abweichender Satz, ma\u00dfgeblich sind Netto- und Bruttobetrag","example":19,"type":["number","null"]},"labourCost":{"description":"Darin enthaltene Arbeitskosten (\u00a7 35a EStG)","example":40,"type":["number","null"]},"distribution":{"description":"Umlagema\u00dfstab; nur bei ADDITIONAL","anyOf":[{"$ref":"#\/components\/schemas\/DistributionKey.jsonld"},{"type":"null"}]},"tenants":{"description":"Mietverh\u00e4ltnisse, auf die die Kosten umgelegt werden; nur bei Umlagema\u00dfstab 25","type":"array","items":{"$ref":"#\/components\/schemas\/TenantReference.jsonld"}},"apartments":{"description":"Einheiten, auf die die Kosten umgelegt werden; nur bei Umlagema\u00dfstab 32","type":"array","items":{"$ref":"#\/components\/schemas\/ApartmentReference.jsonld"}},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"CostTypeReference.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"key":{"description":"Schl\u00fcssel der Kostenart, siehe \/api\/v1\/cost-types","example":"2030","type":"string"},"argeKey":{"description":"Kostenart-Schl\u00fcssel nach ARGE Heiz- und Wasserkosten; nicht eindeutig","example":"225","type":"string"},"label":{"description":"Bezeichnung der Kostenart","example":"Kaminfeger","type":"string"}}},"DistributionKey.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"key":{"description":"Schl\u00fcssel des Umlagema\u00dfstabs","example":"12","type":"string"},"label":{"description":"Bezeichnung, z. B. Wohnfl\u00e4che","example":"Heizfl\u00e4che","type":"string"}}},"TenantReference.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"ID des Mietverh\u00e4ltnisses (\/api\/v1\/tenants\/{id}); null, wenn es nicht zugeordnet werden konnte, z. B. bei Leerstand","example":1234,"type":["integer","null"]},"name":{"description":"Name, wie er auf der Abrechnung steht","example":"Erika Mustermann","type":["string","null"]}}},"BillingCost":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"UUID der Kostenposition","example":"e5f7a9b1-3c5d-4e7f-9a1b-2c3d4e5f6a7b","type":"string","format":"uuid"},"category":{"description":"HEATING = Heiz- und Warmwassernebenkosten, ADDITIONAL = Kaltwasser und weitere Betriebskosten","example":"HEATING","type":"string","enum":["HEATING","ADDITIONAL"]},"costType":{"description":"Kostenart","anyOf":[{"$ref":"#\/components\/schemas\/CostTypeReference"},{"type":"null"}]},"description":{"description":"Abweichende Bezeichnung der Position","example":"Kehrung und Abgasmessung 2025","type":["string","null"]},"date":{"description":"Rechnungsdatum","example":"2025-11-14T00:00:00+01:00","type":"string","format":"date-time"},"invoiceNumber":{"description":"Rechnungsnummer","example":"RE-2025-4711","type":["string","null"]},"netAmount":{"description":"Betrag netto","example":84.03,"type":["number","null"]},"grossAmount":{"description":"Betrag brutto","example":100,"type":"number"},"taxRate":{"description":"Umsatzsteuersatz in Prozent, z. B. 19; null = abweichender Satz, ma\u00dfgeblich sind Netto- und Bruttobetrag","example":19,"type":["number","null"]},"labourCost":{"description":"Darin enthaltene Arbeitskosten (\u00a7 35a EStG)","example":40,"type":["number","null"]},"distribution":{"description":"Umlagema\u00dfstab; nur bei ADDITIONAL","anyOf":[{"$ref":"#\/components\/schemas\/DistributionKey"},{"type":"null"}]},"tenants":{"description":"Mietverh\u00e4ltnisse, auf die die Kosten umgelegt werden; nur bei Umlagema\u00dfstab 25","type":"array","items":{"$ref":"#\/components\/schemas\/TenantReference"}},"apartments":{"description":"Einheiten, auf die die Kosten umgelegt werden; nur bei Umlagema\u00dfstab 32","type":"array","items":{"$ref":"#\/components\/schemas\/ApartmentReference"}},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"CostTypeReference":{"type":"object","description":"","deprecated":false,"properties":{"key":{"description":"Schl\u00fcssel der Kostenart, siehe \/api\/v1\/cost-types","example":"2030","type":"string"},"argeKey":{"description":"Kostenart-Schl\u00fcssel nach ARGE Heiz- und Wasserkosten; nicht eindeutig","example":"225","type":"string"},"label":{"description":"Bezeichnung der Kostenart","example":"Kaminfeger","type":"string"}}},"DistributionKey":{"type":"object","description":"","deprecated":false,"properties":{"key":{"description":"Schl\u00fcssel des Umlagema\u00dfstabs","example":"12","type":"string"},"label":{"description":"Bezeichnung, z. B. Wohnfl\u00e4che","example":"Heizfl\u00e4che","type":"string"}}},"TenantReference":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"ID des Mietverh\u00e4ltnisses (\/api\/v1\/tenants\/{id}); null, wenn es nicht zugeordnet werden konnte, z. B. bei Leerstand","example":1234,"type":["integer","null"]},"name":{"description":"Name, wie er auf der Abrechnung steht","example":"Erika Mustermann","type":["string","null"]}}},"BillingCost.CostUpdate":{"type":"object","description":"","deprecated":false,"properties":{"costType":{"description":"Schl\u00fcssel der Kostenart; nur innerhalb derselben Kategorie (HEATING bzw. ADDITIONAL) \u00e4nderbar","type":["string","null"]},"date":{"description":"Rechnungsdatum","type":["string","null"],"format":"date-time"},"netAmount":{"description":"Betrag netto","type":["number","null"]},"grossAmount":{"description":"Betrag brutto","type":["number","null"]},"taxRate":{"minimum":0,"maximum":100,"description":"Umsatzsteuersatz in Prozent; null = abweichender Satz","type":["number","null"]},"invoiceNumber":{"maxLength":255,"description":"Rechnungsnummer","type":["string","null"]},"description":{"maxLength":255,"description":"Abweichende Bezeichnung der Position","type":["string","null"]},"labourCost":{"minimum":0,"description":"Darin enthaltene Arbeitskosten (\u00a7 35a EStG)","type":["number","null"]},"distribution":{"description":"Umlagema\u00dfstab (`distribution.key`); nur bei Betriebskosten. 25 braucht `tenants`, 32 braucht `apartments`","type":["string","null"]},"tenants":{"description":"Nur bei Umlagema\u00dfstab 25 (zugeordnete Nutzer): IDs der Mietverh\u00e4ltnisse aus \/api\/v1\/tenants, auf die die Kosten umgelegt werden","type":["array","null"],"items":{"type":"integer"}},"apartments":{"description":"Nur bei Umlagema\u00dfstab 32 (zugeordnete Nutzereinheiten): UUIDs der Einheiten, auf die die Kosten umgelegt werden","type":["array","null"],"items":{"type":"string"}}}},"BillingDocument.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"ID des Dokuments","example":4711,"type":"integer"},"type":{"description":"Dokumentart; APARTMENT_HEATING_BILL = Einzelabrechnung, PROPERTY_HEATING_BILL = Gesamtabrechnung","example":"APARTMENT_HEATING_BILL","type":"string","enum":["PROPERTY_METER_PROTOCOL","TENANT_METER_PROTOCOL","INQUIRY","INQUIRY_RESPONSE","CONTRACT","ADVANCE_PAYMENT_ADJUSTMENT","ORDER_CONFIRMATION","INSTALLATION","USER_UPLOADED","PREVIOUS_CONTRACT","SERVICE_INVOICE","DEVICE_INVOICE","FLOOR_PLAN","PROPERTY_HEATING_BILL","APARTMENT_HEATING_BILL","INDIVIDUAL_CUSTOMER_LETTER","COST_TRANSMISSION_DATA","TERMINATION_CONFIRMATION","TERMINATION_LETTER_THIRD_PARTY_MEASUREMENT","DELIVERY_NOTE_DEVICES","TENANT_LIST","MONTHLY_CONSUMPTION_INFORMATION","INSTALLATION_PROTOCOL","SEPA_DIRECT_DEBIT_MANDATE","SEPA_DIRECT_DEBIT_MANDATE_CONFIRMATION","PARTITION_DECLARATION","APARTMENT_CONSUMPTION_ANALYSIS","CONTRACT_CONFIRMATION_SERVICE","CONTRACT_CONFIRMATION_DEVICE","BILLING_DOCUMENT","INSTALLATION_ORDER","MANDATE","ROTATING_PLAN","ROTATING_PLAN_CONFIRMATION","PIPE_SCHEMA","METER_LIST","MISCELLANEOUS_DOCUMENT","PROPERTY_ANALYSIS_RESULT","CONTRACT_REQUESTED"]},"name":{"description":"Dateiname","example":"Abrechnung_Mustermann_2025.pdf","type":["string","null"]},"date":{"description":"Erstellt am","example":"2026-03-01T00:00:00+01:00","type":["string","null"],"format":"date-time"},"apartment":{"description":"Einheit; nur bei Einzelabrechnungen","anyOf":[{"$ref":"#\/components\/schemas\/ApartmentReference.jsonld"},{"type":"null"}]},"tenant":{"description":"Nutzer; nur bei Einzelabrechnungen","anyOf":[{"$ref":"#\/components\/schemas\/TenantReference.jsonld"},{"type":"null"}]},"usageBegin":{"description":"Beginn des abgerechneten Nutzungszeitraums","example":"2025-01-01T00:00:00+01:00","type":["string","null"],"format":"date-time"},"usageEnd":{"description":"Ende des abgerechneten Nutzungszeitraums","example":"2025-12-31T00:00:00+01:00","type":["string","null"],"format":"date-time"},"totalCostGross":{"description":"Kosten brutto; bei der Gesamtabrechnung die Gesamtkosten der Liegenschaft","example":1012.4,"type":["number","null"]},"prepaymentGross":{"description":"Geleistete Vorauszahlungen brutto; nur bei Einzelabrechnungen","example":960,"type":["number","null"]},"balanceGross":{"description":"Ergebnis brutto: positiv = Nachzahlung, negativ = Guthaben; nur bei Einzelabrechnungen","example":52.4,"type":["number","null"]},"pdf":{"description":"Pfad zum Herunterladen der PDF-Datei","example":"\/api\/v1\/billing-documents\/4711\/pdf","type":"string"}}},"BillingDocument":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"ID des Dokuments","example":4711,"type":"integer"},"type":{"description":"Dokumentart; APARTMENT_HEATING_BILL = Einzelabrechnung, PROPERTY_HEATING_BILL = Gesamtabrechnung","example":"APARTMENT_HEATING_BILL","type":"string","enum":["PROPERTY_METER_PROTOCOL","TENANT_METER_PROTOCOL","INQUIRY","INQUIRY_RESPONSE","CONTRACT","ADVANCE_PAYMENT_ADJUSTMENT","ORDER_CONFIRMATION","INSTALLATION","USER_UPLOADED","PREVIOUS_CONTRACT","SERVICE_INVOICE","DEVICE_INVOICE","FLOOR_PLAN","PROPERTY_HEATING_BILL","APARTMENT_HEATING_BILL","INDIVIDUAL_CUSTOMER_LETTER","COST_TRANSMISSION_DATA","TERMINATION_CONFIRMATION","TERMINATION_LETTER_THIRD_PARTY_MEASUREMENT","DELIVERY_NOTE_DEVICES","TENANT_LIST","MONTHLY_CONSUMPTION_INFORMATION","INSTALLATION_PROTOCOL","SEPA_DIRECT_DEBIT_MANDATE","SEPA_DIRECT_DEBIT_MANDATE_CONFIRMATION","PARTITION_DECLARATION","APARTMENT_CONSUMPTION_ANALYSIS","CONTRACT_CONFIRMATION_SERVICE","CONTRACT_CONFIRMATION_DEVICE","BILLING_DOCUMENT","INSTALLATION_ORDER","MANDATE","ROTATING_PLAN","ROTATING_PLAN_CONFIRMATION","PIPE_SCHEMA","METER_LIST","MISCELLANEOUS_DOCUMENT","PROPERTY_ANALYSIS_RESULT","CONTRACT_REQUESTED"]},"name":{"description":"Dateiname","example":"Abrechnung_Mustermann_2025.pdf","type":["string","null"]},"date":{"description":"Erstellt am","example":"2026-03-01T00:00:00+01:00","type":["string","null"],"format":"date-time"},"apartment":{"description":"Einheit; nur bei Einzelabrechnungen","anyOf":[{"$ref":"#\/components\/schemas\/ApartmentReference"},{"type":"null"}]},"tenant":{"description":"Nutzer; nur bei Einzelabrechnungen","anyOf":[{"$ref":"#\/components\/schemas\/TenantReference"},{"type":"null"}]},"usageBegin":{"description":"Beginn des abgerechneten Nutzungszeitraums","example":"2025-01-01T00:00:00+01:00","type":["string","null"],"format":"date-time"},"usageEnd":{"description":"Ende des abgerechneten Nutzungszeitraums","example":"2025-12-31T00:00:00+01:00","type":["string","null"],"format":"date-time"},"totalCostGross":{"description":"Kosten brutto; bei der Gesamtabrechnung die Gesamtkosten der Liegenschaft","example":1012.4,"type":["number","null"]},"prepaymentGross":{"description":"Geleistete Vorauszahlungen brutto; nur bei Einzelabrechnungen","example":960,"type":["number","null"]},"balanceGross":{"description":"Ergebnis brutto: positiv = Nachzahlung, negativ = Guthaben; nur bei Einzelabrechnungen","example":52.4,"type":["number","null"]},"pdf":{"description":"Pfad zum Herunterladen der PDF-Datei","example":"\/api\/v1\/billing-documents\/4711\/pdf","type":"string"}}},"Billing.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"UUID der Abrechnungsperiode","example":"d4e6f8a0-2b4c-4d6e-8f0a-1b2c3d4e5f60","type":"string","format":"uuid"},"property":{"description":"Liegenschaft","$ref":"#\/components\/schemas\/PropertyReference.jsonld"},"begin":{"description":"Beginn des Abrechnungszeitraums","example":"2025-01-01T00:00:00+01:00","type":"string","format":"date-time"},"end":{"description":"Ende des Abrechnungszeitraums (Stichtag)","example":"2025-12-31T00:00:00+01:00","type":"string","format":"date-time"},"state":{"description":"OPEN = Zeitraum l\u00e4uft noch, BILLABLE = Kosten k\u00f6nnen erfasst werden, SUBMITTED = Kosten \u00fcbermittelt, REVIEW = R\u00fcckfrage, Kosten erg\u00e4nzen und erneut \u00fcbermitteln, DONE = Abrechnung erstellt, Ergebnisse unter \/documents","example":"DONE","type":"string","enum":["OPEN","BILLABLE","SUBMITTED","REVIEW","DONE"]},"submitDate":{"description":"Zeitpunkt, zu dem die Kosten \u00fcbermittelt wurden","example":"2026-02-10T08:15:00+01:00","type":["string","null"],"format":"date-time"},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am, z. B. durch einen Statuswechsel","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"Billing":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"UUID der Abrechnungsperiode","example":"d4e6f8a0-2b4c-4d6e-8f0a-1b2c3d4e5f60","type":"string","format":"uuid"},"property":{"description":"Liegenschaft","$ref":"#\/components\/schemas\/PropertyReference"},"begin":{"description":"Beginn des Abrechnungszeitraums","example":"2025-01-01T00:00:00+01:00","type":"string","format":"date-time"},"end":{"description":"Ende des Abrechnungszeitraums (Stichtag)","example":"2025-12-31T00:00:00+01:00","type":"string","format":"date-time"},"state":{"description":"OPEN = Zeitraum l\u00e4uft noch, BILLABLE = Kosten k\u00f6nnen erfasst werden, SUBMITTED = Kosten \u00fcbermittelt, REVIEW = R\u00fcckfrage, Kosten erg\u00e4nzen und erneut \u00fcbermitteln, DONE = Abrechnung erstellt, Ergebnisse unter \/documents","example":"DONE","type":"string","enum":["OPEN","BILLABLE","SUBMITTED","REVIEW","DONE"]},"submitDate":{"description":"Zeitpunkt, zu dem die Kosten \u00fcbermittelt wurden","example":"2026-02-10T08:15:00+01:00","type":["string","null"],"format":"date-time"},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am, z. B. durch einen Statuswechsel","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"Billing.BillingCreate.jsonld":{"type":"object","description":"","deprecated":false,"required":["property","begin","end"],"properties":{"property":{"description":"UUID der Liegenschaft","type":["string","null"]},"begin":{"description":"Beginn des Abrechnungszeitraums","type":["string","null"],"format":"date-time"},"end":{"description":"Ende des Abrechnungszeitraums (Stichtag), h\u00f6chstens ein Jahr nach dem Beginn","type":["string","null"],"format":"date-time"},"heatingCostEnabled":{"description":"Heizkosten abrechnen (bucht `00002`)","type":"boolean"},"warmWaterCostEnabled":{"description":"Warmwasserkosten abrechnen (bucht `00002`)","type":"boolean"},"coldWaterCostEnabled":{"description":"Kaltwasserkosten abrechnen (bucht `00004`)","type":"boolean"},"additionalCostEnabled":{"description":"Weitere Betriebskosten abrechnen (bucht `00003`)","type":"boolean"}}},"Billing.BillingCreate":{"type":"object","description":"","deprecated":false,"required":["property","begin","end"],"properties":{"property":{"description":"UUID der Liegenschaft","type":["string","null"]},"begin":{"description":"Beginn des Abrechnungszeitraums","type":["string","null"],"format":"date-time"},"end":{"description":"Ende des Abrechnungszeitraums (Stichtag), h\u00f6chstens ein Jahr nach dem Beginn","type":["string","null"],"format":"date-time"},"heatingCostEnabled":{"description":"Heizkosten abrechnen (bucht `00002`)","type":"boolean"},"warmWaterCostEnabled":{"description":"Warmwasserkosten abrechnen (bucht `00002`)","type":"boolean"},"coldWaterCostEnabled":{"description":"Kaltwasserkosten abrechnen (bucht `00004`)","type":"boolean"},"additionalCostEnabled":{"description":"Weitere Betriebskosten abrechnen (bucht `00003`)","type":"boolean"}}},"BillingCost.CostCreate.jsonld":{"type":"object","description":"","deprecated":false,"required":["costType","date","netAmount","grossAmount"],"properties":{"costType":{"description":"Schl\u00fcssel der Kostenart (`key` aus \/api\/v1\/cost-types)","type":"string"},"date":{"description":"Rechnungsdatum","type":["string","null"],"format":"date-time"},"netAmount":{"description":"Betrag netto","type":["number","null"]},"grossAmount":{"description":"Betrag brutto","type":["number","null"]},"taxRate":{"minimum":0,"maximum":100,"description":"Umsatzsteuersatz in Prozent, z. B. 19; null = abweichender Satz, ma\u00dfgeblich sind Netto- und Bruttobetrag","type":["number","null"]},"invoiceNumber":{"maxLength":255,"description":"Rechnungsnummer","type":["string","null"]},"description":{"maxLength":255,"description":"Abweichende Bezeichnung der Position","type":["string","null"]},"labourCost":{"minimum":0,"description":"Darin enthaltene Arbeitskosten (\u00a7 35a EStG)","type":["number","null"]},"distribution":{"description":"Umlagema\u00dfstab (`distribution.key`); nur bei Betriebskosten, Standard ist der Umlagema\u00dfstab der Kostenart. 25 braucht `tenants`, 32 braucht `apartments`","type":["string","null"]},"tenants":{"description":"Nur bei Umlagema\u00dfstab 25 (zugeordnete Nutzer): IDs der Mietverh\u00e4ltnisse aus \/api\/v1\/tenants, auf die die Kosten umgelegt werden","type":["array","null"],"items":{"type":"integer"}},"apartments":{"description":"Nur bei Umlagema\u00dfstab 32 (zugeordnete Nutzereinheiten): UUIDs der Einheiten, auf die die Kosten umgelegt werden","type":["array","null"],"items":{"type":"string"}}}},"BillingCost.CostCreate":{"type":"object","description":"","deprecated":false,"required":["costType","date","netAmount","grossAmount"],"properties":{"costType":{"description":"Schl\u00fcssel der Kostenart (`key` aus \/api\/v1\/cost-types)","type":"string"},"date":{"description":"Rechnungsdatum","type":["string","null"],"format":"date-time"},"netAmount":{"description":"Betrag netto","type":["number","null"]},"grossAmount":{"description":"Betrag brutto","type":["number","null"]},"taxRate":{"minimum":0,"maximum":100,"description":"Umsatzsteuersatz in Prozent, z. B. 19; null = abweichender Satz, ma\u00dfgeblich sind Netto- und Bruttobetrag","type":["number","null"]},"invoiceNumber":{"maxLength":255,"description":"Rechnungsnummer","type":["string","null"]},"description":{"maxLength":255,"description":"Abweichende Bezeichnung der Position","type":["string","null"]},"labourCost":{"minimum":0,"description":"Darin enthaltene Arbeitskosten (\u00a7 35a EStG)","type":["number","null"]},"distribution":{"description":"Umlagema\u00dfstab (`distribution.key`); nur bei Betriebskosten, Standard ist der Umlagema\u00dfstab der Kostenart. 25 braucht `tenants`, 32 braucht `apartments`","type":["string","null"]},"tenants":{"description":"Nur bei Umlagema\u00dfstab 25 (zugeordnete Nutzer): IDs der Mietverh\u00e4ltnisse aus \/api\/v1\/tenants, auf die die Kosten umgelegt werden","type":["array","null"],"items":{"type":"integer"}},"apartments":{"description":"Nur bei Umlagema\u00dfstab 32 (zugeordnete Nutzereinheiten): UUIDs der Einheiten, auf die die Kosten umgelegt werden","type":["array","null"],"items":{"type":"string"}}}},"FuelDelivery.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"UUID der Position","example":"f6a8b0c2-4d6e-4f80-8a2b-3c4d5e6f7a8b","type":"string","format":"uuid"},"type":{"description":"INITIAL = Anfangsbestand, PURCHASE = Lieferung bzw. Rechnung, FINAL = Endbestand","example":"PURCHASE","type":"string","enum":["INITIAL","PURCHASE","FINAL"]},"date":{"description":"Liefer- bzw. Stichtag","example":"2025-06-02T00:00:00+02:00","type":"string","format":"date-time"},"invoiceNumber":{"description":"Rechnungsnummer","example":"OEL-2025-06","type":["string","null"]},"fuelType":{"description":"Brennstoff","$ref":"#\/components\/schemas\/FuelType.jsonld"},"quantity":{"description":"Menge in der Einheit des Brennstoffs","example":3000,"type":"number"},"netAmount":{"description":"Betrag netto","example":2940,"type":"number"},"grossAmount":{"description":"Betrag brutto","example":3498.6,"type":"number"},"taxRate":{"description":"Umsatzsteuersatz in Prozent, z. B. 19; null = abweichender Satz, ma\u00dfgeblich sind Netto- und Bruttobetrag","example":19,"type":["number","null"]},"calorificValue":{"description":"Heizwert in kWh je Mengeneinheit","example":10,"type":"number"},"emissionFactor":{"description":"Emissionsfaktor in kg CO\u2082 je kWh","example":0.266,"type":"number"},"carbonEmission":{"description":"CO\u2082-Menge in kg","example":7980,"type":"number"},"carbonCost":{"description":"CO\u2082-Kosten brutto","example":522.29,"type":"number"},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"FuelType.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"key":{"description":"Schl\u00fcssel des Brennstoffs","example":"1001","type":"string"},"argeKey":{"description":"Kostenart-Schl\u00fcssel nach ARGE Heiz- und Wasserkosten","example":"111","type":"string"},"label":{"description":"Bezeichnung, z. B. Heiz\u00f6l in Liter","example":"Leichtes Heiz\u00f6l in Liter","type":"string"},"unit":{"description":"Mengeneinheit","example":"l","type":"string"},"storable":{"description":"true = lagerf\u00e4hig (\u00d6l, Pellets, Fl\u00fcssiggas); dann sind Anfangs- und Endbestand anzugeben","type":"boolean"},"emissionFactor":{"description":"Standard-Emissionsfaktor in kg CO\u2082 je kWh","example":0.266,"type":["number","null"]}}},"FuelDelivery":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"UUID der Position","example":"f6a8b0c2-4d6e-4f80-8a2b-3c4d5e6f7a8b","type":"string","format":"uuid"},"type":{"description":"INITIAL = Anfangsbestand, PURCHASE = Lieferung bzw. Rechnung, FINAL = Endbestand","example":"PURCHASE","type":"string","enum":["INITIAL","PURCHASE","FINAL"]},"date":{"description":"Liefer- bzw. Stichtag","example":"2025-06-02T00:00:00+02:00","type":"string","format":"date-time"},"invoiceNumber":{"description":"Rechnungsnummer","example":"OEL-2025-06","type":["string","null"]},"fuelType":{"description":"Brennstoff","$ref":"#\/components\/schemas\/FuelType"},"quantity":{"description":"Menge in der Einheit des Brennstoffs","example":3000,"type":"number"},"netAmount":{"description":"Betrag netto","example":2940,"type":"number"},"grossAmount":{"description":"Betrag brutto","example":3498.6,"type":"number"},"taxRate":{"description":"Umsatzsteuersatz in Prozent, z. B. 19; null = abweichender Satz, ma\u00dfgeblich sind Netto- und Bruttobetrag","example":19,"type":["number","null"]},"calorificValue":{"description":"Heizwert in kWh je Mengeneinheit","example":10,"type":"number"},"emissionFactor":{"description":"Emissionsfaktor in kg CO\u2082 je kWh","example":0.266,"type":"number"},"carbonEmission":{"description":"CO\u2082-Menge in kg","example":7980,"type":"number"},"carbonCost":{"description":"CO\u2082-Kosten brutto","example":522.29,"type":"number"},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"FuelType":{"type":"object","description":"","deprecated":false,"properties":{"key":{"description":"Schl\u00fcssel des Brennstoffs","example":"1001","type":"string"},"argeKey":{"description":"Kostenart-Schl\u00fcssel nach ARGE Heiz- und Wasserkosten","example":"111","type":"string"},"label":{"description":"Bezeichnung, z. B. Heiz\u00f6l in Liter","example":"Leichtes Heiz\u00f6l in Liter","type":"string"},"unit":{"description":"Mengeneinheit","example":"l","type":"string"},"storable":{"description":"true = lagerf\u00e4hig (\u00d6l, Pellets, Fl\u00fcssiggas); dann sind Anfangs- und Endbestand anzugeben","type":"boolean"},"emissionFactor":{"description":"Standard-Emissionsfaktor in kg CO\u2082 je kWh","example":0.266,"type":["number","null"]}}},"FuelDelivery.FuelDeliveryCreate.jsonld":{"type":"object","description":"","deprecated":false,"required":["type","quantity"],"properties":{"type":{"description":"INITIAL = Anfangsbestand, PURCHASE = Lieferung bzw. Rechnung, FINAL = Endbestand","type":["string","null"],"enum":["INITIAL","PURCHASE","FINAL",null]},"date":{"description":"Liefer- bzw. Rechnungsdatum; bei INITIAL standardm\u00e4\u00dfig Beginn, bei FINAL Ende des Abrechnungszeitraums","type":["string","null"],"format":"date-time"},"quantity":{"minimum":0,"description":"Menge in der Einheit des Brennstoffs der Liegenschaft; 0 nur bei leerem Anfangs- oder Endbestand","type":["number","null"]},"netAmount":{"description":"Betrag netto; bei FINAL wird der Endbestand aus den Lieferungen bewertet","type":["number","null"]},"grossAmount":{"description":"Betrag brutto; bei FINAL wird der Endbestand aus den Lieferungen bewertet","type":["number","null"]},"taxRate":{"minimum":0,"maximum":100,"description":"Umsatzsteuersatz in Prozent, z. B. 19; null = abweichender Satz","type":["number","null"]},"calorificValue":{"minimum":0.5,"maximum":20,"description":"Heizwert in kWh je Mengeneinheit; Standard ist der Wert des Brennstoffs","type":["number","null"]},"emissionFactor":{"minimum":0,"description":"Emissionsfaktor in kg CO\u2082 je kWh; Standard ist der Wert des Brennstoffs","type":["number","null"]},"carbonEmission":{"minimum":0,"description":"CO\u2082-Menge in kg; Standard: Menge \u00d7 Heizwert \u00d7 Emissionsfaktor","type":["number","null"]},"carbonCost":{"minimum":0,"description":"CO\u2082-Kosten brutto; Standard: CO\u2082-Menge \u00d7 CO\u2082-Preis des Jahres (BEHG)","type":["number","null"]},"invoiceNumber":{"maxLength":255,"description":"Rechnungsnummer","type":["string","null"]}}},"FuelDelivery.FuelDeliveryCreate":{"type":"object","description":"","deprecated":false,"required":["type","quantity"],"properties":{"type":{"description":"INITIAL = Anfangsbestand, PURCHASE = Lieferung bzw. Rechnung, FINAL = Endbestand","type":["string","null"],"enum":["INITIAL","PURCHASE","FINAL",null]},"date":{"description":"Liefer- bzw. Rechnungsdatum; bei INITIAL standardm\u00e4\u00dfig Beginn, bei FINAL Ende des Abrechnungszeitraums","type":["string","null"],"format":"date-time"},"quantity":{"minimum":0,"description":"Menge in der Einheit des Brennstoffs der Liegenschaft; 0 nur bei leerem Anfangs- oder Endbestand","type":["number","null"]},"netAmount":{"description":"Betrag netto; bei FINAL wird der Endbestand aus den Lieferungen bewertet","type":["number","null"]},"grossAmount":{"description":"Betrag brutto; bei FINAL wird der Endbestand aus den Lieferungen bewertet","type":["number","null"]},"taxRate":{"minimum":0,"maximum":100,"description":"Umsatzsteuersatz in Prozent, z. B. 19; null = abweichender Satz","type":["number","null"]},"calorificValue":{"minimum":0.5,"maximum":20,"description":"Heizwert in kWh je Mengeneinheit; Standard ist der Wert des Brennstoffs","type":["number","null"]},"emissionFactor":{"minimum":0,"description":"Emissionsfaktor in kg CO\u2082 je kWh; Standard ist der Wert des Brennstoffs","type":["number","null"]},"carbonEmission":{"minimum":0,"description":"CO\u2082-Menge in kg; Standard: Menge \u00d7 Heizwert \u00d7 Emissionsfaktor","type":["number","null"]},"carbonCost":{"minimum":0,"description":"CO\u2082-Kosten brutto; Standard: CO\u2082-Menge \u00d7 CO\u2082-Preis des Jahres (BEHG)","type":["number","null"]},"invoiceNumber":{"maxLength":255,"description":"Rechnungsnummer","type":["string","null"]}}},"BillingSettings.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"UUID der Abrechnungsperiode","example":"d4e6f8a0-2b4c-4d6e-8f0a-1b2c3d4e5f60","type":"string","format":"uuid"},"heatingCostEnabled":{"description":"Heizkosten werden abgerechnet","type":"boolean"},"warmWaterCostEnabled":{"description":"Warmwasserkosten werden abgerechnet","type":"boolean"},"coldWaterCostEnabled":{"description":"Kaltwasserkosten werden abgerechnet","type":"boolean"},"additionalCostEnabled":{"description":"Weitere Betriebskosten werden abgerechnet","type":"boolean"},"heatingBaseCostPercentage":{"description":"Grundkostenanteil Heizung in Prozent","example":30,"type":"integer"},"heatingUsageCostPercentage":{"description":"Verbrauchskostenanteil Heizung in Prozent","example":70,"type":"integer"},"heatingBaseCostDistribution":{"description":"Umlagema\u00dfstab der Grundkosten Heizung","$ref":"#\/components\/schemas\/DistributionKey.jsonld"},"warmWaterBaseCostPercentage":{"description":"Grundkostenanteil Warmwasser in Prozent","example":30,"type":"integer"},"warmWaterUsageCostPercentage":{"description":"Verbrauchskostenanteil Warmwasser in Prozent","example":70,"type":"integer"},"warmWaterBaseCostDistribution":{"description":"Umlagema\u00dfstab der Grundkosten Warmwasser","$ref":"#\/components\/schemas\/DistributionKey.jsonld"},"warmWaterUsageCostDistribution":{"description":"Umlagema\u00dfstab der Verbrauchskosten Warmwasser","$ref":"#\/components\/schemas\/DistributionKey.jsonld"},"warmWaterShareMethod":{"description":"Ermittlung des Warmwasseranteils an den Brennstoffkosten bei zentraler Warmwasserbereitung: PERCENTAGE = fester Prozentsatz, DEVICE = W\u00e4rmemengenz\u00e4hler, WARM_WATER_USAGE = Warmwasserverbrauch, LIVING_SPACE = Wohnfl\u00e4che, NO_HOT_WATER = keine zentrale Warmwasserbereitung","example":"PERCENTAGE","type":["string","null"],"enum":["PERCENTAGE","DEVICE","WARM_WATER_USAGE","LIVING_SPACE","NO_HOT_WATER",null]},"warmWaterSharePercentage":{"description":"Warmwasseranteil in Prozent bei warmWaterShareMethod = PERCENTAGE","example":18,"type":["number","null"]},"warmWaterTemperature":{"description":"Warmwassertemperatur in \u00b0C","example":55,"type":"number"},"heatingSystem":{"description":"Art der Heizungsanlage der Liegenschaft","example":"OIL","type":"string"},"fuelType":{"description":"Brennstoff der Liegenschaft","$ref":"#\/components\/schemas\/FuelType.jsonld"},"carbonCostSplitEnabled":{"description":"CO\u2082-Kosten werden nach CO2KostAufG aufgeteilt","type":"boolean"},"commercialUse":{"description":"Gewerbliche Nutzung (Nichtwohngeb\u00e4ude)","type":"boolean"},"restructuringRequirements":{"description":"Sanierungsauflagen: \u00f6ffentlich-rechtliche Vorgaben schr\u00e4nken eine energetische Sanierung ein","type":"boolean"},"noTotalCarbonEmissionDeduction":{"description":"Kein CO\u2082-Gesamtabzug (WEG)","type":"boolean"},"monumentProtection":{"description":"Denkmalschutz","type":"boolean"}}},"BillingSettings":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"UUID der Abrechnungsperiode","example":"d4e6f8a0-2b4c-4d6e-8f0a-1b2c3d4e5f60","type":"string","format":"uuid"},"heatingCostEnabled":{"description":"Heizkosten werden abgerechnet","type":"boolean"},"warmWaterCostEnabled":{"description":"Warmwasserkosten werden abgerechnet","type":"boolean"},"coldWaterCostEnabled":{"description":"Kaltwasserkosten werden abgerechnet","type":"boolean"},"additionalCostEnabled":{"description":"Weitere Betriebskosten werden abgerechnet","type":"boolean"},"heatingBaseCostPercentage":{"description":"Grundkostenanteil Heizung in Prozent","example":30,"type":"integer"},"heatingUsageCostPercentage":{"description":"Verbrauchskostenanteil Heizung in Prozent","example":70,"type":"integer"},"heatingBaseCostDistribution":{"description":"Umlagema\u00dfstab der Grundkosten Heizung","$ref":"#\/components\/schemas\/DistributionKey"},"warmWaterBaseCostPercentage":{"description":"Grundkostenanteil Warmwasser in Prozent","example":30,"type":"integer"},"warmWaterUsageCostPercentage":{"description":"Verbrauchskostenanteil Warmwasser in Prozent","example":70,"type":"integer"},"warmWaterBaseCostDistribution":{"description":"Umlagema\u00dfstab der Grundkosten Warmwasser","$ref":"#\/components\/schemas\/DistributionKey"},"warmWaterUsageCostDistribution":{"description":"Umlagema\u00dfstab der Verbrauchskosten Warmwasser","$ref":"#\/components\/schemas\/DistributionKey"},"warmWaterShareMethod":{"description":"Ermittlung des Warmwasseranteils an den Brennstoffkosten bei zentraler Warmwasserbereitung: PERCENTAGE = fester Prozentsatz, DEVICE = W\u00e4rmemengenz\u00e4hler, WARM_WATER_USAGE = Warmwasserverbrauch, LIVING_SPACE = Wohnfl\u00e4che, NO_HOT_WATER = keine zentrale Warmwasserbereitung","example":"PERCENTAGE","type":["string","null"],"enum":["PERCENTAGE","DEVICE","WARM_WATER_USAGE","LIVING_SPACE","NO_HOT_WATER",null]},"warmWaterSharePercentage":{"description":"Warmwasseranteil in Prozent bei warmWaterShareMethod = PERCENTAGE","example":18,"type":["number","null"]},"warmWaterTemperature":{"description":"Warmwassertemperatur in \u00b0C","example":55,"type":"number"},"heatingSystem":{"description":"Art der Heizungsanlage der Liegenschaft","example":"OIL","type":"string"},"fuelType":{"description":"Brennstoff der Liegenschaft","$ref":"#\/components\/schemas\/FuelType"},"carbonCostSplitEnabled":{"description":"CO\u2082-Kosten werden nach CO2KostAufG aufgeteilt","type":"boolean"},"commercialUse":{"description":"Gewerbliche Nutzung (Nichtwohngeb\u00e4ude)","type":"boolean"},"restructuringRequirements":{"description":"Sanierungsauflagen: \u00f6ffentlich-rechtliche Vorgaben schr\u00e4nken eine energetische Sanierung ein","type":"boolean"},"noTotalCarbonEmissionDeduction":{"description":"Kein CO\u2082-Gesamtabzug (WEG)","type":"boolean"},"monumentProtection":{"description":"Denkmalschutz","type":"boolean"}}},"BillingSettings.BillingSettingsUpdate":{"type":"object","description":"","deprecated":false,"properties":{"heatingBaseCostPercentage":{"enum":[0,30,40,50,100],"description":"Grundkostenanteil Heizung in Prozent: 0, 30, 40, 50 oder 100","type":["integer","null"]},"heatingCostEnabled":{"description":"Kostenpflichtig: Heizkosten abrechnen (bucht `00002`)","type":["boolean","null"]},"warmWaterCostEnabled":{"description":"Kostenpflichtig: Warmwasserkosten abrechnen (bucht `00002`)","type":["boolean","null"]},"coldWaterCostEnabled":{"description":"Kostenpflichtig: Kaltwasserkosten abrechnen (bucht `00004`)","type":["boolean","null"]},"additionalCostEnabled":{"description":"Kostenpflichtig: Weitere Betriebskosten abrechnen (bucht `00003`)","type":["boolean","null"]},"warmWaterBaseCostPercentage":{"enum":[0,30,40,50,100],"description":"Grundkostenanteil Warmwasser in Prozent: 0, 30, 40, 50 oder 100","type":["integer","null"]},"heatingBaseCostDistribution":{"description":"Umlagema\u00dfstab der Grundkosten Heizung (`key`)","type":["string","null"]},"warmWaterBaseCostDistribution":{"description":"Umlagema\u00dfstab der Grundkosten Warmwasser (`key`)","type":["string","null"]},"warmWaterUsageCostDistribution":{"description":"Umlagema\u00dfstab der Verbrauchskosten Warmwasser (`key`)","type":["string","null"]},"warmWaterShareMethod":{"description":"Ermittlung des Warmwasseranteils an den Brennstoffkosten","type":["string","null"],"enum":["PERCENTAGE","DEVICE","WARM_WATER_USAGE","LIVING_SPACE","NO_HOT_WATER",null]},"warmWaterSharePercentage":{"minimum":0,"maximum":100,"description":"Warmwasseranteil in Prozent bei warmWaterShareMethod = PERCENTAGE","type":["number","null"]}}},"CostType.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"key":{"description":"Eindeutiger Schl\u00fcssel der Kostenart","example":"2030","type":"string"},"argeKey":{"description":"Kostenart-Schl\u00fcssel nach ARGE Heiz- und Wasserkosten; nicht eindeutig","example":"225","type":"string"},"label":{"description":"Bezeichnung","example":"Kaminfeger","type":"string"},"category":{"description":"HEATING = Heiz- und Warmwassernebenkosten, ADDITIONAL = Kaltwasser und weitere Betriebskosten","example":"HEATING","type":"string","enum":["HEATING","ADDITIONAL"]},"group":{"description":"HEATING: DEFAULT_HEATING_COST = Heizung und Warmwasser, SPECIAL_HEATING_COST = nur Heizung, SPECIAL_WARM_WATER_COST = nur Warmwasser; ADDITIONAL: Kostengruppe, z. B. Wasserversorgung","example":"DEFAULT_HEATING_COST","type":"string"},"distribution":{"description":"Standard-Umlagema\u00dfstab","anyOf":[{"$ref":"#\/components\/schemas\/DistributionKey.jsonld"},{"type":"null"}]},"hint":{"description":"Hinweis zur Erfassung","example":"Bitte die Rechnung des Bezirkskaminkehrers erfassen.","type":["string","null"]}}},"CostType":{"type":"object","description":"","deprecated":false,"properties":{"key":{"description":"Eindeutiger Schl\u00fcssel der Kostenart","example":"2030","type":"string"},"argeKey":{"description":"Kostenart-Schl\u00fcssel nach ARGE Heiz- und Wasserkosten; nicht eindeutig","example":"225","type":"string"},"label":{"description":"Bezeichnung","example":"Kaminfeger","type":"string"},"category":{"description":"HEATING = Heiz- und Warmwassernebenkosten, ADDITIONAL = Kaltwasser und weitere Betriebskosten","example":"HEATING","type":"string","enum":["HEATING","ADDITIONAL"]},"group":{"description":"HEATING: DEFAULT_HEATING_COST = Heizung und Warmwasser, SPECIAL_HEATING_COST = nur Heizung, SPECIAL_WARM_WATER_COST = nur Warmwasser; ADDITIONAL: Kostengruppe, z. B. Wasserversorgung","example":"DEFAULT_HEATING_COST","type":"string"},"distribution":{"description":"Standard-Umlagema\u00dfstab","anyOf":[{"$ref":"#\/components\/schemas\/DistributionKey"},{"type":"null"}]},"hint":{"description":"Hinweis zur Erfassung","example":"Bitte die Rechnung des Bezirkskaminkehrers erfassen.","type":["string","null"]}}},"Device.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"UUID des Ger\u00e4ts; f\u00fcr alle Folgeabfragen verwenden","example":"c3d5e7f9-0a1b-4c2d-9e3f-4a5b6c7d8e9f","type":"string","format":"uuid"},"number":{"description":"Z\u00e4hlernummer bzw. Seriennummer, wie auf dem Ger\u00e4t aufgedruckt","example":"21048992","type":["string","null"]},"type":{"description":"Ger\u00e4tetyp","type":"string","enum":["HEAT","HCA","WARM_WATER","COLD_WATER","SMOKE","ELECTRICITY","GAS"]},"state":{"description":"Status des Ger\u00e4ts","type":"string","enum":["ACTIVE","HINT","ERROR","DISMANTLED"]},"manufacturer":{"description":"Hersteller","example":"Engelmann","type":["string","null"]},"begin":{"description":"Montagedatum","example":"2020-03-01T00:00:00+01:00","type":"string","format":"date-time"},"end":{"description":"Demontagedatum; null = aktuell montiert","example":"2030-02-28T00:00:00+01:00","type":["string","null"],"format":"date-time"},"apartment":{"description":"Zugeordnete Einheit; null bei Ger\u00e4ten der Liegenschaft (z. B. Hauptz\u00e4hler)","anyOf":[{"$ref":"#\/components\/schemas\/ApartmentReference.jsonld"},{"type":"null"}]},"property":{"description":"Zugeordnete Liegenschaft","$ref":"#\/components\/schemas\/PropertyReference.jsonld"},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"Device":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"UUID des Ger\u00e4ts; f\u00fcr alle Folgeabfragen verwenden","example":"c3d5e7f9-0a1b-4c2d-9e3f-4a5b6c7d8e9f","type":"string","format":"uuid"},"number":{"description":"Z\u00e4hlernummer bzw. Seriennummer, wie auf dem Ger\u00e4t aufgedruckt","example":"21048992","type":["string","null"]},"type":{"description":"Ger\u00e4tetyp","type":"string","enum":["HEAT","HCA","WARM_WATER","COLD_WATER","SMOKE","ELECTRICITY","GAS"]},"state":{"description":"Status des Ger\u00e4ts","type":"string","enum":["ACTIVE","HINT","ERROR","DISMANTLED"]},"manufacturer":{"description":"Hersteller","example":"Engelmann","type":["string","null"]},"begin":{"description":"Montagedatum","example":"2020-03-01T00:00:00+01:00","type":"string","format":"date-time"},"end":{"description":"Demontagedatum; null = aktuell montiert","example":"2030-02-28T00:00:00+01:00","type":["string","null"],"format":"date-time"},"apartment":{"description":"Zugeordnete Einheit; null bei Ger\u00e4ten der Liegenschaft (z. B. Hauptz\u00e4hler)","anyOf":[{"$ref":"#\/components\/schemas\/ApartmentReference"},{"type":"null"}]},"property":{"description":"Zugeordnete Liegenschaft","$ref":"#\/components\/schemas\/PropertyReference"},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"DeviceValue.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"ID des Messwerts","example":"987654321","type":"string"},"reportDate":{"description":"Zeitpunkt der Erfassung (ISO 8601 mit Zeitzone)","example":"2026-06-30T12:00:00+02:00","type":"string","format":"date-time"},"value":{"description":"Z\u00e4hlerstand","example":1234.567,"type":"number"},"unit":{"description":"Einheit; leer bei Rauchmeldern","type":["string","null"],"enum":["m\u00b3","kWh","Einheiten","",null]},"type":{"description":"Erfassungsart: REMOTE = per Funk, MANUAL = manuell, ESTIMATED = gesch\u00e4tzt, SYSTEM\/CALCULATED = vom System berechnet","example":"REMOTE","type":"string","enum":["MANUAL","REMOTE","ESTIMATED","SYSTEM","CALCULATED"]},"deviceType":{"description":"Ger\u00e4tetyp des Z\u00e4hlers","type":"string","enum":["HEAT","HCA","WARM_WATER","COLD_WATER","SMOKE","ELECTRICITY","GAS"]},"isBillingRelevant":{"description":"true = flie\u00dft in die Heizkostenabrechnung ein","type":"boolean"}}},"DeviceValue":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"ID des Messwerts","example":"987654321","type":"string"},"reportDate":{"description":"Zeitpunkt der Erfassung (ISO 8601 mit Zeitzone)","example":"2026-06-30T12:00:00+02:00","type":"string","format":"date-time"},"value":{"description":"Z\u00e4hlerstand","example":1234.567,"type":"number"},"unit":{"description":"Einheit; leer bei Rauchmeldern","type":["string","null"],"enum":["m\u00b3","kWh","Einheiten","",null]},"type":{"description":"Erfassungsart: REMOTE = per Funk, MANUAL = manuell, ESTIMATED = gesch\u00e4tzt, SYSTEM\/CALCULATED = vom System berechnet","example":"REMOTE","type":"string","enum":["MANUAL","REMOTE","ESTIMATED","SYSTEM","CALCULATED"]},"deviceType":{"description":"Ger\u00e4tetyp des Z\u00e4hlers","type":"string","enum":["HEAT","HCA","WARM_WATER","COLD_WATER","SMOKE","ELECTRICITY","GAS"]},"isBillingRelevant":{"description":"true = flie\u00dft in die Heizkostenabrechnung ein","type":"boolean"}}},"DeviceValue.ReadingCreate.jsonld":{"type":"object","description":"","deprecated":false,"required":["reportDate","value"],"properties":{"reportDate":{"description":"Ablesezeitpunkt (ISO 8601 mit Zeitzone)","type":["string","null"],"format":"date-time"},"value":{"description":"Z\u00e4hlerstand","type":["number","null"]}}},"DeviceValue.ReadingCreate":{"type":"object","description":"","deprecated":false,"required":["reportDate","value"],"properties":{"reportDate":{"description":"Ablesezeitpunkt (ISO 8601 mit Zeitzone)","type":["string","null"],"format":"date-time"},"value":{"description":"Z\u00e4hlerstand","type":["number","null"]}}},"FuelDelivery.FuelDeliveryUpdate":{"type":"object","description":"","deprecated":false,"properties":{"type":{"description":"INITIAL = Anfangsbestand, PURCHASE = Lieferung bzw. Rechnung, FINAL = Endbestand","type":["string","null"],"enum":["INITIAL","PURCHASE","FINAL",null]},"date":{"description":"Liefer- bzw. Rechnungsdatum","type":["string","null"],"format":"date-time"},"quantity":{"minimum":0,"description":"Menge in der Einheit des Brennstoffs der Liegenschaft; 0 nur bei leerem Anfangs- oder Endbestand","type":["number","null"]},"netAmount":{"description":"Betrag netto","type":["number","null"]},"grossAmount":{"description":"Betrag brutto","type":["number","null"]},"taxRate":{"minimum":0,"maximum":100,"description":"Umsatzsteuersatz in Prozent; null = abweichender Satz","type":["number","null"]},"calorificValue":{"minimum":0.5,"maximum":20,"description":"Heizwert in kWh je Mengeneinheit","type":["number","null"]},"emissionFactor":{"minimum":0,"description":"Emissionsfaktor in kg CO\u2082 je kWh","type":["number","null"]},"carbonEmission":{"minimum":0,"description":"CO\u2082-Menge in kg","type":["number","null"]},"carbonCost":{"minimum":0,"description":"CO\u2082-Kosten brutto","type":["number","null"]},"invoiceNumber":{"maxLength":255,"description":"Rechnungsnummer","type":["string","null"]}}},"Property.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"UUID der Liegenschaft","example":"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","type":"string","format":"uuid"},"identifier":{"description":"Liegenschaftsnummer in der AssetApp","example":"I-864890871","type":"string"},"label":{"description":"Bezeichnung","example":"Waldfriedhofstra\u00dfe 12","type":"string"},"type":{"description":"Nutzungsart","type":["string","null"],"enum":["RESIDENTIAL","COMMERCIAL","MIXED_USE",null]},"state":{"description":"Bearbeitungsstatus","type":"string","enum":["OPEN","PROGRESS","DONE","CANCELED"]},"address":{"description":"Anschrift","$ref":"#\/components\/schemas\/PostalAddress.jsonld"},"constructionYear":{"description":"Baujahr","example":1972,"type":["integer","null"]},"isWeg":{"description":"Wohnungseigent\u00fcmergemeinschaft (WEG)","type":"boolean"},"apartments":{"description":"Einheiten der Liegenschaft, z. B. f\u00fcr den Umlagema\u00dfstab 32 (zugeordnete Nutzereinheiten)","type":"array","items":{"$ref":"#\/components\/schemas\/ApartmentReference.jsonld"}},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am; f\u00fcr die inkrementelle Synchronisation mit updatedAt[after]","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"Property":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"UUID der Liegenschaft","example":"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","type":"string","format":"uuid"},"identifier":{"description":"Liegenschaftsnummer in der AssetApp","example":"I-864890871","type":"string"},"label":{"description":"Bezeichnung","example":"Waldfriedhofstra\u00dfe 12","type":"string"},"type":{"description":"Nutzungsart","type":["string","null"],"enum":["RESIDENTIAL","COMMERCIAL","MIXED_USE",null]},"state":{"description":"Bearbeitungsstatus","type":"string","enum":["OPEN","PROGRESS","DONE","CANCELED"]},"address":{"description":"Anschrift","$ref":"#\/components\/schemas\/PostalAddress"},"constructionYear":{"description":"Baujahr","example":1972,"type":["integer","null"]},"isWeg":{"description":"Wohnungseigent\u00fcmergemeinschaft (WEG)","type":"boolean"},"apartments":{"description":"Einheiten der Liegenschaft, z. B. f\u00fcr den Umlagema\u00dfstab 32 (zugeordnete Nutzereinheiten)","type":"array","items":{"$ref":"#\/components\/schemas\/ApartmentReference"}},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am; f\u00fcr die inkrementelle Synchronisation mit updatedAt[after]","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"PropertySettings.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"UUID der Liegenschaft","example":"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","type":"string","format":"uuid"},"heatingCostEnabled":{"description":"Heizkosten werden abgerechnet","type":"boolean"},"warmWaterCostEnabled":{"description":"Warmwasserkosten werden abgerechnet","type":"boolean"},"coldWaterCostEnabled":{"description":"Kaltwasserkosten werden abgerechnet","type":"boolean"},"additionalCostEnabled":{"description":"Weitere Betriebskosten werden abgerechnet","type":"boolean"},"heatingBaseCostPercentage":{"description":"Grundkostenanteil Heizung in Prozent","example":30,"type":"integer"},"heatingUsageCostPercentage":{"description":"Verbrauchskostenanteil Heizung in Prozent","example":70,"type":"integer"},"heatingBaseCostDistribution":{"description":"Umlagema\u00dfstab der Grundkosten Heizung","$ref":"#\/components\/schemas\/DistributionKey.jsonld"},"warmWaterBaseCostPercentage":{"description":"Grundkostenanteil Warmwasser in Prozent","example":30,"type":"integer"},"warmWaterUsageCostPercentage":{"description":"Verbrauchskostenanteil Warmwasser in Prozent","example":70,"type":"integer"},"warmWaterBaseCostDistribution":{"description":"Umlagema\u00dfstab der Grundkosten Warmwasser","$ref":"#\/components\/schemas\/DistributionKey.jsonld"},"warmWaterUsageCostDistribution":{"description":"Umlagema\u00dfstab der Verbrauchskosten Warmwasser","$ref":"#\/components\/schemas\/DistributionKey.jsonld"},"warmWaterShareMethod":{"description":"Ermittlung des Warmwasseranteils an den Brennstoffkosten bei zentraler Warmwasserbereitung: PERCENTAGE = fester Prozentsatz, DEVICE = W\u00e4rmemengenz\u00e4hler, WARM_WATER_USAGE = Warmwasserverbrauch, LIVING_SPACE = Wohnfl\u00e4che, NO_HOT_WATER = keine zentrale Warmwasserbereitung","example":"PERCENTAGE","type":["string","null"],"enum":["PERCENTAGE","DEVICE","WARM_WATER_USAGE","LIVING_SPACE","NO_HOT_WATER",null]},"warmWaterSharePercentage":{"description":"Warmwasseranteil in Prozent bei warmWaterShareMethod = PERCENTAGE","example":18,"type":["number","null"]},"heatingSystem":{"description":"Art der Heizungsanlage der Liegenschaft","example":"OIL","type":"string"},"fuelType":{"description":"Brennstoff der Liegenschaft","$ref":"#\/components\/schemas\/FuelType.jsonld"},"carbonCostSplitEnabled":{"description":"CO\u2082-Kosten werden nach CO2KostAufG aufgeteilt","type":"boolean"},"commercialUse":{"description":"Gewerbliche Nutzung (Nichtwohngeb\u00e4ude)","type":"boolean"},"restructuringRequirements":{"description":"Sanierungsauflagen: \u00f6ffentlich-rechtliche Vorgaben schr\u00e4nken eine energetische Sanierung ein","type":"boolean"},"noTotalCarbonEmissionDeduction":{"description":"Kein CO\u2082-Gesamtabzug (WEG)","type":"boolean"},"monumentProtection":{"description":"Denkmalschutz","type":"boolean"}}},"PropertySettings":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"UUID der Liegenschaft","example":"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d","type":"string","format":"uuid"},"heatingCostEnabled":{"description":"Heizkosten werden abgerechnet","type":"boolean"},"warmWaterCostEnabled":{"description":"Warmwasserkosten werden abgerechnet","type":"boolean"},"coldWaterCostEnabled":{"description":"Kaltwasserkosten werden abgerechnet","type":"boolean"},"additionalCostEnabled":{"description":"Weitere Betriebskosten werden abgerechnet","type":"boolean"},"heatingBaseCostPercentage":{"description":"Grundkostenanteil Heizung in Prozent","example":30,"type":"integer"},"heatingUsageCostPercentage":{"description":"Verbrauchskostenanteil Heizung in Prozent","example":70,"type":"integer"},"heatingBaseCostDistribution":{"description":"Umlagema\u00dfstab der Grundkosten Heizung","$ref":"#\/components\/schemas\/DistributionKey"},"warmWaterBaseCostPercentage":{"description":"Grundkostenanteil Warmwasser in Prozent","example":30,"type":"integer"},"warmWaterUsageCostPercentage":{"description":"Verbrauchskostenanteil Warmwasser in Prozent","example":70,"type":"integer"},"warmWaterBaseCostDistribution":{"description":"Umlagema\u00dfstab der Grundkosten Warmwasser","$ref":"#\/components\/schemas\/DistributionKey"},"warmWaterUsageCostDistribution":{"description":"Umlagema\u00dfstab der Verbrauchskosten Warmwasser","$ref":"#\/components\/schemas\/DistributionKey"},"warmWaterShareMethod":{"description":"Ermittlung des Warmwasseranteils an den Brennstoffkosten bei zentraler Warmwasserbereitung: PERCENTAGE = fester Prozentsatz, DEVICE = W\u00e4rmemengenz\u00e4hler, WARM_WATER_USAGE = Warmwasserverbrauch, LIVING_SPACE = Wohnfl\u00e4che, NO_HOT_WATER = keine zentrale Warmwasserbereitung","example":"PERCENTAGE","type":["string","null"],"enum":["PERCENTAGE","DEVICE","WARM_WATER_USAGE","LIVING_SPACE","NO_HOT_WATER",null]},"warmWaterSharePercentage":{"description":"Warmwasseranteil in Prozent bei warmWaterShareMethod = PERCENTAGE","example":18,"type":["number","null"]},"heatingSystem":{"description":"Art der Heizungsanlage der Liegenschaft","example":"OIL","type":"string"},"fuelType":{"description":"Brennstoff der Liegenschaft","$ref":"#\/components\/schemas\/FuelType"},"carbonCostSplitEnabled":{"description":"CO\u2082-Kosten werden nach CO2KostAufG aufgeteilt","type":"boolean"},"commercialUse":{"description":"Gewerbliche Nutzung (Nichtwohngeb\u00e4ude)","type":"boolean"},"restructuringRequirements":{"description":"Sanierungsauflagen: \u00f6ffentlich-rechtliche Vorgaben schr\u00e4nken eine energetische Sanierung ein","type":"boolean"},"noTotalCarbonEmissionDeduction":{"description":"Kein CO\u2082-Gesamtabzug (WEG)","type":"boolean"},"monumentProtection":{"description":"Denkmalschutz","type":"boolean"}}},"PropertySettings.PropertySettingsUpdate":{"type":"object","description":"","deprecated":false,"properties":{"heatingBaseCostPercentage":{"enum":[0,30,40,50,100],"description":"Grundkostenanteil Heizung in Prozent: 0, 30, 40, 50 oder 100","type":["integer","null"]},"warmWaterBaseCostPercentage":{"enum":[0,30,40,50,100],"description":"Grundkostenanteil Warmwasser in Prozent: 0, 30, 40, 50 oder 100","type":["integer","null"]},"heatingBaseCostDistribution":{"description":"Umlagema\u00dfstab der Grundkosten Heizung (`key`)","type":["string","null"]},"warmWaterBaseCostDistribution":{"description":"Umlagema\u00dfstab der Grundkosten Warmwasser (`key`)","type":["string","null"]},"warmWaterUsageCostDistribution":{"description":"Umlagema\u00dfstab der Verbrauchskosten Warmwasser (`key`)","type":["string","null"]},"warmWaterShareMethod":{"description":"Ermittlung des Warmwasseranteils an den Brennstoffkosten","type":["string","null"],"enum":["PERCENTAGE","DEVICE","WARM_WATER_USAGE","LIVING_SPACE","NO_HOT_WATER",null]},"warmWaterSharePercentage":{"minimum":0,"maximum":100,"description":"Warmwasseranteil in Prozent bei warmWaterShareMethod = PERCENTAGE","type":["number","null"]},"fuelType":{"description":"Brennstoff (`fuelType.key`); muss zur Heizungsanlage passen","type":["string","null"]},"carbonCostSplitEnabled":{"description":"CO\u2082-Kosten nach CO2KostAufG aufteilen","type":["boolean","null"]},"commercialUse":{"description":"Gewerbliche Nutzung (Nichtwohngeb\u00e4ude)","type":["boolean","null"]},"restructuringRequirements":{"description":"Sanierungsauflagen","type":["boolean","null"]},"noTotalCarbonEmissionDeduction":{"description":"Kein CO\u2082-Gesamtabzug (WEG)","type":["boolean","null"]},"monumentProtection":{"description":"Denkmalschutz","type":["boolean","null"]}}},"ServicePrice.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"serviceNumber":{"description":"Leistungsnummer","example":"00002","type":"string"},"title":{"description":"Bezeichnung der Leistung","example":"Abrechnungsservice Heizung","type":"string"},"price":{"description":"Preis in Euro; null, wenn AssetWork keinen Preis nennt","example":29.5,"type":["number","null"]}}},"ServicePrice":{"type":"object","description":"","deprecated":false,"properties":{"serviceNumber":{"description":"Leistungsnummer","example":"00002","type":"string"},"title":{"description":"Bezeichnung der Leistung","example":"Abrechnungsservice Heizung","type":"string"},"price":{"description":"Preis in Euro; null, wenn AssetWork keinen Preis nennt","example":29.5,"type":["number","null"]}}},"Tenant.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@context":{"readOnly":true,"oneOf":[{"type":"string"},{"type":"object","properties":{"@vocab":{"type":"string"},"hydra":{"type":"string","enum":["http:\/\/www.w3.org\/ns\/hydra\/core#"]}},"required":["@vocab","hydra"],"additionalProperties":true}]},"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"id":{"description":"ID des Mietverh\u00e4ltnisses","example":1234,"type":"integer"},"apartment":{"description":"Einheit","$ref":"#\/components\/schemas\/ApartmentReference.jsonld"},"reference":{"description":"Kennzeichen des Mieters im Fremdsystem, z. B. die Mieterkontonummer (max. 20 Zeichen); gilt f\u00fcr die Person und damit f\u00fcr alle ihre Mietverh\u00e4ltnisse. Wird in der ARGE-\u00dcbergabe als Ordnungsbegriff des Auftraggebers verwendet.","example":"MK 4711","type":["string","null"]},"personId":{"description":"UUID der Person; gleich f\u00fcr alle Mietverh\u00e4ltnisse derselben Person, z. B. bei einem Umzug innerhalb der Liegenschaft","example":"b2c4e6f8-1a3c-4e5f-8a7b-9c0d1e2f3a4b","type":["string","null"],"format":"uuid"},"vacant":{"description":"true = Leerstand ohne Person; bei einer gel\u00f6schten oder nicht sichtbaren Person false, Name und Kontaktdaten sind dann leer","type":"boolean"},"name":{"description":"Name des Mieters","example":"Erika Mustermann","type":["string","null"]},"company":{"description":"Firma","example":"Mustermann GmbH","type":["string","null"]},"email":{"description":"E-Mail-Adresse","example":"erika.mustermann@example.com","type":["string","null"]},"phone":{"description":"Telefonnummer","example":"+49 89 1234567","type":["string","null"]},"begin":{"description":"Einzug","example":"2026-07-01T00:00:00+02:00","type":"string","format":"date-time"},"end":{"description":"Auszug; null = unbefristet","example":"2027-06-30T00:00:00+02:00","type":["string","null"],"format":"date-time"},"prepaymentNetAmount":{"description":"Vorauszahlungen netto f\u00fcr den Abrechnungszeitraum (Summe); aus dem Bruttobetrag abgeleitet","example":957.98,"type":["number","null"]},"prepaymentGrossAmount":{"description":"Vorauszahlungen brutto f\u00fcr den Abrechnungszeitraum (Summe, nicht monatlich)","example":1140,"type":["number","null"]},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"Tenant":{"type":"object","description":"","deprecated":false,"properties":{"id":{"description":"ID des Mietverh\u00e4ltnisses","example":1234,"type":"integer"},"apartment":{"description":"Einheit","$ref":"#\/components\/schemas\/ApartmentReference"},"reference":{"description":"Kennzeichen des Mieters im Fremdsystem, z. B. die Mieterkontonummer (max. 20 Zeichen); gilt f\u00fcr die Person und damit f\u00fcr alle ihre Mietverh\u00e4ltnisse. Wird in der ARGE-\u00dcbergabe als Ordnungsbegriff des Auftraggebers verwendet.","example":"MK 4711","type":["string","null"]},"personId":{"description":"UUID der Person; gleich f\u00fcr alle Mietverh\u00e4ltnisse derselben Person, z. B. bei einem Umzug innerhalb der Liegenschaft","example":"b2c4e6f8-1a3c-4e5f-8a7b-9c0d1e2f3a4b","type":["string","null"],"format":"uuid"},"vacant":{"description":"true = Leerstand ohne Person; bei einer gel\u00f6schten oder nicht sichtbaren Person false, Name und Kontaktdaten sind dann leer","type":"boolean"},"name":{"description":"Name des Mieters","example":"Erika Mustermann","type":["string","null"]},"company":{"description":"Firma","example":"Mustermann GmbH","type":["string","null"]},"email":{"description":"E-Mail-Adresse","example":"erika.mustermann@example.com","type":["string","null"]},"phone":{"description":"Telefonnummer","example":"+49 89 1234567","type":["string","null"]},"begin":{"description":"Einzug","example":"2026-07-01T00:00:00+02:00","type":"string","format":"date-time"},"end":{"description":"Auszug; null = unbefristet","example":"2027-06-30T00:00:00+02:00","type":["string","null"],"format":"date-time"},"prepaymentNetAmount":{"description":"Vorauszahlungen netto f\u00fcr den Abrechnungszeitraum (Summe); aus dem Bruttobetrag abgeleitet","example":957.98,"type":["number","null"]},"prepaymentGrossAmount":{"description":"Vorauszahlungen brutto f\u00fcr den Abrechnungszeitraum (Summe, nicht monatlich)","example":1140,"type":["number","null"]},"createdAt":{"description":"Angelegt am","example":"2026-01-15T09:30:00+01:00","type":"string","format":"date-time"},"updatedAt":{"description":"Zuletzt ge\u00e4ndert am","example":"2026-10-01T14:05:00+02:00","type":["string","null"],"format":"date-time"}}},"Tenant.TenantCreate.jsonld":{"type":"object","description":"","deprecated":false,"required":["apartment","begin"],"properties":{"apartment":{"format":"uuid","description":"UUID der Einheit","externalDocs":{"url":"https:\/\/schema.org\/identifier"},"type":"string"},"personId":{"format":"uuid","description":"Bekannte Person (personId aus \/api\/v1\/tenants), die einzieht; Name und Kontaktdaten werden dann nicht ben\u00f6tigt","externalDocs":{"url":"https:\/\/schema.org\/identifier"},"type":["string","null"]},"begin":{"description":"Einzugsdatum","type":["string","null"],"format":"date-time"},"end":{"description":"Auszugsdatum, falls bereits bekannt","type":["string","null"],"format":"date-time"},"name":{"pattern":"^((?!\\s*$).{2,255})$","description":"Name des Mieters; Pflicht, wenn keine bekannte Person gefunden wird","type":["string","null"]},"reference":{"maxLength":20,"pattern":"^(\\S(.*\\S)?)$","description":"Kennzeichen des Mieters im Fremdsystem, z. B. die Mieterkontonummer (max. 20 Zeichen); gilt f\u00fcr die Person und damit f\u00fcr alle ihre Mietverh\u00e4ltnisse. Wird in der ARGE-\u00dcbergabe als Ordnungsbegriff des Auftraggebers verwendet.","type":["string","null"]},"company":{"pattern":"^((?!\\s*$).{2,255})$","description":"Firma","type":["string","null"]},"email":{"format":"email","description":"E-Mail-Adresse; der Mieter erh\u00e4lt keine Einladung","externalDocs":{"url":"https:\/\/schema.org\/email"},"type":["string","null"]},"phone":{"pattern":"^((?!\\s*$).{2,50})$","description":"Telefonnummer","type":["string","null"]},"prepaymentGrossAmount":{"minimum":0,"description":"Vorauszahlungen brutto f\u00fcr den Abrechnungszeitraum (Summe, nicht monatlich); bei einem Mietverh\u00e4ltnis \u00fcber mehrere Jahre vor jeder Abrechnung mit PATCH aktualisieren","type":["number","null"]},"nettoCalculation":{"description":"Vorauszahlungen netto abrechnen","type":"boolean"},"adjustOverlappingTenancies":{"description":"Ein \u00fcberschneidendes Mietverh\u00e4ltnis der Einheit anpassen statt die Anfrage abzulehnen (Mieterwechsel)","type":"boolean"},"vacant":{"description":"Leerstand erfassen, z. B. nach einem Auszug ohne Nachmieter; ohne Person und ohne Vorauszahlung","type":"boolean"}}},"Tenant.TenantCreate":{"type":"object","description":"","deprecated":false,"required":["apartment","begin"],"properties":{"apartment":{"format":"uuid","description":"UUID der Einheit","externalDocs":{"url":"https:\/\/schema.org\/identifier"},"type":"string"},"personId":{"format":"uuid","description":"Bekannte Person (personId aus \/api\/v1\/tenants), die einzieht; Name und Kontaktdaten werden dann nicht ben\u00f6tigt","externalDocs":{"url":"https:\/\/schema.org\/identifier"},"type":["string","null"]},"begin":{"description":"Einzugsdatum","type":["string","null"],"format":"date-time"},"end":{"description":"Auszugsdatum, falls bereits bekannt","type":["string","null"],"format":"date-time"},"name":{"pattern":"^((?!\\s*$).{2,255})$","description":"Name des Mieters; Pflicht, wenn keine bekannte Person gefunden wird","type":["string","null"]},"reference":{"maxLength":20,"pattern":"^(\\S(.*\\S)?)$","description":"Kennzeichen des Mieters im Fremdsystem, z. B. die Mieterkontonummer (max. 20 Zeichen); gilt f\u00fcr die Person und damit f\u00fcr alle ihre Mietverh\u00e4ltnisse. Wird in der ARGE-\u00dcbergabe als Ordnungsbegriff des Auftraggebers verwendet.","type":["string","null"]},"company":{"pattern":"^((?!\\s*$).{2,255})$","description":"Firma","type":["string","null"]},"email":{"format":"email","description":"E-Mail-Adresse; der Mieter erh\u00e4lt keine Einladung","externalDocs":{"url":"https:\/\/schema.org\/email"},"type":["string","null"]},"phone":{"pattern":"^((?!\\s*$).{2,50})$","description":"Telefonnummer","type":["string","null"]},"prepaymentGrossAmount":{"minimum":0,"description":"Vorauszahlungen brutto f\u00fcr den Abrechnungszeitraum (Summe, nicht monatlich); bei einem Mietverh\u00e4ltnis \u00fcber mehrere Jahre vor jeder Abrechnung mit PATCH aktualisieren","type":["number","null"]},"nettoCalculation":{"description":"Vorauszahlungen netto abrechnen","type":"boolean"},"adjustOverlappingTenancies":{"description":"Ein \u00fcberschneidendes Mietverh\u00e4ltnis der Einheit anpassen statt die Anfrage abzulehnen (Mieterwechsel)","type":"boolean"},"vacant":{"description":"Leerstand erfassen, z. B. nach einem Auszug ohne Nachmieter; ohne Person und ohne Vorauszahlung","type":"boolean"}}},"Tenant.TenantUpdate":{"type":"object","description":"","deprecated":false,"properties":{"begin":{"description":"Neues Einzugsdatum","type":["string","null"],"format":"date-time"},"end":{"description":"Auszugsdatum; null \u00f6ffnet das Mietverh\u00e4ltnis wieder, weglassen beh\u00e4lt es bei","type":["string","null"],"format":"date-time"},"reference":{"maxLength":20,"pattern":"^(\\S(.*\\S)?)$","description":"Kennzeichen des Mieters im Fremdsystem, z. B. die Mieterkontonummer (max. 20 Zeichen); gilt f\u00fcr die Person und damit f\u00fcr alle ihre Mietverh\u00e4ltnisse. Wird in der ARGE-\u00dcbergabe als Ordnungsbegriff des Auftraggebers verwendet. null l\u00f6scht es, weglassen beh\u00e4lt es bei.","type":["string","null"]},"prepaymentGrossAmount":{"minimum":0,"description":"Vorauszahlungen brutto f\u00fcr den Abrechnungszeitraum (Summe, nicht monatlich)","type":["number","null"]}}},"MoveOutReading.jsonld":{"type":"object","description":"","deprecated":false,"properties":{"@id":{"readOnly":true,"type":"string"},"@type":{"readOnly":true,"type":"string"},"deviceId":{"description":"UUID des Ger\u00e4ts","example":"3d6f0a8e-5b1c-4e2a-9f7d-2c8b1e4a6f90","type":"string","format":"uuid"},"deviceNumber":{"description":"Ger\u00e4tenummer","example":"12345678","type":["string","null"]},"deviceType":{"description":"Ger\u00e4tetyp","type":"string","enum":["HEAT","HCA","WARM_WATER","COLD_WATER","SMOKE","ELECTRICITY","GAS"]},"moveOutDate":{"description":"Auszugstag, zu dem der Stand z\u00e4hlt","example":"2026-06-30T00:00:00+02:00","type":"string","format":"date-time"},"status":{"description":"ON_DATE, NEARBY oder MISSING","type":"string","enum":["ON_DATE","NEARBY","MISSING"]},"readingDate":{"description":"Zeitpunkt des z\u00e4hlenden Stands; null bei MISSING","example":"2026-06-29T12:00:00+02:00","type":["string","null"],"format":"date-time"},"value":{"description":"Z\u00e4hlerstand; null bei MISSING","example":1234.567,"type":["number","null"]},"unit":{"description":"Einheit","type":["string","null"],"enum":["m\u00b3","kWh","Einheiten","",null]},"readingType":{"description":"Erfassungsart des Stands; null bei MISSING","type":["string","null"],"enum":["MANUAL","REMOTE","ESTIMATED","SYSTEM","CALCULATED",null]}}},"MoveOutReading":{"type":"object","description":"","deprecated":false,"properties":{"deviceId":{"description":"UUID des Ger\u00e4ts","example":"3d6f0a8e-5b1c-4e2a-9f7d-2c8b1e4a6f90","type":"string","format":"uuid"},"deviceNumber":{"description":"Ger\u00e4tenummer","example":"12345678","type":["string","null"]},"deviceType":{"description":"Ger\u00e4tetyp","type":"string","enum":["HEAT","HCA","WARM_WATER","COLD_WATER","SMOKE","ELECTRICITY","GAS"]},"moveOutDate":{"description":"Auszugstag, zu dem der Stand z\u00e4hlt","example":"2026-06-30T00:00:00+02:00","type":"string","format":"date-time"},"status":{"description":"ON_DATE, NEARBY oder MISSING","type":"string","enum":["ON_DATE","NEARBY","MISSING"]},"readingDate":{"description":"Zeitpunkt des z\u00e4hlenden Stands; null bei MISSING","example":"2026-06-29T12:00:00+02:00","type":["string","null"],"format":"date-time"},"value":{"description":"Z\u00e4hlerstand; null bei MISSING","example":1234.567,"type":["number","null"]},"unit":{"description":"Einheit","type":["string","null"],"enum":["m\u00b3","kWh","Einheiten","",null]},"readingType":{"description":"Erfassungsart des Stands; null bei MISSING","type":["string","null"],"enum":["MANUAL","REMOTE","ESTIMATED","SYSTEM","CALCULATED",null]}}}},"securitySchemes":{"oauth":{"type":"oauth2","flows":{"clientCredentials":{"tokenUrl":"\/api\/v1\/token","scopes":{"read":"Lesezugriff","write":"Schreibzugriff"}}}}}},"security":[{"oauth":["read"]}]}