DDT Italia: differenze tra le versioni

Da Dolibarr Wiki.
Vai alla navigazione Vai alla ricerca
Nessun oggetto della modifica
Nessun oggetto della modifica
 
(17 versioni intermedie di uno stesso utente non sono mostrate)
Riga 1: Riga 1:


<div style="text-align:right;">
<div style="text-align:right;">
'''Manuale utente rev. 3'''
'''Manuale utente rev. 3'''


'''“Modulo D.D.T. ITALIA”'''
'''“Modulo D.D.T. ITALIA”'''
</div>
<div style="text-align:right;">[[File:Logo dp.png]]'''Versione del modulo: 3.0.0Versione di Dolibarr supportate: 12.0.x / 13.0.XData: 13 Luglio 2024Autori: Diciannove Soc. Coop.'''</div>


'''Versione del modulo: 3.0.0'''


<div style="text-align:right;">'''''https://shop.19.coop'''''</div>
'''Versione di Dolibarr supportate: >= 16.0.x'''


'''Data ultimo aggiornamento: 05 Aprile 2024'''


'''Autori: Diciannove Soc. Coop.'''</div>


'''Indice'''
<div style="text-align:right;">'''''https://shop.19.coop'''''</div>
 
 
 
 
{| style="border-spacing:0;width:17cm;"
|- style="border:none;padding:0cm;"
| align=center| '''1'''
||
|| '''Introduzione'''
|- style="border:none;padding:0cm;"
| align=center| '''2'''
||
|| '''Installazione del modulo in Dolibarr ERP&CRM'''
|- style="border:none;padding:0cm;"
| align=center| '''3'''
||
|| '''Configurazione del modulo'''
|- style="border:none;padding:0cm;"
| align=center| '''4'''
||
|| '''Utilizzo e funzionalità del modulo'''
|- style="border:none;padding:0cm;"
| align=center| '''5'''
||
|| '''Aggiornamento luglio 2021: versione 3.0'''




|-
|}
= 1. Introduzione =
= 1. Introduzione =


Riga 49: Riga 22:


Il modulo '''DDT ITALIA''' è il modulo sviluppato ad-hoc per Dolibarr ERP & CRM che consente alle aziende italiane di completare il modulo core “Spedizioni” aggiungendo i campi richiesti dalla legislazione italiana.
Il modulo '''DDT ITALIA''' è il modulo sviluppato ad-hoc per Dolibarr ERP & CRM che consente alle aziende italiane di completare il modulo core “Spedizioni” aggiungendo i campi richiesti dalla legislazione italiana.




Riga 61: Riga 35:
= 2. Installazione del modulo in Dolibarr ERP&CRM =
= 2. Installazione del modulo in Dolibarr ERP&CRM =


<div style="color:#000000;">[[Image:Immagine2.png]]</div>
<div style="color:#000000;">[[File:Img1 ddt-italia manuale.png]]</div>
 
[[File:Img1b ddt-italia manuale.png|centro|img ddt 1.2]]
<span style="color:#000000;">Una volta scaricato il pacchetto contenente il Modulo DDT ITALIA, il contenuto va copiato nella cartella “</span><span style="color:#000000;">''/custom”''</span><span style="color:#000000;"> all’interno della directory principale di Dolibarr ERP&CRM.</span>
<span style="color:#000000;">Una volta scaricato il pacchetto contenente il Modulo DDT ITALIA, il contenuto va copiato nella cartella “</span><span style="color:#000000;">''/custom”''</span><span style="color:#000000;"> all’interno della directory principale di Dolibarr ERP&CRM.</span>


<span style="color:#000000;">Effettuata questa operazione il modulo va attivato dalla pagina </span><span style="color:#000000;"><u>Impostazioni</u></span><span style="color:#000000;"> → </span><span style="color:#000000;"><u>Moduli/Applicazioni.</u></span>
<span style="color:#000000;">Effettuata questa operazione il modulo va attivato dalla pagina </span><span style="color:#000000;"><u>Impostazioni</u></span><span style="color:#000000;"> → </span><span style="color:#000000;"><u>Moduli/Applicazioni.</u></span>
 
