FarmOS 土地ポートフォリオ は何をしますか?
所有地とリース地、リース条件、貸主との関係、支払い、年間土地コストを追跡します。
重要: データ完全性ルール
部分的なデータや切り詰められたデータを絶対に使用しないでください。以下のルールは譲歩できません:
/api/integration/dashboardは絶対に使用しない — 結果を5件に切り詰めます。部分的な支払いデータは、完全性の誤った印象を与えるため、データがないよりはるかに悪質です。- 完全なデータを得るには、以下にリストされている
/allエンドポイントを常に使用 してください。 - エンドポイントがエラーや空の結果を返した場合は、ユーザーに障害を報告 してください。別のエンドポイントに静かにフォールバックしたり、部分的なデータを提示したりしないでください。
- 返されたレコードの総数を常に明記 し、ユーザーがデータが完全であることを確認できるようにしてください。例:「3月に支払期日が来る11件の支払い、合計175,058ドルが見つかりました。」
- 完全なデータを取得できない場合は、その旨を明示的に伝えてください。 「完全な支払いデータを取得できませんでした」と伝えることは、11件中5件の支払いのみを表示するよりもはるかに優れています。
このスキルがトリガーされるタイミング
- 「リースの期限はいつですか?」
- 「スミス農地の地代はいくらですか?」
- 「今年の総土地コストは?」
- 「延滞支払いを表示」
- 「貸主の連絡先情報」
- 「区画あたりのコスト」
- 「リース中の全区画をリスト」
- 「3月に支払期日が来る支払いは?」
- 「来月の資金要件は?」
- 「支払い[X]を支払済みとしてマーク」
- 「3月の全支払いを支払済みとしてマーク」
- 「スミスリースを更新」
- 「リース更新をプレビュー」
アクセス制御
リース条件、賃料額、貸主情報は機密のビジネスデータです。管理者またはマネージャーロールのみに制限してください。
ロールマッピング: ~/.openclaw/farmos-users.json で送信者のロールを確認してください。ユーザーが管理者またはマネージャーでない場合は、土地ポートフォリオデータへのアクセス権がないことを伝えてください。
API ベース
統合エンドポイント(認証不要)— 読み取り操作のみ
重要: 書き込み操作(支払済みマーク、更新)には認証エンドポイントを使用してください。読み取り操作(支払いリスト、リース、貸主)には統合の /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ヶ月以内に期限切れとなるリースを常にフラグ付けしてください。
- 支払いステータス(期日内/延滞)は重要です — 延滞支払いはすぐにフラグ付けしてください。
- エーカーあたりのコスト分析は、所有地とリース地の経済性を比較するのに役立ちます。
- 貸主の連絡先情報はプライベートです — 管理者/マネージャーチャネルの外部で共有しないでください。
- 「資金要件」や「何を支払う必要があるか」と尋ねられた場合は、常に日付フィルタリング付きで
/api/integration/payments/allを使用して完全な状況を把握してください。 - 財務計画に関する質問には、完全なビューを得るために
/api/integration/payments/allと/api/integration/finance/costsを組み合わせて使用してください。 - 書き込み操作: 支払いを支払済みとしてマークしたり、リースを更新したりする際は、常に認証済みエンドポイントを使用してください。一括操作を行う場合は、最初にプレビューしてください。
- 一括支払いマーク: ユーザーが「3月の全支払いを支払済みとしてマーク」と言った場合は、個別の呼び出しではなく、一括日付エンドポイントを使用してください。