Esprinet importazione catalogo: differenze tra le versioni

Da Dolibarr Wiki.
Vai alla navigazione Vai alla ricerca
VisualeWikitesto
Nessun oggetto della modifica
Nessun oggetto della modifica
 
(9 versioni intermedie di uno stesso utente non sono mostrate)
Riga 1: Riga 1:
<div style="text-align:center;"></div>
<div style="text-align:right;">'''Manuale utente rev. 1
<div style="text-align:right;"></div>


'''“Modulo Esprinet importazione catalogo”'''


'''Versione del modulo: 2.0.0'''


'''Versione di Dolibarr supportate: 12.0.x / 13.0.x'''


'''Data: 13 Luglio 2021'''


'''Autori: Diciannove Soc. Coop.'''</div>
<div style="text-align:right;">'''''https://shop.19.coop'''''</div>
= 1. Introduzione =




Il modulo '''Esprinet importazione catalogo''' è il modulo sviluppato ad-hoc per Dolibarr ERP & CRM che consente l’importazione come prodotti predefiniti del catalogo “disponibilità prodotti” di Esprinet.
<br
Il modulo prevede la possibilità di collegarsi al server di Esprinet tramite protocollo s/ftp e scaricare il file del catalogo aggiornato. Tale file viene messo a disposizione dai servizi Esprinet ogni 15 minuti.


Tale operazione può essere effettuata automaticamente, tramite processo pianificato oppure manualmente.


<div style="text-align:right;"></div>
= 2. Installazione del modulo in Dolibarr ERP&CRM =
<div style="text-align:right;">'''Manuale utente rev. 3'''</div>
<div style="text-align:right;">'''“Modulo Lettere di intenti - Esenzione I.V.A.”'''</div>
<div style="text-align:right;">[[Image:Immagine1.png]]</div>


<div style="text-align:right;"></div>
<div style="color:#000000;">[[File:Img1 ddt-italia manuale.png|346x346px]]</div>
<div style="text-align:right;"></div>
<div style="text-align:right;"></div>
<div style="text-align:right;"></div>
<div style="text-align:right;"></div>
<div style="text-align:right;">'''Versione del modulo: 6.0.x'''</div>
<div style="text-align:right;">'''Versione di Dolibarr supportate: 12.0.x / 13.0.x'''</div>
<div style="text-align:right;">'''Data: 13 Luglio 2021'''</div>
<div style="text-align:right;">'''Autori: Diciannove Soc. Coop.'''</div>


<div style="text-align:right;">'''''https://shop.19.coop'''''</div>
<span style="color:#000000;">Una volta scaricato il pacchetto contenente il Modulo “</span><span style="color:#000000;">Esprinte importazione catalogo”</span><span style="color:#000000;">, 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>


<div style="text-align:right;"></div>
<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="text-align:center;"></div>
<div style="text-align:center;"></div>
<div style="text-align:center;"></div>
<div style="text-align:center;"></div>
<div style="text-align:center;"></div>
<div style="text-align:center;"></div>


'''Indice'''


{| style="border-spacing:0;width:17cm;"
<div style="color:#000000;">{{clear}}</div>
|- 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'''
||
|| '''Utilizzo e funzionalità del modulo'''
|- style="border:none;padding:0cm;"
| align=center| '''4'''
||
|| '''Lettere di intenti'''


|-
'''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:
|}
= 1. Introduzione =


<div style="text-align:center;">$dolibarr_main_url_root_alt
$dolibarr_main_document_root_alt
</div>eliminando le “//” iniziali e compilando con il percorso corretto.


Il modulo '''ESENZIONE I.V.A – Lettere di intenti'''. è il modulo sviluppato ad-hoc per Dolibarr ERP & CRM che consente alle aziende italiane di integrare la gestione dell’esenzione I.V.A. e delle lettere di intenti all’interno del gestionale e della fatturazione elettronica.
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/.''