<div style="color:#000000;"></div>
 
 
 
 
 
 
 
 
 
 
 
 
 
<div style="color:#000000;">{{clear}}
[[Image:Immagine3.png|center]]</div>


'''Nota 1: '''dopo aver copiato il modulo nella cartella “''/custom”'', se esso non risulta ancora visibile nell’elenco dei moduli, è necessario attivare nel file di configurazione di Dolibarr ERP&CRM le due direttive seguenti:
'''Nota 1: '''dopo aver copiato il modulo nella cartella “''/custom”'', se esso non risulta ancora visibile nell’elenco dei moduli, è necessario attivare nel file di configurazione di Dolibarr ERP&CRM le due direttive seguenti:
Riga 103: Riga 61:
= 3. Configurazione del modulo  =
= 3. Configurazione del modulo  =


 
Il modulo DDT ITALIA a partire dalla versione 2.0.0 dispone di una propria area di configurazione necessaria per la corretta visualizzazione delle informazione all’interno del pdf del documento di trasporto.<div style="color:#6395ed;">Opzioni generali per il template PDF:</div>
 
'''CONFIGURAZIONE DEL MODULO'''
 
Il modulo DDT ITALIA a partire dalla versione 2.0.0 dispone di una propria area di configurazione necessaria per la corretta visualizzazione delle informazione all’interno del pdf del documento di trasporto.  
 
 
<div style="color:#6395ed;">Opzioni generali per il template PDF:</div>


sono presenti opzioni che modificano la visualizzazione delle colonne nella tabella dei prodotti presenti nel DDT e che permettono di mostrare le sole informazioni che l’operatore ritiene fondamentali.  
sono presenti opzioni che modificano la visualizzazione delle colonne nella tabella dei prodotti presenti nel DDT e che permettono di mostrare le sole informazioni che l’operatore ritiene fondamentali.  


[[File:Img2 ddt-italia manuale.png|centro|1081x1081px|img ddt 2]]


{{clear}}
[[Image:Immagine4.png|center]]


2 esempi di template pdf che è possibile ottenere modificando queste opzioni:


2 esempi di template pdf che è possibile ottenere modificando queste opzioni:
[[File:Img3 ddt-italia manuale esempio1.png]][[File:Img4 ddt-italia manuale esempio2.png|741x741px]]


[[Image:Immagine5.png]][[Image:Immagine6.png]]




Riga 130: Riga 80:


{{clear}}
{{clear}}
[[Image:Immagine7.png|center]]
[[File:Img5 ddt-italia manuale.png|centro|1082x1082px|Img5 ddt-italia manuale]]




Riga 139: Riga 89:


{{clear}}
{{clear}}
[[Image:Immagine8.png|center]]
[[File:Img6 ddt-italia manuale.png|centro|1082x1082px|Img6 ddt-italia manuale]]
 
Come nelle versioni precedenti, per inserire un luogo di destinazione merce differente dalla sede legale del cliente è necessario assegnare un contatto alla singola spedizione di tipo “'''Contatto spedizione cliente'''”. Dalla versione 2.0 del modulo sono stati aggiunti alcuni campi extrafields nella scheda del contatto che permettono la personalizzazione delle informazioni riguardanti appunto il luogo di destinazione merce.
Come nelle versioni precedenti, per inserire un luogo di destinazione merce differente dalla sede legale del cliente è necessario assegnare un contatto alla singola spedizione di tipo “'''Contatto spedizione cliente'''”. Dalla versione 2.0 del modulo sono stati aggiunti alcuni campi extrafields nella scheda del contatto che permettono la personalizzazione delle informazioni riguardanti appunto il luogo di destinazione merce.


Riga 151: Riga 100:




[[Image:Immagine9.png|left|top]][[Image:Immagine10.png]]
[[File:Img7 ddt-italia manuale.png|sinistra|Img7 ddt-italia manuale]]
 
[[File:Img8 ddt-italia manuale.png|407x407px]]
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 




