Was macht FarmOS Land Portfolio?
Eigentums- und Pachtland, Pachtbedingungen, Vermieterbeziehungen, Zahlungen und jährliche Landkosten verfolgen.
KRITISCH: Regeln zur 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. Teilweise Zahlungsdaten sind schlimmer als gar keine Daten, da sie ein falsches Vollständigkeitsgefühl vermitteln. - Verwenden Sie IMMER die
/all-Endpunkte, die unten aufgeführt sind, 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 Teildaten.
- 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 ausdrücklich. „Ich konnte keine vollständigen Zahlungsdaten abrufen“ ist unendlich viel besser, als 5 von 11 Zahlungen anzuzeigen.
Wann diese Skill ausgelöst wird
- „Wann laufen unsere Pachtverträge aus?“
- „Wie hoch ist die Pacht für das Smith-Grundstück?“
- „Gesamtlandkosten dieses Jahr?“
- „Überfällige Zahlungen anzeigen“
- „Kontaktdaten des Vermieters“
- „Kosten pro Acre nach Parzelle“
- „Alle Pachtparzellen auflisten“
- „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“
- „Smith-Pachtvertrag verlängern“
- „Vorschau Pachtverlängerungen“
Zugriffskontrolle
Pachtbedingungen, Mietbeträge und Vermieterinformationen sind vertrauliche Geschäftsdaten. Nur auf Admin- oder Manager-Rollen beschränken.
Rollen-Zuordnung: Überprüfen Sie die Rolle des Absenders in ~/.openclaw/farmos-users.json. Wenn der Benutzer weder Admin noch Manager ist, teilen Sie ihm mit, dass er keinen Zugriff auf Landportfolio-Daten hat.
API-Basis
Integrations-Endpunkte (Keine Authentifizierung erforderlich) – NUR LESEOPERATIONEN
WICHTIG: Verwenden Sie Auth-Endpunkte für SCHREIBoperationen (bezahlt markieren, Verlängerungen). Verwenden Sie Integrations-/all-Endpunkte für LESEoperationen (Auflisten von Zahlungen, Pachtverträgen, Vermietern).
Zahlungen (VOLLSTÄNDIG – diesen verwenden, nicht Dashboard)
GET /api/integration/payments/all
- Gibt ALLE Zahlungen mit vollständigen Details zurück – Parzellennamen, Vermieternamen, Überfälligkeitsstatus
- Abfrageparameter:
status– pending, paid, overdue, scheduledpayment_type– rent, mortgage, property_tax, insurance, improvement, otherparcel_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 - März 2026 Zahlungen:
/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 Vorausschauzeitraum
Pachtverträge (VOLLSTÄNDIG)
GET /api/integration/leases/all
- Gibt ALLE Pachtverträge mit Vermieterkontaktdaten, Mietbedingungen, Ablaufstatus zurück
- Abfrageparameter:
status– active, expiredlandlord_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, Gesamtackerzahl, Gesamtmiete zurück
Parzellen
GET /api/integration/parcels
- Gibt ALLE Parzellen mit Eigentumsart, Ackerzahl, Landkreis zurück
- Abfrageparameter:
ownership_type– owned, leased
Zusammenfassungsstatistiken
GET /api/integration/summary
- Gesamtackerzahl, Aufteilung Eigentum/Pacht, Anzahl Parzellen/Pachtverträge/Vermieter, 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 GuV)
GET /api/integration/finance/cost-per-field?year=2026
- Auf Produktionsfelder umgelegte Landkosten
- Abfrageparameter:
year,entity_id
Überfällige Posten
GET /api/integration/tasks/overdue
- Alle überfälligen Zahlungen und Erinnerungen – hohe Priorität
Maßnahmen erfordernde Posten
GET /api/integration/tasks/actionable?days_ahead=30
- Anstehende Zahlungen, auslaufende Pachtverträge, ausstehende Erinnerungen
Authentifizierte Endpunkte – SCHREIBOPERATIONEN
Diese erfordern eine JWT-Authentifizierung. Siehe Abschnitt Authentifizierung unten.
Authentifizierung
Diese Skill greift auf geschützte FarmOS-Endpunkte zu, die ein JWT-Token erfordern.
So erhalten Sie ein Token: Führen Sie den Auth-Helper mit der entsprechenden Rolle aus:
TOKEN=$(~/clawd/scripts/farmos-auth.sh admin)
So verwenden Sie das Token: Fügen Sie es als Bearer-Token hinzu:
curl -H "Authorization: Bearer $TOKEN" http://100.102.77.110:8009/api/endpoint
Token-Ablauf: Token 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 (Sammelverarbeitung)
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": "Sammelschecklauf"
}
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 „Markiere alle März-Zahlungen als bezahlt“ oder ähnliche datumsbasierte Sammeloperationen.
Vorschau 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 Sammelverlängerungen, damit der Benutzer bestätigen kann.
Sammel-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: Zeigen Sie immer zuerst eine Vorschau an, bestätigen Sie mit dem Benutzer und führen Sie dann aus.
Jahresabschluss-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 auf Zahlungspläne, die für das neue Anbaujahr erstellt würden.
Jahresabschluss-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. Zeigen Sie immer zuerst eine Vorschau an.
VERBOTENE Endpunkte – Nicht verwenden
| Endpunkt | Grund |
|---|---|
GET /api/integration/dashboard | Kürzt auf 5 Einträge. NIEMALS verwenden. |
Schlüsselkonzepte
- Parzelle: Eine Landeinheit – entweder Eigentum oder Pacht.
- Pachtarten: Barpacht, Ernteteilung, Flexible Pacht.
- Pachtablauf: Kritisch zu verfolgen – bevorstehende Abläufe erfordern proaktive Aufmerksamkeit.
- Landzahlungen: Pacht, Hypothek, Grundsteuer, Versicherung – jeweils mit Fälligkeitsdaten.
Nutzungshinweise
- Die Verfolgung des Pachtablaufs ist die Abfrage mit dem höchsten Wert – kennzeichnen Sie immer Pachtverträge, die innerhalb von 6 Monaten auslaufen.
- Der Zahlungsstatus (fällig/überfällig) ist kritisch – kennzeichnen Sie überfällige Zahlungen sofort.
- Die Analyse der Kosten pro Acre hilft, die Wirtschaftlichkeit von Eigentum vs. Pacht zu vergleichen.
- Vermieterkontaktdaten 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 Fragen zur Finanzplanung kombinieren Sie
/api/integration/payments/allmit/api/integration/finance/costsfür die vollständige Ansicht. - Schreiboperationen: Verwenden Sie immer authentifizierte Endpunkte zum Markieren von Zahlungen als bezahlt oder Verlängern von Pachtverträgen. Zeigen Sie bei Sammeloperationen zuerst eine Vorschau an.
- Sammelmarkierung von Zahlungen: Wenn der Benutzer sagt „Markiere alle März-Zahlungen als bezahlt“, verwenden Sie den Bulk-by-Date-Endpunkt anstelle einzelner Aufrufe.