# 2. Anagrafiche e catalogo

Estensioni a dati anagrafici, installazioni, prodotti, servizi e contratti.

# Aziende e Contatti

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

# Aziende e Contatti

## Classificazione

Moduli standard vtenext estesi.

## A cosa servono le aggiunte

I dati anagrafici determinano chi riceve la Fattura, la data di scadenza e l’indirizzo e-mail. Dal dettaglio è inoltre possibile aprire rapidamente un Ticket o predisporre un Lavoro.

## Dove si trovano

Aprire **Aziende** o **Contatti**, entrare nel record e individuare il blocco **Fatturazione Avanzata** e i comandi **Crea Ticket** e **Crea Lavoro**.

## Campi aggiunti

| Modulo | Campo | Compilazione ed effetto |
|---|---|---|
| Aziende | **Email Fatturazione** | inserita dall’utente; usata se nessun Contatto è Responsabile Fatture |
| Aziende e Contatti | **Giorni Pagamento Fattura** | scelta fra 0, 15, 30, 60, 90, 120; usata per la scadenza |
| Aziende e Contatti | **Fattura Fine Mese** | se selezionata, porta la scadenza all’ultimo giorno del mese calcolato |
| Contatti | **Responsabile Fatture** | identifica i Contatti destinatari delle e-mail di fatturazione |

## Creare un Ticket

1. Aprire l’Azienda o il Contatto.
2. Premere **Crea Ticket**.
3. Compilare **Titolo Assistenza** e **Descrizione Assistenza**.
4. Confermare.
5. Il sistema crea un Ticket **Aperto**, con priorità **Bassa**, assegnato all’utente corrente e collegato all’anagrafica.
6. Il nuovo Ticket si apre in una nuova scheda.

## Creare un Lavoro

1. Premere **Crea Lavoro**.
2. Compilare titolo e descrizione.
3. Confermare.
4. Il sistema crea prima il Ticket con **Stato Fatturazione = Da Fatturare**.
5. Si apre la creazione di un Lavoro già collegato al Ticket.

## Controlli e messaggi

Se titolo o descrizione non sono compilati compare: **“Per Favore Compilare i Campi Titolo e Descrizione”**.

## Destinatari e-mail Fatture

Con Azienda collegata, il sistema usa nell’ordine:

1. tutti i Contatti con **Responsabile Fatture**;
2. **Email Fatturazione** dell’Azienda;
3. e-mail principale dell’Azienda.

> **📸 SCREENSHOT DA INSERIRE — Campi fatturazione in Azienda e Contatto**
>
> **Pagina da aprire:** dettaglio e modifica di un’Azienda e di un Contatto  
> **Contenuto da mostrare:** blocco Fatturazione Avanzata e pulsanti  
> **Evidenziare:** Email Fatturazione, Giorni Pagamento, Fattura Fine Mese, Responsabile Fatture  
> **Dati da usare:** anagrafiche dimostrative  
> **Scopo:** riconoscere dati e comandi necessari

---

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

# Installazioni

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

# Installazioni

## Classificazione

Modulo standard vtenext esteso.

## A cosa serve

Dall’Installazione si può aprire assistenza sul bene installato. Il sistema tenta di individuare automaticamente l’eventuale Contratto di servizio attivo.

## Procedura

1. Aprire **Installazioni** e il record interessato.
2. Premere **Crea Ticket** oppure **Crea Lavoro**.
3. Inserire **Titolo Assistenza** e **Descrizione Assistenza**.
4. Confermare.

Con **Crea Lavoro**, il sistema crea prima il Ticket e apre poi un Lavoro collegato.

## Automatismi

- Il cliente del Ticket è l’Azienda collegata all’Installazione.
- Se non esiste alcun Contratto attivo, il Ticket riceve **Stato Fatturazione = Da Fatturare**.
- Se esiste un solo Contratto attivo, il Ticket viene collegato al contratto e classificato in base alla tipologia del contratto.
- Se esistono più contratti attivi, l’operazione viene bloccata per evitare un’associazione ambigua.

## Controlli e messaggi

- Titolo o descrizione mancanti: **“Per Favore Compilare i Campi Titolo e Descrizione”**.
- Più contratti attivi: **“L'installazione selezionata ha più di un Servizio a Contratto attivo”**.

## Risultato atteso

Viene creato un Ticket associato all’Installazione e al cliente; quando un solo contratto è disponibile viene creata anche la relazione con quel contratto.

