---
title: "Überblick"
description: "Die API rechnet die Courtage nach erfolgreicher Vermittlung ab und stellt die Rechnung als PDF bereit."
url: "https://maklerportal.apim.eu/apis/provisionsabrechnung/docs/uebersicht"
image: "https://maklerportal.apim.eu/_og/d/c_Ocean.takumi,title_~w5xiZXJibGljaw,description_Die+API+rechnet+die+Courtage+nach+erfolgreicher+Vermittlung+ab+und+stellt+die+Rechnung+als+PDF+bereit.,props_eyJ0aGVtZSI6eyJtb2RlIjoiZGFyayIsImNvbG9ycyI6eyJwcmltYXJ5IjoiI0Q0QTI0QyJ9fX0,p_Ii9hcGlzL3Byb3Zpc2lvbnNhYnJlY2hudW5nL2RvY3MvdWViZXJzaWNodCI,s_P3gKVM2t2639ksCL.png"
---

# Überblick

Die API rechnet die Courtage nach erfolgreicher Vermittlung ab und stellt die Rechnung als PDF bereit.

## [Geteilte Courtage](#geteilte-courtage)

Beim Verkauf von Wohnungen und Einfamilienhäusern an Verbraucher darf der Käuferanteil den Verkäuferanteil nicht übersteigen. Die API prüft das beim Anlegen und antwortet andernfalls mit `422` und `code: "provision_unzulaessig"`.

Prüfen Sie dieselbe Bedingung bereits im Objektdatensatz – dort steht die Provision, die im Exposé beworben wird. Eine Abrechnung, die von der beworbenen Courtage abweicht, ist im Streitfall schwer zu halten.

## [Bemessungsgrundlage](#bemessungsgrundlage)

| Geschäftsart      | Grundlage                                    |
| :---------------- | :------------------------------------------- |
| verkauf           | beurkundeter Kaufpreis                       |
| vermietung        | Nettokaltmiete, üblicherweise als Vielfaches |
| gewerbevermietung | Jahresnettokaltmiete                         |

## [Zahlungseingänge](#zahlungseingänge)

`POST /abrechnungen/{id}/zahlungseingang` verbucht auch Teilzahlungen. Der Status wechselt erst auf `bezahlt`, wenn die Summe der Eingänge den Bruttobetrag erreicht; bis dahin steht er auf `teilweise_bezahlt`. So bleibt ohne zusätzliche Buchhaltungslogik erkennbar, was offen ist.

## [Vorabberechnung](#vorabberechnung)

`POST /courtage/rechner` rechnet eine Courtage durch, ohne etwas anzulegen. Das ist der richtige Aufruf für Angebotsgespräche und für die Provisionsangabe im Exposé.

## [Benötigter Scope](#benötigter-scope)

Alle Aufrufe verlangen `provisionen:lesen`. Schreibende Vorgänge sind bewusst an dieselbe Rolle gebunden, weil Abrechnungen nur von der Buchhaltung angelegt werden sollten.