# Seleziona la tua versione di OpenSTAManager

{% hint style="info" %}
Per un corretto utilizzo delle guide assicurati di aver selezionato la versione di OpenSTAManager corretta dal menu a sinistra o cliccando sui link sottostanti.
{% endhint %}

* [Versione 2.11](https://docs.openstamanager.com/2.11/) (Ultima release)
* [Versione 2.10.4](https://docs.openstamanager.com/2.10.4/)&#x20;
* [Versione 2.10.3](https://docs.openstamanager.com/2.10.3/)
* [Versione 2.10.2](https://docs.openstamanager.com/2.10.2/)&#x20;
* [Versione 2.10.1](https://docs.openstamanager.com/2.10.1/)&#x20;
* [Versione 2.10](https://docs.openstamanager.com/2.10/)
* [Versione 2.9.8](https://docs.openstamanager.com/2.9.8/)
* [Versione 2.9.7](https://docs.openstamanager.com/2.9.7/)
* [Versione 2.9.6](https://docs.openstamanager.com/2.9.6/)&#x20;
* [Versione 2.9.5](https://docs.openstamanager.com/2.9.5/)&#x20;
* [Versione 2.9.4](https://docs.openstamanager.com/2.9.4/)&#x20;
* [Versione 2.9.3](https://docs.openstamanager.com/2.9.3/)&#x20;
* [Versione 2.9.2](https://docs.openstamanager.com/2.9.2/)
* [Versione 2.9.1 ](/2.9.1)
* [Versione 2.9](https://docs.openstamanager.com/2.9/)&#x20;
* [Versione 2.8.3](https://docs.openstamanager.com/2.8.3/)&#x20;
* [Versione 2.8.2](https://docs.openstamanager.com/2.8.2/)&#x20;
* [Versione 2.8.1](https://docs.openstamanager.com/2.8.1/)
* [Versione 2.8](https://docs.openstamanager.com/2.8/)
* [Versione 2.7.3](https://docs.openstamanager.com/2.7.3/)&#x20;
* [Versione 2.7.2](https://docs.openstamanager.com/2.7.2/)&#x20;
* [Versione 2.7.1](https://docs.openstamanager.com/2.7.1/)
* [Versione 2.7](https://docs.openstamanager.com/2.7/)&#x20;
* [Versione 2.6.2](https://docs.openstamanager.com/2.6.2/)
* [Versione 2.6.1](https://docs.openstamanager.com/2.6.1/)
* [Versione 2.6](https://docs.openstamanager.com/2.6/)&#x20;
* [Versione 2.5.7](https://docs.openstamanager.com/2.5.7/)&#x20;
* [Versione 2.5.6](https://docs.openstamanager.com/2.5.6/)
* [Versione 2.5.5](https://docs.openstamanager.com/2.5.5/)
* [Versione 2.5.4](https://docs.openstamanager.com/2.5.4/)&#x20;
* [Versione 2.5.3](https://docs.openstamanager.com/2.5.3/)
* [Versione 2.5.2-beta](https://docs.openstamanager.com/2.5.2/)&#x20;
* [Versione 2.5.1-beta ](https://docs.openstamanager.com/2.5.1/)
* [Versione 2.5-beta](https://docs.openstamanager.com/2.5/)
* [Versione 2.4.54](https://docs.openstamanager.com/2.4.54/)
* [Versione 2.4.53](https://docs.openstamanager.com/2.4.53/)
* [Versione 2.4.52](https://docs.openstamanager.com/2.4.52/)&#x20;
* [Versione 2.4.51](https://docs.openstamanager.com/2.4.51/)&#x20;
* [Versione 2.4.50](https://docs.openstamanager.com/2.4.50/)
* [Versione 2.4.49](https://docs.openstamanager.com/2.4.49/)
* [Versione 2.4.48](https://docs.openstamanager.com/2.4.48/)&#x20;
* [Versione 2.4.47](https://docs.openstamanager.com/2.4.47/)
* [Versione 2.4.46](https://docs.openstamanager.com/2.4.46/)
* [Versione 2.4.45](https://docs.openstamanager.com/2.4.45/)
* [Versione 2.4.44](https://docs.openstamanager.com/2.4.44/)&#x20;
* [Versione 2.4.43](https://docs.openstamanager.com/2.4.43/)&#x20;
* [Versione 2.4.42](https://docs.openstamanager.com/2.4.42/)
* [Versione 2.4.41](https://docs.openstamanager.com/2.4.41/)&#x20;
* [Versione 2.4.40](https://docs.openstamanager.com/2.4.40/)&#x20;
* [Versione 2.4.39](https://docs.openstamanager.com/2.4.39/)&#x20;
* [Versione 2.4.38](https://docs.openstamanager.com/2.4.38/)
* [Versione 2.4.37](https://docs.openstamanager.com/2.4.37/)&#x20;
* [Versione 2.4.36](https://docs.openstamanager.com/2.4.36/)
* [Versione 2.4.35](https://docs.openstamanager.com/2.4.35/)
* [Versione 2.4.34](https://docs.openstamanager.com/2.4.34/)
* [Versione 2.4.33](https://docs.openstamanager.com/2.4.33/)
* [Versione 2.4.32 ](https://docs.openstamanager.com/2.4.32/)
* [Versione 2.4.25](broken://spaces/-LZJeLg23eVDvrCv74U7-887967055)
* [Versione 2.4.24](broken://spaces/-LZJeLg23eVDvrCv74U7-1555242653)
* [Versione 2.4.23](broken://spaces/-LZJeLg23eVDvrCv74U7-980611001)
* [Versione 2.4.22](broken://spaces/-LZJeLg23eVDvrCv74U7-4220097936)

Buona navigazione! ⛵


# OpenSTAManager

Benvenuto nella documentazione di OpenSTAManager!

Benvenuto nella documentazione di OpenSTAManager!

> Al giorno d'oggi, per le aziende coinvolte nel settore dell'assistenza tecnica la necessità di un software dedicato, flessibile, completo e funzionale in molteplici categorie di dispositivi risulta di fondamentale importanza per permettere un'efficiente gestione dell'attività lavorativa. Per rispondere a queste esigenze nasce il gestionale per il servizio di assistenza tecnica OpenSTAManager, che rende disponibile un supporto informatico per la gestione di questa tipologia di pratiche in un contesto talvolta povero di alternative.

## Presentazione

Il gestionale OpenSTAManager è un software open-source e web based, sviluppato dall'azienda informatica DevCode di Este per gestire ed archiviare il servizio di assistenza tecnica e la relativa fatturazione. Il nome del progetto deriva dalla parziale traduzione in inglese degli elementi principali che lo compongono: la natura open-source e il suo obiettivo quale Gestore del Servizio Tecnico di Assistenza.

Un software gestionale, identificato nell'insieme degli applicativi che automatizzano i processi di gestione all'interno delle aziende, appartiene solitamente a una specifica categoria del settore, specializzata negli ambiti di:

* Gestione della contabilità;
* Gestione del magazzino;
* Gestione e ausilio della produzione;
* Gestione e previsione dei budget aziendali;
* Gestione ed analisi finanziaria.

Secondo questa definizione, OpenSTAManager riesce a generalizzare al proprio interno le funzionalità caratteristiche della contabilità e della gestione del magazzino, presentando inoltre moduli piuttosto avanzati e destinati a complementare l'attività aziendale in relazione agli interventi di assistenza della realtà lavorativa in oggetto.

## Storia

OpenSTAManager viene inizialmente ideato da Nicoletta Marampon e sviluppato da **Fabio Lovato** al fine di gestire esclusivamente le anagrafiche e gli interventi aziendali per piccole realtà lavorative.

La prima release (0.2RC2 dell'agosto 2008) viene successivamente ampliata con numerosi e innovativi componenti, quali il calendario delle attività, e ottimizzata in relazione al sistema di installazione e di aggiornamento; parallelamente, tra il 2011 e 2012, viene introdotto il sistema di gestione della contabilità e vengono migliorati numerosi moduli, soprattutto a livello grafico. Fondamentale in questo senso risulta essere la collaborazione dei nuovi colleghi **Luca Salvà** e **Fabio Piovan**, che ha permesso il continuo adeguamento del progetto a un mondo informatico in continua evoluzione e a richieste sempre più complesse da parte dei clienti.

## Proposte

Hai delle proposte per migliorare questa documentazione? Video, immagini, descrizioni, esempi,... sono tutti i benvenuti!

Contattaci attraverso il [forum ufficiale](https://forum.openstamanager.com) oppure su [GitHub](https://github.com/devcode-it/devcode-it.github.io/issues).

## Navigazione

Il menu di sinistra è il principale strumento per la navigazione in questo sito.

Puoi trovarvi in particolare due sezioni generali:

* **Configurazione**, dedicata alle informazioni sull'installazione e l'aggiornamento del gestionale
* **Caratteristiche**, dedicata alle strutture più comuni presenti in OpenSTAManager

Le altre sezioni riguardano dei raggruppamenti di moduli e plugin tramite la logica di funzionamento del software.

Buona navigazione!


# Configurazione

La sezione seguente contiene le informazioni fondamentali sulle procedure di installazione, configurazione e aggiornamento del gestionale OpenSTAManager.

{% content-ref url="/pages/-M2sjKPGTGM1p-ndncvb" %}
[Installazione](/configurazione/installazione)
{% endcontent-ref %}

{% content-ref url="/pages/-M2sjKPHX37TG1FRb5F\_" %}
[Inizializzazione](/configurazione/inizializzazione)
{% endcontent-ref %}

{% content-ref url="/pages/-M2sjKPIACp2LythRq41" %}
[Aggiornamento](/configurazione/aggiornamento)
{% endcontent-ref %}

{% content-ref url="/pages/-M2sjt3lEjXtXBa6X5Jk" %}
[Backup](/configurazione/backup)
{% endcontent-ref %}


# Installazione

Per procedere all'installazione di OpenSTAManager è necessario seguire i seguenti punti:

1. [Scaricare una release ufficiale del progetto](https://github.com/devcode-it/openstamanager/releases).
2. Creare una cartella (ad esempio `openstamanager`) nella root del *web server* ed estrarvi il contenuto della release scaricata (per maggiori informazioni, [consultare la documentazione tecnica](/configurazione/installazione))
3. Creare un database vuoto (tramite [PHPMyAdmin](http://localhost/phpmyadmin/) o riga di comando).
4. Accedere a <http://localhost/openstamanager> dal vostro browser.

Una volta completate le istruzioni per l'installazione del software, è necessario procedere alla sua configurazione per permetterne il funzionamento nell'ambiente di utilizzo.

Questa procedura può essere suddivisa in tre sezioni differenti:

* Controllo dei requisiti
* Revisione della licenza del software
* Configurazione delle credenziali di accesso al database MySQL

## Requisiti

{% hint style="info" %}
Il software permette in automatico di controllare se l'ambiente di utilizzo presenta una configurazione adeguata per il suo corretto funzionamento.
{% endhint %}

In particolare, viene richiesta la presenza di un *web server* [Apache](https://httpd.apache.org) con il linguaggio di programmazione [PHP](http://php.net) e il [DBMS MySQL](https://www.mysql.com), richiedendo le seguenti versioni minime:

* PHP >= 7.2
* MySQL >= 5.7

Nel caso la versione PHP non sia compatibile, viene mostrato immediatamente un messaggio informativo a riguardo.

Successivamente, se il controllo precedente viene soddisfatto, il software verrà effettivamente avviato e sarà possibile procedere nella configurazione.

Viene quindi caricata la pagina per il controllo della configurazione del *web server*, di cui vengono controllati vari componenti:

* Moduli Apache
* Estensioni PHP
* Percorsi di servizio per il software

Nel caso vengano mostrati dei componenti in rosso, è consigliato procedere all'attivazione del modulo/estensione seguendo le linee guida ufficiali del relativi software ([PHP ](http://php.net/manual/en/install.pecl.windows.php)o [Apache](https://stackoverflow.com/a/5758551)).

![Schermata dei requisiti(non soddisfatti)](/files/-LZifqqz1qLuVp1NPYrr)

Una volta corretti correttamente i requisiti, cliccare ![](/files/-LZssXF0sBuPwlFZfqRp) .

![Schermata dei requisiti (soddisfatti)](/files/-LZifoMDwQVn0lTlPnSu)

### Codice da GitHub

Nel caso si stia utilizzando la versione direttamente ottenuta dalla repository di GitHub, è necessario eseguire i seguenti comandi da linea di comando per completare le dipendenze PHP (tramite [Composer](https://getcomposer.org)) e gli assets (tramite [Yarn](https://yarnpkg.com)) del progetto.

```bash
php composer.phar install
yarn global add gulp
yarn install
gulp
```

In alternativa alla sequenza di comandi precedente, è possibile utilizzare il seguente comando (richiede l'installazione di GIT e Yarn, oltre che l'inserimento dell'archivio `composer.phar` nella cartella principale del progetto):

```bash
yarn run develop-OSM
```

## Licenza

La schermata successiva a quella dei requisiti consiste nella gestione della licenza di utilizzo del software.

![Schermata per la licenza](/files/-LZieTQlik3MuqGbVklr)

OpenSTAManager viene reso disponibile tramite la licenza **GPL-3.0**, che ne permette l'uso commerciale e la personalizzazione a patto di mantenere un riferimento al progetto iniziale rimuovendo la responsabilità di eventuali problematiche agli sviluppatori originali.

Una volta accettata la licenza, cliccare su **Successivo**.

{% hint style="warning" %}
**Non è possibile procedere all'utilizzo del software senza aver accettato la licenza.**
{% endhint %}

![Errore di licenza](/files/-LZifHCGlPx-nMkulkgI)

## Database

Una volta corretti i requisiti e accettata la licenza, viene resa disponibile la pagina dedicata alla configurazione del software per l'accesso al database MySQL.

![Screenshot configurazione](/files/-LZifRrLgOCEA1Kv1wh6)

E' possibile, una volta completate le informazioni di configurazione, procedere ad un test automatico per controllare se il database presente è completamente compatibile con il gestionale. Questa funzione è disponibile attraverso il pulsante **Testa il database**.

![Test della configurazione](/files/-LZie_gTvyYcVQ7i5nKH)

![Test ok](/files/-LZieg2s1TqWdD4KnJm0)

In ogni caso, si possono verificare degli errori duranti il salvataggio della configurazione se:

* I dati di connessione sono errati

![Errore di connessione](/files/-LZinJGKzJPPQIUNbEk-)

* I permessi di creazione e scrittura sul file `config.inc.php` sono troppo restrittivi

![Errore di test](/files/-LZiesruVWi7mxs0W1Ro)

Se le credenziali inserite sono corrette, dopo aver cliccato su **Installa** si verrà reindirizzati alla procedura automatica di installazione del database.

## Installazione del database

Una volta inseriti correttamente i parametri di configurazione, è sufficiente cliccare sul pulsante ![](/files/-LZn9QESC2Bkx8p9hUdE) per avviare l'installazione del database di OpenSTAManager.

![Installazione del database](/files/-LZiiXRbe12jtYQMQ8gJ)

![Processi di installazione del database](/files/-LZiiilDMjUymNrnVxXq)

![Database installato con successo](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FA3mhWhiUY9LKS17bUvx0%2Ffile.png?alt=media)

Per maggiori informazioni su questa procedura, oppure nel caso si verificassero degli errori, visitare la sezione **Aggiornamento**.

[Vai alla sezione Aggiornamento](/configurazione/aggiornamento)

## Inizializzazione

Una volta completati i precedenti passaggi con successo, verrà richiesta di inizializzare il gestionale con delle informazioni di base.

[Vai alla sezione Inizializzazione](/configurazione/inizializzazione)


# Inizializzazione

{% hint style="info" %}
Una volta completata l'installazione del gestionale, ed in alcuni casi a seguito di un aggiornamento, può essere presentata un'ulteriore schermata per l'inizializzazione del software.
{% endhint %}

![Schermata di inizializzazione](/files/TFols8skQyKhRDD0uunp)

Attraverso questa funzionalità vengono generalmente completate delle informazioni di base per il funzionamento del software, suddivise secondo tre categorie:

* Amministrazione
* Azienda predefinita
* Impostazioni di base

Nel caso questa schermata si presenti a seguito di un aggiornamento, potrebbe richiedere la compilazione esclusiva di una parte delle informazioni elencate di seguito.

## Amministrazione

{% hint style="info" %}
La sezione **Amministrazione** permette di configurare le credenziali dell'account di amministrazione predefinito, ed è accessibile solo dopo la prima installazione.
{% endhint %}

E' in particolare possibile definire:

* Username dell'account
* Password dell'account
* Email collegata

![Gestione dell'amministrazione](/files/-LZjDlx9EaPEwYMcI4qo)

## Azienda predefinita

{% hint style="info" %}
La sezione **Azienda predefinita** richiede il completamento delle informazioni relative all'azienda destinata ad utilizzare il gestionale.
{% endhint %}

In particolare, è possibile definire la *ragione sociale* e una serie di dati anagrafici di base. E' inoltre possibile caricare il *logo aziendale*, che verrà successivamente implementato nelle stampe del gestionale.

![Creazione iniziale account OpenSTAManager](/files/-LZjDtVvtxByJiehJB66)

## Impostazioni di base

{% hint style="info" %}
Infine, la sezione **Impostazioni di base** prevede la compilazione di alcune opzioni di OpenSTAManager obbligatorie per il funzionamento di diverse componenti, quali per esempio la contabilità e la fatturazione elettronica.
{% endhint %}

![Impostazioni di base](/files/-LZjDxKGQhc9Xsi-rr96)

## Salvataggio

{% hint style="info" %}
Una volta completate correttamente le informazioni richieste dalle sezioni precedenti, è possibile procedere al salvataggio delle stesse e al successivo utilizzo del software cliccando sul pulsante **Configura**.
{% endhint %}

![Schermata di login](/files/-LZjE-CCtxJYQVKQxhvo)

Sarà possibile accedere fin da subito con le credenziali di amministrazione immesse in precedenza.


# Aggiornamento

{% hint style="warning" %}
**Attenzione**: Questa documentazione è esclusivamente relativa all'aggiornamento del software. Per maggiori informazioni sull'installazione consultare la documentazione relativa nella sezione [Installazione](/configurazione/installazione).
{% endhint %}

OpenSTAManager supporta due procedure distinte per il caricamento degli aggiornamenti:

* Automatici tramite caricamento del file ZIP nel modulo Aggiornamenti
* Manuali tramite la scompattazione del file ZIP

Per un approfondimento su entrambe queste tipologie, siete pregati di visitare la sezione sui [Dettagli tecnici](#dettagli-tecnici).

Dopo il caricamento dell'aggiornamento, si possono in genere verificare due situazioni:

* L'aggiornamento **non** richiede di modificare il database, e quindi non sono necessarie ulteriori azioni
* L'aggiornamento richiede di modificare il database

In quest'ultimo caso, ogni utente presente all'interno del gestionale verrà automaticamente reindirizzato verso il logout e sarà possibile aggiornare il database come richiesto attraverso delle apposite schermate e il pulsante ![](/files/-LZnA-i2gI9CM0foAgMQ) .

![Aggiornamento del database disponibile](/files/-LZil9Md3QXyOUuih_wJ)

![Aggiornamento del database completato](/files/-LZilYfl2lw6nYiyWAG7)

## Errori di aggiornamento

La procedura di aggiornamento, come ogni componente software, è soggetta a possibili errori.

![Errore aggiornamento](/files/-LZilNMzG2eX_wgjL8hh)

Nel caso questi si verifichino, l'utente dovrebbe riuscire a visualizzare il seguente messaggio informativo:

![Errore aggiornamento](/files/-LZilEeLUVBPlfCEz0q-)

In questi casi, si consiglia di contattare gli sviluppatori ufficiali e di consultare il [forum ufficiale](https://www.openstamanager.com/forum/) per eventuali segnalazioni simili.

## Aggiornamento in corso

{% hint style="info" %}
Mentre l'aggiornamento è in esecuzione, il gestionale rimarrà bloccato per tutti gli utenti ad eccezione di quello responsabile dell'inizio della procedura di aggiornamento.

Nel caso la procedura rimanga persistente per un periodo molto prolungato di tempo, è possibile che si sia verificato un errore non rilevato dall'utente durante l'aggiornamento. In questo caso si consiglia di consultare la sezione di [Ripresa forzata](#ripresa-forzata) oppure di contattare gli sviluppatori ufficiali.
{% endhint %}

## Ripresa forzata

In alcuni casi particolari, può essere necessario riprendere forzatamente l'esecuzione di un aggiornamento andato in errore.

Questo viene reso possibile visitando l'URL a cui è possibile accedere a OpenSTAManager con l'aggiunta del testo `?force`.

{% hint style="warning" %}
**Attenzione**: quest'azione è sconsigliata a utenti non esperti.
{% endhint %}

## Dettagli tecnici

### Aggiornamento semplificato

La procedura di aggiornamento semplificato ha l'obiettivo di fornire un sistema di facile utilizzo per favorire l'aggiornamento, e migliorare in questo modo l'interazione con l'utente finale.

L'utilizzo di questa procedura è però sottoposto alla seguenti condizioni nelle impostazioni PHP:

* `upload_max_filesize` >= 16MB
* `post_max_size` >= 16MB

Di seguito la procedura:

1. Accedere con un account amministrativo
2. Entrare nel modulo **Aggiornamenti** (disponibile nel menu principale a sinistra, eventualmente sotto la dicitura **Strumenti**)
3. Selezionare il file *.zip* della release attraverso l'apposita sezione "Carica un aggiornamento" e cliccare sul pulsante "Carica"

Dopo l'esecuzione di queste azioni, il gestionale effettuerà automaticamente il logout di tutti gli utenti connessi e renderà disponibile l'interfaccia di aggiornamento.

### Aggiornamento manuale

La procedura di aggiornamento manuale è resa disponibile per ovviare ai problemi relativi al caricamento del file *.zip* (in alcuni casi il file non viene correttamente rilevato, non sono disponibili i permessi per caricare file oppure la dimensione del file eccede il limite di upload sul server).

Di seguito la procedura:

1. De-comprimere il contenuto del file *.zip* in una cartella temporanea
2. Rinominare il file `VERSION` dell'installazione corrente in `VERSION.old` (rispettando minuscole e maiuscole) \[facoltativo a partire dalla versione 2.3]
3. Copiare i file della nuova versione dalla cartella temporanea alla cartella del server, in modo che le cartelle principali (`files`, `modules`, `templates`, ...) vengano sovrascritte

Dopo l'esecuzione di queste azioni, il gestionale effettuerà automaticamente il logout di tutti gli utenti connessi e renderà disponibile l'interfaccia di aggiornamento.

### Migrazione dalla versione 1.x

E' possibile effettuare la migrazione da una qualsiasi versione 1.x alla nuova 2.0, seguendo una procedura un po’ diversa dalle precedenti:

1. Scaricare la versione 2.0 per la migrazione da SourceForge ([openstamanager-2.0-migrazione.zip](https://sourceforge.net/projects/openstamanager/files/openstamanager/openstamanager-2.x/))
2. Creare un backup completo della versione in uso
3. De-comprimere il contenuto del file *.zip* in una cartella temporanea
4. Effettuare le seguenti operazioni dal backup della precedente versione alla cartella della versione 2.0:
   * Copiare il file `VERSION`, rinominandolo in `VERSION.old`
   * Copiare il file `config.inc.php`
   * Copiare la cartella `files/`
   * Copiare i contenuti della cartella `/modules/magazzino/articoli/images/` in `/files/articoli/`
   * Copiare la cartella `templates/` (mantenendo però i file `pdfgen.php` e `pdfgen_variables.php` della versione 2.0)

Dopo l'esecuzione di queste azioni, il gestionale renderà disponibile l'interfaccia di aggiornamento.


# Backup

OpenSTAManager include un sistema integrato di backup, che permette di salvare le informazioni dell'installazione in un percorso predefinito secondo la configurazione indicata.

### Configurazione

Il backup presenta alcune impostazioni configurabili dall'utilizzatore in relazione alle operazioni di [backup automatico](#backup-automatico) e al percorso di salvataggio dei backup stessi.

Il percorso di backup può essere configurato nel file `config.inc.php`:

```
// Percorso della cartella di backup
$backup_dir = __DIR__.'/backup/';
```

{% hint style="warning" %}
Per motivi di sicurezza si consiglia di modificare il percorso della cartella di backup al di fuori della cartella di OSM, possibilmente in una unità esterna.
{% endhint %}

### Modulo

Esiste un modulo apposito, **Backup**, che permette di visualizzare in ogni momento le informazioni relative alla configurazione dei backup e di gestire i backup presenti del gestionale.

![](/files/-M2sp65CQTwlJ9DLTEs6)

L'esecuzione manuale del backup è estremamente semplice:

![](/files/-MWOnUgXy-VYVqVxesas)

### Formato dei backup

Il backup di OpenSTAManager viene gestito secondo due procedure diverse sulla base della configurazione PHP del server: se è installata [l'estensione ZIP](https://www.php.net/manual/en/book.zip.php) viene generato un singolo archivio `.zip`, altrimenti viene creata una cartella apposita per il backup.

In entrambi i casi, i backup presentano la stessa struttura interna poiché contengono tutti i file del gestionale con l'unica aggiunta di un file `database.sql` nel percorso principale, che contiene l'intero database in cui il gestionale è installato risalente al momento di esecuzione del backup.

{% hint style="warning" %}
Per migliorare la sicurezza del server, il file `config.inc.php`, che contiene i dati di accesso al database, non viene mai incluso nel backup.
{% endhint %}

### Ripristino

Esiste una procedura semplificata di ripristino dei backup, che cerca di risolvere il problema tecnico per utenti con meno esperienza tecnica.

La procedura semplificata è raggiungibile nel modulo **Backup**, sotto la sezione *Ripristina backup*, tramite la selezione di un archivio ZIP.

![](/files/-LZeR4paA8nGFCz40aGO)

La procedura manuale è comunque sempre disponibile, e prevede di:

* Creare una cartella vuoto dove estrarre/copiare il contenuto del backup
* Creare un nuovo database, per poi importare il file `database.sql` dalla cartella del ripristino
* Rimuovere il file `database.sql` dalla cartella del ripristino
* Procedere alla configurazione del database per il gestionale (tramite procedura semplificata o impostazione manuale del file `config.inc.php`)

### Backup automatico

E' disponibile una impostazione nativa per l'esecuzione del backup al primo accesso giornaliero: nel modulo **Impostazioni**, sotto la categoria **Backup** è sufficiente selezionare *Backup automatico*.

![Opzioni disponibili per i backup](/files/-M2slQ7ONS835iXNclSr)

Il backup automatico viene eseguito in modi diversi a seconda della versione del gestionale installata:

* per versioni < 2.4.11 il backup viene eseguito durante la procedura di login del primo utente;
* dalla versione 2.4.11 in poi, è presente un *hook* indipendente che effettua il backup in background.


# Interfaccia

Guida all'interfaccia di OpenSTAManager.

OpenSTAManager presenta un'interfaccia generale piuttosto chiara, basata su strutture comuni e solitamente di semplice utilizzo.

## Navigazione

![](/files/-LZjFGp8QONcJAqvNYGy)

La navigazione attraverso le diverse sezioni del gestionale viene resa possibile dal menu laterale, visibile in ogni pagina e rappresentante i moduli a cui l'utente autenticato ha accesso. Questo menu si compone generalmente di macro-sezioni per argomento (quali **Attività**, **Vendite**, **Acquisti**) che raggruppano diversi moduli al loro interno, generalmente visualizzabili cliccando sul simbolo ![](/files/-LZi-nhaynyik4wefMW_) .

Il modulo corrente viene evidenziato, nel tema predefinito, con una scritta bianca più vivace delle altre. Per maggiori informazioni sui moduli, visitare la [sezione apposita](/interfaccia/moduli-e-plugin).

Nella parte più alta di questa componente è inoltre presente una barra di ricerca generalizzata all'interno del gestionale, che permette di effettuare ricerche tra i moduli che supportano questa funzione.

## Selezione temporale

Nella sezione in alto a sinistra di ogni modulo è possibile selezionare il periodo temporale a cui il gestionale farà riferimento per l'individuazione delle informazioni di ogni modulo.

Sono presenti diversi valori preimpostati:

* Oggi
* I trimestre
* II trimestre
* III trimestre
* IV trimestre
* I semestre
* II semestre
* Questo mese
* Mese scorso
* Quest'anno (*default*)
* Anno scorso

Questa funzionalità è sfruttata in particolare da moduli in cui il periodo di tempo è rilevante (quali, per esempio, **Attività** e **Fatture**) mentre in altri non provoca alcun effetto (per esempio, **Dashboard** e **Articoli**).

![](/files/-M376D2KCagZZgFLCbqu)

## Opzioni di controllo

Parallelamente alla possibilità di selezionare il periodo temporale, vengono rese disponibili alcune opzioni aggiuntive nella sezione in alto a destra del software.

![](/files/-M36xpdMgzudmeq2aTLC)

Viene qui permesso di procedere alle seguenti azioni, in ordine:

* Stampare la schermata attuale attraverso il browser
* Visitare la pagina per la segnalazione dei bug
* Visitare l'elenco dei propri tentativi di accesso
* Visitare la pagina di informazioni sul software
* Effettuare il logout

## **Messaggi personalizzati**

{% hint style="warning" %}
Questa funzione è di rilevanza per chi desidera personalizzare alcune delle informazioni presentate dal gestionale senza modificare in modo consistente il codice generale.
{% endhint %}

A partire dalla versione 2.4.2 è stato reso possibile inserire dei messaggi generali all'interno di ogni pagina del gestionale, specifici per l'installazione in utilizzo.

E' possibile procedere alla personalizzazione di questi contenuti attraverso i seguenti file (da creare secondo necessità):

* `include/custom/extra/login.php`, dedicato ai messaggi da mostrare all'accesso
* `include/custom/extra/extra.php`, per i messaggi da mostrare una volta che l'utente si è autenticato

## Informazioni aggiuntive

{% content-ref url="/pages/-M36yBXldYe3fA96PM24" %}
[Moduli e plugin](/interfaccia/moduli-e-plugin)
{% endcontent-ref %}

{% content-ref url="/pages/-M36yMtJqoinhEFOVbrL" %}
[Widget](/interfaccia/widget)
{% endcontent-ref %}

{% content-ref url="/pages/-M372PphqWo9\_vcpY3pW" %}
[Stato dei servizi](/interfaccia/stato-dei-servizi)
{% endcontent-ref %}

{% content-ref url="/pages/-M36yZjlMvpsHJrfYH2I" %}
[Gestione upload](/interfaccia/gestione-upload)
{% endcontent-ref %}


# Moduli e plugin

I moduli sono la componente principale della struttura di OpenSTAManager. Sono progettati per avere una struttura facilmente personalizzabile e mantenere comportamenti indipendenti dal resto del software.

Ogni modulo del gestionale è raggiungibile attraverso il [menu laterale](/interfaccia#navigazione), ma può presentare una grafica personalizzata sulla base della funzione a cui è dedicato. Esistono però alcune caratteristiche comuni che si possono individuare quasi sempre, descritte in questa pagina.

Per ottenere maggiori informazioni sul funzionamento interno e specifico di un modulo, è necessario visitare la relativa guida dedicata.

## Pagina principale

I moduli sono solitamente caratterizzati da due pagine, una dedicata alla visualizzazione generale di tutti i record salvati e una indirizzata alla gestione delle informazioni di un singolo record.

La pagina principale può essere composta da due strutture diverse: una tabella generale oppure un sistema di contenti personalizzati.

### Tabella generale

La schermata principale più comune nei moduli del gestionale presentano è una tabella che permette una serie di operazioni comuni su tutti gli elementi registrati all'interno del modulo:

* Scorrere e visualizzare (attraverso un click) i diversi record
* Selezionare diversi record attraverso le relative righe per esportarli (in formato CSV), stamparli o copiarli
* Selezionare dei record per effettuare delle azioni generali specifiche del modulo

![Esempio dell'interfaccia con tabella generale](/files/-LZjG366p_G3PufreKpm)

Esempi di questo comportamento sono individuabili in **Anagrafiche**, **Attività**, **Articoli** e in molti altri moduli predefiniti.

### Contenuti personalizzati

Esistono alcuni moduli con requisiti particolari per la propria schermata principale, sia per motivi estetici che perché rappresentano informazioni poco compatibili al formato tabellare. In questi casi, è impossibile prevedere il tipo di informazioni presentabili e la modalità, che dipende dal singolo modulo.

Esempi di questa struttura sono presenti nei moduli **Dashboard** e **Statistiche**.

## Operazioni sui record

Nel caso i moduli presentino una struttura di record gestibili singolarmente tramite la tabella generale, sono solitamente disponibili della ulteriori operazioni generali di creazione e modifica dei record.

{% hint style="info" %}
Le informazioni richieste da queste operazioni sono delegate al modulo stesso, che quindi può richiedere qualunque tipo di dato.
{% endhint %}

### Creazione record

I moduli che permettono la creazione di nuovi elementi presentano un pulsante apposito ![](/files/-LZi3_ucH_QZ1sE_0hyp) vicino all'intestazione della pagina.

![Pulsante di creazione record (Anagrafiche)](/files/-LZjG8tuT3NDCIxN8MNl)

Una volta cliccato il pulsante in questione, verrà aperta una schermata sovrapposta al resto del gestionale ch permettere di inserire le informazioni del nuovo elemento.

![Creazione di un nuovo record (Anagrafiche)](/files/-LZi5KGhCMinIIxaZ_yo)

### Modifica record

I moduli che permetto la modifica e la visualizzazione dei propri record permettono l'apertura di una schermata apposita al click sulla riga del record nella tabella principale. Questa schermata può chiedere e contenere molte più informazioni rispetto alla tabella generale e alla schermata di creazione.

![Esempio di schermata di modifica record (Anagrafiche)](/files/-LZjGG9NDlcpV2ziMoFg)

## Gestione dei moduli

Le operazioni di gestione dei moduli, quali abilitazione e disabilitazione, sono disponibili attraverso il modulo [Stato dei servizi](/interfaccia/stato-dei-servizi).

## Gestione degli upload

Alcuni moduli presentano una componente generale per permettere l'inserimento di file di vario tipo all'utente finale del gestionale. Questa funzione viene spiegata più nel dettaglio in [Gestione upload](/interfaccia/gestione-upload).

## Plugin

I plugin sono dei moduli che sono sottoposti alla gestione gerarchica di un altro modulo, e pertanto possono essere considerati dei sotto-moduli. Ogni modulo può possedere un numero variabile di plugin, visibili nella sezione in alto a destra della schermata dei moduli.

![Plugin](/files/-LZnB7ODbI4E3V8aq1-r)

I plugin possono presentare comportamenti molto diversi, e sono in generale separati dal modulo a cui appartengono, malgrado vi siano collegati fortemente.

{% hint style="info" %}
Per gli amministratori, è inoltre presente un plugin denominato **Info** che permette di visualizzare la cronologia del record.
{% endhint %}

## Campi personalizzati

{% hint style="warning" %}
Questa funzione è di rilevanza per chi desidera personalizzare alcune delle informazioni presentate dal gestionale senza modificare in modo consistente il codice generale.
{% endhint %}

A partire dalla versione 2.4 è possibile sfruttare dei campi personalizzati per aggiungere informazioni ai moduli principali in modo dinamico.

Questi campi sono gestiti a livello di database attraverso le tabelle `zz_fields` e `zz_field_record`, che si occupano rispettivamente della gestione generale dei campi e del salvataggio dei record personalizzati. Le procedure automatiche di gestione di questi campi sono integrate nei file `actions.php`, `editor.php` e `add.php`.

E' eventualmente disponibile il modulo **Campi personalizzati**, da abilitare, per la gestione dinamica di queste informazioni.

{% hint style="danger" %}
I campi creati in questo modo non sono utilizzabili per interagire con il resto del gestionale.
{% endhint %}


# Widget

I widget sono componenti predefinite che presentano una serie di funzioni aggiuntive a un modulo, che possono andare da filtri ad operazioni di gestione interna dei record.

Esistono pertanto diversi tipi di widget, malgrado si presentino sempre nella parte alta o bassa della pagina del modulo.

![Esempio di widget (Anagrafiche)](/files/-LZjGJlsGf8yn5cMjBw1)

## **Gestione dei widget**

I widget, essendo componenti del gestionale, presentano un sistema di base che ne permette la gestione all'utente finale.

In particolare, è possibile procedere a disabilitare un widget attraverso il relativo pulsante in alto a destra dello stesso, oltre che modificare la posizione relativa dei widget di una stessa pagina attraverso un azione di *drag\&drop*.

![Pulsante di disabilitazione del widget](/files/-LZKpV58jLWY7P4vXqJk)

La gestione dei widget può inoltre essere effettuata attraverso il modulo [Stato dei servizi](/interfaccia/stato-dei-servizi).


# Stato dei servizi

Il modulo **Stato dei servizi** permette di visualizzare e gestire i componenti di OpenSTAManager a partire da un'unica interfaccia gerarchica.

## Moduli installati

Visualizza una serie di informazioni relative ai moduli, quali:

* Nome
* Versione
* Stato
* Compatibilità
* Opzioni

![Screenshot moduli installati](/files/-LZeRcmAOH-rEorCXgKQ)

{% hint style="warning" %}
Cliccando sopra un ingranaggio si può disabilitare un *modulo*
{% endhint %}

## Widgets

Visualizza una serie di informazioni relative ai *Widgets*, quali:

* Nome
* Posizione
* Stato
* Posizione (per modificare la *Posizione* di un determinato *Widget*)

![Screenshot widget](/files/-LZeRhNJssjPya9trG8p)

{% hint style="warning" %}
Cliccando sopra una freccia si può modificare la posizione di un *Widget*
{% endhint %}


# Gestione upload

OpenSTAManager presenta una struttura comune per la gestione degli upload da parte dell'utente per il singolo record di un modulo o plugin.

Questa funzione, qualora abilitata per il modulo in utilizzo, si presenta nel seguente modo:

![Screenshot della sezione di gestione degli upload](/files/-LZjGRWhRMXT1UAjqQ7Z)

## Struttura interna

Tutti gli upload di OpenSTAManager vengono salvati all'interno della cartella `files/` , suddivisi secondo il nome del modulo cui sono relativi.

{% hint style="info" %}
I file di upload vengono rinominati in modo casuale al fine di evitare una possibile sovrascrittura di file preesistenti, e pertanto non è possibile risalire manualmente a un qualunque file che è stato caricato.
{% endhint %}


# Moduli


# Dashboard

**Dashboard** è il modulo principale aperto come prima pagina di default da OpenSTAManager.

Grazie al calendario, questo modulo offre una visione generale degli I**nterventi** e attraverso l'applicazione dei filtri permette possibile ridurre il campo di ricerca per uno sguardo più approfondito su determinate operazioni.

![Opzioni di filtraggio](/files/-LZYu_XOIJIbp8yv3a10)

![Calendario](/files/-LZdd1EgmB4ogC2D_dMd)

Attraverso il calendario è inoltre possibile creare un intervento, [clicca qui](/modules/dashboard/creazione#da-calendario) per aprire la pagina di **creazione** di un intervento.

L' utente ha a disposizione delle strutture, chiamate *widget,* che permettono di visualizzare:

* Promemoria contratti da pianificare
* Promemoria attività da pianificare
* Notifiche interne
* Scadenze
* Articoli in esaurimento
* Preventivi in lavorazione
* Contratti in scadenza
* Rate contrattuali
* Stampa calendario
* Attività nello stato da programmare
* Attività confermate

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F8e1rYalOqDuajyd9n5WC%2Ffile.png?alt=media)

Un *widget* molto utile è **Stampa calendario** , cliccando su di esso, specificando *anno* e *mese,* è possibile avere una stampa del calendario.

![Widget Stampa calendario](/files/-LZeVf_h3Ph4bsh8h5XS)

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Dashboard**

![Navigazione dashboard](/files/-LZjJLAJ9FDIKcnbssci)

## Caratteristiche

L' interfaccia della **Dashboard** è personalizzabile rimuovendo o aggiungendo *widget* a piacimento.

Cliccando su un intervento nel calendario è possibile accedere alla schermata di modifica:

![Modifica attività da dashboard](/files/-LZnDmMv7E5ZJmhdVuko)

**Rimozione dei widget**

![Rimozione widget](/files/-LZKpV58jLWY7P4vXqJk)

Se un *widget* è stato rimosso è possibile aggiungerlo tramite il modulo **Strumenti**, cliccando il modulo **Aggiornamenti** selezionando l'ingranaggio del *widget* che si desidera aggiungere.

Dal modulo **Strumenti** è anche possibile disattivare un *widget* attivo, selezionando l'ingranaggio del *widget* che si desidera disattivare.

{% hint style="info" %}
Per maggiori approfondimenti andare sul modulo [Aggiornamenti](/modules/strumenti/aggiornamenti).
{% endhint %}

![Aggiungere o rimuovere Widget](/files/-LZKpftBA367XxCNTTZb)


# Creazione

Utilizzando il calendario presente nella **Dashboard** è possibile aggiungere un intervento trascinando il mouse, come nell'esempio che segue:

{% file src="/files/6UKMUCRXwOpGFr08ElIv" %}
Creazione attività
{% endfile %}

Creando un intervento come precedentemente indicato si hanno a disposizione una serie di campi da compilare, quali:

* Cliente
* Sede
* Per conto di
* Zona(definita automaticamente in base al *cliente* selezionato,per maggiori informazioni, visitare la documentazione del modulo [**Zone**](/modules/anagrafiche/zone))
* Preventivo
* Contratto
* Impianto
* Componenti
* Data e ora richiesta
* Tipo attività
* Stato
* Richiesta
* Inizio attività
* Fine attività
* Tecnici

![Screenshot creazione intervento](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FxCe3FxbvXTRIjzM7I3Hu%2Ffile.png?alt=media)

## Creazione impianto al volo

Nella schermata di creazione di un nuovo intervento è permessa la creazione al volo di un *impianto* relativa al nuovo record. Questa funzionalità viene permessa dal pulsante dedicato a destra del selettore del campo Impianto.

![Screenshot creazione impianto al volo](/files/-LZKpzgCy89kY41p_T4t)

La gestione della creazione viene quindi delegata al modulo **MyImpianti**, permettendo l’inserimento delle informazioni standard documentate nella sezione relativa attraverso un *modal* sovrapposto al resto del contenuto.

![Screenshot creazione impianto al volo](/files/-LZKq3FfLh3It1UuPg6l)

Una volta completata la creazione in questione, l’*impianto* creato verrà automaticamente selezionato.

![Impianto aggiunto](/files/-LZKqB-27WAMvHp4yeIp)


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

## Caratteristiche <a href="#caratteristiche" id="caratteristiche"></a>

Una volta all'interno di questa parte del sistema, il modulo **Anagrafiche** permette di completare *tutte* le informazioni che il gestionale supporta per le anagrafiche. In particolare, per permettere un maggiore senso logico nella navigazione dei dati, la sezione di modifica è suddivisa in 6 raggruppamenti.

* [Dati intervento](#dati-intervento)
* [Ore di lavoro](#ore-di-lavoro)
* [Materiale utilizzato](#materiale-utilizzato)
* [Altre spese](#altre-spese)
* [Costi totali](#costi-totali)
* [Allegati](#allegati)

### Dati intervento

Il primo raggruppamento permette di:

* Cambiare lo **stato** dell'attività
* Aggiungere **note interne**

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FW7M9vurmaZDyBUMlOHe8%2Ffile.png?alt=media)

### Ore di lavoro

Il secondo raggruppamento permette di visualizzare il *Tecnico* assegnato con relativi:

* Orario inizio
* Orario fine
* Ore
* Km
* Sconto ore
* Sconto km

![Screenshot sezione ore di lavoro](/files/-LZdVQF4_gyqo5G1cT3T)

### Materiale utilizzato

**Materiale utilizzato** permette di visualizzare una lista di eventuali materiali utilizzati.

![Screenshot sezione materiale utilizzato](/files/-LZdWX_tWsmkqfCyNWD0)

### Altre spese

**Altre spese** permette la visualizzazione di eventuali spese effettuate necessarie a compiere l'intervento.

![Screenshot sezione altre spese](/files/-LZdWtuJQDFGOlVQjVyq)

### Costi totali

Il raggruppamento **costi totali** visualizza la lista completa delle spese effettuate per l'intervento.

![Screenshot sezione costi totali](/files/-LZdXcnMRDS65ek8YcfV)

### Allegati

L' ultimo raggruppamento è **allegati**, il quale permette di visualizzare eventuali **allegati** caricati.

![Screenshot sezione allegati](/files/CsH4UpHRFwgrrktJM2O2)


# Azioni aggiuntive

Finita la compilazione dei campi è possibile compiere diverse operazioni, presenti in alto a destra, quali:

* Stampa intervento
  * Stampa intervento (senza prezzi)
* Invia rapportino intervento
  * Invia notifica intervento
  * invia notifica rimozione intervento
  * invia stato intervento
* Anteprima e firma
* Duplica attività

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FCHr4Hkgcmvz9KpvXddqd%2Ffile.png?alt=media)


# Anagrafiche

{% hint style="info" %}
Il modulo **Anagrafiche** permette all’azienda di archiviare tutte le informazioni riguardanti gli individui e gli enti con cui si instaura una relazione lavorativa.
{% endhint %}

![Screenshot Anagrafiche](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FL9jxnCVWCwJY2W1pjbm0%2Ffile.png?alt=media)

Proprio per facilitare la categorizzazione di questi *stakeholder*, sono disponibili cinque principali tipologie di anagrafiche:

* Agenti
* Clienti
* Fornitori
* Tecnici
* Vettori

Il gestionale permette inoltre di memorizzare le informazioni relative ai referenti aziendali e alle sedi lavorative delle società esterne, generando autonomamente statistiche basilari riguardanti interventi eseguiti, fatture emesse, preventivi effettuati e contratti lavorati.

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Anagrafiche**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FLs4k5TwrOATHMnBZcMjX%2Ffile.png?alt=media)

## Caratteristiche

Questo modulo possiede un modulo incentrato sulla gestione delle zone lavorative (denominato [**Zone**](/modules/anagrafiche/zone)) e uno sulle relazioni, raggiungibili all'espansione del menu laterale.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FegH49d56NeAchNg8yfQX%2Ffile.png?alt=media)

La schermata principale del modulo è strutturata secondo la tabella generale predefinita, e presenta 6 widget per il filtraggio automatico delle anagrafiche per tipo:

* Agenti
* Clienti
* Fornitori
* Tecnici
* Vettori
* Tutti

![](/files/-LZsN_a-cuE3XDgORgjJ)

Sono inoltre presenti 7 [plugin](/modules/anagrafiche/plugin) nella sezione di modifica del modulo:

* [Impianti del cliente](/modules/anagrafiche/plugin/impianti-del-cliente)
* [Dichiarazioni d'intento](/modules/anagrafiche/plugin/dichiarazioni-dintento)
* [Storico attività](/modules/anagrafiche/plugin/storico-attivita)
* [Ddt del cliente](/modules/anagrafiche/plugin/ddtdelcliente)
* [Statistiche](/modules/anagrafiche/plugin/statistiche)
* [Sedi](/modules/anagrafiche/plugin/sedi)
* [Referenti](/modules/anagrafiche/plugin/referenti)

Di questi, **Ddt del cliente** e **Impianti del cliente** sono utilizzabili esclusivamente per anagrafiche di tipo *Cliente*.

## Particolarità

{% hint style="info" %}
Il modulo presenta la possibilità di creare una singola anagrafica di tipo *Azienda* per motivi logico-funzionali. Questa anagrafica viene inoltre memorizzata nelle impostazioni di OpenSTAManager sotto l'impostazione nascosta **Azienda predefinita**.

Inoltre, l'eventuale eliminazione dei *record* viene effettuata a livello logico, per evitare di rimuovere informazioni necessarie al resto del gestionale. Sarà quindi possibile ripristinare, sotto richiesta di assistenza, eventuali elementi rimossi erroneamente.
{% endhint %}


# Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Creazione anagrafica](/files/-LZYz6ltVRK5i8w-0SL2)

{% hint style="info" %}
Il modulo **Anagrafiche** presenta quindi la possibilità di inserire le informazioni relative alla nuova anagrafica da creare, mostrando di default una versione basilare delle informazioni richieste. Eventualmente, è possibile inserire maggiori informazioni fin dalla creazione sfruttando la sezione **Dati anagrafici**.
{% endhint %}

![Screenshot creazione anagrafica](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fy38a1Fa25wCrAzwYmkRX%2Ffile.png?alt=media)

## Caratteristiche

{% hint style="info" %}
La versione standard del sistema di creazione anagrafica richiede esclusivamente l'inserimento della *Denominazione* e la selezione della relativa tipologia,o al suo posto, *Nome* e *Cognome*.

Nella versione estesa, come visibile dalle immagini sovrastanti, è possibile procedere al completamento di *Partita IVA*, *Codice Fiscale*, e della maggior parte delle informazioni relative alla sede legale e alle opzioni di contatto dell'anagrafica.
{% endhint %}


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

## Caratteristiche

Una volta all'interno di questa parte del sistema, il modulo **Anagrafiche** permette di completare *tutte* le informazioni che il gestionale supporta per le anagrafiche. In particolare, per permettere un maggiore senso logico nella navigazione dei dati, la sezione di modifica è suddivisa in 6 raggruppamenti:

* [Dati anagrafici](#dati-anagrafici)
* [Sede legale](#sede-legale)
* [Informazioni per tipo di anagrafica](#informazioni-per-tipo-di-anagrafica)
* [Informazione aggiuntive](#informazioni-aggiuntive)
* [Allegati](#allegati)

### Dati anagrafici

Il primo raggruppamento di informazioni sull'anagrafica consiste nell'insieme dei dati anagrafici relativi.

Attraverso questa sezione, è possibile procedere alla modifica delle informazioni di base dell'anagrafica in questione:

* Ragione sociale
* Tipologia (Azienda/Privato/Ente pubblico)
* Informazioni sulla nascita (o fondazione)
* Sesso
* Codice interno dell'anagrafica
* Indirizzo PEC
* Sito web

![Screenshot modifica anagrafica](/files/-LZZ1IGCzIqa5Xgfs81t)

### Sede legale

Viene quindi presentata una selezione di campi relativi alle informazioni sulla *sede legale* dell'anagrafica, quali:

* Partita IVA
* Codice fiscale
* Informazioni varie sulla sede (per maggiori informazioni, visitare la sezione [Sedi](/modules/anagrafiche/plugin/sedi))

In particolare, se l'impostazione [**Google Maps API key**](/modules/anagrafiche/maps) viene impostata, sarà possibile visualizzare attraverso Google Maps l'indirizzo indicato ed eventualmente definire manualmente longitudine e latitudine.

![Screenshot sezione sede legale](/files/-LZZ1MdO08K6P4heTM9K)

### Informazioni per tipo di anagrafica

Questo raggruppamento permette di impostare dei valori predefiniti in base al tipo di anagrafica

#### Cliente

* Attività predefinita
* Pagamento
* Relazioni con il cliente
* Iva
* Indirizzo di fatturazione
* Banca
* Ritenuta d'acconto
* Piano di sconti/rincaro su articoli
* Agenti
* Piano dei conti cliente

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FSszmLd27tPFZqSdxBTfw%2Ffile.png?alt=media)

#### Fornitore

* Pagamento
* Iva
* Banca
* Ritenuta d'acconto
* Piano di sconti/rincaro su articoli
* Piano dei conti cliente

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fo49leVxu8hsEBfV96Or7%2Ffile.png?alt=media)

#### Cliente e Fornitore

* Split payment
* Dicitura fissa in fattura

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FDpTd32Sx7EGaU1jT99Jt%2Ffile.png?alt=media)

#### Tecnico

* Colore

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FgBkRUQGtr08yMCBhTgsA%2Ffile.png?alt=media)

### Informazioni aggiuntive

L'ultimo raggruppamento di informazioni presenta una serie di elementi non fondamentali per ogni tipologia di anagrafica, ma che potrebbero essere utili in base alle necessità dell'utente (tra cui la possibilità di cambiare la tipologia dell'anagrafica).

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fbt2TaA1GFEPWP7K4gBKB%2Ffile.png?alt=media)

### Allegati

In questa sezione è possibile caricare un file dal proprio computer specificandone la categoria.

{% hint style="warning" %}
**Attenzione:** Selezionando l'anagrafica **Azienda** è possibile impostare il logo dell'azienda, caricando un file immagine (jpg,png,...) con risoluzione 302 x 111 , specificando sul campo **Nuovo allegato** il nome **Logo stampe**. Il logo caricato su questa anagrafica permetterà di visualizzare in tutte le stampe cartacee il logo precedentemente caricato( ad esempio sulla stampa di una attività, di una fattura di vendita, di un preventivo, etc...)
{% endhint %}

![](/files/-MWOnW1qCKXr72T8QHxO)

## Altro

In alcuni casi, l'eliminazione dell'anagrafica viene impedita.

Questa condizione si verifica quando esiste un collegamento interno dell'elemento con altre componenti del gestionale.

![Screenshot documenti collegati](/files/-LZZ1fB_GDd40gddCu95)

Una volta completata la creazione del nuovo elemento anagrafico, il gestionale provvederà a creare i relativi conti per il **Partitario** se l'anagrafica è di tipo *Cliente* oppure *Fornitore*.

## Fatturazione Elettronica

{% hint style="info" %}
Per quanto riguarda la **Fatturazione Elettronica** è stata creata una sezione apposita, [clicca qui](/faq/fatturazione-elettronica) per visualizzarla!
{% endhint %}


# Zone

{% hint style="info" %}
Il modulo **Zone** è dedicato alla gestione delle eventuali suddivisioni, da parte dell'azienda, del territorio in aree. Grazie ad esso, è possibile assegnare specifiche anagrafiche ad una zona di servizio per tecnici specifici e gestire in modo dinamico le attività visualizzate nella **Dashboard**.
{% endhint %}

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Zone** visibile dall'espansione del menu **Anagrafiche**.

![](/files/-MWOnVnrsVmTZeXclO3O)


# Maps

{% hint style="info" %}
Nella modifica e nella fase di creazione di una nuova **anagrafica** è possibile visualizzare attraverso *Google Maps* l'indirizzo indicato ed eventualmente definire manualmente latitudine e longitudine.
{% endhint %}

Per fare ciò basta cliccare sopra il link mostrato nella figura sottostante

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FBRVHan5ta23dwqYu6Mgw%2Ffile.png?alt=media)

Successivamente si verrà indirizzati in *impostazioni* in modo di abilitare la visualizzazione delle anagrafiche nella mappa compilando alcuni campi.

Per visualizzare la posizione è obbligatorio compilare il campo *Google Maps API Key*.

## Come ottenere Google Maps API Key

1. Cliccare su questo link: [https://cloud.google.com/maps-platform/?\_\_utma=102347093.1283278314.1550498378.1550499031.1550499031.1&\_\_utmb=102347093.0.10.1550499031&\_\_utmc=102347093&\_\_utmx=-&\_\_utmz=102347093.1550499031.1.1.utmcsr=google|utmccn=(organic)|utmcmd=organic|utmctr=(not provided)&\_\_utmv=-&\_\_utmk=128107788&\_ga=2.39899682.1839265660.1550498378-1283278314.1550498378#get-started](https://cloud.google.com/maps-platform/?__utma=102347093.1283278314.1550498378.1550499031.1550499031.1&__utmb=102347093.0.10.1550499031&__utmc=102347093&__utmx=-&__utmz=102347093.1550499031.1.1.utmcsr=google%7Cutmccn=%28organic%29%7Cutmcmd=organic%7Cutmctr=%28not%20provided%29&__utmv=-&__utmk=128107788&_ga=2.39899682.1839265660.1550498378-1283278314.1550498378#get-started)

Apparirà questa schermata:

![Screenshot creazione API Key](/files/-LZKssaSCAEXj1GYfcZ_)

Fare la spunta su tutte e 3 le caselle e premere ![](/files/-LZtZ6oq44PIvkqAu_JR) .

(Maps API, Geocoding API, Places API)

* Entrare con la vostra email
* Inserire email

![](/files/adi5ZVXQg00HqDKE39ye)

* Inserire password

![](/files/wxN7RI5FqeVJF4uEyVlL)

* Se appare nuovamente la schermata del punto uno fare nuovamente la spunta sulle 3 caselle, se non appare, invece, apparirà questa schermata:

![Abilitare google maps platform](/files/-LZKtH0LjT6rJx4KDpph)

* Selezionare **Yes** e cliccare su ![](/files/-LZsu0u6Rrkubtc5_BLh) , comparirà questa finestra:

![Abilita fatturazione per il progetto](/files/-LZKtNQTwl0U_MOZE6AJ)

* Cliccare su ![](/files/-LZstangSXs-cObVY2uN) **:**

![Accettazione termini di servizio](/files/-LZKtQfnOaXf4lY57d-l)

* Cliccare su ![](/files/-LZstfiGtqTfPgQqbdDW) , accettando i termini di servizio
* Compilare i campi campi richiesti e cliccare su ***AVVIA LA MIA PROVA GRATUITA***

{% hint style="warning" %}
**Attenzione:** Mettendo i dati della carta di credito non verrà fatto alcun addebito, sono richiesti solamente per verifica. Se si prova in qualche modo a saltare l'inserimento del metodo di pagamento e a generare comunque l'API, essa non funzionerà. L'inserimento del metodo di pagamento è obbligatorio.
{% endhint %}

![API e servizi](/files/-LZKtdND8MLUWoD_hX2p)

Successivamente cliccare sulle 3 linee in alto a sinistra,andare su **API e servizi** e selezionare ![](/files/-MWOnSRhorXgIZCI6FOc)

![Generazione API Key](/files/-LZKtjbilILiB2lFDp53)

Cliccare su ![](/files/-LZstTV8OIQgitT4zgWO) , selezionare *Chiave API*. Ora la chiave API è stata creata.


# Azioni aggiuntive

Selezionando o creando un *record* in **Anagrafiche** sono presenti nella parte in alto a destra degli strumenti che consentono diverse opzioni, quali:

* Stampa dettaglio anagrafica
  * Stampa dati aziendali
* Crea
  * Nuova attività
  * Nuovo preventivo
  * Nuovo contratto
  * Nuovo ordine cliente
  * Nuovo ddt in uscita
  * Nuova fattura di vendita
  * Nuova registrazione contabile


# Plugin


# Impianti del cliente

{% hint style="info" %}
Il plugin **Impianti del cliente** è una componente del modulo **Anagrafiche** che permette di visualizzare gli impianti collegati all'anagrafica di tipo cliente.
{% endhint %}

## Caratteristiche

È possibile creare e collegare un impianto ad un'anagrafica di tipo cliente dal modulo [Impianti](/modules/impianti).

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FU3BmfknIEzP68wIFLoDD%2Ffile.png?alt=media)


# Dichiarazioni d'intento

{% hint style="info" %}
l plugin **Dichiarazioni d'intento** è una componente del modulo **Anagrafiche** dedicata alla completa gestione di tutte le eventuali dichiarazioni d'intento.
{% endhint %}

## Caratteristiche

Grazie a questo plugin é possibile aggiungere o modificare le dichiarazione d'intento specificando le seguenti informazioni

* Data ricezione
* Numero protocollo
* Numero progressivo
* Data inizio
* Data fine
* Massimale
* Data protocollo
* Data emissione

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F3To1UI2CpziNrQnSXxjW%2Ffile.png?alt=media)


# Storico attività

{% hint style="info" %}
Il plugin **Storico attività** è una componente del modulo **Anagrafiche** dedicata al riepilogo delle attività.
{% endhint %}

## Caratteristiche

Grazie a questo plugin è possibile visualizzare tutte le attività collegate all'anagrafica

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FGmQjknTbw6B9e0p4J4Mc%2Ffile.png?alt=media)


# Statistiche

{% hint style="info" %}
Il plugin **Statistiche** è una componente del modulo **Anagrafiche** dedicata al riepilogo.
{% endhint %}

## Caratteristiche

Il plugin presenta 6 sezioni che portano ai rispettivi moduli, quali:

* Interventi
* Preventivi
* Contratti
* Fatture
* Ordini cliente
* DDT in uscita

È possibile inoltre selezionare uno o più periodi temporali.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FQTMcav6KwTAEP3oVJsOy%2Ffile.png?alt=media)


# Sedi

{% hint style="info" %}
Il plugin **Sedi** è una componente del modulo **Anagrafiche** dedicata alla completa gestione di tutte le eventuali sedi delle anagrafiche registrate all'interno di OpenSTAManager.
{% endhint %}

## Navigazione

Il plugin è raggiungibile, all'interno dell'area di modifica di un *record* del modulo **Anagrafiche**, attraverso il menu dedicato sotto la dicitura **Sedi**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FjoZwwA0nmHwTOgrrIB69%2Ffile.png?alt=media)

## Caratteristiche

La schermata principale del plugin è strutturata secondo la tabella generale predefinita, presentando inoltre la possibilità di creare e modificare gli elementi attraverso strutture grafiche che si sovrappongono agli altri contenuti (*modal*).

### Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del plugin.

Viene quindi reso possibile compilare tutte le informazioni di base relative alla nuova sede da creare:

* Nome sede
* Indirizzo
* Codice destinatario
* Città
* CAP
* Provincia
* Km
* Nazione
* Zona (per maggiori informazioni, visitare la documentazione del modulo [**Zone**](/modules/anagrafiche/zone))
* Cellulare
* Telefono
* Indirizzo email

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F0moxETvNmaEd7gYJsBLx%2Ffile.png?alt=media)

### Modifica

La schermata di modifica, sebbene molto simile a quella di creazione, permette in particolare di impostare altre informazioni secondarie.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FFkZ2iucjuXlwBDU44Fhf%2Ffile.png?alt=media)

In particolare, se l'impostazione [**Google Maps API key**](/modules/anagrafiche/maps) viene impostata, sarà possibile visualizzare attraverso Google Maps l'indirizzo indicato ed eventualmente definire manualmente longitudine e latitudine.

## Particolarità

{% hint style="info" %}
La sede legale, predefinita per l'anagrafica, non viene registrata allo stesso modo delle altre sedi. Sarà pertanto impossibile eliminare completamente la sede legale da un'anagrafica.
{% endhint %}


# Ddt del cliente

{% hint style="info" %}
Il plugin **Ddt del cliente** è una componente del modulo **Anagrafiche** dedicata alla completa visualizzazione dei Ddt del cliente.
{% endhint %}

{% hint style="warning" %}
**Attenzione:** i ddt senza righe non saranno visualizzati.
{% endhint %}

## Navigazione

Il plugin è raggiungibile, all'interno dell'area di modifica di un *record* del modulo **Anagrafiche**, attraverso il menu dedicato sotto la dicitura **Ddt del cliente**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FXMlEBABZrTJ8gA4hPYku%2Ffile.png?alt=media)


# Referenti

{% hint style="info" %}
Il plugin **Referenti** è una componente del modulo **Anagrafiche** dedicata alla completa gestione degli eventuali referenti relativi alle anagrafiche registrate all'interno di OpenSTAManager.
{% endhint %}

Può essere sfruttato per creare una rubrica di contatti per l'anagrafica e indicare una specifica persona rilevante per eventuali **Attività**, **Contratti** e **Preventivi**.

## Navigazione

Il plugin è raggiungibile, all'interno dell'area di modifica di un *record* del modulo **Anagrafiche**, attraverso il menu dedicato sotto la dicitura **Referenti**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fe8Wrkr5RkwE3h9GyTe2j%2Ffile.png?alt=media)

## Caratteristiche

La schermata principale del plugin è strutturata secondo la tabella generale predefinita, presentando inoltre la possibilità di creare e modificare gli elementi attraverso strutture grafiche che si sovrappongono agli altri contenuti (*modal*).

### Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del plugin.

![Aggiungere un referente](/files/-LZnO6tCB_cez6k_4N64)

Viene quindi reso possibile compilare tutte le informazioni di base relative al nuovo referente da registrare:

* Nominativo
* Mansione
* Telefono
* Indirizzo email
* Sede (per maggiori informazioni, visitare la documentazione del plugin [**Sedi**](/modules/anagrafiche/plugin/sedi))

![Screenshot creazione referenti](/files/-LZiAVwUD1Yf3wphz1Zh)

### Modifica

La schermata di modifica risulta identica a quella di creazione, permettendo in aggiunta l'eventuale eliminazione del referente dal sistema.

![Screenshot modifica referenti](/files/-LZiCTxg6xWrgFcWUjM9)


# Import anagrafiche

{% hint style="info" %}
È possibile importare le anagrafiche in maniera massiva tramite il caricamento di un file CSV.
{% endhint %}

### Procedura

Accedere dal menù di OpenStaManager al modulo [Import](/modules/strumenti/import) e impostare **Anagrafiche** nel menù a tendina, dopo aver selezionato il modulo sarà visibile un nuovo pulsante nella schermata "Scarica esempio CSV".\
Cliccando su questo pulsante si aprirà un file di esempio di come importare le anagrafiche tramite il file CSV.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FKAYcjU46Mt551Js0WFWg%2Ffile.png?alt=media)

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fd2zONN3MJ2hKZcXEia83%2Ffile.png?alt=media)

A questo punto si può iniziare a creare il file CSV per l'importazione delle anagrafiche, utilizzare gli stessi nomi delle colonne per automatizzare l'importazione dei dati.

{% hint style="info" %}
Nel campo Tipo è possibile inserire **Cliente**, **Fornitore**, **Tecnico**, **Agente**.
{% endhint %}

Una volta che il file CSV è pronto per essere caricato seguire le istruzioni del modulo [Import](/modules/strumenti/import) per completare l'importazione.


# Gestione email


# Account email

{% hint style="info" %}
Il modulo **Account email** permette all’azienda di gestire tutte le informazioni riguardanti gli account email utilizzati da OpenSTAManager per l'eventuale invio di email con contenuti specifici dei diversi moduli.
{% endhint %}

Questo modulo è complementare a [**Template email**](/modules/email/template), che si occupa di gestire le informazioni di base dell'email da inviare.

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Account email** visibile dall'espansione del menu **Gestione email**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FHyJwCYCIqxU8YDElgTQd%2Ffile.png?alt=media)

## Caratteristiche

La schermata principale del modulo è strutturata secondo la tabella generale predefinita.

![Screenshot interfaccia Account email](/files/-LZiD1yfQnmgpd9ZjjpR)

### Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Screenshot creazione account email](/files/-LZd6E8louTOOscvRUSm)

Viene quindi data la possibilità di completare le informazioni di base del nuovo account email, quali:

* Nome dell'account
* Nome mostrato nelle email
* Indirizzo email

![Screenshot creazione Account email](/files/-LZd6ToPMFMHqa_Hp3Z1)

Il completamento di ulteriori informazioni viene permesso dalla schermata di modifica.

### Modifica

La schermata di modifica permette il completamento di tutte le informazioni che possono essere sfruttate per l'accesso all'account email specificato.

In particolare, vengono resi disponibili i seguenti campi relativi alla gestione di account SMTP:

* Server SMTP
* Username SMTP
* Password SMTP
* Porta SMTP
* Sicurezza SMTP

![Screenshot modifica Account email](/files/-LZd6g8IbJS7OXHNtbGj)

Viene inoltre permessa l'impostazione di un qualsiasi account email come predefinito per la creazione di nuovi template e la segnalazione di eventuali bug.

## Particolarità

{% hint style="info" %}
L'account email predefinito impostato nelle versioni precedenti attraverso le impostazioni viene importato come *Account email da Impostazioni*.
{% endhint %}


# Template email

{% hint style="info" %}
Il modulo **Template email** permette all’azienda di gestire le informazioni di base riguardanti i contenuti e le caratteristiche delle email che OpenSTAManager può eventualmente procedere a inviare.
{% endhint %}

Questo modulo è complementare a [**Account email**](/modules/email/account), che si occupa di gestire le informazioni degli account email utilizzati per l'invio delle email.

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Template email** visibile dall'espansione del menu **Gestione email**.

![Screenshot navigazione template email](/files/-LZcyRUdR3i1_8qV_yGr)

## Caratteristiche

La schermata principale del modulo è strutturata secondo la tabella generale predefinita.

![Screenshot caratteristiche template email](/files/-LZcyUSDP22FIoYfg2-q)

### Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F5lrjxYwVrSzCa2jBCP9D%2Ffile.png?alt=media)

Viene quindi data la possibilità di completare le informazioni di base del nuovo template, quali:

* Nome del template
* Modulo relativo al template
* Oggetto del template
* [Account email](/modules/email/account) da utilizzare

![Screenshot creazione template email](/files/-LZcysuUwrYN08e9F9Xc)

Il completamento di ulteriori informazioni viene permesso dalla schermata di modifica.

### Modifica

La schermata di modifica permette il completamento di tutte le informazioni riguardanti il template.

In particolare, oltre ai campi previsti alla creazione, vengono resi disponibili i seguenti attributi:

* Notifica di lettura (per richiederla)
* Icona
* CC
* CCN
* Rispondi a
* Stampe da allegare (di default)
* Contenuto

![Screenshot modifica template email](/files/-LZczROVkGkBevQ0dzxW)

Tra questi campi, *Contenuto* e *Oggetto* prevedono un sistema di autocompletamento per alcuni particolari valori definiti dal modulo. L'elenco completo di questi elementi viene reso disponibile nella sezione informativa **Istruzioni per i campi automatici**.

![Screenshot campi automatici template email](/files/-LZd-AtHSTImCyra6Ums)

La sostituzione di queste componenti dipende dai contenuti del *record* da cui viene inviata l'email. Per maggiori informazioni, visitare la documentazione di [invio email](/modules/email/invio).

È inoltre presente il pulsante **Duplica template** che permette di duplicare un template precedentemente creato.

## Particolarità

Sono presenti dei template predefiniti per diversi moduli, personalizzabili a piacimento.

{% hint style="info" %}
Inserendo un'indirizzo email nel campo "**CC**" di un relativo **Template** ogni email verrà inviata anche all'indirizzo email inserito in "**CC"** oltre al destinatario principale dell'email. Questo, per esempio, può essere utile se voglio inviare un'email ad un **Cliente** e al commercialista.
{% endhint %}


# Newsletter

{% hint style="info" %}
Il modulo **Newsletter** permette all’azienda di inviare simultaneamente più mail ad un gruppo di indirizzi utilizzando un testo fisso.\
È possibile creare dei gruppi predefiniti di indirizzi email grazie al modulo Liste.
{% endhint %}

Questo modulo è complementare a [Liste](/modules/email/liste) e [Template email](/modules/email/template), che si occupa di creare dei gruppi predefiniti di indirizzi email da utilizzare per l'invio delle **NewsLetter**, mentre il secondo \*\*\*\* si occupa di gestire le informazioni di base dell'email da inviare.

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Newsletter** visibile dall'espansione del menu **Gestione email**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FRAHkUDBlTx6lcByhbUGe%2Ffile.png?alt=media)

## Caratteristiche

La schermata principale del modulo è strutturata secondo la tabella generale predefinita.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FIs9sJVL33sGjVSq6qDGM%2Ffile.png?alt=media)

### Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

Viene quindi data la possibilità di completare le informazioni di base della Newsletter, quali:

* [Template email](/modules/email/template) da utilizzare
* Nome

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FFRDZKQMId1VtLPrOgcpL%2Ffile.png?alt=media)

Il completamento di ulteriori informazioni viene permesso dalla schermata di modifica.

### Modifica

La schermata di modifica permette il completamento di tutte le informazioni riguardanti la **Newsletter**.

In particolare, oltre ai campi previsti alla creazione, vengono resi disponibili i seguenti attributi:

* Stato
* Oggetto
* Contenuto

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FzzHEarcwKhfisKqtw2hF%2Ffile.png?alt=media)

* Destinatari, è possibile selezionare i destinatari della **Newsletter**
* Lista, sono presenti tutte le liste inserite nel modulo [Liste](/modules/email/liste)

Una volta selezionati i destinatari o la lista in base alle necessità, tramite il pulsante **+ Aggiungi** vengono inseriti i vari indirizzi email nella tabella Destinatari in cui sono presenti tutti i destinatari della **Newsletter.**

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FUdA9FzjZfrRK7mxBs7HW%2Ffile.png?alt=media)

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FR1rq7PDXhkczcKLrUETq%2Ffile.png?alt=media)

È possibile inoltre inserire degli allegati alla **Newsletter**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fg4KQ21T1LB8PWMpJ1P2m%2Ffile.png?alt=media)

### Invio

Una volta aggiunte tutte le informazioni e averle salvate si può procedere all'invio della Newsletter cliccando sul pulsante apposito ad inizio schermata.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fzmttti46e1qIEDYQ6HJV%2Ffile.png?alt=media)


# Liste

{% hint style="info" %}
Il modulo **Liste** permette all’azienda di creare dei gruppi di destinatari da utilizzare nell' invio delle **email.**
{% endhint %}

Questo modulo è complementare a [Newsletter](/modules/email/newsletter), che si occupa dell'invio email a più destinatari.

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Liste** visibile dall'espansione del menu **Gestione email**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FcZ2KKn4BVE3EWqPYICiD%2Ffile.png?alt=media)

## Caratteristiche

La schermata principale del modulo è strutturata secondo la tabella generale predefinita.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FjyOPGay6HHqWOF8iYMU1%2Ffile.png?alt=media)

### Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

Viene quindi data la possibilità di inserire il nome della lista.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FQ8HXdaJR5cDoZg0fmwWr%2Ffile.png?alt=media)

### Modifica

La schermata di modifica permette il completamento di tutte le informazioni riguardanti la **Lista**.

In particolare, oltre al campo **Nome** previsto alla creazione, vengono resi disponibili i seguenti attributi:

**Descrizione**\
In questo campo è possibile aggiungere o aggiornare la descrizione della lista.

**Query dinamica**\
\*\*\*\*L'utilizzo di questo campo esclude la possibilità di inserire i destinatari tramite il menù a tendina "*Destinatari"* presente nella sezione Aggiunta destinatari.\
Le informazioni inserite in questo campo devono essere scritte con il linguaggio sql;\
*Esempio*: "**SELECT idanagrafica AS id FROM an\_anagrafiche"** aggiungerà tutte le anagrafiche nella tabella Destinatari.

**Destinatari**\
In alternativa, lasciando vuoto il campo *Query dinamica* è possibile aggiungere i vari destinatari tramite il menù a tendina, cliccando su aggiungi infatti, verranno inseriti i destinatari sulla tabella corrispondente.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F9SgkV6IU5Xvp6HLCLSnK%2Ffile.png?alt=media)

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FJNMgVuIL6m4j9IvNhxRY%2Ffile.png?alt=media)


# Aruba

{% hint style="info" %}
Per configurare correttamente un account email Aruba all'interno di OpenSTAManager è necessario completare nel seguente modo le informazioni dell'elemento del modulo [**Account email**](/modules/email/account):
{% endhint %}

* *Server SMTP*: `smtp.miodominio.ext`
* *Username SMTP*: indirizzo email (<example@miodominio.ext>, oppure <example@miodominio.ext>)
* *Porta SMTP*: `25`
* *Sicurezza SMTP*: `Nessuna`

![Screenshot creazione account email aruba](/files/-MWOnXBnY2hTMk7xbiHw)

## Particolarità

{% hint style="warning" %}
Nel caso in cui si continui a verificare l'errore: `PHPMailer: SMTP Error: Could not connect to SMTP host`, provare a disabilitare l'estensione PHP `openssl`.
{% endhint %}


# Gmail

{% hint style="info" %}
Per configurare correttamente un account email Gmail all'interno di OpenSTAManager è necessario completare nel seguente modo le informazioni dell'elemento del modulo [**Account email**](/modules/email/account):
{% endhint %}

* *Server SMTP*: `smtp.gmail.com`
* *Username SMTP*: indirizzo email (<example@gmail.com>, oppure <example@domain.com>)
* *Porta SMTP*: `587`
* *Sicurezza SMTP*: `TLS`

![Screenshot creazione account email gmail](/files/-LZd04mMgZegwJUb39OC)

Se l'account da utilizzare è protetto attraverso il sistema di autenticazione a due fattori, visitare la [sezione relativa](https://github.com/devcode-it/devcode-it.github.io/tree/c372246fd4462ad0101f4f643f1719d85d3d3249/_openstamanager/guide/modules/email/autenticazione-a-due-fattori/README.md). In alternativa, procedere con la guida *Applicazione meno sicure*.

## Applicazione meno sicure

Nel caso **non** sia abilitata l'autenticazione a due fattori, è necessario procedere ad abilitare l'accesso da applicazioni meno sicure attraverso le impostazioni dell'account Google: <https://myaccount.google.com/lesssecureapps>.

![Consenso app meno sicure](/files/-LZd0QSJN3QO6eOKFaD8)

E' quindi necessario inserire nel campo *Password SMTP* dell'account del gestionale la password originale dell'account Gmail.

## Autenticazione a due fattori

Se l'autenticazione a due fattori è abilitata, è necessario creare una chiave di accesso Google nella sezione dedicata: <https://myaccount.google.com/apppasswords>.

Una volta visitato il link precedente, comparirà il seguente contenuto. Sarà necessario selezionare il valore `Altra` del campo *Seleziona app*.

![Screenshot autenticazione a due fattori](/files/-LZd4ZBSZL3stZZxCZ-z)

Verrà quindi reso disponibile un campo per la denominazione della nuova chiave. Una volta compilato il nome, cliccare sul pulsante ![](https://github.com/devcode-it/openstamanager-docs/tree/5242b6a23c677db2f5451152c8e4c4aded3a99cf/.gitbook/assets/genera-1.PNG) .

![Screenshot autenticazione a due fattori](/files/-LZd4aQnKFFZmKOetalZ)

Comparirà quindi un messaggio di avvertenza relativo all'utilizzo della nuova chiave, che sarà copiabile dal testo evidenziato in giallo.

![Password per l'app generata](/files/-LZd4cfwAAaBb2ctfO_n)

E' necessario inserire questa chiave nel campo *Password SMTP* dell'account del gestionale.


# Invio

{% hint style="info" %}
La funzione di invio email è una caratteristica integrata in OpenSTAManager, che si basa sulle strutture fornite dai moduli **Account email** e **Template email** per semplificare la gestione delle informazioni relative.
{% endhint %}

Il sistema è accessibile all'interno di ogni *record* dei moduli che possiedono almeno un template collegato, ed è accessibile attraverso il pulsante dedicato nella sezione in alto a destra della schermata.

## Completamento

Una volta cliccato sul pulsante relativo al template email da inviare, viene mostrata la seguente struttura grafica che si sovrappone agli altri contenuti (*modal*).

![Screenshot compilazione email](/files/-LZd5J3CM1HqVIYSh-E-)

Viene quindi reso possibile modificare alcuni valori predefiniti del template, quali:

* Oggetto
* Contenuto
* Notifica di lettura
* Stampe da allegare

Viene inoltre fornita la possibilità, oltre ad impostare manualmente i destinatari, di allegare alcuni upload dell'anagrafica Azienda predefinita e dell'elemento di cui si sta effettuando la condivisione.

## Particolarità

{% hint style="warning" %}
Nel caso l'account email legato al template non sia stato completato correttamente, viene mostrato un messaggio di avvertenza relativo.
{% endhint %}


# Gestione documentale

## Gestione documentale

{% hint style="info" %}
Il modulo **gestione documentale** permette di creare un elenco di *documenti* gestibili per categoria.
{% endhint %}

![Screenshot interfaccia gestione documentale](/files/-LZd74nmQQFZSpsCxBKO)

### Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Gestione Documentale**.

![Screenshot navigazione gestione documentale](/files/-LZKuE4mu_RZCol6HiFp)


# Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Screenshot creazione gestione documentale](/files/-LZKuH_c3rs-KYTwp6wM)

Il modulo **Gestione documentale** presenta la possibilità di gestire una serie di documenti attraverso la compilazione di alcuni campi, quali:

* Nome
* Categoria
* Data

![Screenshot creazione gestione documentale](/files/-LZKuLjKzzmpD0xgiB4D)

Il completamento di ulteriori informazioni viene permesso dalla schermata di modifica.


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FRPEJUw30SLfp3qn6EZLj%2Ffile.png?alt=media)

Così facendo è possibile modificare:

* Nome
* Categoria
* Data

In aggiunta è possibile allegare un file al documento.

{% hint style="info" %}
Quando vado a caricare un allegato in qualsiasi schermata, viene creata una **categoria** in base a quella indicata, in questo modo , quando vado a caricare un nuovo allegato mi appaiono tra i consigliati le diverse categorie precedentemente create permettendo così di creare delle sezioni. E' comunque possibile creare una nuova categoria.
{% endhint %}


# Categorie documenti

{% hint style="info" %}
Nel modulo **Categorie documenti** vengono gestite le categorie per i documenti utilizzabili nella sezione ***Categoria*** nella creazione nel modulo **Gestione Documentale**.
{% endhint %}

![Screenshot interfaccia categorie documenti](/files/-LZKv8JWST2_tX2W5ua_)

## Navigazione

Il modulo **Categorie documenti** è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Gestione Documentale**.

![Screenshot navigazione categorie documenti](/files/-LZKvD284JEU-Zkkgpv3)


# Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Screenshot creazione categorie documenti](/files/-LZKvMhHo4DETPMJqtl_)

Successivamente si può proseguire alla creazione della categoria.

![Screenshot creazione categorie documenti](/files/-LZKvPCY-vCETb8gfFza)

Il completamento di ulteriori informazioni viene permesso dalla schermata di [modifica](/modules/gestionedocumentale/categoriedocumenti/modifica1).


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

Così facendo è possibile modificare la descrizione di un *record*.

![Screen modifica categorie documenti](/files/-LZKvSsDjtSDqRurGGYI)


# Attività

{% hint style="info" %}
Il modulo **Attività** risulta essere una delle componenti fondamentali di OpenSTAManager, dedicata alla completa gestione delle attività di assistenza effettuata dai tecnici aziendali.

Questa sezione si contraddistingue, in particolare, per la possibilità di fissare in modo dinamico gli appuntamenti lavorativi e gestire contemporaneamente molteplici tecnici con le relative tariffe (oraria, al km e sul diritto di chiamata).
{% endhint %}

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FyO0gHnbakLJpA4dPRw5m%2Ffile.png?alt=media)

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Attività**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FPNGintkDBpinVMIBVHxD%2Ffile.png?alt=media)

## Caratteristiche

Questo modulo possiede 3 moduli, raggiungibili all'espansione del menu laterale e dedicati alla gestione di diverse caratteristiche delle attività:

* [Tipi di attività](/modules/attivita/tipidiattivita)
* [Stati di attività](/modules/attivita/statidiattivita)
* [Tecnici e tariffe](/modules/attivita/tecnicietariffe)

## Particolarità

Il modulo presenta la possibilità di integrare/trasformare l'attività in una fattura.

E' possibile ottenere una visualizzazione grafica degli interventi attraverso il modulo **Dashboard**, che permette inoltre di filtrare in modo piuttosto avanzato i contenuti da mostrare.

{% hint style="info" %}
E' inoltre disponibile, per gli utenti di tipo *Tecnici*, un sistema di sincronizzazione automatico della **Dashboard** con calendari esterni attraverso il sistema API ufficiale. Maggiori informazioni sono ottenibili cliccando sul nome dell'utente in alto a sinistra.
{% endhint %}


# Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Screenshot creazione attività](/files/-LZ_3B4-_EMyMIU9AZVu)

Il modulo **Attività** presenta quindi la possibilità di inserire le informazioni complete relative alla nuova attività da creare.

## Caratteristiche

Il sistema di creazione di un nuovo elemento permette il completamento delle informazioni di base fondamentali per il processo di inizializzazione dell'attività. Queste vengono divise in quattro sezioni principali:

* Dati intervento
* Dettagli aggiuntivi
* Assegnazione tecnici
* Ore di lavoro

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FNFAW21CIYjQ8Rg0uqTZw%2Ffile.png?alt=media)

### Dati intervento

La sezione *Dati intervento* si occupa della gestione dei dati dell'attività interagenti con altri moduli:

* Cliente dell'attività
* Ordine collegato
* Tipo
* Stato
* Preventivo collegato
* Contratto collegato
* Data/ora richiesta
* Richiesta

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FAJIS2TlYGyWHBMun2FeA%2Ffile.png?alt=media)

### Dettagli aggiuntivi

Parallelamente, la componente *Dati intervento* permette la compilazione di alcune informazioni generali, quali:

* Zona
* Sede destinazione
* Per conto di
* Data/ora scadenza
* Impianto
* Componenti

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fze5WXLPPTcWs7ldGSUAK%2Ffile.png?alt=media)

### Assegnazione tecnici

La sezione *Assegnazione tecnici* si occupa della gestione dei tecnici dell'attività:

* Tecnici assegnati

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FVylZtPBDizmjzIvAB1h7%2Ffile.png?alt=media)

### Ore di lavoro

La sezione *Ore di lavoro* si occupa di determinare durata dell'attività e il tecnico assegnato, composto dai seguenti campi:

* Inizio attività
* Fine attività
* Tecnici

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FMfAw308yhsu9VZ67wD20%2Ffile.png?alt=media)

### Creazione anagrafica al volo

Nella schermata di creazione di una nuova attività viene permessa la creazione al volo dell'anagrafica di tipo *Cliente* relativa al nuovo *record*. Questa funzionalità viene permessa dal pulsante dedicato a destra del selettore del campo *Cliente*.

![Screenshot creazione anagrafica al volo](/files/-LZ_5hecPUqHGbSqg1T8)

La gestione della creazione viene quindi delegata al modulo **Anagrafiche**, permettendo l'inserimento delle informazioni standard documentate nella [sezione relativa](/modules/anagrafiche/creazione) attraverso un *modal* sovrapposto al resto del contenuto.

![Screenshot creazione anagrafica al volo](/files/-LZ_5sWPBsXzR6enAAz4)

Una volta completata la creazione in questione, l'anagrafica creata verrà automaticamente selezionata.

## Particolarità

Creare un'attività senza tecnici selezionati la aggiungerà al widget **Promemoria attività da pianificare** della **Dashboard**.

![Widget promemoria attività da pianificare presente nella Dashboard](/files/-LZjvQPg3bsuF6oPyhtu)


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

## Caratteristiche

Una volta all'interno di questa parte del sistema, il modulo **Attività** permette di completare *tutte* le informazioni che il gestionale supporta per le attività. In particolare, per permettere un maggiore senso logico nella navigazione dei dati, la sezione di modifica è suddivisa in 4 raggruppamenti:

* [Dati cliente](#dati-cliente)
* [Geolocalizzazione](#geolocalizzazione)
* [Dati intervento](#dati-intervento)
* [Dati appalto](#dati-appalto)
* [Ore di lavoro](#ore-di-lavoro)
* [Righe](#righe)
* [Costi totali](#tabella-dei-costi-totali)
* [Allegati](#allegati)

### Dati cliente

Il primo raggruppamento di informazioni consiste nell'insieme dei dati relativi al cliente selezionato.

Attraverso questa sezione, è possibile procedere alla modifica di alcune informazioni di base:

* Cliente dell'attività
* Sede di esecuzione attività
* Cliente per conto di cui viene eseguita l'attività
* Referente di contatto
* Preventivo collegato
* Contratto collegato
* Ordine collegato

Per maggiori informazioni sulla relazione dell'attività con [**Preventivi**](https://github.com/devcode-it/devcode-it.github.io/tree/c372246fd4462ad0101f4f643f1719d85d3d3249/_openstamanager/guide/preventivi.md) e [**Contratti**](https://github.com/devcode-it/devcode-it.github.io/tree/c372246fd4462ad0101f4f643f1719d85d3d3249/_openstamanager/guide/contratti.md), visitare le sezioni relative.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FoiGPm5leMNbzi8CGGa6R%2Ffile.png?alt=media)

### Geolocalizzazione

È possibile visualizzare la sede dell'intervento tramite la geolocalizzazione.

Per maggiori informazioni sulle [maps](/modules/anagrafiche/maps), visitare la sezione relativa.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F0vHIQnW5zVOjvP0nrY6A%2Ffile.png?alt=media)

### Dati intervento

Viene quindi presentata una selezione di campi relativi alle informazioni dell'attività stessa, quali:

* Numero
* Data di richiesta
* Data scadenza
* Zona relativa
* Tipo di attività
* Stato dell'attività
* Tecnici assegnati
* Richiesta
* Descrizione
* Note interne

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FxNNZ8XcNvCNiPBTQpdxJ%2Ffile.png?alt=media)

### Dati appalto

Questa sezione è dedicata ai dati di appalto, le seguenti informazioni sono da specificare nel caso l'attività fosse effettuata verso la Pubblica amministrazione:

* Identificatore documento
* Numero riga
* Codice CIG
* Codice CUP

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FipuHkf8AAeqcrwg9C7W6%2Ffile.png?alt=media)

### Ore di lavoro

Esiste quindi sezione dedicata alla gestione delle ore di lavoro dell'attività, è possibile aggiungere, duplicare, modificare ed eliminare le ore lavorative dei vari tecnici.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FqipH3Ez81VHyygKSBDLW%2Ffile.png?alt=media)

### Righe

Questa sezione permette di inserire le righe descrittive dell'attività che possono essere aggiunte tramite:

* DDT
* Articoli di magazzino
* Barcode
* Righe generiche
* Sconti/maggiorazioni

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FRMIjWLKiXqQ20pFLQJfj%2Ffile.png?alt=media)

### Tabella dei costi totali

In questa sezione viene viene visualizzata una tabella riassuntiva di tutti i costi inerenti all'attività.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F5q7uX6HUCv5rioxxOFyg%2Ffile.png?alt=media)

### Allegati

Il modulo **allegati** permette l'importazione di un file caricandolo dal proprio computer, specificando la categoria.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FP3mbIKSZW5PaEvK157Xe%2Ffile.png?alt=media)


# Azioni aggiuntive

Nella parte superiore della pagina viene inoltre permessa la visualizzazione di una serie di opzioni dedicate al modulo **Attività**:

* Stampa dell'attività
* Invio del rapportino via email
* Duplica attività
* Visualizzazione dell'anteprima della stampa e [firma conclusiva dell'attività](/modules/attivita/modifica#anteprima-e-firma)

## Anteprima e firma

La funzionalità di *Anteprima e firma* permette al cliente di firmare l'attività per segnalare l'avvenuto completamento dei lavori. Una volta firmata l'attività, risulterà impossibile modificarla.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FA5GqcU1DrZUEwjpHWYT5%2Ffile.png?alt=media)


# Plugin


# Checklist

{% hint style="info" %}
Plugin che permette di spuntare delle liste di controllo per verificare di avere portato a termine l'attività.
{% endhint %}

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FGojxoGpfTysIput3Qe6Q%2Ffile.png?alt=media)

Tramite il pulsante **Nuova** è possibile creare dei check, mentre il pulsante **Checklist predefinite** permette di importare delle checklist già create.

Il modulo per la crezione delle checklist è raggiungibile attraverso il menu laterale del gestionale, sotto il link [**Checklist**](/modules/strumenti/checklists).

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F28LhTN3jsGaaEz1JwKMQ%2Ffile.png?alt=media)


# Impianti

{% hint style="info" %}
Nella sezione di modifica del modulo **Attività** è presente il plugin **Impianti** dedicato alla gestione della relazione dell'attività con l’impianto (gestito dal modulo [Impianti](/modules/impianti)) in cui viene eseguita.
{% endhint %}

![](/files/-MWPgmy2-L8TaCIcSRZF)


# Tipi di attività

{% hint style="info" %}
Il modulo **Tipi di attività** permette di creare una sorta di tariffario da assegnare ad un **Tecnico** per lo svolgimento di un'attività. Offre di base due *record*:
{% endhint %}

* GEN(Generico)
* ODS(Ordine di servizio)

![Screenshot interfaccia tipi di attività](/files/-LZL1n_jzsPqQYpVIxS1)

## Navigazione

Il modulo **Tipi di attività** è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Attività**.

![Screenshot navigazione tipi di attivitià](/files/-LZL1q4n02nzzq5fV5So)

## Caratteristiche

Se i **Tipi di attività** sono collegati a degli interventi andando a cancellare il **Tipo di attività** collegato ad un determinato intervento, viene rimosso anche l'intervento.


# Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Screenshot creazione tipi di attività](/files/-LZL1tE9bpkpLTwz3rYK)

Il modulo **Tipi di attività** presenta quindi la possibilità di inserire le informazioni relative al nuovo tipo di attività da creare, mostrando di default una versione basilare delle informazioni richieste.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FRFAfwu7cNKyeH0BFVKEK%2Ffile.png?alt=media)

**ATTENZIONE**

{% hint style="warning" %}
**Tempo standard** accetta valori compresi tra 0,25 e 25 ore, esempi:
{% endhint %}

* 60 minuti= 1 ora
* 30 minuti= 0,5 ore
* 15 minuti = 0,25 ore


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

## Caratteristiche

Una volta all'interno di questa parte del sistema, il modulo **Tipi di attività** permette di modificare *tutte* le informazioni che il gestionale supporta per **Tipi di attività**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FMesID5RHRCVq0r8gjhI7%2Ffile.png?alt=media)

### ATTENZIONE

{% hint style="warning" %}
Eliminando un **tipo di attività** collegato ad un intervento vengono rimossi anche gli interventi collegati!
{% endhint %}


# Stati di attività

{% hint style="info" %}
Il modulo **Stati di attività** offre di base 4 stati, assegnabili ad un tecnico,quali:
{% endhint %}

* TODO(Da programmare)
* FAT(Fatturato)
* OK(Completato)
* WIP(Programmato)

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FMGsr3PCgNlXwYFz8Gq6k%2Ffile.png?alt=media)

## Navigazione

Il modulo **Stati di attività** è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Attività**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FPsHqsipaPFO9HsEIRvkF%2Ffile.png?alt=media)


# Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Screenshot creazione stati di attività](/files/-LZL2NRv8Joq0D3OZOrI)

Il modulo **Stati di attività** presenta quindi la possibilità di inserire le informazioni complete relative ad un nuovo stato di attività da creare.

![Screenshot creazione stati di attività](/files/-LZL2WnnGn0JHk2CuLJ2)


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

## Caratteristiche

Una volta all'interno di questa parte del sistema, il modulo **Stati di attività** permette di modificare *tutte* le informazioni che il gestionale supporta:

**Abilita notifiche**\
\*\*\*\*Attivando abilita notifiche ogni volta che lo stato viene inserito nell'attività invierà una notifica ai destinatari designati, i quali possono essere:

* **Cliente**, attivando Notifica al cliente verrà inviata una notifica alla email del cliente
* **Tecnici**, attivando Notifica ai tecnici verrà inviata una notifica a tutti i clienti collegati all'attività
* **Destinatari** **aggiuntivi**, in questo campo è possibile aggiungere un ulteriore indirizzo email a cui inviare la notifica.

**Template email**\
Questo campo permette di impostare il template dell'email aggiunta precededentemente dal modulo [Template Mail](/modules/email/template)

**Completato**\
\*\*\*\*Considera l'attività completata quando passa in questo stato.

**Fatturabile**\
\*\*\*\*Considera l'attività fatturabile quando passa in questo stato.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FIrl91cuLr8LdeNjuwH7u%2Ffile.png?alt=media)


# Tecnici e tariffe

{% hint style="info" %}
Il modulo **Tecnici e tariffe** offre la possibilità di personalizzare le *tariffe* di uno o più tecnici. In questo modo ogni tecnico avrà la propria tariffa.
{% endhint %}

I costi del cliente sono:

* Addebito orario
* Addebito km
* Addebito diritto ch.

Mentre i costi interni sono:

* Costo orario
* Costo km
* Costo diritto ch.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FijtcIqK7ACKin8osJeY8%2Ffile.png?alt=media)

## Navigazione

Il modulo **Tecnici e tariffe** è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Attività**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FNNMDyIhJOr96QRMLJwXy%2Ffile.png?alt=media)


# Vendite


# Preventivi

{% hint style="info" %}
Il modulo **Preventivi** permette di gestire le informazioni relative ai preventivi dell'azienda.
{% endhint %}

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FAos1ZeXQ3YnOSEQcSdC5%2Ffile.png?alt=media)

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Preventivi** visibile dall'espansione del menu **Vendite**.

![Screenshot navigazione preventivi](/files/-LZZ4dlO5xEOlLHGy3md)


# Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Screenshot creazione preventivi](/files/-LZd8sg_FCJWB14zDogj)

Il modulo **Preventivi** presenta quindi la possibilità di inserire le informazioni di base relative al nuovo preventivo da creare.

## Caratteristiche

Il sistema di creazione di un nuovo elemento richiede la compilazione di alcune informazioni fondamentali:

* Data bozza
* Nome del preventivo
* Cliente
* Sede
* Tipo di attività relativa

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FSblCh3b1IludJBtHGiZw%2Ffile.png?alt=media)


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

## Caratteristiche

La sezione di modifica del modulo **Preventivi** permette di procedere alla modifica dei seguenti campi di base:

* Numero
* Nome
* Cliente
* Sede
* Agente
* Referente
* Tempi di consegna
* Validità (in giorni)
* Metodo di pagamento
* Date di bozza, accettazione, conclusione e rifiuto
* Stato
* Tipo di attività
* Esclusioni
* Garanzia
* Descrizione
* Condizioni generali di fornitura

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FtfbK1yOBxTD243fcxfcW%2Ffile.png?alt=media)

E' inoltre supportata la gestione dello *Sconto finale* sul netto a pagare del preventivo inserendo un valore nel campo **Sconto finale** in fase di modifica del documento.

### Dati appalto

Questa sezione è dedicata ai dati di appalto, le seguenti informazioni sono da specificare nel caso l'attività fosse effettuata verso la Pubblica amministrazione:

* Identificatore documento
* Numero riga
* Codice CIG
* Codice CUP

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FjeLxSduV7fkcNAgzfJFI%2Ffile.png?alt=media)

### Righe

Il modulo **Preventivi** integra all'interno della sezione **Righe** la gestione delle spese relative ai propri elementi.

Cliccando sui pulsanti relativi, è possibile procedere quindi alla creazione di nuove spese relative al preventivo:

* Articoli
* Barcode
* Righe (spese generiche)
* Descrizioni (righe dedicate alla stampa)
* Sconti e maggiorazioni

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FqjrgVWMbXjPedew2TVVu%2Ffile.png?alt=media)

Una volta inserite correttamente le informazioni richieste, la nuova spesa verrà aggiunta all'elenco del preventivo.

E' quindi possibile procedere alla modifica premendo il tasto ![](/files/-LaFNVTKtACQckRCAXwH) e all'eventuale rimozione della spesa attraverso il pulsante ![](/files/-La18dxuaqEQSy3Psr2h) .

### Allegati

Il modulo **allegati** permette l'importazione di un file caricandolo dal proprio computer, specificando la categoria.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FGGlUqrDQK2qi3drA4z0P%2Ffile.png?alt=media)


# Azioni aggiuntive

Selezionando o creando un *record* in **Fatture di vendita** sono presenti nella parte in alto a destra degli strumenti che consentono diverse opzioni, quali:

* Stampa preventivo
  * Stampa preventivo (senza prezzi)
  * Stampa preventivo (senza totali)
  * Stampa consuntivo preventivo (senza prezzi)
  * Stampa consuntivo preventivo
  * Stampa preventivo (solo totale)
  * Stampa preventivo (senza totali)
  * Stampa consuntivo preventivo interno
* Invia
  * Invia preventivo
  * Invia consuntivo preventivo
* Duplica preventivo
* Crea nuova revisione
* Crea
  * Ordine cliente
  * Ordine fornitore
  * DDT in uscita
  * Contratto
  * Fattura

![](/files/-LZjjiO8wCK1x4KMaAmw)


# Plugin


# Consuntivo

{% hint style="info" %}
Questo modulo presenta il plugin **Consuntivo** per il monitoraggio del rapporto budget-spesa, basato sulla relazione delle attività con il preventivo.
{% endhint %}

E' possibile stampare il consuntivo cliccando sopra a **Stampa consuntivo**

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FHNypYkhmLnRBi9cRi2hB%2Ffile.png?alt=media)


# Revisioni

{% hint style="info" %}
Il plugin **Revisioni** permette di avere uno storico dei **preventivi.** E' possibile selezionare una **revisione** e cliccando sul tasto ![](/files/-LZp2CTKiTGCetV5Biij) viene aggiornato il preventivo alla revisione selezionata.
{% endhint %}

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FmG8nuwJiSYqcsK3RVcvv%2Ffile.png?alt=media)

Per aggiungere una revisione è necessario cliccare il pulsante **Crea nuova revisione** dalla schermata di modifica del preventivo.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F91t5zg47iij3XqT715Cd%2Ffile.png?alt=media)

Una volta cliccato il pulsante, viene aperto un modal in cui è possibile rinominare la descrizione della nuova revisione.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FruhzdVTvlUGagJRgur6t%2Ffile.png?alt=media)


# Contratti

{% hint style="info" %}
Il modulo **Contratti** permette di gestire le informazioni relative ai contratti dell'azienda.
{% endhint %}

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F58MWYRAJx7BfTCPeQBlY%2Ffile.png?alt=media)

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Contratti** visibile dall'espansione del menu **Vendite**.

![Screenshot navigazione contratti](/files/-LZZ4iPGdK-IMNgFU8OG)

## Caratteristiche

Questo modulo presenta presenta 4 [plugin](/modules/vendite/contratti) nella sezione di modifica del modulo:

* **Pianificazione fatturazione**
* **Pianificazione attività**
* **Consuntivo** per il monitoraggio del rapporto budget-spesa
* **Rinnovi**


# Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Screenshot creazione contratti](/files/-LZdB7dEnUhUK-PN7fnc)

Il modulo **Contratti** presenta quindi la possibilità di inserire le informazioni di base relative al nuovo contratto da creare.

## Caratteristiche

Il sistema di creazione di un nuovo elemento richiede la compilazione di alcune informazioni fondamentali:

* Nome del contratto
* Cliente

![Screenshot creazione contratti](/files/-LZdBBLEmy6Qh5Ad4ruo)


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

## Caratteristiche

La sezione di modifica del modulo **Contratti** permette di procedere alla modifica dei seguenti campi di base:

* Numero
* Nome
* Cliente
* Sede
* Agente
* Referente
* Validità
* Metodo di pagamento
* Date di bozza, accettazione, conclusione e rifiuto
* Stato
* Impianti interessati
* Esclusioni
* Descrizione

E' inoltre supportata la gestione dello *Sconto finale* sul netto a pagare del contratto inserendo un valore nel campo **Sconto finale** in fase di modifica del documento.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FEmtxIygKWTFKhPQZfcUS%2Ffile.png?alt=media)

### Dati appalto

Questa sezione è dedicata ai dati di appalto, le seguenti informazioni sono da specificare nel caso l'attività fosse effettuata verso la Pubblica amministrazione:

* Identificatore documento
* Numero riga
* Codice CIG
* Codice CUP

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FVgd2bTg76YLdQbtRoppV%2Ffile.png?alt=media)

### Costi unitari

Grazie a questa sezione è possibile addebitare i costi orari, al kilometro e al diritto di chiamata in base al tipo di attività.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FmV4aVNuSQOOtF1hFgN4F%2Ffile.png?alt=media)

### Righe

Il modulo **Contratti** integra all'interno della sezione **Righe** la gestione delle spese relative ai propri elementi.

Cliccando sui pulsanti relativi, è possibile procedere quindi alla creazione di nuove spese relative al contratto:

* Articoli
* Barcode
* Righe (spese generiche)
* Descrizioni (righe dedicate alla stampa)
* Sconti e maggiorazioni

Una volta inserite correttamente le informazioni richieste, la nuova spesa verrà aggiunta all'elenco del contratto.

E' quindi possibile procedere alla modifica e all'eventuale rimozione della spesa attraverso i pulsanti dedicati della spesa.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fw0a2YnDCuD2E9saMdk5I%2Ffile.png?alt=media)

### Attenzione

{% hint style="warning" %}
Se voglio monitorare il consumo delle ore mi basterà aggiungere una **Riga,** inserire una **descrizione,** selezionare **ore** come **Unità di misura** e inserire nel campo **Q.tà** il numero delle ore, come nell'esempio che segue:
{% endhint %}

![](https://github.com/devcode-it/openstamanager-docs/tree/5242b6a23c677db2f5451152c8e4c4aded3a99cf/.gitbook/assets/oreore-1.png)

Successivamente, cliccando in altro a destra su *Consuntivo* si potrà visualizzare:

* Ore residue
* Ore erogate
* Ore in contratto

![](/files/-L_Nt3QoSsnAkI67b44S)


# Plugin


# Pianificazione fatturazione

## **Pianificazione fatturazione**

{% hint style="info" %}
Il plugin **Pianificazione fatturazione** è una componente del modulo **Contratti** dedicata alla completa gestione della pianificazione delle fatture relative ai contratti registrati all'interno di OpenSTAManager.
{% endhint %}

## Caratteristiche

Per pianificare la fatturazione è necessario inserire la data di accettazione e la data di conclusione del contratto, inoltre lo stato deve essere in uno dei seguenti stati:

* In lavorazione
* Fatturato
* Pagato
* Parzialmente fatturato

La possibilità di creare nuovi elementi viene resa disponibile dal pulsante ![](/files/-LZtdB6vJmTubpXiXNQT) *.*

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FOjsQ72GwfIsm7lWdZh94%2Ffile.png?alt=media)

### Creazione

Come descritto sopra, la creazione di nuovi elementi viene resa disponibile dal pulsante *Pianifica*. Una volta cliccato il pulsate, verrà aperto una schermata in cui si può pianificare la fatturazione specificando i **periodi** e le **righe** da importare.

#### Periodi

Selezionando la **Ricorrenza fatturazione** le rate vengono impostate automaticamente nei mesi corrispondenti, è comunque possibile modificare manualmente le rate in base alle necessità cliccando direttamente sul mese.

È possibile inoltre impostare il **Giorno di fatturazione** tra:

* inizio mese
* fine mese
* giorno fisso (selezionare il giorno)

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fp1ZnKf26XoCQhwaog1rc%2Ffile.png?alt=media)

#### Righe

In questa sezione è possibile selezionare quali righe fatturare del contratto e la quantità da inserire in ogni fattura.(Inserire le quantità uguale o multiple al numero delle rate per avere le fatture con la stessa quantità)

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fb2TWXfvmvQbOn0FVSnT2%2Ffile.png?alt=media)

Una volta inserite le informazioni nelle due sezioni basta cliccare il pulsante **Procedi** per pianificare le fatture.\
Cliccando sul pulsante **Crea fattura** si aprirà una schermata di inserimento della fattura per effettuare la creazione.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F4GMfipq9AWm9Zlde2fwY%2Ffile.png?alt=media)


# Pianificazione attività

## Pianificazione attività

{% hint style="info" %}
Il plugin **Pianificazione attività** è una componente del modulo **Contratti** dedicata alla completa gestione della pianificazione delle attività (*promemoria*) relative ai contratti registrati all'interno di OpenSTAManager.
{% endhint %}

## Navigazione

Il plugin è raggiungibile, all'interno dell'area di modifica di un *record* del modulo **Contratti**, attraverso il menu dedicato sotto la dicitura **Pianificazione attività**.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FXbXATTMfEJRlDKihCmMI%2Ffile.png?alt=media)

## Caratteristiche

È possibile **pianificare dei "promemoria"** o direttamente gli **interventi** da effettuare entro determinate scadenze. Per poter pianificare i promemoria, il contratto deve avere **data accettazione** e **data conclusione** definita ed essere in uno dei seguenti stati: **In lavorazione, Fatturato, Pagato, Parzialmente fatturato.**\
\*\*\*\*La possibilità di creare nuovi elementi viene resa disponibile dal pulsante *Nuovo promemoria* (dopo aver selezionato il tipo di promemoria) che apre una struttura grafiche, *modal*, sovrapposta agli altri contenuti.\\

### Creazione

Come descritto sopra, la creazione di nuovi elementi viene resa disponibile dal pulsante ![](/files/-LZnSCZTWRmABb0MXgCz) . Una volta cliccato il pulsate, verrà aperta una schermata con la possibilità di completare le informazioni dell'elemento.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FE5znZCmDl0C79pbNImZF%2Ffile.png?alt=media)

Ogni promemoria può possedere articoli, spese generiche e allegati indipendenti, oltre ai campi:

* Data del promemoria
* Tipo intervento
* Sede
* Impianti a contratto
* Descrizione

### Pianificazione ciclica

Una volta creato il promemoria, sarà possibile effettuare una pianificazione ciclica dello stesso attraverso seguente pulsante della relativa riga.

![Screenshot pianificazione ciclica](/files/-LZZ9fPgIeo3FlxjQmf3)

In fondo al *modal* di riepilogo che compare dopo il click sul pulsante relativo, saranno visibili nuovi due raggruppamenti:

* *Promemoria ciclico?*
* *Pianificare interventi?* per rendere automaticamente il promemoria un'attività

La pianificazione di promemoria ciclici replicherà in modo completo le caratteristiche del promemoria selezionato (compresi articoli, spese generiche e allegati), aggiornando le date di conseguenza.

### Trasformazione in attività

Una volta creato il promemoria, sarà possibile trasformarlo in attività in modo indipendente dalla funzione di **Pianificazione ciclica** attraverso il pulsante dedicato nella relativa riga.

![Trasformazione in attività](/files/-LZjp9nPCVSOZZvzTSsF)

Questa azione permetterà quindi di confrontarsi con la classica schermata per la creazione delle attività, pre-impostata secondo le caratteristiche del promemoria.

## Particolarità

I promemoria verranno successivamente visualizzati nel modulo **Dashboard** per semplificare la pianificazione del giorno dell'intervento, ad esempio nel caso di interventi con cadenza mensile.

![Esempio Promemoria da pianificare](/files/-LZZApl4YQXM3ZQMC5a6)

## \*\*\*\*


# Consuntivo

## Consuntivo

{% hint style="info" %}
La creazione di righe con unità di misura *ore* viene sfruttata dal plugin **Consuntivo** per monitorare l'utilizzo delle stesse all'interno delle attività collegate.
{% endhint %}

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F9AECozDmrIZCjJKuD7F0%2Ffile.png?alt=media)

È possibile inoltre effettuare una Stampa del consutivo direttamente dal plugin con il pulsante **Stampa consuntivo.**


# Rinnovi

{% hint style="info" %}
Il plugin **Rinnovi** è una componente del modulo **Contratti** dedicata alla completa gestione dei rinnovi relativi ai contratti registrati all'interno di OpenSTAManager.
{% endhint %}

Questo plugin permette la gestione dei rinnovi con la possibilità di rinnovare in maniera automatica il contratto alla scadenza, inserire il numero di giorni di preavviso e inserire la soglia minima prima di visualizzare un avviso per un eventuale rinnovo anticipato.\
Inoltre, vengono visualizzati in una tabella, se presenti, tutti i rinnovi effettuati su quel contratto.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FMVtm0WyOqTgeetXLXIAf%2Ffile.png?alt=media)


# Azioni aggiuntive

Selezionando o creando un *record* in **Contratti** sono presenti nella parte in alto a destra degli strumenti che consentono diverse opzioni quali:

* Stampa contratto
  * Stampa contratto(senza prezzi)
  * Stampa consuntivo contratto(senza prezzi)
  * Stampa consuntivo contratto
  * Stampa consuntivo contratto interno
* Invia
  * Invia contratto
  * Invia consuntivo contratto
* Crea fattura
* Rinnova
* Duplica contratto

## Rinnova

{% hint style="info" %}
La funzionalità *Rinnova* viene resa disponibile se il campo *Rinnovabile* del contratto viene selezionato. In questo caso, una volta definite le date di accettazione e conclusione (***Data accettazione*** e ***Data conclusione***), sarà possibile sfruttare questa opzione per copiare il contratto con le rispettive date traslate di conseguenza a partire dal giorno successivo alla *Data conclusione*.
{% endhint %}

![](/files/-LZdC8Wu9CfL85Yp323s)

La procedura di rinnovazione replica in modo completo le spese relative al contratto e le pianificazioni relative, rimuovendo però gli interventi che erano stato collegati in precedenza (che, logicamente, rimarranno in relazione con il contratto precedente).


# Ordini cliente

{% hint style="info" %}
Il modulo **Ordini cliente** permette all'utente di creare un documento per richiedere prodotti o servizi da parte di un cliente stabilendone tempistiche e tipo di pagamento.
{% endhint %}

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il modulo **Vendite**.

![Navigazione ordini cliente](/files/-LZZOWPZ2nUDyOn1cS2K)

## Caratteristiche

La schermata principale del modulo è strutturata secondo la tabella generale predefinita. La modifica di un *record* del modulo **Ordini cliente** presenta la possibilità di utilizzare delle [Azioni aggiuntive](/modules/vendite/fatturedivendita/plugin)


# Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Creazione ordini cliente](/files/-LZZOSUdm0kVM11EtCDB)

Il modulo **Ordini cliente** presenta quindi la possibilità di inserire le informazioni relative alla nuova anagrafica da creare, mostrando di default una versione basilare delle informazioni richieste.

![Creazione ordini cliente](/files/-LZKzjnL29reYEgzgRpz)


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

## Caratteristiche

Una volta all'interno di questa parte del sistema, il modulo **Ordini cliente** permette di completare *tutte* le informazioni che il gestionale supporta per le anagrafiche. In particolare, per permettere un maggiore senso logico nella navigazione dei dati, la sezione di modifica è suddivisa in 3 raggruppamenti.

* [Intestazione](#intestazione)
* [Dati appalto](/modules/vendite/preventivi/modifica#dati-appalto)
* [Righe](#righe)
* [Allegati](#allegati)

## Intestazione

Il primo raggruppamento di informazioni di **Ordini cliente** è l'intestazione.

Attraverso questa sezione, è possibile procedere alla modifica delle informazioni di base

* Numero ordine
* Numero ordine cliente
* Data ordine cliente
* Data
* Stato
* Cliente
* Referente
* Sede
* Pagamento
* Note
* Note aggiuntive(interne)

E' inoltre supportata la gestione dello *Sconto finale* sul netto a pagare dell'ordine inserendo un valore nel campo **Sconto finale** in fase di modifica del documento.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fshr651dRtuqwfnLdX81T%2Ffile.png?alt=media)

## Dati appalto

Questa sezione è dedicata ai dati di appalto, le seguenti informazioni sono da specificare nel caso l'attività fosse effettuata verso la Pubblica amministrazione:

* Identificatore documento
* Numero riga
* Codice CIG
* Codice CUP

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FvlFJRGu8gVvk4qASErss%2Ffile.png?alt=media)

## Righe

Il modulo **Ordini cliente** integra all'interno della sezione **Righe** la gestione delle spese relative ai propri elementi.

Cliccando sui pulsanti relativi, è possibile procedere quindi alla creazione di nuove spese relative per ordini clienti:

* Articoli
* Preventivi
* Barcode
* Righe (spese generiche)
* Descrizioni (righe dedicate alla stampa)
* Sconti e maggiorazioni

Una volta inserite correttamente le informazioni richieste, la nuova spesa verrà aggiunta all'elenco.

E' quindi possibile procedere alla modifica e all'eventuale rimozione della spesa attraverso i pulsanti dedicati della spesa.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FUWSM0ZkMqK2nYVHFjLyw%2Ffile.png?alt=media)

## Allegati

In fine è possibile aggiungere un **allegato** caricandolo dal proprio computer.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fs5V4T5jNsmsk1cHOOrlx%2Ffile.png?alt=media)


# Azioni aggiuntive

Selezionando o creando un *record* in **Ordini cliente** sono presenti nella parte in alto a destra dei *pulsanti* che consentono diverse opzioni quali:

![Azioni aggiuntive ordini cliente](/files/-LZKzbamUFbnQsdYcB6a)

* stampa ordine cliente
  * Stampa ordine cliente(senza prezzi)
  * Stampa consuntivo ordine
* invia ordine
* Crea(se sono presenti articoli):
  * Ddt
  * Fattura
  * Attività
  * Ordine fornitore


# Plugin


# Consuntivo

## Consuntivo

{% hint style="info" %}
Grazie a questo plugin è possibile consultare il consuntivo dell'ordine cliente collegato alle attività.
{% endhint %}

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FLci4RwFJBhiX9xGeGuBp%2Ffile.png?alt=media)


# Fatture di vendita

{% hint style="info" %}
Il modulo **Fatture di vendita** permette all'utente di creare una fattura di vendita con la possibilità di verificare tramite *widget*, posti in alto, il ***Fatturato*** ed eventuali ***Crediti da clienti***, entrambi con IVA inclusa.
{% endhint %}

![Screenshot interfaccia fatture di vendita](/files/-LZKybytIIdXN-LlCaEH)

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il modulo **Vendite**.

![Screenshot navigazione fatture di vendita](/files/-LZKyeRQXE5gQ6B_zFw3)

## Caratteristiche

La schermata principale del modulo è strutturata secondo la tabella generale predefinita. La modifica di un *record* del modulo **Fatture di Vendita** presenta la possibilità di utilizzare diverse [Azioni aggiuntive](/modules/vendite/ordinicliente/plugin1)


# Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Screenshot creazione fatture di vendita](/files/-LZKyhF99imgeuSea0nq)

I campi da compilare che verranno visualizzati sono:

* Data
* Cliente
* Tipo fattura
* Sezionale

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FiRKzbcec3nzzpUoFakbw%2Ffile.png?alt=media)


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

## Caratteristiche <a href="#caratteristiche" id="caratteristiche"></a>

Una volta all'interno di questa parte del sistema, il modulo **Anagrafiche** permette di completare *tutte* le informazioni che il gestionale supporta per le anagrafiche. In particolare, per permettere un maggiore senso logico nella navigazione dei dati, la sezione di modifica è suddivisa in 3 raggruppamenti:

* [Intestazione](#intestazione)
* [Righe](#righe)
* [Allegati](#allegati)

### Intestazione

Attraverso questa sezione, è possibile procedere alla modifica delle informazioni di base delle Fatture di vendita in questione:

* Data emissione
* Data competenza
* Stato
* Stato FE
* Cliente
* Referente
* Agente di riferimento
* Partenza merce
* Destinazione merce
* Tipo fattura
* Pagamento
* Banca
* Sconto finale
* Split payment
* Fattura per conto terzi
* Ritenuta contributi
* Dichiarazione d'intento
* Note(visibili anche in stampa)
* Note aggiuntive(interne)

E' inoltre supportata la gestione dello *Sconto finale* sul netto a pagare della fattura inserendo un valore nel campo **Sconto finale** in fase di modifica del documento.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FjmBohhf5b5Xf9IUT2P6a%2Ffile.png?alt=media)

### Righe

Il modulo **Fatture di vendita** integra all'interno della sezione **Righe** la gestione delle spese relative ai propri elementi.

Cliccando sui pulsanti relativi, è possibile procedere quindi alla creazione di nuove spese relative alle **Fatture di vendita**:

* Intervento
* Preventivo
* Contratto
* Ddt
* Ordine
* Articolo
* Barcode
* Riga
* Descrizione
* Sconti e maggiorazioni

Una volta inserite correttamente le informazioni richieste, la nuova spesa verrà aggiunta all'elenco.

E' quindi possibile procedere alla modifica e all'eventuale rimozione della spesa attraverso i pulsanti dedicati della spesa.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2F4GlnztivzPYWiFGwM0QI%2Ffile.png?alt=media)

### Dati fattura accompagnatoria

Questa sezione compare se si vuole fare una *fattura accompagnatoria di vendita* e comporta l'inserimento dei seguenti campi:

* Aspetto beni
* Causale trasporto
* Porto
* Num.colli
* Tipo di spedizione
* Vettore
* Tipo resa
* Peso
* Volume

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FhiEWLQMYlCEwvdpilZrG%2Ffile.png?alt=media)

### Allegati

Il terzo e ultimo raggruppamento permette di **allegare** un file presente nel computer, specificando la categoria.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2Fh31jQKM8Kw9MafviBYis%2Ffile.png?alt=media)


# Azioni aggiuntive

Selezionando o creando un *record* in **Fatture di vendita** sono presenti nella parte in alto a destra degli strumenti che consentono diverse opzioni quali:

![Screenshot azioni aggiuntive fatture di vendita](/files/-LZKzZ6GT5KUlXLVaXeW)

* Stampa fattura di vendita
  * Stampa fattura di vendita(senza intestazione)
  * Stampa fattura elettronica di vendita
* Invia fattura (tramite mail/PEC)
* Duplica fattura
* Attributi avanzati
* Crea
  * Nota di debito
  * Nota di credito
* Registra insoluto
* Registra contabile


# Plugin


# Fatturazione elettronica

{% hint style="info" %}
Per quanto riguarda la **Fatturazione Elettronica** è stata creata una sezione apposita, [clicca qui](/faq/fatturazione-elettronica) per visualizzarla!
{% endhint %}


# Acquisti


# Ordini fornitore

{% hint style="info" %}
Il modulo **Ordini fornitore** permette all'utente di creare un documento che permette di richiedere ad un fornitore prodotti e servizi stabilendone tempistiche e tipo di pagamento.
{% endhint %}

![Screenshot interfaccia ordini fornitore](/files/-LZjsJBQR0X_HOM3rzMD)

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il modulo **Vendite**.

![Navigazione ordini fornitore](/files/-LZL-OqywPOwdlv3MdTD)

## Caratteristiche

La schermata principale del modulo è strutturata secondo la tabella generale predefinita. La modifica di un *record* del modulo **Ordini fornitore** presenta la possibilità di utilizzare diverse [Azioni aggiuntive](/modules/acquisti/ordinifornitore/plugin)


# Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Screenshot creazione ordini fornitore](/files/-LZL-aTbeFt8dCl_vaf3)

Il modulo **Ordini fornitore** presenta quindi la possibilità di inserire le informazioni complete relative ad un ordine.

![Screenshot creazione ordini fornitore](/files/-LZL-cQMVsUQo4KQjL7z)


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

## Caratteristiche

Una volta all'interno di questa parte del sistema, il modulo **Ordini fornitore** permette di completare *tutte* le informazioni che il gestionale supporta per le anagrafiche. In particolare, per permettere un maggiore senso logico nella navigazione dei dati, la sezione di modifica è suddivisa in 3 raggruppamenti:

* [Intestazione](#intestazione)
* [Righe](#righe)
* [Allegati](#allegati)

## **Intestazione**

Il primo raggruppamento di informazioni di **Ordini fornitore** è l'intestazione.

Attraverso questa sezione, è possibile procedere alla modifica delle informazioni di base

* Numero ordine
* Numero secondario
* Data
* Stato
* Fornitore
* Referente
* Sede
* Pagamento
* Sconto incondizionato
* Note
* Note aggiuntive(interne)

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FvWGKrAf2PXp1aghwexir%2Ffile.png?alt=media)

## Righe

Il modulo **Ordini fornitore** integra all'interno della sezione **Righe** la gestione delle spese relative ai propri elementi.

Cliccando sui pulsanti relativi, è possibile procedere quindi alla creazione di nuove spese relative a **Ordini fornitore**:

* Articolo
* Barcode
* Riga
* Descrizione
* Sconto/maggiorazione

Una volta inserite correttamente le informazioni richieste, la nuova spesa verrà aggiunta all'elenco.

E' quindi possibile procedere alla modifica e all'eventuale rimozione della spesa attraverso i pulsanti dedicati della spesa.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FItbBhUFUVj1DjbtkZVe8%2Ffile.png?alt=media)

## Allegati

In fine è possibile aggiungere un **allegato** caricandolo dal proprio computer.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FLNaFWUdHIaLhDYCHe8jX%2Ffile.png?alt=media)


# Azioni aggiuntive

Selezionando o creando un *record* in **Ordini fornitore** sono presenti nella parte in alto a destra dei *plugin* che consentono diverse opzioni quali:

![Screenshot azioni aggiuntive ordini fornitore](/files/-LZL07cURuA_AnRLFoLf)

* stampa ordine fornitore
  * stampa ordine fornitore(senza prezzi)
* invia ordine (tramite mail)
* Crea
  * Ddt
  * Fattura
  * Attività


# Fatture di acquisto

{% hint style="info" %}
Il modulo **Fatture di acquisto** permette all'utente di creare una fattura di acquisto con la possibilità di verificare tramite *widget*, posti in alto,gli ***acquisti*** ed eventuali ***debiti verso fornitori***, entrambi con IVA inclusa.
{% endhint %}

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il modulo **Acquisti**.

![Screenshot navigazione fatture di acquisto](/files/-LZL0AxqaBA62ekJh6Ox)

## Caratteristiche

La schermata principale del modulo è strutturata secondo la tabella generale predefinita. La modifica di un *record* del modulo **Fatture di acquisto** presenta la possibilità di utilizzare diverse [Azioni aggiuntive](/modules/acquisti/fatturediacquisto/plugin1)


# Creazione

La creazione di nuovi elementi segue il funzionamento standard del gestionale, necessitando il click sul pulsante apposito all'interno dell'intestazione del modulo.

![Screenshot creazione fatture di acquisto](/files/-LZL0EjFdMPIz4wQMlUh)

Il modulo **Fatture di acquisto** presenta quindi la possibilità di inserire le informazioni relative alla nuova fattura da creare, mostrando di default una versione basilare delle informazioni richieste.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FtNDCvwKaP3jdi3enLXhu%2Ffile.png?alt=media)


# Modifica

La sezione di modifica degli elementi del modulo segue il sistema standard del gestionale, necessitando il click sulla riga relativa al *record* all'interno della tabella della schermata principale.

## Caratteristiche

Una volta all'interno di questa parte del sistema, il modulo **Fatture di acquisto** permette di completare *tutte* le informazioni che il gestionale supporta. In particolare, per permettere un maggiore senso logico nella navigazione dei dati, la sezione di modifica è suddivisa in 3 raggruppamenti:

* [Intestazione](#intestazione)
* [Righe](#righe)
* [Allegati](#allegati)

## Intestazione

Il primo raggruppamento è l'**intestazione**.

Attraverso questa sezione, è possibile procedere alla modifica delle informazioni di base:

* Numero fattura/protocollo
* Numero fattura del fornitore
* Data emissione
* Data registrazione
* Data competenza
* Stato
* Fornitore
* Riferente
* Partenza merce
* Destinazione merce
* Tipo fattura
* Pagamento
* Banca
* Split payment(selezionabile, si applica solitamente quando si fattura alla PA)
* Ritenuta contributi
* Ritenuta pagata dal fornitore
* Note
* Note aggiuntive(interne)

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FdFPYmrUDaNQIcJl3jb9o%2Ffile.png?alt=media)

## Righe

Il modulo **Fatture di acquisto** integra all'interno della sezione **Righe** la gestione delle spese relative ai propri elementi.

Cliccando sui pulsanti relativi, è possibile procedere quindi alla creazione di nuove spese relative alle **Fatture di acquisto**:

* Ddt
* Ordine
* Articolo
* Barcode
* Riga
* Descrizione
* Sconto/maggiorazione

Una volta inserite correttamente le informazioni richieste, la nuova spesa verrà aggiunta all'elenco.

E' quindi possibile procedere alla modifica e all'eventuale rimozione della spesa attraverso i pulsanti dedicati della spesa.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FbL8Q89b1Bil2QweCcWzt%2Ffile.png?alt=media)

## Allegati

In fine è possibile aggiungere un **allegato** caricandolo dal proprio computer.

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FDnnEiv2HCAX7g6poas5O%2Ffile.png?alt=media)


# Azioni aggiuntive

Selezionando o creando un *record* in **Fatture di vendita** sono presenti nella parte in alto a destra degli strumenti che consentono diverse opzioni quali:

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FjF1ZCH8muclvWldOViuR%2Ffile.png?alt=media)

* Stampa fattura elettronica di acquisto
* Duplica fattura
* Registra insoluto
* Registra contabile


# Contabilità


# Stampe contabili

{% hint style="info" %}
Il modulo **Stampe contabili** permette all'utente di stampare:
{% endhint %}

* Registri iva
  * Registro IVA vendite
  * Registro IVA acquisti
  * Liquidazione IVA
* Comunicazione dati fatture
* Fatturato
  * Fatturato in entrata
  * Fatturato in uscita

![](https://firebasestorage.googleapis.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LZJeLg23eVDvrCv74U7-887967055%2Fuploads%2FGmzubzT2EZexWablqbuU%2Ffile.png?alt=media)

## Attenzione

{% hint style="warning" %}
Le suddette stampe contabili non sono da considerarsi valide ai fini fiscali.
{% endhint %}

## Navigazione

Il modulo è raggiungibile attraverso il menu laterale del gestionale, sotto il link **Contabilità**.

![Screenshot navigazione stampe contabili](/files/-LZL3sWcmKIygvJY_WLt)




---

[Next Page](/llms-full.txt/1)

