Gestisci l'anagrafica dei clienti madre (committenti): dati aziendali, indirizzo legale, coordinate GPS automatiche/manuali, verifica VIES e controllo coerenza territoriale. I cantieri operativi (filiali/reparti) si gestiscono nella pagina dedicata.
Per creare un nuovo cliente, il form è già visibile in alto nella pagina. Per modificarne uno esistente, clicca direttamente sul nome del cliente (link blu) nell'elenco in basso: il form si apre in modalità modifica con tutti i dati precompilati.
Se stai modificando un cliente, trovi un menu a tendina "🔍 Selezione Rapida Cliente Esistente" sopra il form. Selezionando un cliente dal menu, la pagina si ricarica con i dati di quel cliente e le coordinate GPS vengono verificate/aggiornate automaticamente.
I campi richiesti sono:
• Ragione Sociale * — nome completo dell'azienda committente
Gli altri campi sono facoltativi ma raccomandati:
• P.IVA / Cod. Fiscale — usa il pulsante 🔍 VIES per verificare e compilare automaticamente (vedi sotto)
• Indirizzo Legale, Comune, Prov., C.A.P., Nazione — usati per il calcolo automatico delle coordinate GPS
• Pref. Int. e Telefono — contatti telefonici del cliente
Le coordinate vengono calcolate automaticamente dall'indirizzo al momento del salvataggio. Puoi anche modificarle manualmente cliccando ✏️ Modifica GPS. Vedi sezione GPS →
Clicca 💾 Salva Scheda Cliente. Il sistema salva i dati, calcola le coordinate GPS (se l'indirizzo è completo) e verifica la coerenza territoriale. Dopo il salvataggio, la pagina si ricarica in modalità modifica sul cliente appena salvato.
Il sistema gestisce le coordinate GPS della sede legale del cliente in tre modi:
Quando salvi un cliente con indirizzo e comune completi, il sistema invia i dati a un servizio di geocodifica (OpenRouteService) che restituisce latitudine e longitudine. Le coordinate vengono salvate automaticamente insieme alla scheda cliente. Se il geocodifica fallisce (es. indirizzo non riconoscibile), il salvataggio procede comunque senza coordinate: potrai inserirle manualmente in seguito.
Nella sezione "📍 Coordinate GPS Sede" del form, clicca ✏️ Modifica GPS. I campi latitudine e longitudine diventano modificabili (sfondo bianco, bordo blu). Inserisci i valori manualmente, poi clicca 💾 Salva Coordinate per salvarli via AJAX senza ricaricare la pagina. Clicca ❌ Annulla per tornare ai valori precedenti. Il salvataggio manuale verifica anche la coerenza territoriale. Vedi sezione Coerenza →
Dopo aver usato il pulsante 🔍 VIES per estrarre i dati anagrafici, il sistema ricalcola automaticamente le coordinate GPS usando l'indirizzo appena estratto dal registro europeo. Non devi fare nulla: le coordinate si aggiornano da sole. Vedi sezione VIES →
Quando selezioni un cliente dal menu "Selezione Rapida", il sistema verifica se le coordinate sono già presenti in archivio. Se sì, le carica direttamente. Se no, le calcola dall'indirizzo salvato e le memorizza per le prossime volte. In entrambi i casi, viene eseguito anche il controllo di coerenza territoriale.
Il pulsante 🔍 VIES accanto al campo P.IVA interroga il registro europeo VAT Information Exchange System per verificare la validità della partita IVA ed estrarre automaticamente i dati anagrafici del cliente.
Digita la partita IVA nel campo "P.IVA / Cod. Fiscale" (senza prefisso paese, solo i caratteri alfanumerici), poi clicca il pulsante 🔍 VIES. Il sistema interroga il servizio europeo e attende la risposta.
Se la P.IVA è valida, il sistema compila automaticamente i seguenti campi:
• Ragione Sociale (dal registro VIES)
• Indirizzo Legale
• Comune, Provincia, C.A.P.
• Nazione (se diversa da Italia)
I campi esistenti vengono sovrascritti con i dati ufficiali europei.
Subito dopo l'estrazione VIES, il sistema ricalcola le coordinate GPS usando l'indirizzo appena aggiornato. Il messaggio di stato diventa "⏳ Ricalcolo coordinate GPS con dati VIES..." e poi "✅ Coordinate GPS aggiornate automaticamente da VIES." se il calcolo va a buon fine. Viene eseguito anche il controllo di coerenza territoriale.
Ogni volta che le coordinate GPS vengono calcolate, salvate manualmente o aggiornate via VIES, il sistema esegue automaticamente un controllo di coerenza confrontando la posizione del cliente con la sede aziendale.
Il sistema calcola la distanza in linea d'aria (formula di Haversine) tra le coordinate del cliente e quelle della sede aziendale (configurate in Amministrazione Sistema). Se la sede aziendale non ha coordinate configurate, il controllo viene saltato con un avviso giallo.
Sotto i campi GPS appare un pannello colorato con il risultato:
• ✅ Verde: "Coordinate coerenti. Distanza dalla sede: X km." — il cliente è entro 300 km dalla sede aziendale
• ⚠️ Rosso: "Coordinate FUORI RANGE! Distanza dalla sede: X km (max 300 km). Verificare l'indirizzo o correggere manualmente le coordinate." — il cliente supera la soglia di 300 km
• ⚠️ Giallo: "Coordinate sede aziendale non configurate. Impossibile verificare la coerenza." — manca il riferimento della sede
Il sistema non elimina mai definitivamente i clienti dall'archivio. Usa invece un meccanismo di visibilità:
Nella scheda del cliente in modifica, clicca il pulsante rosso ❌ Disattiva Cliente. Il sistema chiede conferma. Dopo la conferma, il cliente viene marcato come nascosto: non appare più nell'elenco dei clienti attivi, nei selettori di contratti e nelle liste operative. Tutti i dati restano in archivio e lo storico contratti/fatture viene conservato.
Per riattivare un cliente disattivato, dovrai accedere al database o contattare l'amministratore di sistema. La funzione di ripristino non è disponibile nell'interfaccia standard per evitare riattivazioni accidentali di clienti cessati.
Sopra la tabella dell'elenco clienti, trovi il campo 🔍 Filtra elenco clienti in tempo reale. Digita qualsiasi testo: ragione sociale, P.IVA, comune o provincia.
La tabella si aggiorna immediatamente mentre digiti, senza ricaricare la pagina. Le righe che non corrispondono al testo inserito vengono nascoste. Cancella il campo per tornare all'elenco completo. Il filtro ignora gli accenti e le maiuscole/minuscole.