'''EXTAFIELDS SCHEDA CONTATTO / INDIRIZZI'''
'''EXTAFIELDS SCHEDA CONTATTO / INDIRIZZI'''


All’interno del modulo dei Soggetti terzi è possibile visualizzare i campi aggiuntivi inseriti dal modulo DDT ITALIA. Tali campi NON devono essere modificati dall’utente per il corretto funzionamento del modulo.
All’interno del modulo dei Soggetti terzi è possibile visualizzare i campi aggiuntivi inseriti dal modulo DDT ITALIA. Tali campi NON devono essere modificati dall’utente per il corretto funzionamento del modulo.


<div style="color:#6395ed;">Extrafields contatti dei soggetti terzi</div>
<div style="color:#6395ed;">Extrafields contatti dei soggetti terzi</div>


{{clear}}
{{clear}}
[[Image:Immagine11.png|center]]
[[File:Img9 ddt-italia manuale.png|centro|1082x1082px|Img9 ddt-italia manuale]]




Riga 189: Riga 117:


{{clear}}
{{clear}}
[[Image:Immagine12.png|none]]
 
[[File:Img10 ddt-italia manuale.png]]
 




Riga 198: Riga 128:


{{clear}}
{{clear}}
[[Image:Immagine13.png|center]]
 
[[File:Img11 ddt-italia manuale.png|589x589px]]


'''ATTIVAZIONE TEMPLATE PDF “DDT ITALIA V. 2.0”'''
'''ATTIVAZIONE TEMPLATE PDF “DDT ITALIA V. 2.0”'''
Riga 209: Riga 140:


{{clear}}
{{clear}}
[[Image:Immagine14.png|none]]
[[File:Img12 ddt-italia manuale.png|centro|880x880px|Img12 ddt-italia manuale]]




Riga 216: Riga 147:




 
4. Utilizzo e funzionalità del modulo
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
= 4. Utilizzo e funzionalità del modulo =
 




Riga 258: Riga 153:


Come mostrato nella figura seguente, all’interno della scheda “Spedizioni” vengono mostrati i campi aggiuntivi seguenti:
Come mostrato nella figura seguente, all’interno della scheda “Spedizioni” vengono mostrati i campi aggiuntivi seguenti:


* '''Data documento''' → campo obbligatorio di tipo data mostrato in alto a destra nel pdf della spedizione
* '''Data documento''' → campo obbligatorio di tipo data mostrato in alto a destra nel pdf della spedizione
* '''Vettore / Conducente''' → tendina con campo modificabili da dizionario


* '''Causale del trasporto''' → tendina con campo modificabili da dizionario


* '''Aspetto esteriore dei beni''' → tendina con campo modificabili da dizionario


<div style="margin-left:1.27cm;margin-right:0cm;"></div>* '''Vettore / Conducente''' → tendina con campo modificabili da dizionario
* '''Numero di colli''' → campo di testo numerico
 
 
 
<div style="margin-left:1.27cm;margin-right:0cm;"></div>* '''Causale del trasporto''' → tendina con campo modificabili da dizionario
 
 
 
<div style="margin-left:1.27cm;margin-right:0cm;"></div>* '''Aspetto esteriore dei beni''' → tendina con campo modificabili da dizionario
 
 
 
<div style="margin-left:1.27cm;margin-right:0cm;"></div>* '''Numero di colli''' → campo di testo numerico
 
 
 
 
 
 


Tali campi sono presenti sia in fase di creazione della spedizione che in fase di modifica e risultano modificabili fino alla convalida della spedizione.
Tali campi sono presenti sia in fase di creazione della spedizione che in fase di modifica e risultano modificabili fino alla convalida della spedizione.




{{clear}}
{{clear}}
[[Image:Immagine15.png|center]]
[[File:Img13 ddt-italia manuale.png|centro|800x800px|Img13 ddt-italia manuale]]
 
'''TEMPLATE PDF SPEDIZIONI'''
'''TEMPLATE PDF SPEDIZIONI'''


Riga 307: Riga 183:


{{clear}}
{{clear}}
[[Image:Immagine16.png|center]]
[[File:Img14 ddt-italia manuale.png|centro|1081x1081px|Img14 ddt-italia manuale]]




