Files
Khaemhat/docs/wiki/Automazioni.md
T
Alby96andClaude Opus 5.5 88de272b3e docs: avoid ambiguous Unicode and record Gitea planning in STATUS
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>
2026-11-10 22:44:14 +01:00

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

072 · Regole 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)

073 · Catalogo procedure 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

  1. Automazioni → Regole, premi Nuova regola.
  2. Quando: scegli l'evento e, se serve, un filtro (es. "righe con codice IVA in N3.5").
  3. Se: imposta una o più condizioni (campo, operatore, valore).
  4. Allora: aggiungi una o più azioni (Azione 1, Azione 2…).
  5. Opzioni: Esegui una sola volta per documento, Disattiva dopo N errori consecutivi.
  6. 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