Vai al contenuto

Anagrafiche (Clienti)

Modulo

  • View FAB: Anagrafiche -> Clienti
  • View FAB: Anagrafiche -> Codici ATECO

Import dati di base

CSV legacy in: incoming/clienti_migration/csv

Comando: 

/root/.pyenv/versions/safeops/bin/flask --app app import_reference_csv --csv-dir incoming/clienti_migration/csv

Importa: - gi_province.csv -> tabella provincia - gi_comuni.csv (o fallback gi_comuni_cap.csv) -> tabella comune

Import clienti (upsert)

Comando: 

/root/.pyenv/versions/safeops/bin/flask --app app import_clienti_csv --file <path_csv_clienti> --tenant-key <tenant_key>

Supporta deduplica su: - tenant_key + partita_iva - tenant_key + codice_fiscale - fallback tenant_key + nome + comune_nome

Multi-tenant in view

La view Clienti applica filtro automatico per tenant quando la richiesta arriva da host tenant (non admin host).

Import Anagrafiche CSV da menu

  • Menu: Anagrafiche -> Import e Sync -> Import Anagrafiche CSV
  • Route: /clienteview/import-csv
  • Template ufficiale:
  • menu Anagrafiche -> Import e Sync -> Template Import Anagrafiche
  • route /clienteview/import-csv-template
  • Isolamento tenant:
  • su host tenant importa solo nel tenant corrente (bloccato);
  • su control-plane richiede selezione tenant destinazione.
  • Colonne principali supportate:
  • nome/ragione_sociale
  • partita_iva/piva
  • codice_fiscale/cf
  • email, pec, sdi/codice_sdi/codice_destinatario
  • telefono, indirizzo, cap, tipologie, note
  • Modalita:
  • dry-run (non salva)
  • upsert (crea/aggiorna)
  • Validazione guidata:
  • segnala colonne non supportate;
  • segnala PIVA/CF/SDI non validi;
  • segnala tipologie non trovate;
  • export CSV non conformita da pulsante dedicato.
  • Non conformita:
  • validazione PIVA/CF/SDI
  • tipologie non trovate
  • righe senza nome

Aggiornamento massivo tipologie

  • Menu: Anagrafiche -> Import e Sync -> Aggiornamento Tipologie CSV
  • Route: /clienteview/import-tipologie-csv
  • CSV minimo:
  • identificatore cliente: cliente_id oppure partita_iva oppure codice_fiscale oppure nome;
  • tipologie (codici o nomi separati da |, ,, ;).
  • Modalita:
  • merge aggiunge tipologie mantenendo le attuali;
  • replace sostituisce l'insieme tipologie;
  • remove rimuove solo le tipologie indicate.
  • Supporta dry-run senza scrittura DB.

Cruscotto qualità dati

  • Menu: Anagrafiche -> Import e Sync -> Cruscotto Qualita Anagrafiche
  • Route: /clienteview/quality-dashboard
  • KPI principali per tenant:
  • clienti senza PIVA;
  • clienti senza email;
  • clienti senza indirizzo/comune;
  • clienti senza tipologie;
  • SDI invalidi;
  • top duplicati PIVA/CF.

Pannello Globali/Tenant (Control Plane)

  • Menu: Anagrafiche -> Import e Sync -> Pannello Anagrafiche/Tenant
  • Route: /global-anagrafiche-tenant-panel/
  • Uso: vedere su quali tenant e agganciata ogni anagrafica globale, agganciare o sganciare selezioni multiple.

Audit duplicati certi

Comando strict: 

/root/.pyenv/versions/safeops/bin/flask --app app audit_duplicati_strict

Con filtro tenant: 

/root/.pyenv/versions/safeops/bin/flask --app app audit_duplicati_strict --tenant-key tenant_besant

Fail con exit code 1 se trova duplicati: 

/root/.pyenv/versions/safeops/bin/flask --app app audit_duplicati_strict --fail-on-duplicates