Riga 317: Riga 193:


{{clear}}
{{clear}}
[[Image:Immagine17.png|center]]
[[File:Img15 ddt-italia manuale.png|centro|Img15 ddt-italia manuale]]




Riga 326: Riga 202:
<div style="margin-left:1.358cm;margin-right:0cm;"></div>
<div style="margin-left:1.358cm;margin-right:0cm;"></div>


<div style="margin-left:1.358cm;margin-right:0cm;">{{clear}}
<div style="margin-left:1.358cm;margin-right:0cm;">{{clear}}[[File:Img16 ddt-italia manuale.png|centro|Img16 ddt-italia manuale]]</div>
[[Image:Immagine18.png|center]]</div>




Riga 346: Riga 221:


{{clear}}
{{clear}}
[[Image:Immagine19.png|center]]
[[File:Img17 ddt-italia manuale.png|centro|1527x1527px|Img17 ddt-italia manuale]]
 
= <span style="color:#800000;">5. </span><span style="color:#800000;">Aggiornamento luglio 2021: versione 3.0</span> =


= <span style="color:#800000;">4. </span><span style="color:#800000;">Aggiornamento luglio 2021: versione 3.0</span> =


Con il rilascio della nuova versione 5.0 del modulo DDT ITALIA, è ora possibile:


Con il rilascio della nuova versione 5.0 del modulo DDT ITALIA, è ora possibile:* modificare ordini clienti già spediti
* modificare ordini clienti già spediti
* riportare in bozza spedizioni convalidate
* riportare in bozza spedizioni convalidate


'''CONFIGURAZIONE'''
'''CONFIGURAZIONE'''
Riga 365: Riga 236:


{{clear}}
{{clear}}
[[Image:Immagine20.png|none]]
 
[[File:Img18 ddt-italia manuale.png|1080x1080px]]


'''PERMESSI'''
'''PERMESSI'''
Riga 373: Riga 245:


{{clear}}
{{clear}}
[[Image:Immagine21.png|center]]
[[File:Img19 ddt-italia manuale.png|centro|Img19 ddt-italia manuale]]




Riga 381: Riga 253:


{{clear}}
{{clear}}
[[Image:Immagine22.png|none]]
 
[[File:Img20 ddt-italia manuale.png|1080x1080px]]


'''SPEDIZIONI'''
'''SPEDIZIONI'''
Riga 388: Riga 261:


{{clear}}
{{clear}}
[[Image:Immagine23.png|none]]
 
[[File:Img21 ddt-italia manuale.png|1080x1080px]]
 




Riga 397: Riga 272:


{{clear}}
{{clear}}
[[Image:Immagine24.png|center]]
 
[[File:Img22 ddt-italia manuale.png|1081x1081px]]
 




Riga 406: Riga 283:


{{clear}}
{{clear}}
[[Image:Immagine25.png|center]]
 
[[File:Img23 ddt-italia manuale.png]]
[[Categoria:Moduli]]

Versione attuale delle 15:28, 5 apr 2024

Manuale utente rev. 3


“Modulo D.D.T. ITALIA”

Versione del modulo: 3.0.0

Versione di Dolibarr supportate: >= 16.0.x

Data ultimo aggiornamento: 05 Aprile 2024

Autori: Diciannove Soc. Coop.
https://shop.19.coop


1. Introduzione

Il modulo DDT ITALIA è il modulo sviluppato ad-hoc per Dolibarr ERP & CRM che consente alle aziende italiane di completare il modulo core “Spedizioni” aggiungendo i campi richiesti dalla legislazione italiana.


Il modulo DDT ITALIA aggiunge i seguenti campi al modulo Spedizioni standard:* Data documento

  • Vettore / Conducente
  • Causale del trasporto
  • Aspetto esteriore dei beni
  • Numero di colli

Inoltre, aggiunge un nuovo template PDF all’oggetto Spedizioni che permette la stampa dei nuovi campi.

2. Installazione del modulo in Dolibarr ERP&CRM

