Was macht FarmOS Land-Portfolio?
Eigentums- und Pachtland, Pachtbedingungen, Vermieterbeziehungen, Zahlungen und jährliche Landkosten verfolgen.
KRITISCH: Regeln für Datenvollständigkeit
Verwenden Sie NIEMALS unvollständige oder abgeschnittene Daten. Diese Regeln sind nicht verhandelbar:
- Verwenden Sie NIEMALS
/api/integration/dashboard– es kürzt Ergebnisse auf 5 Einträge. Unvollständige Zahlungsdaten sind schlimmer als keine Daten, da sie ein falsches Gefühl von Vollständigkeit vermitteln. - Verwenden Sie IMMER die
/all-Endpunkte (siehe unten) für vollständige Daten. - Wenn ein Endpunkt einen Fehler oder leere Ergebnisse zurückgibt, MELDEN SIE DEN FEHLER dem Benutzer. Fallen Sie nicht stillschweigend auf einen anderen Endpunkt zurück oder präsentieren Sie unvollständige Daten.
- Geben Sie IMMER die Gesamtanzahl der zurückgegebenen Datensätze an, damit der Benutzer weiß, dass die Daten vollständig sind. Beispiel: „11 im März fällige Zahlungen in Höhe von insgesamt 175.058 $ gefunden.“
- Wenn Sie keine vollständigen Daten abrufen können, sagen Sie dies explizit. „Ich konnte keine vollständigen Zahlungsdaten abrufen“ ist unendlich besser, als 5 von 11 Zahlungen anzuzeigen.
Wann diese Fähigkeit ausgelöst wird
- „Wann laufen unsere Pachtverträge ab?“
- „Wie hoch ist die Pacht für das Smith-Grundstück?“
- „Gesamt-Landkosten dieses Jahr?“
- „Zeige überfällige Zahlungen“
- „Kontaktdaten des Vermieters“
- „Kosten pro Acre nach Parzelle“
- „Liste aller gepachteten Parzellen“
- „Welche Zahlungen sind im März fällig?“
- „Liquiditätsbedarf für nächsten Monat“
- „Zahlung [X] als bezahlt markieren“
- „Alle März-Zahlungen als bezahlt markieren“
- „Pachtvertrag für Smith verlängern“
- „Vorschau der Pachtverlängerungen“
Zugriffskontrolle
Pachtbedingungen, Mietbeträge und Vermieterinformationen sind vertrauliche Geschäftsdaten. Zugriff auf Admin- oder Manager-Rollen beschränken.
Rollen-Zuordnung: Überprüfen Sie die Rolle des Absenders in ~/.openclaw/farmos-users.json. Wenn der Benutzer kein Admin oder Manager ist, teilen Sie ihm mit, dass er keinen Zugriff auf Landportfolio-Daten hat.
API-Basis
Integrationsendpunkte (Keine Authentifizierung erforderlich) — NUR LESE-OPERATIONEN
WICHTIG: Verwenden Sie Auth-Endpunkte für SCHREIB-OPERATIONEN (als bezahlt markieren, Verlängerungen). Verwenden Sie Integrations-/all-Endpunkte für LESE-OPERATIONEN (Auflisten von Zahlungen, Pachtverträgen, Vermietern).
Zahlungen (VOLLSTÄNDIG — dies verwenden, nicht Dashboard)
GET /api/integration/payments/all
- Gibt ALLE Zahlungen mit vollständigen Details zurück – Parzellennamen, Vermieternamen, Überfälligkeitsstatus
- Abfrageparameter:
status— pending (ausstehend), paid (bezahlt), overdue (überfällig), scheduled (geplant)payment_type— rent (Pacht), mortgage (Hypothek), property_tax (Grundsteuer), insurance (Versicherung), improvement (Verbesserung), other (Sonstiges)parcel_id— nach bestimmter Parzelle filterndue_date_from— YYYY-MM-DD Bereichsstartdue_date_to— YYYY-MM-DD Bereichsendecrop_year— nach Anbaujahr filtern
- Beispiele:
- Alle überfälligen:
/api/integration/payments/all?status=overdue - Zahlungen März 2026:
/api/integration/payments/all?due_date_from=2026-03-01&due_date_to=2026-03-31 - Alle Pachtzahlungen:
/api/integration/payments/all?payment_type=rent
- Alle überfälligen:
Anstehende Zahlungen (nächste N Tage)
GET /api/integration/payments/upcoming?days=30
- Gibt ALLE anstehenden Zahlungen innerhalb von N Tagen zurück (keine Kürzung)
- Verwenden Sie
days=60oderdays=90für einen längeren Vorausblick
Pachtverträge (VOLLSTÄNDIG)
GET /api/integration/leases/all
- Gibt ALLE Pachtverträge mit Vermieter-Kontaktdaten, Pachtbedingungen und Ablaufstatus zurück
- Abfrageparameter:
status— active (aktiv), expired (abgelaufen)landlord_id— nach Vermieter filtern
Auslaufende Pachtverträge
GET /api/integration/leases/expiring?days=90
- Gibt ALLE Pachtverträge zurück, die innerhalb von N Tagen auslaufen
Vermieter (VOLLSTÄNDIG)
GET /api/integration/landlords/all
- Gibt ALLE Vermieter mit Kontaktdaten, Anzahl aktiver Pachtverträge, Gesamt-Acres und Gesamtpacht zurück
Parzellen
GET /api/integration/parcels
- Gibt ALLE Parzellen mit Eigentumsart, Acres und Landkreis zurück
- Abfrageparameter:
ownership_type— owned (Eigentum), leased (gepachtet)
Zusammenfassungsstatistiken
GET /api/integration/summary
- Gesamt-Acres, Aufteilung Eigentum/Pacht, Parzellen-/Pacht-/Vermieteranzahl, jährliche Kosten
Jährliche Landkosten (nach Monat und Einheit)
GET /api/integration/finance/costs?year=2026
- Monatliche Kostenaufschlüsselung nach Kategorie (Pacht, Hypothek, Steuer, Versicherung)
- Aufschlüsselung nach Einheit
- Abfrageparameter:
year,entity_id
Kosten pro Feld (für P&L)
GET /api/integration/finance/cost-per-field?year=2026
- Landkosten, die Produktionsfeldern zugeordnet werden
- Abfrageparameter:
year,entity_id
Überfällige Elemente
GET /api/integration/tasks/overdue
- Alle überfälligen Zahlungen und Erinnerungen – Elemente mit hoher Priorität
Umsetzbare Elemente
GET /api/integration/tasks/actionable?days_ahead=30
- Anstehende Zahlungen, auslaufende Pachtverträge, ausstehende Erinnerungen
Authentifizierte Endpunkte — SCHREIB-OPERATIONEN
Diese erfordern JWT-Authentifizierung. Siehe Abschnitt Authentifizierung unten.
Authentifizierung
Diese Fähigkeit greift auf geschützte FarmOS-Endpunkte zu, die ein JWT-Token erfordern.
So erhalten Sie ein Token: Führen Sie das Auth-Hilfsskript mit der entsprechenden Rolle aus:
TOKEN=$(~/clawd/scripts/farmos-auth.sh admin)
So verwenden Sie das Token: Fügen Sie es als Bearer-Token ein:
curl -H "Authorization: Bearer $TOKEN" http://100.102.77.110:8009/api/endpoint
Token-Gültigkeit: Tokens sind 15 Minuten gültig. Wenn Sie eine 401-Antwort erhalten, fordern Sie ein neues Token an.
Einzelne Zahlung als bezahlt markieren
POST /api/payments/{id}/mark-paid Authorization: Bearer {token} Content-Type: application/json
Body:
{
"paid_date": "2026-02-15",
"notes": "Scheck #1234"
}
Mehrere Zahlungen als bezahlt markieren (Massenverarbeitung)
POST /api/payments/bulk/mark-paid Authorization: Bearer {token} Content-Type: application/json
Body:
{
"payment_ids": [12, 34, 56],
"paid_date": "2026-02-15",
"notes": "Batch-Scheckausstellung"
}
Zahlungen nach Datumsbereich als bezahlt markieren
POST /api/payments/bulk/mark-paid-by-date Authorization: Bearer {token} Content-Type: application/json
Body:
{
"due_date_from": "2026-03-01",
"due_date_to": "2026-03-31",
"paid_date": "2026-02-15",
"payment_type": "rent",
"notes": "März-Pachtzahlungen"
}
Verwenden Sie dies, wenn der Benutzer sagt „alle März-Zahlungen als bezahlt markieren“ oder ähnliche Massenoperationen basierend auf Datumsbereichen.
Vorschau der Pachtverlängerung
POST /api/leases/renewal-preview Authorization: Bearer {token} Content-Type: application/json
Body:
{
"lease_ids": [5, 12],
"new_start_date": "2027-03-01",
"rent_increase_percent": 3.0
}
Gibt zurück: Vorschau, wie die verlängerten Pachtverträge aussehen würden, einschließlich neuer Zahlungspläne. Verwenden Sie dies VOR der Ausführung von Massenverlängerungen, damit der Benutzer bestätigen kann.
Massen-Pachtverlängerung ausführen
POST /api/leases/bulk-renew Authorization: Bearer {token} Content-Type: application/json
Body:
{
"lease_ids": [5, 12],
"new_start_date": "2027-03-01",
"new_end_date": "2028-02-28",
"new_rent_amount": 52000.00,
"rent_increase_percent": 3.0,
"notes": "Jährliche Verlängerung mit 3% Erhöhung"
}
WICHTIG: Immer zuerst eine Vorschau anzeigen, mit dem Benutzer bestätigen, dann ausführen.
Jahreswechsel-Rollover-Vorschau
POST /api/payments/year-end-rollover/preview Authorization: Bearer {token} Content-Type: application/json
Body:
{
"from_year": 2026,
"to_year": 2027
}
Gibt zurück: Vorschau der Zahlungspläne, die für das neue Anbaujahr erstellt würden.
Jahreswechsel-Rollover ausführen
POST /api/payments/year-end-rollover/execute Authorization: Bearer {token} Content-Type: application/json
Body:
{
"from_year": 2026,
"to_year": 2027,
"apply_rent_increase": true,
"rent_increase_percent": 2.5
}
WICHTIG: Dies erstellt die Zahlungspläne für das nächste Jahr basierend auf den aktuellen Pachtverträgen. Immer zuerst eine Vorschau anzeigen.
VERBOTENE Endpunkte — Nicht verwenden
| Endpunkt | Grund |
|---|---|
GET /api/integration/dashboard | Kürzt auf 5 Elemente. NIEMALS verwenden. |
Schlüsselkonzepte
- Parzelle: Eine Landeinheit – entweder Eigentum oder gepachtet.
- Pachtarten: Barpacht, Ernteanteil, flexible Pacht.
- Pachtablauf: Kritisch zu verfolgen – anstehende Abläufe erfordern proaktive Aufmerksamkeit.
- Landzahlungen: Pacht, Hypothek, Grundsteuer, Versicherung – jeweils mit Fälligkeitsdaten.
Nutzungshinweise
- Die Verfolgung auslaufender Pachtverträge ist die Abfrage mit dem höchsten Mehrwert – weisen Sie immer auf Pachtverträge hin, die innerhalb von 6 Monaten auslaufen.
- Der Zahlungsstatus (fällig/überfällig) ist kritisch – weisen Sie sofort auf überfällige Zahlungen hin.
- Die Kosten-pro-Acre-Analyse hilft, die Wirtschaftlichkeit von Eigentum vs. Pacht zu vergleichen.
- Vermieter-Kontaktdaten sind privat – niemals außerhalb von Admin/Manager-Kanälen teilen.
- Wenn nach „Liquiditätsbedarf“ oder „Was schulden wir“ gefragt wird, verwenden Sie immer
/api/integration/payments/allmit Datumsfilterung, um das VOLLSTÄNDIGE Bild zu erhalten. - Für Finanzplanungsfragen kombinieren Sie
/api/integration/payments/allmit/api/integration/finance/costsfür die vollständige Ansicht. - Schreiboperationen: Verwenden Sie immer authentifizierte Endpunkte, um Zahlungen als bezahlt zu markieren oder Pachtverträge zu verlängern. Zeigen Sie bei Massenoperationen zuerst eine Vorschau an.
- Massen-Zahlungsmarkierung: Wenn der Benutzer sagt „alle März-Zahlungen als bezahlt markieren“, verwenden Sie den Bulk-by-Date-Endpunkt anstelle einzelner Aufrufe.