Gitea flags en dash, multiplication sign, minus sign and single angle quotes as confusable characters, which put a warning on most pages; use plain equivalents (docs/SPEC.md stays untouched). STATUS.md now lists the issue numbers per milestone, the items waiting for the owner and the open specification questions tracked by issue #114. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
9.0 KiB
Automazioni e procedure
Stato: bozza · Ultima revisione: 2026-11-10 · Versione software: non ancora rilasciata (milestone M12) Modulo di licenza: AUTO (regole e procedure oltre quelle di sistema) · Permessi principali:
automation.rule.write,automation.procedure.run,automation.run.read· Specifica: SPEC §11.12, §9, §12.5
A cosa serve
Le automazioni fanno lavorare Khaemhat da solo in due modi:
- Regole quando → se → allora: al verificarsi di un evento (una fattura emessa, una notifica SDI, una giacenza sotto scorta…), se le condizioni sono vere, eseguono una o più azioni (e-mail, notifica, attività, blocco…).
- Procedure: operazioni di lavoro complete (fatturazione differita, contabilizzazione, solleciti, liquidazione IVA, ammortamenti…) raccolte in un catalogo, eseguibili a mano, da una regola o da un'attività programmata.
Le procedure di sistema sono sempre disponibili; il modulo AUTO aggiunge le regole e le procedure pianificabili oltre a quelle di sistema.
Dove si trova
Menu laterale Automazioni: Regole, Procedure, Esecuzioni. La pianificazione oraria delle procedure si gestisce in Amministrazione → Attività programmate (Attività programmate).
Schermate
Mockup 072 — elenco delle regole con evento, condizione, azione, numero di esecuzioni e interruttore di attivazione; sotto, la definizione della regola selezionata in tre colonne Quando, Se, Allora (anteprima ridotta)
Mockup 073 — catalogo delle procedure con codice, area, descrizione, modalità di esecuzione, ultima esecuzione ed esito; sotto, i parametri della procedura selezionata (anteprima ridotta)
Regole quando → se → allora
Creare una regola
- Automazioni → Regole, premi Nuova regola.
- Quando: scegli l'evento e, se serve, un filtro (es. "righe con codice IVA in N3.5").
- Se: imposta una o più condizioni (campo, operatore, valore).
- Allora: aggiungi una o più azioni (Azione 1, Azione 2…).
- Opzioni: Esegui una sola volta per documento, Disattiva dopo N errori consecutivi.
- Prova la regola con Prova su documento, poi attivala con l'interruttore.
Eventi
| Evento | Quando scatta |
|---|---|
DocumentCreated |
un documento viene creato |
DocumentConfirmed |
un documento viene confermato (es. ordine) |
DocumentIssued |
una fattura viene emessa |
DocumentCancelled |
un documento viene annullato |
SdiNotificationImported |
arriva una notifica dello SDI (es. scarto NS) |
OpenItemOverdue |
una partita scade |
StockBelowReorder |
la disponibilità scende sotto il punto di riordino |
LeadCreated |
nasce un lead |
OpportunityStageChanged |
un'opportunità cambia fase |
TicketOpened |
si apre un ticket |
InterventionClosed |
si chiude un intervento |
Schedule |
a orari fissi (es. ogni giorno alle 08:00) |
Condizioni
Filtri semplici sui campi del documento o della controparte (uguale, diverso, maggiore, minore, contiene, in elenco)
e soglie percentuali (es. cliente.dichiarazione_intento.utilizzato_pct ≥ 90). Gli operatori esatti saranno
fissati in sviluppo.
Azioni
| Azione | Esempio |
|---|---|
| Invia e-mail o PEC con modello | fattura con PDF e XML al cliente |
| Notifica in app | all'agente del cliente, a un ruolo |
| Crea attività | "Richiamare" dopo 5 giorni dall'invio del preventivo |
| Imposta campo o stato | ricalcola il punteggio del lead |
| Blocca con permesso | blocca l'ordine finché un utente con permesso di override non lo sblocca |
| Aggiungi a proposta di riordino | articolo sotto scorta con fornitore abituale |
| Genera documento collegato | documento successivo nel flusso |
| Esegui procedura | una procedura del catalogo |
| Webhook | chiamata firmata (HMAC) verso un sistema esterno, con retry (modulo API) |
Regole predefinite
Le regole predefinite sono caricate con i dati di base; quelle mostrate nel mockup:
| Regola | Quando | Se | Allora |
|---|---|---|---|
| Avviso plafond dichiarazione d'intento | fattura emessa con IVA N3.5 | plafond utilizzato > 90 % | e-mail all'amministrazione + notifica all'agente |
| Invio fatture al cliente | fattura emessa | il cliente riceve i documenti per e-mail | e-mail con PDF (+ XML) |
| Blocco ordine per fido | ordine confermato | scaduto > 0 o fido superato | blocca (override con permesso), notifica agente |
| Attività dopo preventivo | preventivo inviato | sempre | crea attività "Richiamare" a +5 giorni |
| Fattura scartata dallo SDI | notifica NS importata | sempre | notifica all'amministrazione, documento da correggere |
| Riordino automatico | disponibile < punto di riordino | fornitore abituale presente | aggiunge alla proposta d'ordine |
| Promemoria scadenze fornitori | ogni giorno alle 08:00 | pagamenti entro 7 giorni | riepilogo e-mail alla tesoreria |
| Punteggio lead | lead creato o aggiornato | sempre | calcola il punteggio (fonte + interesse + interazioni) |
Prova, log e disattivazione
- Prova su documento esegue la regola su un documento esistente senza effetti e mostra cosa farebbe.
- Ogni esecuzione è registrata in Esecuzioni (data, regola, documento, esito, durata, errore) e nel Log, sezione Automazioni.
- Dopo N errori consecutivi (impostabile per regola, es. 5) la regola si disattiva da sola; la disattivazione resta nel log (l'eventuale notifica agli amministratori sarà definita in sviluppo).
Catalogo delle procedure
Automazioni → Procedure elenca le procedure con codice, area, descrizione, modalità di esecuzione (manuale, pianificata), ultima esecuzione ed esito. Selezionando una procedura compaiono i suoi parametri; i pulsanti sono Esegui ora, Pianifica e Storico.
| Procedura | Area | Cosa fa |
|---|---|---|
| Fatturazione differita | Vendite | DDT non fatturati → fatture differite (TD24) per cliente |
| Contabilizzazione documenti | Contabilità | registrazioni dei documenti confermati non ancora contabilizzati |
| Generazione scadenze | Tesoreria | partite di scadenzario dei documenti |
| Solleciti | Tesoreria | livelli 1-3, modelli, interessi di mora |
| Stampa / invio massivo | Documenti | stampe e invii di più documenti (ZIP) |
| Proposta di riordino | Magazzino | sottoscorta → ordini fornitore in bozza |
| Aggiornamento listini | Articoli | variazioni massive dei prezzi |
| Liquidazione IVA | Contabilità | calcolo del periodo e controlli |
| Ammortamenti | Cespiti | quote annuali civilistiche e fiscali |
| Ratei e risconti | Contabilità | scritture di assestamento |
| Chiusura esercizio | Contabilità | passi della chiusura guidata |
| Ricostruzioni | Manutenzione | giacenze, partite, totali, numeratori, saldi |
| Import inbox e canali SDI | Fiscale | legge XML e P7M da cartella e canali |
| Cambi | Tabelle | tassi giornalieri BCE |
| Export per il commercialista | Contabilità | pacchetto ZIP mensile |
| Pulizie | Sistema | pulizia di dati temporanei e scaduti |
Esempio di parametri (fatturazione differita, mockup 073): Clienti (tutti con DDT da fatturare), Periodo DDT (mese precedente), Data fattura (ultimo giorno del mese), Sezionale, e le opzioni Genera XML SDI, Contabilizza, Invia e-mail, Anteprima prima di generare.
Regole comuni a tutte le procedure
- Idempotenti: rieseguire una procedura non duplica il lavoro (non rifattura i DDT già fatturati, non ricontabilizza, non duplica le quote di ammortamento).
- Con log: inizio, fine, durata, esito e dettaglio nel Log, con il codice di traccia.
- Tre modi di avvio: a mano (Esegui ora), da una regola (azione Esegui procedura), da un'attività programmata (Pianifica, con preset o espressione cron).
Permessi e licenza
- Le procedure di sistema funzionano con i moduli a cui appartengono (es. la liquidazione IVA con ACCT).
- AUTO serve per creare regole e per pianificare procedure oltre a quelle di sistema; senza licenza le regole esistenti restano conservate ma non vengono eseguite.
- L'azione Webhook richiede il modulo API.
- I codici dei permessi in testa sono indicativi (convenzione
modulo.entità.azione, SPEC §7.2).
Attenzione
- Una regola con azione di invio e-mail agisce su documenti reali: provala sempre con Prova su documento.
- Le procedure pianificate girano con l'utente indicato nell'attività programmata ("esegui come"): i permessi sono i suoi.
Pagine correlate
Attività programmate · Log · Vendite · Contabilità · IVA · Scadenzario · Fatturazione elettronica · CRM · Magazzino · Tabelle azienda · API e MCP