netgescon-day0/docs/00-IMPORT/01-GESCON/GUIDA-IMPORT-GESCON-MDB.md

📥 Guida Import GESCON da Stabili.mdb (NetGescon 2025)

Questa guida spiega come importare i dati reali dal vecchio GESCON in NetGescon usando la pipeline artisan gescon:import-full, sfruttando Stabili.mdb per mappare Codice Fiscale del condominio, CF amministratore, dati catastali (foglio/particella/sub) e coordinate bancarie (IBAN/banca) quando presenti.

Prerequisiti

• Linux con mdb-tools installati (mdb-export, mdb-tables)
• PHP 8.3+, Laravel 12.x
• Accesso alla cartella di staging che contiene Stabili.mdb e gli altri MDB/CSV esportati
• Backup DB prima di un import reale

File sorgenti rilevanti

• docs/000-IMPORT/01-GESCON/stabili-mdb-schema.json – struttura MDB rilevata
• docs/000-IMPORT/01-GESCON/complete-mdb-schema.json – schema completo
• docs/IMPORT-ESEMPIO-STABILI.csv – esempio campi target (CF, IBAN, banca, ABI/CAB, intestazione)

Campo → Mappatura (Stabili.mdb → NetGescon)

• denominazione → stabili.denominazione
• indirizzo, cap, citta, provincia → stabili.[indirizzo, cap, citta, provincia]
• codice_fiscale (condominio) → stabili.codice_fiscale
• cf_amministratore (se presente in staging) → stabili.cod_fisc_amministratore
• foglio/particella/sub (se presenti in staging) → stabili.[foglio, particella, subalterno]
• iban_bancario/iban_postale, banca, abi, cab, intestazione (se presenti in staging o CSV di supporto) → tabella dati_bancari associata allo stabile; visibile nella tab “Dati Bancari” dello Stabile

Note

• Se alcuni campi non sono direttamente in Stabili.mdb, la pipeline può attingere da tabelle/csv di staging. Tieni allineati i nomi col file IMPORT-ESEMPIO-STABILI.csv.
• I dati bancari vengono creati come conto collegato allo Stabile; l’IBAN sarà poi usato per import/riconciliare i movimenti bancari.

Comando consigliato (artisan)

Usa la pipeline centralizzata con dry-run per validare, poi esegui l’import reale:

• Dry-run (nessuna scrittura):

  • php artisan gescon:import-full --stabile=0024 --dry-run --solo=stabili
  • php artisan gescon:import-full --stabile=0019 --dry-run --solo=stabili

• Import reale (scrive sul DB):

  • php artisan gescon:import-full --stabile=0024 --solo=stabili
  • php artisan gescon:import-full --stabile=0019 --solo=stabili

Opzioni principali

• --stabile=NNNN limita ad uno stabile legacy (es. 0024, 0019)
• --anno=YYYY delimita le gestioni/operazioni per anno
• --path=/percorso/staging punta alla cartella con MDB/CSV (se differente)
• --dry-run avvia in sola validazione
• --solo= esegue solo uno step (stabili, unita, soggetti, diritti, millesimi, voci, operazioni, rate, incassi, giroconti, straord, addebiti, detrazioni)
• --reset-temp reset tabelle temporanee
• --no-views salta l’aggiornamento delle viste QA

Sequenza completa tipica

1. Stabili – anagrafica + CF/CF-amministratore + catasto + dati bancari (se presenti)
2. Unità – unità immobiliari, interni e scale; palazzine derivate se mancanti
3. Soggetti – proprietari/inquilini con codici deterministici a 8 char
4. Diritti – proprietà/locazioni e quote
5. Millesimi – tabelle e dettagli per unità, con UI “Show” e “Configura”
6. Voci/Operazioni – voce spesa, prima nota, partita doppia
7. Rate/Incassi – emissione e registrazione incassi
8. Straordinarie/Addebiti/Detrazioni – componenti extra

Verifiche post-import (QA)

• Stabile → Tab Dati Generali: vedi Codice Fiscale, CF Amministratore, Catasto (foglio/particella/sub)
• Stabile → Tab Dati Bancari: vedi IBAN, banca, saldo attuale (se caricato), API saldo attuale disponibile
• Tabelle Millesimali → pagina Dettaglio: verifica somma millesimi, per-unità, e azione “Bilancia”
• QA viste/ cruscotti: anomalie, duplicati, collegamenti mancanti

Collegamento con conto bancario e riconciliazioni

• I conti creati nel tab Dati Bancari sono usati per importare estratti (CSV banca) e associare movimenti
• Le scritture contabili (partita doppia) includono chiavi per la riconciliazione con movimenti bancari; lo stato di quadratura viene aggiornato a valle del matching

Esempi reali richiesti

• Stabile 147 (cartella legacy 0024)

  • Dry-run: php artisan gescon:import-full --stabile=0024 --dry-run --solo=stabili
  • Import: php artisan gescon:import-full --stabile=0024 --solo=stabili

• Stabile 146 “Andrea Doria” (cartella 0019)

  • Dry-run: php artisan gescon:import-full --stabile=0019 --dry-run --solo=stabili
  • Import: php artisan gescon:import-full --stabile=0019 --solo=stabili

Troubleshooting rapido

• CF/IBAN mancanti: verifica i CSV di staging e il mapping con i nomi previsti in IMPORT-ESEMPIO-STABILI.csv
• Millesimi non allineati: usa l’azione “Bilancia” nella pagina della tabella
• Unità non abbinate: controlla i criteri scala/interno e normalizzazione cantine

Riferimenti

• docs/000-IMPORT/README-IMPORT-PROCESS.md – panoramica processo
• docs/000-IMPORT/RELAZIONI-COMPLETE-FLUSSO-FINANZIARIO.md – end-to-end contabilità↔banca
• docs/91-database/02-tabelle-collegate/contabilita.md – struttura scritture e riconciliazioni