📖 Manuale interattivo
Clienti e anagrafica
Partita IVA
11 cifre per i soggetti italiani. Per la fattura elettronica deve essere corretta: lo SDI scarta le fatture con P.IVA non valida. Per clienti esteri usa l'identificativo fiscale del paese.
Codice fiscale
Obbligatorio per privati e ditte individuali; per le società coincide spesso con la P.IVA. Serve allo SDI per recapitare la fattura se manca il Codice Destinatario.
Codice destinatario (SDI)
Codice di 7 caratteri con cui lo SDI consegna la fattura elettronica. Se il cliente non ne ha uno, lascia 0000000 e indica la PEC: la fattura arriverà lì.
PEC
Casella di posta certificata. Usata come recapito della fattura elettronica quando il cliente non ha un Codice Destinatario SDI.
Tipo (B2B / B2C / PA)
Determina le regole di fatturazione: verso la PA la fattura passa per lo SDI con regole specifiche (es. split payment); verso privati B2C valgono soglie e codici diversi.
Ordini e bozze
Bozza vs ordine
La bozza è un carrello modificabile e non impegnativo; diventa ordine solo quando la confermi (allora entra nel ciclo fattura/pagamento).
Contratti
Decorrenza
Data da cui il contratto è attivo e da cui partono fatturazione ricorrente e scadenze. Diversa dalla data di firma.
Rinnovo tacito
Se attivo, il contratto si rinnova da solo alla scadenza salvo disdetta entro il preavviso. Imposta il preavviso per ricevere l'avviso in tempo.
Fatturazione elettronica
Regime fiscale
Il regime del tuo profilo (es. ordinario RF01, forfettario RF19). Cambia come viene esposta l'IVA in fattura: nel forfettario, ad esempio, l'IVA non si applica.
Scissione dei pagamenti
Per le fatture verso la Pubblica Amministrazione: l'IVA la versa l'ente, non tu. Attivalo solo nei casi previsti dalla normativa.
Ritenuta d'acconto
Trattenuta che il cliente versa per tuo conto (tipica di professionisti). Indica aliquota e causale: riduce l'importo che incassi ma non il tuo imponibile.
Esigibilità IVA
Stabilisce quando l'IVA diventa dovuta: immediata, differita o split payment. In dubbio lascia "immediata".
Imposta di bollo
Dovuta (oggi €2) sulle fatture senza IVA sopra una soglia (es. esenti / fuori campo). Loogico segnala quando serve.
Import / Export dati
Modello CSV
Scarica sempre prima il modello dell'entità che vuoi importare: contiene le colonne esatte attese. Le righe con un numero di colonne diverso dall'intestazione vengono saltate con un avviso.
Formato file
CSV separato da virgola, codifica UTF-8 (Excel: "Salva con nome → CSV UTF-8"). Una riga di intestazione, poi i dati.
Ciclo di vita di un campo custom
Un campo custom proposto dall'import segue una pratica con stati: BOZZA → RICHIESTO → IN_VALUTAZIONE → APPROVATO → IN_SVILUPPO → IN_TEST → RILASCIATO. Rami laterali: PARCHEGGIATO (sospeso in attesa di contesto), RIFIUTATO o RITIRATO (terminali). Ogni transizione è registrata nell'audit. All'APPROVATO viene creata la definizione del campo (bozza), che poi va rilasciata per ring.
Rilascio per ring
Il rilascio è progressivo per "ring" di tenant (0=interno, 1=early adopter, 2=esteso, 3=generale) ed è cumulativo: rilasciando fino al ring N il campo diventa importabile per tutti i tenant con ring ≤ N. Permette di provare un campo su pochi tenant prima di aprirlo a tutti, senza modifiche allo schema del database.
Import vendite (catena)
Ordini, righe ordine, fatture e fatture fornitori non si caricano singolarmente: dipendono dalle anagrafiche (fornitori, prodotti, clienti) che creano i riferimenti usati dalle vendite. Per questo vanno importati insieme e in sequenza. Lancia sempre prima il "Controllo (dry-run)": esegue tutta la catena in prova e mostra quante righe verrebbero importate/saltate, SENZA scrivere nulla. Solo quando i numeri tornano usa "Carica" (fai un backup prima). L'operazione è idempotente: ripeterla non duplica i dati già caricati.
Assistente AI e consumi
Quote token
Crediti che misurano l'uso delle funzioni AI di Loogico (estrazione bollette, AskLOOGICO, analisi). Qui vedi il saldo residuo e gli acquisti.
Quote token
I "token" sono l'unità di consumo delle funzioni AI (chat, estrazione bollette). Il piano ne include un quantitativo al mese; qui vedi quanti ne restano.
Token-pack via bonifico
I pacchetti token extra sono rolling (non scadono). Per ora l'acquisto avviene su richiesta: clicchi il pacchetto, ricevi una causale e le coordinate per il bonifico, e i token vengono accreditati alla conferma dell'incasso (non in automatico). Il pagamento con carta è in arrivo.
Costo cliente vs nostro
"Costo nostro" è quanto paghiamo noi il provider AI; "costo cliente" è quanto è conteggiato a te secondo il piano. Servono a tenere sotto controllo la spesa.
Cosa può fare AskLOOGICO
Risponde su dati reali del tuo tenant (clienti, ordini, fatture, scadenze) e ti aiuta a trovare informazioni. Non esegue azioni irreversibili senza conferma.
Modulo Energia & Gas
Review FT EE / GAS
Verifica assistita dall'AI delle fatture di energia elettrica e gas: l'AI estrae i dati dal PDF, tu controlli e correggi prima di confermare.
POD / PDR
Anagrafica dei punti di fornitura: POD per l'energia elettrica, PDR per il gas. Ogni punto è collegato a contratti, consumi e fatture.
Contratti energia
I contratti di fornitura di energia elettrica e gas verso i clienti. Ogni contratto è legato a un punto di fornitura (POD per l'energia elettrica, PDR per il gas) e al relativo cliente.
Pratiche
Le pratiche operative aperte presso il distributore per attivare o modificare una fornitura: switch (cambio venditore), voltura (cambio intestatario), subentro (riattivazione di un POD/PDR disattivato) e prima attivazione.
Consumi
Lo storico delle letture dei contatori per punto di fornitura (POD / PDR), da cui si ricavano i consumi fatturati. Distingue letture reali, autoletture del cliente e stime.
Mercati & prezzi
I prezzi all'ingrosso dell'energia (dati pubblici GME), utili come riferimento per impostare le offerte e valutare la marginalità rispetto ai contratti a prezzo indicizzato.
Scadenze
Vista che aggrega gli appuntamenti da non perdere nell'area energia: contratti in scadenza (da rinnovare o disdire) e pratiche operative ferme da troppo tempo. È un riepilogo calcolato, non un'entità a sé.
Contratti attivi
Contratti di fornitura di energia elettrica e gas attualmente attivi.
POD/PDR attivi
Punti di fornitura attivi: POD (energia elettrica) + PDR (gas).
Fatturato (30gg)
Fatturato dell'area energia negli ultimi 30 giorni.
Energia erogata
Energia complessivamente erogata ai clienti nel periodo.
POD
Codice del punto di prelievo elettrico (14 caratteri, inizia con IT). È stampato sulla bolletta: identifica univocamente la fornitura.
PDR
Codice del punto di riconsegna gas (14 cifre). Equivalente del POD ma per il gas; lo trovi in bolletta.
Mercato (libero / tutelato)
Distingue forniture a prezzo libero da quelle in tutela. Cambia i campi di prezzo e le condizioni applicabili.
Review estrazione AI
L'AI legge il PDF della bolletta e propone POD, consumi e costi. Tu confermi o correggi: i campi a bassa confidenza sono evidenziati. Niente viene salvato senza la tua revisione.
Modulo Vino & Distillati
Bollini di Stato
Contrassegni di Stato (fascette) per i vini a denominazione DOCG/DOC: vanno applicati alle bottiglie e rendicontati. Qui ne tracci consumo e giacenza.
Ordine vocale
Raccogli l'ordine HoReCa dettandolo a voce (o scrivendolo): la trascrizione avviene nel tuo browser e l'AI abbina le parole al catalogo del cliente, proponendo le righe con il prezzo del suo listino. Pensato per la presa-ordine veloce dell'agente.
Distribuzione HoReCa
Il centro della rete vendita B2B verso ristoranti, wine bar e hotel: da qui gestisci clienti HoReCa, ordini, agenti e provvigioni con i relativi KPI (clienti attivi, ordini in corso, da spedire).
Listini per canale
Listini di vendita distinti per canale commerciale: lo stesso vino può avere prezzi diversi su Web B2C, B2B HoReCa o Cantina diretta. Sono la base di prezzo per gli ordini di distribuzione.
Documenti di spedizione
Documenti fiscali che accompagnano il trasporto dei prodotti vitivinicoli, richiesti dalla normativa accise. Qui li emetti, ne segui lo stato e li colleghi a lotto, etichetta e spedizione.
Mappa vigneti
Vista geografica dei vigneti: visualizzi i confini disegnati sulla mappa e apri ogni appezzamento per vederne i dettagli (vitigni, denominazione, dati di impianto).
Superficie vitata
Ettari totali dei vigneti registrati a sistema.
Produzione prevista
Stima della produzione di vino della prossima vendemmia.
Vino in affinamento
Volume di vino attualmente in fase di affinamento in cantina.
Lotti attivi
Lotti di produzione attualmente in lavorazione o giacenza.
Gradazione alcolica
Titolo alcolometrico (% vol). Incide su accisa e adempimenti: indicalo per ogni lotto.
Accisa
Imposta sulla produzione/movimentazione. Loogico la calcola sui lotti; verifica aliquote e categoria prodotto.
Contrassegni di Stato
I "bollini" fiscali da applicare ad alcune bottiglie. Qui tracci richiesta, ricezione e utilizzo per restare in regola.
e-DAS / MVV
Documenti che accompagnano il trasporto dei prodotti vitivinicoli. Generali per ogni spedizione soggetta.
Ordine vocale
Detti l'ordine al telefono (o scrivi): la trascrizione avviene nel tuo browser — nessun audio passa dai nostri server. L'AI abbina le parole al catalogo del cliente e propone le righe con prezzo da listino. Rivedi quantità, sconto e avvisi, poi crei la bozza: nulla viene salvato prima della conferma.
Rigenera lessico
Aggiorna gli "alias parlati" del catalogo (es. soprannomi delle bottiglie) usati per riconoscere meglio i prodotti dettati. È incrementale (solo le etichette cambiate) e consuma token AI: lancialo dopo aver modificato molto il catalogo, non a ogni ordine.
Modulo Fonia
Numerazioni
Inventario dei numeri telefonici (MSISDN) disponibili o assegnati ai clienti. Da qui vedi quali numeri sono liberi, riservati o già attivi su una linea.
SIM / eSIM
Parco delle SIM fisiche ed eSIM, con il loro stato (a magazzino, attiva, sospesa) e l'eventuale linea collegata.
Portabilità (MNP)
Pratiche per portare un numero da un altro operatore (donante) verso di noi (ricevente). Qui segui stato, eventuali rifiuti e date di ogni richiesta.
Linee
Le utenze attive dei clienti: mobile, fisso (FTTH/FTTC/ADSL), SIP/centralino o dati. Ogni linea raccoglie numero, SIM, piano, canone e agente.
Centralino (PBX)
I centralini telefonici dei clienti, cloud o on-premise, con i relativi interni configurati.
Attivazioni
Le pratiche operative sulle linee: nuove attivazioni, cambi e cessazioni. Da qui segui l'avanzamento di ogni ordine fino al completamento.
Linee attive
Linee (mobile, fisso, dati) attualmente attive.
Nuove attivazioni
Nuove linee attivate nel periodo.
Ticket aperti
Ticket di assistenza attualmente aperti.
Tasso di retention
Quota di clienti/linee mantenute nel periodo (l'opposto dell'abbandono).
Portabilità (MNP)
Per portare un numero da un altro operatore servono codice di migrazione/ICCID e i dati del titolare. Le tempistiche dipendono dall'operatore donante.
Sistema, ruoli e cestino
Cestino
Gli elementi eliminati non spariscono subito: finiscono qui e puoi ripristinarli. La cancellazione definitiva è un'azione separata.
Ruoli team
Ogni utente ha un ruolo che decide cosa può vedere e fare (es. sola lettura, operatore, admin). Assegna il minimo necessario.
Console super-admin (costi, cancellazioni tenant)
Costo sostenuto
Quanto paghiamo NOI i provider AI (Anthropic, Voyage, …) per le funzioni usate da quel tenant: l'esborso reale di Loogico. Distinto dal ricavo conteggiato al cliente.
Margine lordo
Ricavo (valore consumato lato cliente) meno il costo sostenuto verso i provider. La percentuale è il margine sul ricavo. Non include i costi fissi di piattaforma.
Denari caricati
Somma delle ricariche token-pack completate (incassate) nel periodo per quel tenant. Il "saldo" confronta quanto ha caricato con quanto ha consumato a valore.
Cockpit — centro di controllo
Vista unica super-admin che aggrega tutta la piattaforma a colpo d'occhio, in 3 fasce: 🔴 Problemi attivi (errori 5xx, job falliti, tenant con token AI esauriti=AI bloccata), 🟡 Da gestire (cancellazioni 4-occhi da approvare, token-pack da accreditare, ticket aperti, bollette da revisionare, tenant inattivi, tenant vicini al cap token AI / limite utenti / storage, trial in scadenza, contratti clienti in scadenza, fatture clienti scadute), 📊 Situazione (tenant per stato, costi/margine del mese, eventi AI). Si aggiorna da sola ogni 60s. Ogni card è cliccabile e porta all'area di competenza.
Cancellazione a 4 occhi
La cancellazione di un tenant richiede DUE super-admin diversi: uno apre la richiesta (con motivazione), un secondo la approva. Nessun super-admin può approvare la propria richiesta. È una misura anti-errore e anti-abuso su un'operazione critica.
Cosa fa la cancellazione
È un soft-cancel REVERSIBILE: il tenant passa a stato "cancelled", il login viene bloccato e il tenant sparisce dalle liste, ma i DATI restano conservati e ripristinabili da un super-admin. Non viene smontata l'infrastruttura (vhost/cert) né distrutto alcun dato.
Come funziona il flusso
1) Dal dettaglio tenant → "Zona pericolosa" → Richiedi cancellazione. 2) Gli altri super-admin ricevono notifica in-app + email e la vedono in "Cancellazioni (4 occhi)" sotto "Attività da svolgere". 3) Un altro super-admin Approva (esegue) o Rifiuta. 4) Il richiedente può annullare finché è in attesa. Tutte le azioni sono tracciate (audit).
🚀 Per iniziare
Da dove inizio?
Dopo il signup, segui il wizard di onboarding: 1) completa il profilo azienda, 2) crea il primo cliente, 3) aggiungi un prodotto al catalogo. In 5 minuti sei operativo.
Come importo i miei dati esistenti (clienti/prodotti)?
Vai su Import / Export: scarica il template, compilalo dal tuo Excel/altro gestionale, carica. Per i prodotti puoi attivare "upsert" per aggiornare quelli esistenti per SKU.
Come invito i miei collaboratori?
Solo admin. Vai su Team → "Invita". Inserisci email + ruolo. Riceveranno una mail con link per accettare. Possono creare un account nuovo o collegarne uno esistente.
💳 Billing & abbonamento
Quanto dura la prova gratuita?
14 giorni dal signup, full-feature. Ti avvisiamo via email a 3 giorni e 1 giorno dalla scadenza.
Come cambio piano?
Solo admin. Dal Portale billing (accessibile via account → upgrade/downgrade) — pagamento gestito da Stripe (sicuro PCI-DSS).
Posso disdire?
Sì in qualsiasi momento dal portale billing. L'account resta attivo fino alla fine del periodo pagato. I tuoi dati restano in sola lettura per 30 giorni dopo la cancellazione (export possibile).
🔒 Sicurezza & GDPR
Come attivo l'autenticazione a due fattori?
Vai su 2FA. Genera il QR, scansionalo con Google Authenticator/Authy, conferma il primo codice. Salva i codici di recupero in un posto sicuro.
I miei clienti possono richiedere export GDPR?
Sì. Endpoint API
GET /api/gdpr/export/{cliente_id} (admin only) genera JSON con tutti i dati personali del cliente. Per l'oblio: POST /api/gdpr/erasure/{id}.
I dati della mia azienda sono isolati?
Sì, ogni tenant ha tenant_id UUID isolato a livello PostgreSQL Row Level Security. Nessuna fuoriuscita possibile lato applicazione.
Quanto spesso fate backup?
Backup DB ogni notte alle 02:00, completo (DB + files) sabato 02:30. Storage: locale + S3 cifrato (Backblaze B2). Retention 30 giorni.
📧 Contattaci
Non hai trovato risposta?
✉ support@loogico.it 💳 billing@loogico.it 💼 sales@loogico.itRisposta entro 24h lavorative.