img ddt 1.2
img ddt 1.2

Una volta scaricato il pacchetto contenente il Modulo DDT ITALIA, il contenuto va copiato nella cartella “/custom” all’interno della directory principale di Dolibarr ERP&CRM.

Effettuata questa operazione il modulo va attivato dalla pagina ImpostazioniModuli/Applicazioni.

Nota 1: dopo aver copiato il modulo nella cartella “/custom”, se esso non risulta ancora visibile nell’elenco dei moduli, è necessario attivare nel file di configurazione di Dolibarr ERP&CRM le due direttive seguenti:

$dolibarr_main_url_root_alt
$dolibarr_main_document_root_alt

eliminando le “//” iniziali e compilando con il percorso corretto.

In un’installazione Dolibarr ERP&CRM eseguita a partire da files zip o tar.gz, il file di configurazione chiamato conf.php è all’interno della cartella htdocs/conf/.


Per ulteriori informazioni consultare il link: https://wiki.dolibarr.org/index.php/FAQ_Custom_module_install


Nota 2: è necessario effettuare il login al sistema con un account avente privilegi di “Super amministratore” per poter accedere alla pagina delle Impostazioni.

3. Configurazione del modulo

Il modulo DDT ITALIA a partire dalla versione 2.0.0 dispone di una propria area di configurazione necessaria per la corretta visualizzazione delle informazione all’interno del pdf del documento di trasporto.

Opzioni generali per il template PDF:

sono presenti opzioni che modificano la visualizzazione delle colonne nella tabella dei prodotti presenti nel DDT e che permettono di mostrare le sole informazioni che l’operatore ritiene fondamentali.

img ddt 2
img ddt 2


2 esempi di template pdf che è possibile ottenere modificando queste opzioni:


Opzioni template PDF per box “mittente” e “destinatario”:

le opzioni offrono la possibilità di mostrare la partita iva e il codice fiscale sia nel box “destinatario” che nel box “mittente”.


Template:Clear

Img5 ddt-italia manuale
Img5 ddt-italia manuale


Opzioni template PDF per box “Luogo di destinazione merce”

le opzioni offrono la possibilità di personalizzare il box riguardante il luogo di destinazione della merce.


Template:Clear

Img6 ddt-italia manuale
Img6 ddt-italia manuale

Come nelle versioni precedenti, per inserire un luogo di destinazione merce differente dalla sede legale del cliente è necessario assegnare un contatto alla singola spedizione di tipo “Contatto spedizione cliente”. Dalla versione 2.0 del modulo sono stati aggiunti alcuni campi extrafields nella scheda del contatto che permettono la personalizzazione delle informazioni riguardanti appunto il luogo di destinazione merce.



Esempi:



Img7 ddt-italia manuale
Img7 ddt-italia manuale


EXTAFIELDS SCHEDA CONTATTO / INDIRIZZI

All’interno del modulo dei Soggetti terzi è possibile visualizzare i campi aggiuntivi inseriti dal modulo DDT ITALIA. Tali campi NON devono essere modificati dall’utente per il corretto funzionamento del modulo.

Extrafields contatti dei soggetti terzi

Template:Clear

Img9 ddt-italia manuale
Img9 ddt-italia manuale


Scheda contatto/indirizzi del singolo cliente

Template:Clear



L’aggiunta dei campi extrafields nella scheda del contatto permette di gestire anche i casi più “estremi” di spedizione, in cui la ragione sociale del cliente/destinatario è diversa dalla ragione sociale del luogo di destinazione merce.


Template:Clear

ATTIVAZIONE TEMPLATE PDF “DDT ITALIA V. 2.0”

A partire dalla versione 2.0.0 del modulo è stato introdotto un nuovo template pdf per le spedizioni che, a partire dalla versione 10.x e 11.x di Dolibarr, replica tutte le nuove funzionalità del sistema e consente la gestione delle opzioni aggiuntive inserite nella configurazione del modulo DDT ITALIA.


Il template è compatibile anche con la lingua inglese essendo tradotto al 100%.


Template:Clear

Img12 ddt-italia manuale
Img12 ddt-italia manuale


