netgescon-day0/docs/ai/topics/modulo-fe-unificato-soggetti.md

30 lines
2.1 KiB
Markdown
Executable File

# Modulo FE unificato per soggetti
- Motore FE unico per parsing/import/deduplica/seriali.
- Identificazione certa FE:
- fornitore emittente via P.IVA, fallback CF;
- destinatario via P.IVA, fallback CF, SDI, PEC.
- Amministratore:
- archivio FE nello spazio stabile/amministratore;
- upload manuale disponibile;
- Cassetto Fiscale disponibile solo con `amministratori.fe_cassetto_enabled=true`.
- La tab `fatture-ricevute > Scarichi da Cassetto Fiscale` riconcilia riepilogo remoto (`riepilogo_totaleFatture`), file pacchetto, FE locali, Lista AdE e differenza da verificare; gli scarichi in corso aggiornano `fe_cassetto_download_logs` con stati `queued/started/downloaded/importing/ok/error`.
- Se il flag `fe_cassetto_enabled` e falso, non diagnosticare assenza fatture: lo scarico e bloccato contrattualmente e la UI deve mostrare avviso/pulsanti disabilitati.
- Fornitore:
- archivio FE separato sotto `fornitori/<codice>/fe/ricevute/stabili/<stabile>/inbox/<Y/m>`;
- modulo attivabile con `fornitori.fe_features.invoice_import.enabled`;
- sorgenti abilitate in `fornitori.fe_features.invoice_import.sources`.
- I seriali FE restano collegati tramite `ProductSerial.source_reference = fe:<id>`.
- Pipeline operativa fornitore:
- FE -> creazione/aggiornamento `rubrica_universale` + `fornitori`;
- import prodotti nel catalogo interno;
- import seriali collegati ai prodotti.
- `FatturaElettronicaImporter::ensureFornitoreFromFeData()` crea automaticamente rubrica unica e scheda fornitore quando il soggetto FE manca e l import e autorizzato a creare il fornitore.
- Il dettaglio prodotti fornitore deve leggere sempre la scope alias `catalogScopeSupplierIds()` per vedere anche identificativi e offerte dei fornitori storici collegati al master.
- FOCELDA e il modello base per il catalogo prodotti:
- categorie partono da `Marca`;
- usa anche `Linea`, `Gruppo`, `Famiglia`;
- conserva `EAN` per ricerche e confronti Amazon;
- supporta link multipli per immagini, documenti e pagina produttore;
- puo aggiornare il listino da URL remoto salvato in `fornitori.operational_config.catalog_import.remote_csv_url`.