michele/netgescon-day0
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
main
netgescon-day0/docs/ai/topics/affitti-istat-contratti.md

2.4 KiB
Raw Permalink Blame History

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.