Il template precedente DDT Italia può essere disattivato o eliminato se presente ancora il file.


4. Utilizzo e funzionalità del modulo


CAMPI AGGIUNTIVI NELLA SCHEDA SPEDIZIONI

Come mostrato nella figura seguente, all’interno della scheda “Spedizioni” vengono mostrati i campi aggiuntivi seguenti:

  • Data documento → campo obbligatorio di tipo data mostrato in alto a destra nel pdf della spedizione
  • Vettore / Conducente → tendina con campo modificabili da dizionario
  • Causale del trasporto → tendina con campo modificabili da dizionario
  • Aspetto esteriore dei beni → tendina con campo modificabili da dizionario
  • Numero di colli → campo di testo numerico

Tali campi sono presenti sia in fase di creazione della spedizione che in fase di modifica e risultano modificabili fino alla convalida della spedizione.


Template:Clear

Img13 ddt-italia manuale
Img13 ddt-italia manuale

TEMPLATE PDF SPEDIZIONI

Il modulo aggiunge un nuovo template pdf all’oggetto Spedizioni che introduce tante funzionalità. Di seguito le 3 principali:


  1. la possibilità di dividere il box destinatario tra “Destinatario” e “Luogo di destinazione merce”
    • per diversificare l’indirizzo di destinazione merce rispetto all’indirizzo del soggetto terzo, è necessario utilizzare la Tab “Contatti” della singola spedizione ed inserire un contatto di tipo “Contatto spedizione cliente”. In questo modo, il box “Luogo di destinazione merce” riporterà gli indirizzi del contatto selezionato al posto dell’indirizzo del soggetto terzo della spedizione e mostrerà le informazioni in base alle opzioni di configurazione del modulo stesso.


Template:Clear

Img14 ddt-italia manuale
Img14 ddt-italia manuale


  1. la stampa dei campi aggiuntivi sotto i box mittente e destinatario


Template:Clear

Img15 ddt-italia manuale
Img15 ddt-italia manuale


  1. la stampa dei box per la firma dei vari operatori


Template:Clear
Img16 ddt-italia manuale
Img16 ddt-italia manuale


I 2 box sono sempre visibili sul pdf della spedizioni in quanto contengono campi obbligatori da mostrare.







Template:Clear

Img17 ddt-italia manuale
Img17 ddt-italia manuale

4. Aggiornamento luglio 2021: versione 3.0

Con il rilascio della nuova versione 5.0 del modulo DDT ITALIA, è ora possibile:

  • modificare ordini clienti già spediti
  • riportare in bozza spedizioni convalidate

CONFIGURAZIONE

La pagina di configurazione presenta le opzioni seguenti:


Template:Clear

PERMESSI

Il modulo introduce anche 4 nuovi permessi che devono essere assegnati agli utenti per modificare gli ordini e le spedizioni.


Template:Clear

Img19 ddt-italia manuale
Img19 ddt-italia manuale


ORDINI CLIENTI

Dopo aver attivato le opzioni e aver assegnato i nuovi permessi all’utente sarà possibile gestire dalla nuova tab “Modifica ordine spedito” gli ordini clienti classificati come “spediti” o “in corso di spedizione”. La pagina permette di modificare le informazioni dei prodotti già spediti, aggiungere nuovi prodotti oppure eliminare prodotti non spediti (e non fatturati).

Template:Clear

SPEDIZIONI

Nella scheda delle spedizioni il modulo DDT ITALIA introduce un nuovo bottone “MODIFICA” per riportare in bozza le spedizioni in stato “Convalidato”.

Template:Clear


Con la spedizione in stato “Bozza”, è presente un altro bottone con etichetta “Aggiungi righe di ordine” che consente di selezionare le righe di ordine non ancora presenti in spedizioni per aggiungere i prodotti mancanti.



Template:Clear


Quando si riporta una spedizione in stato “Bozza”, il sistema richiede il magazzino sul quale ricaricare le scorte dei prodotti spediti (solo se è attiva la relativa configurazione nel modulo Magazzino).



Template:Clear