# 1. Introduzione e processo operativo

Panoramica, classificazione e prerequisiti.

# Introduzione e panoramica

> **BOZZA – Manuale in fase di verifica**

# Introduzione e panoramica

Fatturazione Avanzata collega il lavoro svolto per il cliente al ciclo amministrativo. Consente di aprire Ticket e Lavori dalle principali anagrafiche, consuntivare ore, trasferta e materiali, preparare Proposte Fattura, generare Fatture, gestire acconti e saldi, inviare documenti per e-mail e produrre PDF.

Il processo documentato è quello della branch produttiva 21.10.2. Il contenuto descrive ciò che l’utente vede e gli effetti sui record; le note tecniche sono raccolte esclusivamente nell’ultima pagina del libro.

## Moduli aggiuntivi

| Modulo | Scopo |
|---|---|
| **Lavori** | Registra attività, tempi, trasferta, prodotti e servizi eseguiti per un Ticket o un’Operazione. |
| **Proposte Fattura** | Raggruppa i Ticket fatturabili e prepara i dati prima della Fattura. Nell’interfaccia italiana verificata il nome è “Proposta Fattura”. |
| **Testi descrittivi** | Conserva descrizioni riutilizzabili nei documenti commerciali. |
| **Testi termini e condizioni** | Conserva termini e condizioni riutilizzabili nei documenti commerciali. |

## Moduli standard estesi

Aziende, Contatti, Installazioni, Prodotti, Servizi, Contratti di servizio, Ticket, Commesse, Pianificazioni, Operazioni, Preventivi, Ordini di vendita e Fatture restano moduli standard vtenext, ma ricevono campi, pulsanti, relazioni, calcoli o controlli aggiuntivi.

> **Attenzione:** **Lavori** e **Commesse** non sono sinonimi. Lavori è il consuntivo operativo aggiunto dal pacchetto; Commesse è il contenitore standard delle Pianificazioni.

## Convenzioni

- Le etichette in grassetto corrispondono ai testi italiani verificati nell’interfaccia.
- Le funzioni non dimostrate come attive sono indicate come “da verificare” e non sono presentate come operative.
- I valori e i messaggi riportati tra virgolette sono quelli previsti dal pacchetto.
- Tutti gli screenshot sono segnaposto e devono essere acquisiti in un ambiente dimostrativo senza dati sensibili.

## Stato del manuale

Il libro è una **bozza**: le funzionalità dimostrate dal pacchetto sono documentate; i pochi punti che richiedono conferma sull’installazione reale sono elencati nelle note di manutenzione.

---

> **Riferimento documentazione:** branch `21.10.2`, commit `a9156f4054548bc1db1c531077abb8695028ddcc`.

# Flusso operativo completo

> **BOZZA – Manuale in fase di verifica**

# Flusso operativo completo

Il percorso principale parte dall’assistenza e termina nella fatturazione.

1. Dall’Azienda, Contatto, Installazione, Contratto di servizio, Pianificazione o Operazione si crea un **Ticket** oppure un **Lavoro**. Nel secondo caso il sistema crea prima il Ticket.
2. Nel Ticket vengono definiti cliente, eventuale Contratto di servizio, tariffa e **Stato Fatturazione**.
3. Uno o più **Lavori** registrano data, ore, trasferta, pausa, ore non conteggiate, servizi, prodotti e firma.
4. Il sistema ricalcola automaticamente ore e giorni del Ticket e, se richiesto, lo imposta su **Chiuso**.
5. Dalla lista Ticket, i record **Chiuso** e **Da Fatturare** possono essere trasformati in **Proposte Fattura**.
6. La proposta può essere controllata, approvata o sospesa. I Ticket sospesi passano a **Sospeso**; quelli inclusi passano a **Proposta Fattura**.
7. Dalle Proposte Fattura **Approvato** si generano le Fatture. La scadenza è calcolata dai giorni di pagamento e dall’eventuale opzione fine mese.
8. In alternativa, da un Ordine di vendita è possibile creare una Fattura di **Acconto** o **Saldo**.
9. Dalla lista Fatture è possibile generare PDF, salvarli nei Documenti, inviarli per e-mail e aggiornare lo stato delle Fatture inviate.

## Varianti

- Un Ticket collegato a un contratto ordinario può essere classificato **Servizio a Contratto**.
- Un contratto **Supporto a Consuntivo** valorizza tariffa e stato **Da Fatturare**.
- Da un Ordine di vendita il flusso Acconto/Saldo crea direttamente una Fattura.
- Le Pianificazioni di tipo **Consuntivo** includono il lavoro effettivamente registrato; quelle **Preventivo** supportano la pianificazione.

> **📸 SCREENSHOT DA INSERIRE — Flusso completo**
>
> **Pagina da aprire:** viste dettaglio Ticket, Lavoro, Proposta Fattura e Fattura  
> **Contenuto da mostrare:** relazioni e stati nei quattro passaggi  
> **Evidenziare:** Stato, Stato Fatturazione e record collegati  
> **Dati da usare:** processo dimostrativo completo  
> **Scopo:** comprendere il passaggio dal consuntivo alla Fattura