Fin dalla prima versione il modulo permette l’assegnazione ad un cliente della relativa esenzione I.V.A. ed in fase di creazione della fattura elettronica riconosce ed associa la relativa esenzione codificata dal Sistema di Interscambio (N1, N2 … N7) da inserire nel file xml.  
Per ulteriori informazioni consultare il link: [https://wiki.dolibarr.org/index.php/FAQ_Custom_module_install https://wiki.dolibarr.org/index.php/FAQ_Custom_module_install]


Il modulo consente, inoltre, di aggiungere la dicitura di esenzione I.V.A. anche nel PDF delle fatture attive, anche se il documento ha ormai perso valenza fiscale con l’avvento della fatturazione elettronica.
<span style="color:#000000;">'''Nota 2'''</span><span style="color:#000000;">: è necessario effettuare il login al sistema con un account avente privilegi di “Super amministratore” per poter accedere alla pagina delle Impostazioni.</span>


A partire dalla versione 5.x, è stata introdotta la possibilità di gestire in maniera puntuale le '''lettere di intenti '''nel corso dei vari anni fiscali; tale gestione va a sostituire la precedente gestione delle esenzioni per i soggetti terzi di Dolibarr. Questo manuale manterrà le indicazioni per l’utilizzo delle precedenti versioni del modulo, a beneficio dei clienti che non hanno ancora acquistato il nuovo modulo.
= <span style="color:#800000;">3. </span><span style="color:#800000;">Configurazione</span><span style="color:#800000;"> del modulo</span> =


Per avere indicazioni sull’utilizzo delle funzionalità relative alle lettere di intenti si prega di saltare, dopo aver letto il successivo punto per l’installazione del modulo, al punto '''4 – Lettere di intenti'''.
Una volta effettuato l’accesso con un account avente i privilegi di “Super Amministratore”, si accede al menù laterale “'''Impostazioni'''” e quindi “'''Moduli/Applicazioni'''”. Si scorre la pagina fino ad arrivare al modulo “Esprinet Importazione Catalogo” oppure si utilizza l’apposita funzione di ricerca in cima alla pagina.  


Una volta attivato il modulo (pulsante toggle) si può accedere alla pagina di impostazioni (pulsante ingranaggio). La pagina di impostazioni del modulo è la seguente:


= 2. Installazione del modulo in Dolibarr ERP&CRM =
{{clear}}


<div style="color:#000000;">[[Image:Immagine2.png]]</div>
[[File:Img4 import esprinet catalogo manuale.png|1080x1080px]]


<span style="color:#000000;">Una volta scaricato il pacchetto contenente il Modulo ESENZIONE IVA, 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>
Per modificare questi parametri, premere il tasto “'''Modifica'''” in fondo alla pagina.


<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:#007b8c;">Opzioni generali:</div>


Il primo parametro da indicare è il login (username) di un utente del sistema, al quale andranno assegnati i privilegi per “'''eseguire i processi pianificati”'''.


<div style="color:#000000;">{{clear}}
{{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:
[[File:Img5 import esprinet catalogo manuale.png|1080x1080px]]


<div style="text-align:center;">$dolibarr_main_url_root_alt </div>
All’utente poi si possono assegnare anche i permessi specifici introdotti dal modulo:
<div style="text-align:center;">$dolibarr_main_document_root_alt </div>


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


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/.''
[[File:Img6 import esprinet catalogo manuale.png|1080x1080px]]


Per ulteriori informazioni consultare il link: [https://wiki.dolibarr.org/index.php/FAQ_Custom_module_install https://wiki.dolibarr.org/index.php/FAQ_Custom_module_install]
Tutte le configurazioni dei vari parametri sono descritti in maniera puntuale.


<span style="color:#000000;">'''Nota 2'''</span><span style="color:#000000;">: è necessario effettuare il login al sistema con un account avente privilegi di “Super amministratore” per poter accedere alla pagina delle Impostazioni.</span>
L’opzione “<span style="color:#202020;">Effettua il backup del database prima dell'importazione del catalogo</span>”, se attivata, effettuerà un backup di tutto il database '''prima''' di effettuare l’aggiornamento del catalogo. Si consiglia l’attivazione di questa opzione.


= 3. Utilizzo e funzionalità del modulo =
Le ultime due opzioni determinano se utilizzare una connessione via s/ftp per scaricare direttamente dal repository Esprinet il catalogo (versione più aggiornata) da importare in Dolibarr. Nell’ultima opzione “<span style="color:#202020;">Connessione FTP per download file zip catalogo</span>”, andrà selezionata quale connessione FTP, configurata nel modulo FTP (vedi procedura a seguire), utilizzare per il download del file DispoP contenente il catalogo.


=== CONFIGURAZIONE DEL MODULO ===
<div style="color:#007b8c;">Opzioni per processo pianificato (importazione tramite Cron Job automatico):</div>


L’unica configurazione richiesta del modulo riguarda l’inserimento della dicitura di Esenzione I.V.A. all’interno del PDF delle fatture attive. È possibile scegliere se inserire la dicitura dopo ogni riga di fattura o solamente al termine di tutte le righe.
Queste opzioni verranno utilizzate dal processo pianificato. La prima opzione, se attivata, utilizzerà la stessa connessione indicata nella sezione precedente.


=== DIZIONARI ===
L’opzione “<span style="color:#202020;">Percorso del file zip da prelevare rispetto la root del server FTP (es. "cartella1/cartella2/" oppure "/" per indicare la cartella root)</span>” di default può essere lasciata vuota (equivale a “/”) così come la terza opzione “<span style="color:#202020;">Nome del file zip da utilizzare per l'importazione automatica (es. dispoP.xml.zip)</span>” è corretto inserire il valore di esempio '''dispoP.xml.zip''' (Consultare comunque Esprinet in caso di configurazioni particolari).


Tramite lo strumento dei “Dizionari” messo a disposizione da Dolibarr, il modulo permette all’utente di inserire le diverse diciture di Esenzioni I.V.A. necessarie per la propria attività. Per ogni esenzione è obbligatorio inserire la corrispettiva dicitura (N1, N2, ….N7) da inserire nel file xml della fattura attiva.
È possibile avviare manualmente il processo pianificato visitando il link “<span style="color:#000000;">URL per controllare ed eseguire il processo di importazione catalogo in cron</span>”


'''N1 - Operazioni escluse ex art. 15:''' cioè, esclusione IVA per interessi di ritardi o mora non concordati, beni ceduti a titolo di sconto, premio o abbuono, per spese in nome e per conto di terzi tramite accordo esplicito, per imballaggi a rendere e per rivalsa IVA.
<div style="color:#007b8c;">Opzioni invio notifica email:</div>


'''N2 - Operazioni non soggette: '''prestazioni di beni o servizi extra UE. Acquisto fuori campo IVA ex articolo 74 del d.P.R. n 633/1972 commi 1 e 2, cioè articoli tabaccheria, riviste e prestazioni di telefonia al pubblico.Fatture ricevute da contribuenti che si sono avvalsi dei Regimi agevolati, di cui all’articolo 27, commi 1 e 2 del decreto legge n. 98/2011 - regime di vantaggio - e di cui all’articolo 1, commi da 54 a 89, delle Legge 190/2014 - regime forfettario -.
Abilitando tramite la relativa opzione l’invio delle notifiche email, verrà inviata una email al termine della procedura di importazione del catalogo, con oggetto e testo definiti sempre in questa sezione, agli indirizzi indicati (indirizzi email da inserire separati da una virgola ‘,’ ).


'''N3 - Operazioni non imponibili: o'''perazioni come esportazioni, ovvero una cessione di beni intra UE, con riferimento agli acquisti intracomunitari effettuati ai sensi dell’articolo 42 del decreto legge n. 331/1993.
<div style="color:#007b8c;">Impostazioni modulo FTP client:</div>


'''N4 - Operazioni esenti art.10:''' operazioni esenti come prestazioni sanitarie, prestazioni educative e giochi o scommesse.
Le impostazioni dell’FTP vanno configurate nel relativo modulo core del gestionale dal quale si accede sempre da Home → Impostazioni → Moduli/Applicazioni.


'''N5 - Operazioni nel regime del margine: '''fatture relative alle operazioni per le quali si applica il regime speciale dei beni usati (decreto-legge 23 febbraio 1995, n. 41, articolo 36 e seguenti), come ad esempio una cessione di un’autovettura usata, o quello dell’editoria.Fatture emesse senza separata indicazione dell’imposta (articolo 74-ter del d.P.R. n. 633/1972) dalle agenzie di viaggio e turismo.
Di seguito le impostazioni di default per il client FTP di Esprinet:


'''N6 - Operazioni in reverse charge: '''per le operazioni in reverse charge, per esempio i servizi di Pulizia e Manutenzione (rev. Charge Art.17 c.6 lett. A-ter)
[[File:Img7 import esprinet catalogo manuale.png|1080x1080px]]


'''N7 - IVA assolta in altro stato UE: s'''i applica principalmente a vendite a distanza o servizi elettronici online, per esempio la vendita da ecommerce (Art. 40 c. 3 e 4 e art 41 c. 1 lett. B DL 331/93)
'''N.B. '''Utente e Password vanno richiesti ad Esprinet. Il “Nome” può essere inserito a piacere, sarà l’opzione che viene presentata nelle impostazioni del modulo “Esprinet Importazione Catalogo” alla voce “<span style="color:#202020;">Connessione FTP per download file zip catalogo</span>”.




{{clear}}
NOTA: su pannello ISP CONFIG il cron job automatico per l’importazione del catalogo tutte le domeniche alle ore 3.00 è configurato nel seguente modo. Il comando lanciato per esteso:
[[Image:Immagine4.png|none]]
 
=== SCHEDA CLIENTE ===


Per ogni cliente con Esenzione I.V.A. il modulo permette di inserire il periodo di validità e la relativa dicitura. Tale assegnazione, consentirà in fase di creazione di fattura attiva l’assegnazione automatica dell’esenzione I.V.A. corretta.
''https://dolibarr.19.coop/custom/esprinetcatalogimport/esprinetcatalogimportindex.php?cronjob=1&securitykey=SECURITYKEYCRONJOB&userlogin=esprinet&action=importcatalog''


{{clear}}
{{clear}}
[[Image:Immagine5.png|center]]
=== SCHEDA <span style="color:#4f81bd;">FATTURA</span> ATTIVA ===


Quando si inseriscono righe di fattura per un cliente che ha un’esenzione I.V.A. assegnata, il sistema precompila la tendina I.V.A. al valore 0% (tramite un apposito Javascript). Inoltre, inserisce la relativa Esenzione I.V.A. per ogni riga in modo automatico fornendo all’utente il relativo avviso.
[[File:Img8 import esprinet catalogo manuale.png]]


{{clear}}
= <span style="color:#800000;">4. </span><span style="color:#800000;">Esprinet importazione catalogo</span> =
[[Image:Immagine6.png|center]]


Sempre all’interno della scheda fattura, è presente un nuovo bottone “IMPORTA ESENZIONE IVA DA CLIENTE” che permette di assegnare massivamente a tutte le righe con IVA = 0% la relativa esenzione I.V.A selezionata nella scheda del cliente. Di seguito viene mostrato il relativo messaggio prima dell’assegnazione massiva.
Attivando il modulo, verranno inserite due nuove voci di menu laterale, all’interno del menù “'''Strumenti'''”. La prima voce, '''Esprinet importazione''', consente di avviare l’importazione del catalogo manualmente. Se le impostazioni del modulo appena effettuate sono corrette, la pagina dovrebbe apparire in questo modo:


{{clear}}
{{clear}}
[[Image:Immagine7.png|none]]


= 4. <span style="color:#990000;">Lettere di intenti</span> =
[[File:Img10 import esprinet catalogo manuale.png|1080x1080px]]


Nella scheda “'''Soggetto terzo”''' è stata introdotta una nuova tab denominata “'''Lettere di intenti'''”. In questa tab vengono mostrate le lettere di intenti inserite per il soggetto terzo, con la possibilità di modifica e creazione.
In alto sono presente le informazioni riguardanti la connessione FTP con il repository Esprinet e nell’elenco vengono presentati i file selezionabili per l’importazione. Dalla configurazione del modulo sappiamo che il file da selezionare è ''dispoP.xml.zip''.  


{{clear}}
Una volta selezionato uno o più files, comparirà il tasto “'''IMPORTA FILE IN LOCALE'''”.  
[[Image:Immagine8.png|center]]


Premendo il tasto “'''Crea nuova lettera di intenti'''” appare il seguente popup:
Procedendo il file verrà scaricato in una cartella dei documenti di Dolibarr e sarà disponibile nella tabellina sottostante, pronto per essere importato:


{{clear}}
{{clear}}
[[Image:Immagine9.png|center]]Come nel resto del gestionale i campi in grassetto sono obbligatori.


Il campo “Numero di protocollo” contiene il valore assegnato dall’Agenzia dell’Entrate.
[[File:Img11 import esprinet catalogo manuale.png|1080x1080px]]


La dicitura “Aggiungi bollo in fattura” permette di preselezionare alla convalida della fattura l’inserimento automatico del prodotto Bollo in fattura (quando non presente).
La seconda voce di menù laterale, “'''Files importati'''”, è il semplice log delle importazioni manuali ed automatiche effettuate con il modulo:


Gli articoli che vengono proposti nel campo “Articolo esenzione” sono definiti nel Dizionario “'''Esenzione I.V.A.'''”.
{{clear}}


La “Dicitura per fattura XML/PDF” è la descrizione testuale che verrà indicata nei documenti generati alla convalida della fattura.
[[File:Img12 import esprinet catalogo manuale.png|1080x1080px]]


L’elenco delle lettere di intento del soggetto terzo presenta i pulsanti per attivare/disattivare la lettera di intenti, per la modifica e l’eliminazione delle stesse, nonché l’indicazione del plafond consumato nelle fatture intestate al soggetto terzo, e il plafond rimanente.
Per effettuare la corretta importazione dei prodotti del catalogo Esprinet è necessario creare gli appositi extrafields della scheda prodotto:


<div style="color:#c9211e;">'''N.B. Solo una lettera di intenti alla volta può essere attivata per lo stesso soggetto terzo.'''</div>
{{clear}}


=== UTILIZZO DELLE LETTERE DI INTENTI IN FATTURA ===
[[File:Img13 import esprinet catalogo manuale.png]]


Nella scheda della fattura attiva per i soli clienti con una lettera di intenti attiva, viene mostrato un messaggio per evidenziare la sua presenza, con l’indicazione del plafond rimanente:
Il modulo non aggiunge gli extrafields automaticamente e consente l’importazione anche se tali campi extrafields NON vengono inseriti.


{{clear}}
{{clear}}
[[Image:Immagine10.png|center]]Nella tendina in testata di fattura, “'''Lettere di intenti'''” è possibile (non obbligatorio) selezionare la lettere di intenti attiva per il soggetto terzo intestatario della fattura.


Tutte le righe inserite in fattura, dopo aver indicato la lettere di intenti in testata, avranno automaticamente indicato l’articolo di esenzione associato alla lettera (es N3.5, etc..).
[[File:Img14 import esprinet catalogo manuale.png|1080x1080px]]


Per le righe inserite prima di aver impostato in testata la lettera di intenti sarà possibile importare in un’unica soluzione l’articolo di esenzione, utilizzano il pulsante “'''IMPORTA ESENZIONE IVA DA LETTERA DI INTENTI'''”, che comparirà solo dopo che questa è stata indicata per la fattura.
N.B. sono tutti di tipo Stringa


Alla convalida della fattura, il plafond verrà scalato del totale di quest’ultima.
<div style="color:#007b8c;">Configuarzione Cron Job:</div>


Il riferimento della lettera di intenti viene inserito anche nel file xml nel campo Causale:
# tramite linea di comando:  


{{clear}}
* php cron_esprinet_start.php <IDCRONESPRINET> <NOMEFILEZIP> <TYPE> <LANGS>
[[Image:Immagine11.png|center]]
* php cron_esprinet_start.php 13 dispoP.xml.zip automatic it_IT


{{clear}}
[[Image:Immagine12.png|none]]Esempio file PDF fattura attiva con indicata la lettera di intenti:


# tramite invocazione pagina php:


<div style="color:#4f81bd;"></div>
* https://<URLDOLIBARR>/custom/esprinetcatalogimport/esprinetcatalogimportindex.php?cronjob=1&securitykey=<SECURITYKEYCRONJOB>&userlogin=<LOGINUTENTE>&action=importcatalog
<div style="color:#4f81bd;"></div>
<div style="color:#4f81bd;">'''CONFIGURAZIONE DEL MODULO'''</div>
[[Categoria:Moduli]]

Versione attuale delle 15:33, 5 apr 2024

Manuale utente rev. 1

“Modulo Esprinet importazione catalogo”

Versione del modulo: 2.0.0

Versione di Dolibarr supportate: 12.0.x / 13.0.x

Data: 13 Luglio 2021

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

1. Introduzione

Il modulo Esprinet importazione catalogo è il modulo sviluppato ad-hoc per Dolibarr ERP & CRM che consente l’importazione come prodotti predefiniti del catalogo “disponibilità prodotti” di Esprinet. <br Il modulo prevede la possibilità di collegarsi al server di Esprinet tramite protocollo s/ftp e scaricare il file del catalogo aggiornato. Tale file viene messo a disposizione dai servizi Esprinet ogni 15 minuti.

Tale operazione può essere effettuata automaticamente, tramite processo pianificato oppure manualmente.

2. Installazione del modulo in Dolibarr ERP&CRM

Una volta scaricato il pacchetto contenente il Modulo “Esprinte importazione catalogo”, 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 Impostazioni → Moduli/Applicazioni.


Template:Clear

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

Una volta effettuato l’accesso con un account avente i privilegi di “Super Amministratore”, si accede al menù laterale “Impostazioni” e quindi “Moduli/Applicazioni”. Si scorre la pagina fino ad arrivare al modulo “Esprinet Importazione Catalogo” oppure si utilizza l’apposita funzione di ricerca in cima alla pagina.

Una volta attivato il modulo (pulsante toggle) si può accedere alla pagina di impostazioni (pulsante ingranaggio). La pagina di impostazioni del modulo è la seguente:

Template:Clear

Per modificare questi parametri, premere il tasto “Modifica” in fondo alla pagina.

Opzioni generali:

Il primo parametro da indicare è il login (username) di un utente del sistema, al quale andranno assegnati i privilegi per “eseguire i processi pianificati”.

Template:Clear

All’utente poi si possono assegnare anche i permessi specifici introdotti dal modulo:

Template:Clear

Tutte le configurazioni dei vari parametri sono descritti in maniera puntuale.

L’opzione “Effettua il backup del database prima dell'importazione del catalogo”, se attivata, effettuerà un backup di tutto il database prima di effettuare l’aggiornamento del catalogo. Si consiglia l’attivazione di questa opzione.

Le ultime due opzioni determinano se utilizzare una connessione via s/ftp per scaricare direttamente dal repository Esprinet il catalogo (versione più aggiornata) da importare in Dolibarr. Nell’ultima opzione “Connessione FTP per download file zip catalogo”, andrà selezionata quale connessione FTP, configurata nel modulo FTP (vedi procedura a seguire), utilizzare per il download del file DispoP contenente il catalogo.

Opzioni per processo pianificato (importazione tramite Cron Job automatico):

Queste opzioni verranno utilizzate dal processo pianificato. La prima opzione, se attivata, utilizzerà la stessa connessione indicata nella sezione precedente.

L’opzione “Percorso del file zip da prelevare rispetto la root del server FTP (es. "cartella1/cartella2/" oppure "/" per indicare la cartella root)” di default può essere lasciata vuota (equivale a “/”) così come la terza opzione “Nome del file zip da utilizzare per l'importazione automatica (es. dispoP.xml.zip)” è corretto inserire il valore di esempio dispoP.xml.zip (Consultare comunque Esprinet in caso di configurazioni particolari).

È possibile avviare manualmente il processo pianificato visitando il link “URL per controllare ed eseguire il processo di importazione catalogo in cron”

Opzioni invio notifica email:

Abilitando tramite la relativa opzione l’invio delle notifiche email, verrà inviata una email al termine della procedura di importazione del catalogo, con oggetto e testo definiti sempre in questa sezione, agli indirizzi indicati (indirizzi email da inserire separati da una virgola ‘,’ ).

Impostazioni modulo FTP client:

Le impostazioni dell’FTP vanno configurate nel relativo modulo core del gestionale dal quale si accede sempre da Home → Impostazioni → Moduli/Applicazioni.

Di seguito le impostazioni di default per il client FTP di Esprinet:

N.B. Utente e Password vanno richiesti ad Esprinet. Il “Nome” può essere inserito a piacere, sarà l’opzione che viene presentata nelle impostazioni del modulo “Esprinet Importazione Catalogo” alla voce “Connessione FTP per download file zip catalogo”.


NOTA: su pannello ISP CONFIG il cron job automatico per l’importazione del catalogo tutte le domeniche alle ore 3.00 è configurato nel seguente modo. Il comando lanciato per esteso:

https://dolibarr.19.coop/custom/esprinetcatalogimport/esprinetcatalogimportindex.php?cronjob=1&securitykey=SECURITYKEYCRONJOB&userlogin=esprinet&action=importcatalog

Template:Clear

Attivando il modulo, verranno inserite due nuove voci di menu laterale, all’interno del menù “Strumenti”. La prima voce, Esprinet importazione, consente di avviare l’importazione del catalogo manualmente. Se le impostazioni del modulo appena effettuate sono corrette, la pagina dovrebbe apparire in questo modo:

Template:Clear

In alto sono presente le informazioni riguardanti la connessione FTP con il repository Esprinet e nell’elenco vengono presentati i file selezionabili per l’importazione. Dalla configurazione del modulo sappiamo che il file da selezionare è dispoP.xml.zip.

Una volta selezionato uno o più files, comparirà il tasto “IMPORTA FILE IN LOCALE”.

Procedendo il file verrà scaricato in una cartella dei documenti di Dolibarr e sarà disponibile nella tabellina sottostante, pronto per essere importato:

Template:Clear

La seconda voce di menù laterale, “Files importati”, è il semplice log delle importazioni manuali ed automatiche effettuate con il modulo:

Template:Clear

Per effettuare la corretta importazione dei prodotti del catalogo Esprinet è necessario creare gli appositi extrafields della scheda prodotto:

Template:Clear

Il modulo non aggiunge gli extrafields automaticamente e consente l’importazione anche se tali campi extrafields NON vengono inseriti.

Template:Clear

N.B. sono tutti di tipo Stringa

Configuarzione Cron Job:
  1. tramite linea di comando:
  • php cron_esprinet_start.php <IDCRONESPRINET> <NOMEFILEZIP> <TYPE> <LANGS>
  • php cron_esprinet_start.php 13 dispoP.xml.zip automatic it_IT


  1. tramite invocazione pagina php:
  • https://<URLDOLIBARR>/custom/esprinetcatalogimport/esprinetcatalogimportindex.php?cronjob=1&securitykey=<SECURITYKEYCRONJOB>&userlogin=<LOGINUTENTE>&action=importcatalog
Estratto da "https://wiki.doliplatform.com/index.php?title=Esprinet_importazione_catalogo&oldid=159"