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

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.