AlkemyPl-AI BETA

Assistente che risponde in linguaggio naturale a domande sui dati AlkemyPlay (contratti, prodotti, budget media, incassi, clienti), traducendo la domanda in una query di sola lettura sul database legacy e mostrando tabella, grafico ed export.

Come si usa

Scrivi la domanda in italiano (es. «budget media mese per mese di Handler»).
Puoi affinare il risultato con messaggi successivi («ordina per incasso», «solo i clienti morti»).
Ogni risultato ha il pulsante 📊 grafico e ⬇ CSV (compatibile con Excel).
La query SQL usata è sempre mostrata sopra la risposta: è verificabile.

Cosa può rispondere (esempi)

Revenue / incasso per partita IVA o per cliente
Prodotti acquistati per cliente, con stato ordine e rete vendita
Budget media residuo per cliente e per mese, Google e Meta separati
Cassa incassata (mese per mese, per cliente), split media / servizi
Contratti in scadenza nei prossimi mesi + revenue potenziale
Portafoglio per consulente / account manager; clienti attivi vs morti

Da dove vengono i dati (importante)

Tipo di dato	Fonte	Nota
Budget / ricariche / spese media (Google, Meta)	Database live (db3)	Il residuo del mese corrente coincide col gestionale.
Pagato / cassa / margine	File fatture (offline)	Autorevole, copre la competenza 2017-2026 (file corrente 2023-26 + storico 2017-24). Prima del 2023 l'importo non è a DB: c'è solo nel file.

Budget accreditato ≠ cassa incassata. Un cliente può avere budget media spendibile ma averlo pagato in parte (o averlo ricevuto in omaggio). Le due cose sono tenute distinte.

Consumo Meta poco tracciato. Google è tracciato bene (ricarica e spesa complete). Per Meta invece la piattaforma registra il consumo solo per pochi clienti: per la maggior parte il budget Meta risulta ancora intatto (residuo = ricarica), quindi il "speso Meta" appare 0 ma vuol dire non tracciato, non "zero speso". Il consumo media reale di questi clienti oggi è noto solo dal file fatture. Riconciliare le due fonti è un lavoro in corso.

Gli importi sono in euro "lato cliente" (AP), come nel gestionale.

Cosa abbiamo aggiunto dal file fatture (e cosa oggi manca)

Molti dati commerciali e finanziari non vivono nella piattaforma: stanno in file esterni (fatturazione + listino) e in processi amministrativi. Li abbiamo integrati unendoli al database.

Preso dai file esterni — cosa, se è nel gestionale, da dove viene:

Dato	Nel gestionale?	Da dove viene / riscontro
Pagato reale / incasso	solo parziale	db3 ha il prezzo su una minoranza degli ordini; il file copre 1.268 ordini
Retrocessione / margine	assente	nel database nessuna colonna; nel file 1.879 righe
Note di credito / storni	assente	solo file: 76 righe, 55 ordini, ~64k€
Competenza contabile	assente	spesso diversa dalla data dell'ordine (anche di mesi)
Nome prodotto + prezzo di listino	assente	db3 ha solo codici; nomi e prezzi da un 2° file (listino)
Rete vendita / agente (codici SAG)	parziale	db3 ha il consulente; codici e nomi agente nel file
Ricevuta di ritorno contratto	assente	solo file: 350 righe
Tipo contratto, split media / servizi	assente	classificazione commerciale

Nel database (piattaforma) ci sono invece: ordini e stati, servizi/pacchetti a codice, budget e spesa Google, anagrafica cliente, scadenze, budget Meta, consulente / account manager.

Da tenere presente — oggi non c'è / è parziale:

La spesa reale delle campagne Meta (né database né file): c'è la ricarica, non il consumo
Prima del 2023 gli importi esistono SOLO nel file: la piattaforma non registrava i prezzi (2017-2022: il 100% dell'incasso, ~7,4M€). Un incasso a zero da database su quegli anni significa non registrato, non "non incassato" → per la revenue storica va usato il file
Media storico non separabile Google/Meta: fino al 2024 il file tiene il media come blocco unico; lo split per piattaforma esiste solo dal file corrente
Le note di credito esistono solo nel file (il database non le ha) e coprono solo il periodo importato
Il file è un export periodico, non in tempo reale: pagamenti e storni recentissimi compaiono solo dopo il prossimo import

Limiti & avvertenze

Sola lettura. Non può modificare, cancellare o creare nulla: solo interrogare.
Può sbagliare. È un'AI che scrive la query: può interpretare male la domanda o scegliere la vista sbagliata. Verifica sempre i numeri critici (la SQL mostrata aiuta) e segnala le anomalie.
Vede solo un insieme di viste curate, non tutto il database.
Non sostituisce la contabilità ufficiale né i report certificati.
È in beta: aspettatevi imperfezioni; il vostro feedback serve a migliorarla.

Privacy & sicurezza

Accesso protetto da password; connessione in HTTPS.
Il database non è esposto: l'app lo raggiunge solo via tunnel cifrato, con un utente di sola lettura.

AlkemyPl-AI · strumento interno in fase di test.