> **📸 SCREENSHOT DA INSERIRE — Creazione assistenza da Installazione**
>
> **Pagina da aprire:** dettaglio Installazione  
> **Contenuto da mostrare:** pulsanti e finestra titolo/descrizione  
> **Evidenziare:** collegamento al Contratto di servizio  
> **Dati da usare:** Installazione con un solo contratto attivo  
> **Scopo:** mostrare la selezione automatica del contratto

---

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

# Prodotti e Servizi

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

# Prodotti e Servizi

## Classificazione

Moduli standard vtenext estesi.

## Utilizzo nel pacchetto

Prodotti e Servizi alimentano le righe dei Lavori, delle Proposte Fattura, dei Preventivi, degli Ordini di vendita e delle Fatture.

## Prodotti

Nelle selezioni il prodotto è identificato con **Nome Prodotto** e **Codice Prodotto**, così da ridurre gli errori fra articoli simili.

## Servizi Acconto e Saldo

La categoria del Servizio può contenere i valori:

- **Acconto**
- **Saldo**

Questi valori sono usati nella finestra **Crea Acconto/Saldo** dell’Ordine di vendita. Il filtro propone soltanto i Servizi coerenti con il tipo scelto.

## Prerequisiti

- Il prodotto o servizio deve essere disponibile nel catalogo e, se previsto dalla configurazione vtenext, nel Listino selezionato.
- Per creare acconti o saldi a riga singola deve esistere almeno un Servizio della categoria corrispondente.
- Prezzo, quantità, sconto e imposte devono essere controllati nelle righe del documento.

## Effetti automatici

Quando più Lavori sono raggruppati nella stessa Proposta Fattura, righe riferite allo stesso prodotto/servizio possono essere aggregate. Quantità e importi confluiscono nella riga riepilogativa; le descrizioni dei Lavori restano riportate nel documento.

> **📸 SCREENSHOT DA INSERIRE — Servizi Acconto e Saldo**
>
> **Pagina da aprire:** Servizi in creazione/modifica e righe di un Lavoro  
> **Contenuto da mostrare:** categoria servizio e selezione prodotto/servizio  
> **Evidenziare:** valori Acconto e Saldo  
> **Dati da usare:** due servizi dimostrativi  
> **Scopo:** preparare correttamente il catalogo

---

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

# Contratti di servizio

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

# Contratti di servizio

## Classificazione

Modulo standard vtenext esteso.

## Aggiunte

- nuova tipologia **Supporto a Consuntivo**;
- campo **Tariffa**;
- comandi **Crea Ticket** e **Crea Lavoro**;
- aggiornamenti automatici del Ticket collegato e dei consumi del contratto.

## Supporto a Consuntivo

Usare questa tipologia quando le attività devono essere fatturate secondo le ore/lavorazioni registrate.

**Tariffa** è obbligatoria per **Supporto a Consuntivo**. Se manca, il salvataggio è bloccato con: **“Attenzione compilare il campo Tariffa”**.

## Creazione assistenza

1. Aprire il Contratto di servizio.
2. Premere **Crea Ticket** o **Crea Lavoro**.
3. Compilare titolo e descrizione.
4. Confermare.

Il Ticket viene collegato al contratto e al cliente del contratto.

## Aggiornamenti sul Ticket

| Tipo contratto | Stato Fatturazione Ticket | Tariffa Ticket |
|---|---|---|
| **Supporto a Consuntivo** | **Da Fatturare** | copiata dal contratto |
| Altra tipologia | **Servizio a Contratto** | impostata a zero |

Se il collegamento al contratto cambia, il Ticket viene riallineato alla nuova tipologia. Il contratto ricalcola inoltre i valori standard di utilizzo e residuo in base ai Ticket collegati.

## Controlli

Titolo o descrizione mancanti nella creazione rapida: **“Per Favore Compilare i Campi Titolo e Descrizione”**.

> **📸 SCREENSHOT DA INSERIRE — Contratto Supporto a Consuntivo**
>
> **Pagina da aprire:** Contratto di servizio in modifica e dettaglio  
> **Contenuto da mostrare:** tipo, Tariffa, comandi e Ticket correlati  
> **Evidenziare:** effetto sullo Stato Fatturazione  
> **Dati da usare:** contratto dimostrativo  
> **Scopo:** distinguere attività comprese e attività fatturabili

---

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