読み込み中
豆知識
役員社宅モジュールは、物件登録から課税明細書・賃貸借契約書の OCR 確認、賃貸料相当額の計算、規程・計算書の生成、月次チャージ、大家への家賃支払いと銀行消込までを一連の流れで扱います。
⚠️ 本機能は税務アドバイスではありません。採用前に税理士の確認を推奨します。
flowchart LR
A[物件登録] --> B[課税明細書 / 賃貸借契約書<br/>アップロード + OCR]
B --> C[人による確認]
C --> D[賃貸料相当額計算]
D --> E[規程・計算書生成]
E --> F[月次チャージ]
F --> G[家賃支払い<br/>銀行消込]
法令根拠: 国税庁タックスアンサー No.2600（役員）/ No.2597（従業員）、所得税法施行令 84条の2、所得税基本通達 36-15 / 36-40〜42。
| 画面 | ルート | 内容 |
|---|---|---|
| セットアップウィザード | /shataku-setup |
ステッパー形式の初回オンボーディング |
| 物件一覧 | /shataku-setup |
登録済み物件と確認・計算ステータス |
| 物件詳細 | /shataku-setup |
記録・計算・生成書類・チャージ・支払い |
フロントエンド: src/features/shataku-setup/
計算エンジンは calc@1.0.0 の保存記録として保存されます。試算は DB に書き込まず、確定時のみ変更不可のレコードを作成します。
| 基準 | 説明 |
|---|---|
| 小規模住宅等 | 固定資産税課税明細書ベース |
| 小規模住宅等以外 | 賃貸借契約書ベース |
| 借家 | 家賃相当額の特例 |
POST /api/shataku/calculations/preview で状態を変えずに試算できます。
いわゆる豪華社宅に該当する場合、所基通 36-40 の法定算式は 適用しません。物件の is_luxury を有効にし、通常支払うべき使用料相当額（monthly_inkind_value / market_monthly_rent）を入力して計算します（エンジン calc@1.1.0）。床面積 240㎡超は豪華社宅判定の要素ですが、総合勘案が必要です（自動判定しません）。
GET /api/shataku/properties
POST /api/shataku/properties
GET /api/shataku/properties/:property_id
PUT /api/shataku/properties/:property_id
DELETE /api/shataku/properties/:property_id
課税明細書と賃貸借契約書は、アップロード → OCR → 人による verify が完了するまで、計算・書類生成がブロックされます。
POST /api/shataku/properties/:property_id/fixed-asset-records/upload
PUT /api/shataku/fixed-asset-records/:record_id/verify
POST /api/shataku/properties/:property_id/lease-records/upload
PUT /api/shataku/lease-records/:record_id/verify
POST /api/shataku/properties/:property_id/calculations
POST /api/shataku/properties/:property_id/documents
POST /api/shataku/properties/:property_id/charges
POST /api/shataku/properties/:property_id/rent-payments
PATCH /api/shataku/rent-payments/:payment_id/reconcile
銀行明細との候補照合:
GET /api/shataku/properties/:property_id/rent-payment-candidates
GET /api/shataku/charges/:charge_id/collection-candidates
| モデル | 用途 |
|---|---|
shataku_properties |
物件マスタ |
shataku_fixed_asset_records |
課税明細書 OCR 記録 |
shataku_lease_records |
賃貸借契約書 OCR 記録 |
shataku_rent_equivalent_calculations |
賃貸料相当額の保存記録 |
shataku_monthly_charges |
月次チャージ予定 |
shataku_rent_payments |
会社→大家の家賃支払い |
shataku_generated_documents |
生成された規程・計算書 |
shataku_audit_events |
変更履歴 |
書類タイプ: shataku_usage_contract, shataku_rent_statement
solo-boss-cloud_backend/documents/API_SHATAKU.md読み込み中
豆知識