Codici Seriali / Attrezzature: differenze tra le versioni

Da Dolibarr Wiki.
Vai alla navigazione Vai alla ricerca
Riga 349: Riga 349:
I permessi sono quelli standard dei moduli core del sistema.
I permessi sono quelli standard dei moduli core del sistema.


= <span style="color:#0563c1;"><span style="color:#800000;">14.</span></span><span style="color:#0563c1;"><span style="color:#800000;"> Riferimenti</span></span> =
= <span style="color:#0563c1;"><span style="color:#000000;">14.</span></span><span style="color:#0563c1;"><span style="color:#000000;"> Riferimenti</span></span> =





Versione delle 14:03, 10 apr 2024

Manuale utente rev. 1
“Modulo Codici Seriali / Attrezzature ”
File:Immagine1.png
Versione del modulo: 17.x.x
Versione di Dolibarr ERP&CRM supportate: 14.x / 15.x
Data: 25 Agosto 2022
Autori: Diciannove Soc. Coop.
https://shop.19.coop

Indice

1 Introduzione
2 Installazione del modulo in Dolibarr ERP&CRM
3 Attivazione e configurazione del modulo
4 Configurazione dei dizionari
5 Scheda codice seriale
6 Nuovo codice seriale
7 Elenco codici seriali
8 Integrazione modulo Fatturazione Elettronica ITA
9 Integrazione modulo DDT ITALIA
10 Permessi utenti del modulo
11 Riferimenti


1. Introduzione

Il modulo “Codici Seriali / Attrezzature” è il modulo sviluppato ad-hoc per Dolibarr ERP & CRM che consente alle aziende italiane la gestione dei codici seriali associati ai prodotti del gestionale.

Basato sulla versione 3.x del modulo “Equipement” sviluppato da Patas Monkey, il team di 19.coop ha realizzato diverse nuove funzionalità, adattato il modulo allo stile e template grafico delle ultime versioni del gestionale e inserito la traduzione completa in lingua italiana.

Il modulo attuale è completamente indipendente dal modulo originario e si integra con gli altri moduli della suite di 19.coop come: “Fatture Elettroniche ITA” e “DDT ITALIA”.

Le funzionalità principali del modulo sono:

  • gestione codici seriali dei prodotti

* notifica tramite email delle scadenze dei codici seriali

* integrazione con modulo “Fatturazione Elettronica ITA” per inserimento seriali in file xml

* integrazione con modulo “DDT ITALIA” per inserimento seriali in file PDF del D.D.T.

* nuovo campo tipologia per gestire il tipo di codice seriale


2. Installazione del modulo in Dolibarr ERP&CRM

Una volta scaricato il pacchetto contenente il Modulo “Codici Seriali / Attrezzature”, il contenuto va copiato nella cartella “File:Immagine2.png/custom” all’interno della directory principale di Dolibarr ERP&CRM. Effettuata questa operazione il modulo deve essere attivato dalla pagina ImpostazioniModuli/Applicazioni.

Template:Clear
File:Immagine3.png

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 seguente: 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. Attivazione e configurazione del modulo

ATTIVAZIONE DEL MODULO

Il modulo “Codici Seriali / Attrezzature” deve essere attivato come qualsiasi altro modulo di Dolibarr ERP/CRM (core / extra) dall’apposita pagina di elenco Moduli/Applicazioni.

Dopo aver attivato il modulo, risulta fondamentale effettuare la configurazione di alcuni parametri nella pagina di configurazione apposita, entrando da ImpostazioniModuliCodici Seriali.

La configurazione si suddivide in 4 pagine distinte, due delle quali servono solamente per aggiungere campi extrafields alla scheda del singolo codice seriale e alla scheda degli eventi.


CONFIGURAZIONE GENERALE - PARAMETRI

Parte 1: Numerazione e modello dei documenti PDF

La parte iniziale serve per configurare il modello di numerazione dei codici seriali e il modello di documento PDF da utilizzare.