---

> **Riferimento documentazione:** branch `21.10.2`, commit `a9156f4054548bc1db1c531077abb8695028ddcc`.

# Prerequisiti e configurazioni

> **BOZZA – Manuale in fase di verifica**

# Prerequisiti e configurazioni

## Dati anagrafici

Prima di fatturare verificare:

- Azienda o Contatto correttamente collegati al Ticket;
- indirizzi di fatturazione e spedizione;
- **Giorni Pagamento Fattura** nell’Azienda o nel Contatto;
- **Fattura Fine Mese** se la scadenza deve cadere a fine mese;
- **Email Fatturazione** nell’Azienda oppure un Contatto con **Responsabile Fatture**;
- valuta coerente fra i Lavori che confluiscono nella stessa proposta.

## Catalogo e contratti

- Prodotti e Servizi usati nei Lavori devono essere attivi e valorizzati.
- Per acconti e saldi servono Servizi classificati rispettivamente **Acconto** o **Saldo**.
- Un Contratto **Supporto a Consuntivo** richiede la **Tariffa**.
- Un’Installazione non deve avere più di un Contratto di servizio attivo per la creazione rapida.

## Ticket e Lavori

Per generare una proposta il Ticket deve essere **Chiuso**, avere **Stato Fatturazione = Da Fatturare**, essere collegato a un cliente, avere almeno un Lavoro e non contenere Lavori senza righe prodotto/servizio.

## E-mail e PDF

- Deve esistere un account e-mail predefinito.
- Devono essere disponibili Template Email e modello PDF compatibili.
- I PDF inviati sono salvati nelle cartelle Documenti **Fatture Inviate** o **Lavori Inviati**.

## Configurazioni che influenzano i calcoli

L’amministratore può configurare ore per giorno Ticket, arrotondamento e durata minima dei Lavori e creazione della riga negativa che compensa gli acconti nel saldo.

> **📸 SCREENSHOT DA INSERIRE — Prerequisiti di fatturazione**
>
> **Pagina da aprire:** Azienda, Contratto di servizio e Ticket in modifica  
> **Contenuto da mostrare:** giorni pagamento, fine mese, e-mail, tariffa e stato fatturazione  
> **Evidenziare:** campi necessari  
> **Dati da usare:** cliente dimostrativo  
> **Scopo:** prevenire blocchi durante la generazione

---

> **Riferimento documentazione:** branch `21.10.2`, commit `a9156f4054548bc1db1c531077abb8695028ddcc`.

# Classificazione dei moduli

> **BOZZA – Manuale in fase di verifica**

# Classificazione dei moduli

| Modulo | Classificazione | Aggiunte dimostrate |
|---|---|---|
| Aziende | Standard vtenext esteso | creazione Ticket/Lavoro, pagamenti, fine mese, e-mail |
| Contatti | Standard vtenext esteso | creazione Ticket/Lavoro, pagamenti, fine mese, responsabile fatture |
| Installazioni | Standard vtenext esteso | creazione Ticket/Lavoro e contratto attivo |
| Prodotti | Standard vtenext esteso | uso nelle righe e identificazione nome/codice |
| Servizi | Standard vtenext esteso | categorie Acconto e Saldo |
| Contratti di servizio | Standard vtenext esteso | Supporto a Consuntivo, tariffa, aggiornamento Ticket |
| Ticket | Standard vtenext esteso | tariffa, riduzione, stato fatturazione, proposta, ricalcoli |
| Commesse | Standard vtenext | nessuna aggiunta diretta dimostrata |
| Pianificazioni | Standard vtenext esteso | unità, ore, progresso, tipo Preventivo/Consuntivo |
| Operazioni | Standard vtenext esteso | ore e progresso, relazione Lavori |
| Lavori | **Aggiuntivo** | consuntivo, inventario, firma, calcoli, invio PDF |
| Preventivi | Standard vtenext esteso | Posizioni, subtotali, funzioni PDF |
| Ordini di vendita | Standard vtenext esteso | Posizioni, totali fatturati, Acconto/Saldo |
| Proposte Fattura | **Aggiuntivo** | preparazione e raggruppamento Ticket |
| Fatture | Standard vtenext esteso | Acconto/Saldo, acconti, invio massivo, stati |
| Testi descrittivi | **Aggiuntivo** | descrizioni riutilizzabili |
| Testi termini e condizioni | **Aggiuntivo** | termini riutilizzabili |
| Processi | Standard vtenext esteso | relazioni con i testi; copia automatica da verificare |

Le pagine dei moduli standard descrivono solo le aggiunte della Fatturazione Avanzata.

---

> **Riferimento documentazione:** branch `21.10.2`, commit `a9156f4054548bc1db1c531077abb8695028ddcc`.