59 lines
2.4 KiB
Markdown
59 lines
2.4 KiB
Markdown
# Affitti ISTAT e Contratti
|
|
|
|
## Stato Implementazione (06/03/2026)
|
|
|
|
- Gestione affitti: tabella elenco unica con filtro tipo locazione e stato contratto.
|
|
- Contratti obsoleti:
|
|
- Campo `affitti_immobili.obsoleto` + `obsoleto_dal` + `motivo_obsolescenza`.
|
|
- I contratti obsoleti sono nascosti dal filtro default `Solo attivi`.
|
|
- Pulsanti UI: `Segna obsoleto` / `Riattiva contratto`.
|
|
- Anagrafica catastale estesa per immobile affittato:
|
|
- Comune catastale (`comune_catastale_codice`, es. `H501`), sezione urbana, foglio/particella/subalterno.
|
|
- Categoria/classe, consistenza, superficie, interno, piano.
|
|
- Numero e data registrazione AdE/RLI.
|
|
- Emissione rate automatica:
|
|
- Parte da `inizio_contratto`.
|
|
- Giorno emissione configurabile (`giorno_emissione_canone`, default 5).
|
|
- Stop a `data_fine_contratto`/`prossima_scadenza`/mese corrente.
|
|
- Clausole periodiche applicate a canone (mensile/annuale/una tantum).
|
|
- Adempimenti fiscali annui dedicati:
|
|
- Campi contratto `imposta_registro_annuale`, `quota_imposta_inquilino_percent`, `imposta_bollo_annuale`.
|
|
- Pianificazione con `mese_adempimenti_annuali` + `giorno_adempimenti_annuali`.
|
|
- In emissione canoni viene addebitata automaticamente la quota inquilino dell'imposta registro e il bollo annuo nel mese configurato.
|
|
- Avvisi operativi elenco:
|
|
- Rinnovo contratto e registrazione AdE con soglie di prossimita.
|
|
- Evidenza canoni scaduti non pagati in colonna `Avvisi`.
|
|
|
|
## ISTAT API - Base Tecnica
|
|
|
|
- Tabella indici mensili: `istat_indici_mensili`.
|
|
- Comandi:
|
|
- `php artisan istat:sync-indici --url="<json-url>" --series=FOI`
|
|
- `php artisan istat:set-indice 2026 1 121.3000 --series=FOI`
|
|
- Config:
|
|
- `ISTAT_API_URL`
|
|
- `ISTAT_SERIES` (default `FOI`)
|
|
- `ISTAT_SOURCE` (default `ISTAT API`)
|
|
- `ISTAT_TIMEOUT` (default `30`)
|
|
- Scheduler:
|
|
- `istat:sync-indici` pianificato ogni mese alle `03:10`.
|
|
|
|
## Dati Necessari dal Feed ISTAT
|
|
|
|
Formato minimo per riga JSON:
|
|
|
|
- `anno` (es. `2026`)
|
|
- `mese` (1-12)
|
|
- `indice` (numero)
|
|
|
|
Formati alternativi supportati:
|
|
|
|
- `year`, `month`, `value`
|
|
- `periodo` nel formato `YYYY-MM` + `indice`
|
|
|
|
## Prossimo Step Operativo
|
|
|
|
- Collegare feed ufficiale scelto e validare per almeno 24 mesi storici.
|
|
- Aggiungere promemoria dashboard/notifiche per adempimenti annui in scadenza (oltre alla colonna elenco).
|
|
- Introdurre report annuale per quadratura: registro/bollo previsti vs addebitati vs incassati.
|