Per la numerazione si consiglia di utilizzare il modello automatico mod_atlantic. Se si desidera una numerazione personalizzata scegliere il modello mod_artic e immettere il valore nella casella di testo (seguire le stesse regole dei moduli core di Dolibarr ERP/CRM).

File:Immagine4.png

Parte 2: Altre opzioni

Nella tabella sottostante sono riportate le opzioni che riguardano principalmente l’utilizzo o meno di certi campi all’interno della scheda del singolo codice seriale, come:* data di inizio 2 e data di fine 2

  • peso
  • tipologia
  • Rif. immobilizzazione contabile
File:Immagine5.png

Per abilitare l’integrazione con il modulo di fatturazione elettronica realizzato da 19.coop, abilitare l’opzione apposita.

CONFIGURAZIONE GENERALE – CRON SCADENZE CODICI SERIALI

Le impostazioni di questa parte consentono la gestione del processo pianificato che invia tramite email le notifiche di scadenza dei codici seriali.


File:Immagine6.png


È necessario indicare i giorni di anticipo con i quali ricevere la notifica. Il cron andrà impostato lato server per l’esecuzione quotidiana.


4. Configurazione dei dizionari

Il modulo necessita della configurazione di 3 dizionari differenti, accessibili dal menù: HOME → IMPOSTAZIONI → DIZIONARI


File:Immagine7.png


Per i primi 2 dizionari vengono inseriti dei valori di default all’attivazione del modulo, mentre per il terzo i valori sono da inserire manualmente se si intende utilizzare il campo “Tipologia” nella scheda del codice seriale.

5. Scheda codice seriale

La scheda anagrafica del codice seriale contiene tutti i campi che caratterizzano il codice seriale, mostrati in base alla configurazione del modulo.

In visualizzazione vengono presentati tutti i dati: in testata abbiamo il campo Rif, il prodotto a cui è legato, il magazzino e la condizione. La parte centrale è suddivisa tra i dati di acquisto e i dati di vendita. Un codice seriale può essere inserito in un solo oggetto per tipologia (fattura attiva, spedizione, ordine fornitore e fattura fornitore).

Le informazioni possono essere modificate solo quando il codice seriale è in stato ‘bozza’.


File:Immagine8.png

COLLEGA CODICI SERIALI

Il bottone “collega codici seriali” consente di creare un collegamento tra i vari codici seriali. Al click sul bottone esce il seguente popup:


File:Immagine9.png


Dopo aver selezionato il codice seriale da collegare, tra gli oggetti correlati avremo il codice seriale scelto.


File:Immagine10.png

8. Nuovo codice seriale

Esistono diversi modi per inserire nuovi codici seriali nel sistema.


METODO 1 – PAGINA NUOVO CODICE SERIALE

La pagina di inserimento di un nuovo codice seriale è raggiungibile dal menù:

PRODOTTI | SERVIZI → CODICI SERIALI → NUOVO

STEP 1 – Scelta del prodotto

Ogni codice seriale deve essere collegato ad un prodotto. Il primo step chiede all’utente a quale prodotto collegare il codice seriale e la modalità di creazione del seriale. Vi sono 3 possibilità:


  • Attribuzione con inserimento manuale: in questo caso è l’utente a scegliere il codice di riferimento di ciascun codice seriale
  • Attribuzione automatica: in base alla configurazione del modulo il sistema attribuirà il codice di riferimento
  • Lotti
File:Immagine11.png


STEP 2A – Attribuzione con inserimento manuale (Esterna)

All’interno del campo “Attribuzione con inserimento manuale dei codici (Esterna)” l’utente dovrà inserire separati da ‘;’ tutti i codici seriali che desidera creare.

File:Immagine12.png

Pagina dopo inserimento avvenuto con successo:

File:Immagine13.png

STEP 2B – Attribuzione automatica (interna)

Con questa modalità, è il sistema stesso che crea il riferimento del seriale e l’utente non può modificarlo.


File:Immagine14.png

