FarmOS 土地ポートフォリオ は何をしますか?
所有地と賃貸地、リース条件、貸主との関係、支払い、年間土地コストを追跡します。
重要:データ完全性ルール
不完全または切り詰められたデータを決して使用しないでください。これらのルールは絶対です。
/api/integration/dashboardは絶対に使用しないでください — 結果が5件に切り詰められます。部分的な支払いデータは、完全性を錯覚させるため、データがないよりも悪質です。- 完全なデータを取得するには、以下にリストされている
/allエンドポイントを常に使用してください。 - エンドポイントがエラーを返したり、空の結果を返した場合は、ユーザーに失敗を報告してください。 黙って別のエンドポイントにフォールバックしたり、部分的なデータを表示したりしないでください。
- 返されたレコードの総数を常に明記 し、ユーザーがデータが完全であることを確認できるようにしてください。例:「3月の支払いは合計11件、総額175,058ドルが見つかりました。」
- 完全なデータを取得できない場合は、その旨を明示的に伝えてください。 「完全な支払いデータを取得できませんでした」と言うことは、11件中5件の支払いを表示するよりもはるかに優れています。
このスキルがトリガーされるタイミング
- 「リースはいつ期限切れになりますか?」
- 「スミス土地の賃料はいくらですか?」
- 「今年の総土地コストは?」
- 「延滞している支払いを表示して」
- 「貸主の連絡先情報」
- 「区画ごとの1エーカーあたりのコスト」
- 「賃貸中の全区画をリスト表示」
- 「3月に支払われる支払いは何ですか?」
- 「来月の所要資金」
- 「支払い [X] を支払済みとしてマーク」
- 「3月の全支払いを支払済みとしてマーク」
- 「スミスリースを更新」
- 「リース更新のプレビュー」
アクセス制御
リース条件、賃料金額、貸主情報は機密性の高いビジネスデータです。管理者またはマネージャーロールのみに制限してください。
ロールマッピング: ~/.openclaw/farmos-users.json で送信者のロールを確認してください。ユーザーが管理者またはマネージャーでない場合は、土地ポートフォリオデータへのアクセス権がないことを伝えてください。
API ベースURL
統合エンドポイント(認証不要) — 読み取り操作のみ
重要:書き込み操作(支払いマーク、更新)には認証エンドポイントを使用してください。読み取り操作(支払い、リース、貸主のリスト表示)には統合 /all エンドポイントを使用してください。
支払い(完全 — こちらを使用し、ダッシュボードは使用しないでください)
GET /api/integration/payments/all
- 完全な詳細情報(区画名、貸主名、延滞状況)を含むすべての支払いを返します
- クエリパラメータ:
status— pending(保留中)、paid(支払済み)、overdue(延滞)、scheduled(予定)payment_type— rent(賃料)、mortgage(住宅ローン)、property_tax(固定資産税)、insurance(保険)、improvement(改良)、other(その他)parcel_id— 特定の区画でフィルタdue_date_from— YYYY-MM-DD 形式の範囲開始日due_date_to— YYYY-MM-DD 形式の範囲終了日crop_year— 作付年度でフィルタ
- 例:
- すべての延滞:
/api/integration/payments/all?status=overdue - 2026年3月の支払い:
/api/integration/payments/all?due_date_from=2026-03-01&due_date_to=2026-03-31 - すべての賃料支払い:
/api/integration/payments/all?payment_type=rent
- すべての延滞:
今後の支払い(次のN日間)
GET /api/integration/payments/upcoming?days=30
- N日以内のすべての今後の支払いを返します(切り詰めなし)
- より長い先読みには
days=60またはdays=90を使用してください
リース(完全)
GET /api/integration/leases/all
- 貸主の連絡先情報、賃料条件、満期ステータスを含むすべてのリースを返します
- クエリパラメータ:
status— active(有効)、expired(期限切れ)landlord_id— 貸主でフィルタ
期限切れ間近のリース
GET /api/integration/leases/expiring?days=90
- N日以内に期限切れとなるすべてのリースを返します
貸主(完全)
GET /api/integration/landlords/all
- 連絡先情報、有効なリース数、総エーカー数、総賃料を含むすべての貸主を返します
区画
GET /api/integration/parcels
- 所有タイプ、エーカー数、郡を含むすべての区画を返します
- クエリパラメータ:
ownership_type— owned(所有)、leased(賃貸)
サマリー統計
GET /api/integration/summary
- 総エーカー数、所有/賃貸の内訳、区画/リース/貸主の数、年間コスト
年間土地コスト(月別およびエンティティ別)
GET /api/integration/finance/costs?year=2026
- カテゴリ別(賃料、住宅ローン、税金、保険)の月次コスト内訳
- エンティティ別内訳
- クエリパラメータ:
year、entity_id
圃場あたりのコスト(損益計算書用)
GET /api/integration/finance/cost-per-field?year=2026
- 生産圃場に割り当てられた土地コスト
- クエリパラメータ:
year、entity_id
延滞項目
GET /api/integration/tasks/overdue
- すべての延滞支払いとリマインダー — 優先度の高い項目
アクション可能項目
GET /api/integration/tasks/actionable?days_ahead=30
- 今後の支払い、期限切れ間近のリース、保留中のリマインダー
認証済みエンドポイント — 書き込み操作
これらには JWT 認証が必要です。以下の認証セクションを参照してください。
認証
このスキルは、JWT トークンを必要とする保護された FarmOS エンドポイントにアクセスします。
トークンを取得するには: 適切なロールで認証ヘルパーを実行します:
TOKEN=$(~/clawd/scripts/farmos-auth.sh admin)
トークンを使用するには: Bearer トークンとして含めます:
curl -H "Authorization: Bearer $TOKEN" http://100.102.77.110:8009/api/endpoint
トークンの有効期限: トークンは15分間有効です。401 応答が返された場合は、新しいトークンを要求してください。
単一支払いを支払済みとしてマーク
POST /api/payments/{id}/mark-paid Authorization: Bearer {token} Content-Type: application/json
ボディ:
{
"paid_date": "2026-02-15",
"notes": "小切手 #1234"
}
複数支払いを一括で支払済みとしてマーク
POST /api/payments/bulk/mark-paid Authorization: Bearer {token} Content-Type: application/json
ボディ:
{
"payment_ids": [12, 34, 56],
"paid_date": "2026-02-15",
"notes": "バッチ小切手実行"
}
日付範囲で支払いを一括マーク
POST /api/payments/bulk/mark-paid-by-date Authorization: Bearer {token} Content-Type: application/json
ボディ:
{
"due_date_from": "2026-03-01",
"due_date_to": "2026-03-31",
"paid_date": "2026-02-15",
"payment_type": "rent",
"notes": "3月賃料支払い"
}
ユーザーが「3月の全支払いを支払済みとしてマーク」など、日付ベースの一括操作を要求した場合にこれを使用します。
リース更新のプレビュー
POST /api/leases/renewal-preview Authorization: Bearer {token} Content-Type: application/json
ボディ:
{
"lease_ids": [5, 12],
"new_start_date": "2027-03-01",
"rent_increase_percent": 3.0
}
戻り値:更新後のリースのプレビュー(新しい支払いスケジュールを含む)。一括更新を実行する前に、ユーザーが確認できるように、これを必ず使用してください。
一括リース更新の実行
POST /api/leases/bulk-renew Authorization: Bearer {token} Content-Type: application/json
ボディ:
{
"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": "3%増額の年次更新"
}
重要: 常に最初にプレビューし、ユーザーに確認を得てから実行してください。
年度末ロールオーバーのプレビュー
POST /api/payments/year-end-rollover/preview Authorization: Bearer {token} Content-Type: application/json
ボディ:
{
"from_year": 2026,
"to_year": 2027
}
戻り値:新しい作付年度のために作成される支払いスケジュールのプレビュー。
年度末ロールオーバーの実行
POST /api/payments/year-end-rollover/execute Authorization: Bearer {token} Content-Type: application/json
ボディ:
{
"from_year": 2026,
"to_year": 2027,
"apply_rent_increase": true,
"rent_increase_percent": 2.5
}
重要: これは現在の年度のリースに基づいて翌年度の支払いスケジュールを作成します。常に最初にプレビューしてください。
禁止エンドポイント — 使用しないでください
| エンドポイント | 理由 |
|---|---|
GET /api/integration/dashboard | 結果が5件に切り詰められます。絶対に使用しないでください。 |
主要な概念
- 区画: 土地の単位 — 所有または賃貸のいずれか。
- リースの種類: 現金賃料、作物分配、フレックス賃料。
- リースの満期: 追跡が重要 — 満期が近づいているものは積極的な注意が必要です。
- 土地支払い: 賃料、住宅ローン、固定資産税、保険 — それぞれに支払期日があります。
使用上の注意
- リース満期の追跡は最も価値の高いクエリです — 6か月以内に満期を迎えるリースを常にフラグ付けしてください。
- 支払いステータス(期日/延滞)は重要です — 延滞している支払いをすぐにフラグ付けしてください。
- 1エーカーあたりのコスト分析は、所有地と賃貸地の経済性を比較するのに役立ちます。
- 貸主の連絡先情報は非公開です — 管理者/マネージャーのチャネル以外で共有しないでください。
- 「所要資金」や「私たちが負っているもの」について質問された場合は、常に
/api/integration/payments/allを日付フィルタリングとともに使用して、完全な状況を把握してください。 - 財務計画に関する質問には、完全なビューを得るために
/api/integration/payments/allと/api/integration/finance/costsを組み合わせてください。 - 書き込み操作: 支払いのマークやリースの更新には、常に認証済みエンドポイントを使用してください。一括操作の場合は、最初にプレビューを行ってください。
- 一括支払いマーク: ユーザーが「3月の全支払いを支払済みとしてマーク」と言った場合は、個別の呼び出しではなく、日付範囲による一括エンドポイントを使用してください。