Skip to main content

5. Pachtkonten

GET /pachtkonten

Liste aller Pachtkonten.

Query-Parameter:

Parameter Typ Beschreibung
search string Suche in Kontonummer, Bezeichnung, Pächter, Standort
status string aktiv | inaktiv | gekuendigt | ausgelaufen
page integer Seite (Standard: 1)
limit integer Pro Seite (Standard: 20)

Antwort 200: Paginierte Liste von Pachtkonto-Objekten.


POST /pachtkonten

Neues Pachtkonto anlegen.

Pflichtfelder:

{
"kontonummer": "PA-2025-001",
"bezeichnung": "Ackerfläche Nordfeld",
"pachter": "Max Mustermann",
"pachtbeginn": "2025-01-01",
"pachtzins": 850.00,
"flaeche": 12500,
"standort": "Feldweg 3, 12345 Musterstadt",
"status": "aktiv"
}

Optionale Felder: pachtendekontaktIdverpachterIdpaechterKontaktIdkategoriekurzbezeichnungzahlungsart (vorschuessig | nachzahlend), hebungsMonatebelegdruckVerpaechterbelegdruckPaechternotizen

Antwort 201: Angelegtes Pachtkonto-Objekt mit id.


GET /pachtkonten/{id}

Einzelnes Pachtkonto mit Details abrufen.

Antwort 200: PachtkontoDetail-Objekt (inkl. verknüpfte Kontakte, Pachtobjekte, Positionen).
Antwort 404: Nicht gefunden.


PUT /pachtkonten/{id}

Pachtkonto aktualisieren. Alle Felder optional (nur geänderte Felder senden).

Antwort 200: Aktualisiertes Pachtkonto-Objekt.


DELETE /pachtkonten/{id}

Pachtkonto löschen (dauerhaft, inkl. aller Positionen).

Antwort 204: Gelöscht.


GET /pachtkonten/{id}/positionen

Positionen eines Pachtkontos abrufen.

Antwort 200: Array von PachtkontoPosition-Objekten.


POST /pachtkonten/{id}/positionen

Position zu einem Pachtkonto hinzufügen.

{
"bezeichnung": "Grundpachtzins",
"betrag": 750.00,
"typ": "pachtzins",
"gueltigAb": "2025-01-01"
}

Antwort 201: Angelegte PachtkontoPosition.


PUT /pachtkonten/{id}/positionen/{posId}

Position aktualisieren.

Antwort 200: Aktualisierte PachtkontoPosition.


DELETE /pachtkonten/{id}/positionen/{posId}

Position löschen.

Antwort 204: Gelöscht.