In caso di inserimento dei seriali avvenuto correttamente il sistema compie un redirect sempre verso la pagina dei seriali del singolo prodotto.

METODO 2 – TAB “CODICI SERIALI ”SCHEDA PRODOTTO

La creazione di nuovi codici seriali può avvenire anche dalla scheda del prodotto, in particolare dalla tab “Codici Seriali” dove è presente il bottone “Crea”. Se si utilizza questo metodo, si passa direttamente allo step 2 della procedura di creazione di nuovi codici seriali.

File:Immagine15.png


METODO 3 – DA PAGINA RICEZIONE MERCI ORDINE FORNITORE

In fase di ricezione merce dell’ordine fornitore è possibile inserire i codici seriali tramite l’apposita tab presente sull’ordine fornitore. Il form consente la creazione dei codici seriali nelle varie modalità e presenta i campi principali per l’inserimento.

File:Immagine16.png

La stessa funzionalità si trova anche sulla fattura attiva e sulle spedizioni.

7. Elenco codici seriali

La pagina di elenco dei codici seriali è raggiungibile dal menù:

PRODOTTI | SERVIZI → CODICI SERIALI → ELENCO.

File:Immagine17.png


La pagina di elenco presenta tutte le informazioni della scheda codice seriali con relativi filtri e ordinamento. La parte in fondo alla pagina consente aggiornamenti massivi ad alcune informazioni dei codici seriali.


File:Immagine18.png

8. Integrazione modulo Fatturazione Elettronica ITA

Il modulo Codici Seriali è stato sviluppato con l’intento di garantire l’integrazione con il modulo Fatturazione Elettronica ITA, così da consentire l’inserimento dei codici seriali all’interno del file xml della fattura attiva.

All’interno del modulo Codici Seriali è necessario abilitare l’opzione seguente:

File:Immagine19.png

Il modulo di Fatturazione Elettronica deve avere attiva la relativa configurazione affinché l’integrazione sia completa al 100%.


File:Immagine20.png

Le fatture hanno una nuova tab “Codici seriali” dalla quale gestire i codici seriali assegnati ai singoli prodotti della fattura.

File:Immagine21.png

Dalla pagina in questione è possibile sia assegnare alla fattura i codici seriali già presenti nel database, che inserire nuovi codici seriali tramite le due opzioni seguenti:


File:Immagine22.png

Una volta assegnati i codici seriali alla riga di fattura attiva, la scheda della fattura appare così:

File:Immagine23.png

Tali codici seriali verranno inseriti sia nel file xml che nel file PDF alla convalida della fattura.


File:Immagine24.pngRIGA

FILE PDF


File:Immagine25.png

RIGA

FILE XML

9. Integrazione modulo DDT ITALIA

Il modulo Codici Seriali è stato sviluppato con l’intento di garantire l’integrazione con il modulo DDT ITALIA, così da consentire l’inserimento dei codici seriali all’interno del file PDF della spedizione.


Il modulo DDT ITALIA presenta nell’area di configurazione alcune opzioni specifiche. Per abilitare l’integrazione la prima opzione mostrata di seguito deve essere attiva.


File:Immagine26.png


Così come descritto per le fatture attive, anche le spedizioni hanno una nuova tab denominata “Codici seriali” che consente l’assegnazione dei codici seriali ai prodotti della spedizione, oppure l’inserimento di nuovo codici seriali.


File:Immagine27.png

Quando al DDT vengono assegnati codici seriali, le righe della spedizioni si presentano come mostrato nella figura seguente:


File:Immagine28.png

Il PDF della spedizione, invece, diventa così:

File:Immagine29.png

10. Permessi utenti del modulo

Il modulo introduce i seguenti permessi puntuali per gestire i codici seriali:


File:Immagine30.png

I permessi sono quelli standard dei moduli core del sistema.

14. Riferimenti

DOLIBARR: https://www.dolibarr.org/

DOLIBARR ITALIA: https://dolibarr.it/

19.COOP: https://19.coop/

SHOP 19.COOP: https://shop.19.coop/