---
title: "Provisionsabrechnung"
url: "https://maklerportal.apim.eu/apis/provisionsabrechnung/versions/66d24f0e-eec7-434f-880d-19abbf6211e5"
---

# Provisionsabrechnung

OpenAPI specification document.

```json
{"openapi":"3.0.3","info":{"title":"Provisionsabrechnung","version":"1.0.0","description":"Rechnet die Courtage nach erfolgreicher Vermittlung ab: Abrechnung erzeugen,\nRechnung abrufen, Zahlungseingang verbuchen.\n\nDie Provision entsteht mit dem Zustandekommen des Hauptvertrags. Beim Verkauf\nvon Wohnungen und Einfamilienhäusern an Verbraucher gilt das Prinzip der\ngeteilten Courtage – die API prüft die Aufteilung beim Anlegen der Abrechnung.\n","contact":{"name":"API-Support Objektwerk GmbH","email":"api-support@objektwerk.example"}},"servers":[{"url":"https://api.maklerportal.example/v1","description":"Produktion"},{"url":"https://sandbox.api.maklerportal.example/v1","description":"Sandbox"}],"tags":[{"name":"Abrechnungen"},{"name":"Rechnungen"},{"name":"Courtage"}],"security":[{"apiKey":[]}],"paths":{"/abrechnungen":{"get":{"tags":["Abrechnungen"],"summary":"Abrechnungen auflisten","operationId":"abrechnungenAuflisten","parameters":[{"name":"status","in":"query","schema":{"$ref":"#/components/schemas/Abrechnungsstatus"}},{"name":"objekt_id","in":"query","schema":{"type":"string","example":"obj_8f2c1a"}},{"name":"zeitraum_von","in":"query","schema":{"type":"string","format":"date"}},{"name":"zeitraum_bis","in":"query","schema":{"type":"string","format":"date"}}],"responses":{"200":{"description":"Trefferliste","content":{"application/json":{"schema":{"type":"object","properties":{"daten":{"type":"array","items":{"$ref":"#/components/schemas/Abrechnung"}},"seite":{"$ref":"#/components/schemas/Seite"}}}}}},"401":{"$ref":"#/components/responses/NichtAuthentifiziert"}}},"post":{"tags":["Abrechnungen"],"summary":"Abrechnung erstellen","description":"Erzeugt die Abrechnung zu einem abgeschlossenen Vermittlungsvorgang.\nGrundlage ist der beurkundete Kaufpreis bzw. die vereinbarte Miete.\n","operationId":"abrechnungErstellen","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AbrechnungAnlegen"},"example":{"objekt_id":"obj_8f2c1a","geschaeftsart":"verkauf","bemessungsgrundlage_eur":645000,"kaeufer_prozent":3.57,"verkaeufer_prozent":3.57,"vertragsdatum":"2026-08-14","kaeufer":{"name":"Anna Bergmann","interessent_id":"int_71ab"}}}}},"responses":{"201":{"description":"Erstellt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Abrechnung"},"example":{"id":"abr_7c53","objekt_id":"obj_8f2c1a","status":"offen","geschaeftsart":"verkauf","bemessungsgrundlage_eur":645000,"positionen":[{"partei":"kaeufer","satz_prozent":3.57,"netto_eur":19353.36,"umsatzsteuer_eur":3677.14,"brutto_eur":23030.5},{"partei":"verkaeufer","satz_prozent":3.57,"netto_eur":19353.36,"umsatzsteuer_eur":3677.14,"brutto_eur":23030.5}],"faellig_am":"2026-08-28"}}}},"422":{"description":"Aufteilung der Courtage unzulässig","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"},"example":{"code":"provision_unzulaessig","nachricht":"Der Käuferanteil darf den Verkäuferanteil nicht übersteigen.","details":[{"feld":"kaeufer_prozent","grund":"groesser_als_verkaeufer"}]}}}}}}},"/abrechnungen/{abrechnungId}":{"parameters":[{"name":"abrechnungId","in":"path","required":true,"schema":{"type":"string","example":"abr_7c53"}}],"get":{"tags":["Abrechnungen"],"summary":"Abrechnung abrufen","operationId":"abrechnungAbrufen","responses":{"200":{"description":"Abrechnung","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Abrechnung"}}}},"404":{"$ref":"#/components/responses/NichtGefunden"}}}},"/abrechnungen/{abrechnungId}/zahlungseingang":{"parameters":[{"name":"abrechnungId","in":"path","required":true,"schema":{"type":"string","example":"abr_7c53"}}],"post":{"tags":["Abrechnungen"],"summary":"Zahlungseingang verbuchen","description":"Teilzahlungen sind zulässig; der Status wechselt erst bei vollem Ausgleich auf `bezahlt`.","operationId":"zahlungseingangVerbuchen","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["betrag_eur","wertstellung"],"properties":{"betrag_eur":{"type":"number","format":"float","example":23030.5},"wertstellung":{"type":"string","format":"date","example":"2026-08-26"},"verwendungszweck":{"type":"string","example":"RG-2026-0418"}}}}}},"responses":{"200":{"description":"Verbucht","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Abrechnung"}}}}}}},"/rechnungen/{rechnungId}/pdf":{"parameters":[{"name":"rechnungId","in":"path","required":true,"schema":{"type":"string","example":"rec_a920"}}],"get":{"tags":["Rechnungen"],"summary":"Rechnung als PDF laden","operationId":"rechnungPdfLaden","responses":{"200":{"description":"PDF-Dokument","content":{"application/pdf":{"schema":{"type":"string","format":"binary"}}}},"404":{"$ref":"#/components/responses/NichtGefunden"}}}},"/courtage/rechner":{"post":{"tags":["Courtage"],"summary":"Courtage vorab berechnen","description":"Rechnet eine Courtage durch, ohne eine Abrechnung anzulegen – nützlich für\nAngebotsgespräche und für die Anzeige im Exposé.\n","operationId":"courtageBerechnen","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["bemessungsgrundlage_eur","kaeufer_prozent"],"properties":{"bemessungsgrundlage_eur":{"type":"integer","example":645000},"kaeufer_prozent":{"type":"number","format":"float","example":3.57},"verkaeufer_prozent":{"type":"number","format":"float","example":3.57},"umsatzsteuer_prozent":{"type":"number","format":"float","default":19}}}}}},"responses":{"200":{"description":"Berechnung","content":{"application/json":{"schema":{"type":"object","properties":{"positionen":{"type":"array","items":{"$ref":"#/components/schemas/Position"}},"summe_brutto_eur":{"type":"number","format":"float","example":46061}}}}}}}}}},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"apikey","description":"Jeder Aufruf trägt einen API-Schlüssel im Header `apikey`. Den Schlüssel\nerzeugen Sie im Maklerportal unter \"Meine Anwendungen\"; er wird genau einmal\nangezeigt.\n\nAn jedem Schlüssel hängen die Scopes, die er nutzen darf. Fehlt einer,\nantwortet die API mit `403` und `code: \"scope_fehlt\"`; der fehlende Scope\nsteht in `details[].feld`.\n"}},"responses":{"NichtAuthentifiziert":{"description":"Schlüssel fehlt, ist gesperrt oder ungültig","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}}},"NichtGefunden":{"description":"Datensatz nicht gefunden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}}},"Validierungsfehler":{"description":"Die Anfrage entspricht nicht dem Schema","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}}},"ZuVieleAnfragen":{"description":"Rate Limit erreicht","headers":{"Retry-After":{"schema":{"type":"integer","example":12}}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Fehler"}}}}},"schemas":{"Seite":{"type":"object","description":"Cursor-basierte Paginierung.","properties":{"anzahl":{"type":"integer","example":25},"gesamt":{"type":"integer","example":138},"cursor_naechste":{"type":"string","nullable":true,"example":"eyJzIjoyNX0"}}},"Fehlerdetail":{"type":"object","properties":{"feld":{"type":"string","example":"energieausweis.endenergiebedarf_kwh"},"grund":{"type":"string","example":"fehlt"}}},"Fehler":{"type":"object","description":"Einheitliches Fehlerformat aller Maklerportal-APIs.","required":["code","nachricht"],"properties":{"code":{"type":"string","example":"validierung_fehlgeschlagen"},"nachricht":{"type":"string","example":"Für die Veröffentlichung fehlen Pflichtangaben aus dem Energieausweis."},"details":{"type":"array","items":{"$ref":"#/components/schemas/Fehlerdetail"}}}},"Abrechnungsstatus":{"type":"string","enum":["entwurf","offen","teilweise_bezahlt","bezahlt","storniert"],"example":"offen"},"Geschaeftsart":{"type":"string","enum":["verkauf","vermietung","gewerbevermietung"],"example":"verkauf"},"Partei":{"type":"object","properties":{"name":{"type":"string","example":"Anna Bergmann"},"interessent_id":{"type":"string","example":"int_71ab"},"anschrift":{"type":"string","example":"Isestraße 88, 20149 Hamburg"}}},"Position":{"type":"object","properties":{"partei":{"type":"string","enum":["kaeufer","verkaeufer","mieter","vermieter"]},"satz_prozent":{"type":"number","format":"float","example":3.57},"netto_eur":{"type":"number","format":"float","example":19353.36},"umsatzsteuer_eur":{"type":"number","format":"float","example":3677.14},"brutto_eur":{"type":"number","format":"float","example":23030.5}}},"AbrechnungAnlegen":{"type":"object","required":["objekt_id","geschaeftsart","bemessungsgrundlage_eur","kaeufer_prozent","vertragsdatum"],"properties":{"objekt_id":{"type":"string","example":"obj_8f2c1a"},"geschaeftsart":{"$ref":"#/components/schemas/Geschaeftsart"},"bemessungsgrundlage_eur":{"type":"integer","description":"Beurkundeter Kaufpreis bzw. Jahresnettokaltmiete.","example":645000},"kaeufer_prozent":{"type":"number","format":"float","example":3.57},"verkaeufer_prozent":{"type":"number","format":"float","example":3.57},"vertragsdatum":{"type":"string","format":"date","example":"2026-08-14"},"kaeufer":{"$ref":"#/components/schemas/Partei"},"verkaeufer":{"$ref":"#/components/schemas/Partei"}}},"Abrechnung":{"type":"object","properties":{"id":{"type":"string","example":"abr_7c53"},"objekt_id":{"type":"string","example":"obj_8f2c1a"},"status":{"$ref":"#/components/schemas/Abrechnungsstatus"},"geschaeftsart":{"$ref":"#/components/schemas/Geschaeftsart"},"bemessungsgrundlage_eur":{"type":"integer","example":645000},"positionen":{"type":"array","items":{"$ref":"#/components/schemas/Position"}},"rechnung_id":{"type":"string","example":"rec_a920"},"faellig_am":{"type":"string","format":"date","example":"2026-08-28"},"bezahlt_eur":{"type":"number","format":"float","example":0},"erstellt_am":{"type":"string","format":"date-time","example":"2026-08-15T07:30:00Z"}}}}}}
```