Überblick

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

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

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

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

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