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
Riga 1: Riga 1:
<div style="text-align:center;"></div>
<div style="text-align:center;"></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;">'''Manuale utente rev. 3'''</div>
<div style="text-align:right;">'''Manuale utente rev. 1'''</div>
<div style="text-align:right;">'''“Modulo Lettere di intenti - Esenzione I.V.A.”'''</div>
<div style="text-align:right;">'''“Modulo Esprinet importazione catalogo”'''</div>
<div style="text-align:right;">[[Image:Immagine1.png]]</div>
<div style="text-align:right;">[[Image:Immagine1.png]]</div>


Riga 19: Riga 12:
<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;"></div>
<div style="text-align:right;">[[Image:Immagine2.png]]</div>
<div style="text-align:right;">'''Versione del modulo: 6.0.x'''</div>
<div style="text-align:right;">'''Versione del modulo: 2.0.0'''</div>
<div style="text-align:right;">'''Versione di Dolibarr supportate: 12.0.x / 13.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;">'''Data: 13 Luglio 2021'''</div>
<div style="text-align:right;">'''Autori: Diciannove Soc. Coop.'''</div>
<div style="text-align:right;">'''Autori: Diciannove Soc. Coop.'''</div>


<div style="text-align:right;"></div>
<div style="text-align:right;">'''''https://shop.19.coop'''''</div>
<div style="text-align:right;">'''''https://shop.19.coop'''''</div>


<div style="text-align:right;"></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>
Riga 49: Riga 42:
| align=center| '''3'''
| align=center| '''3'''
||  
||  
|| '''Utilizzo e funzionalità del modulo'''
|| '''Configurazione del modulo'''
|- style="border:none;padding:0cm;"
|- style="border:none;padding:0cm;"
| align=center| '''4'''
| align=center| '''4'''
||  
||  
|| '''Lettere di intenti'''
|| '''Esprinet importazione catalogo'''


|-
|-
Riga 60: Riga 53:




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.
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.
 
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.
 
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.
 
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.  


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'''.
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 =
= 2. Installazione del modulo in Dolibarr ERP&CRM =


<div style="color:#000000;">[[Image:Immagine2.png]]</div>
<div style="color:#000000;">[[Image:Immagine3.png]]</div>


<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>
<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>


<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>
Riga 81: Riga 69:


<div style="color:#000000;">{{clear}}
<div style="color:#000000;">{{clear}}
[[Image:Immagine3.png|center]]</div>
[[Image:Immagine4.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 96: Riga 84:
<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>
<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>


= 3. Utilizzo e funzionalità del modulo =
= <span style="color:#800000;">3. </span><span style="color:#800000;">Configurazione</span><span style="color:#800000;"> del modulo</span> =


=== 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.


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.
Una volta attivato il modulo (pulsante toggle) si può accedere alla pagina di impostazioni (pulsante ingranaggio). La pagina di impostazioni del modulo è la seguente:


=== DIZIONARI ===
{{clear}}
[[Image:Immagine5.png|center]]


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.
Per modificare questi parametri, premere il tasto “'''Modifica'''” in fondo alla pagina.


'''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 generali:</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 -.
Il primo parametro da indicare è il login (username) di un utente del sistema, al quale andranno assegnati i privilegi per “'''eseguire i processi pianificati”'''.


'''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.
{{clear}}
[[Image:Immagine6.png|none]]


'''N4 - Operazioni esenti art.10:''' operazioni esenti come prestazioni sanitarie, prestazioni educative e giochi o scommesse.
All’utente poi si possono assegnare anche i permessi specifici introdotti dal modulo:


'''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.
{{clear}}
[[Image:Immagine7.png|center]]


'''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)
Tutte le configurazioni dei vari parametri sono descritti in maniera puntuale.


'''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)
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.


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.


{{clear}}
<div style="color:#007b8c;">Opzioni per processo pianificato (importazione tramite Cron Job automatico):</div>
[[Image:Immagine4.png|none]]
 
Queste opzioni verranno utilizzate dal processo pianificato. La prima opzione, se attivata, utilizzerà la stessa connessione indicata nella sezione precedente.
 
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).
 
È 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>”


=== SCHEDA CLIENTE ===
<div style="color:#007b8c;">Opzioni invio notifica email:</div>


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.
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 ‘,’ ).


{{clear}}
<div style="color:#007b8c;">Impostazioni modulo FTP client:</div>
[[Image:Immagine5.png|center]]


=== SCHEDA <span style="color:#4f81bd;">FATTURA</span> ATTIVA ===
Le impostazioni dell’FTP vanno configurate nel relativo modulo core del gestionale dal quale si accede sempre da Home → Impostazioni → Moduli/Applicazioni.


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.
Di seguito le impostazioni di default per il client FTP di Esprinet:


{{clear}}
[[Image:Immagine8.png]]
[[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.
'''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}}
[[Image:Immagine7.png|none]]


= 4. <span style="color:#990000;">Lettere di intenti</span> =
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:


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.
''https://dolibarr.19.coop/custom/esprinetcatalogimport/esprinetcatalogimportindex.php?cronjob=1&securitykey=SECURITYKEYCRONJOB&userlogin=esprinet&action=importcatalog''


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


Premendo il tasto “'''Crea nuova lettera di intenti'''” appare il seguente popup:
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:Immagine9.png|center]]Come nel resto del gestionale i campi in grassetto sono obbligatori.
[[Image:Immagine10.png|center]]
 
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''.  


Il campo “Numero di protocollo” contiene il valore assegnato dall’Agenzia dell’Entrate.
Una volta selezionato uno o più files, comparirà il tasto “'''IMPORTA FILE IN LOCALE'''”.  


La dicitura “Aggiungi bollo in fattura” permette di preselezionare alla convalida della fattura l’inserimento automatico del prodotto Bollo in fattura (quando non presente).
Procedendo il file verrà scaricato in una cartella dei documenti di Dolibarr e sarà disponibile nella tabellina sottostante, pronto per essere importato:


Gli articoli che vengono proposti nel campo “Articolo esenzione” sono definiti nel Dizionario “'''Esenzione I.V.A.'''”.  
{{clear}}
[[Image:Immagine11.png|none]]


La “Dicitura per fattura XML/PDF” è la descrizione testuale che verrà indicata nei documenti generati alla convalida della fattura.
La seconda voce di menù laterale, “'''Files importati'''”, è il semplice log delle importazioni manuali ed automatiche effettuate con il modulo:


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.
{{clear}}
[[Image:Immagine12.png|none]]


<div style="color:#c9211e;">'''N.B. Solo una lettera di intenti alla volta può essere attivata per lo stesso soggetto terzo.'''</div>
Per effettuare la corretta importazione dei prodotti del catalogo Esprinet è necessario creare gli appositi extrafields della scheda prodotto:


=== UTILIZZO DELLE LETTERE DI INTENTI IN FATTURA ===
{{clear}}
[[Image:Immagine13.png|none]]


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.
[[Image:Immagine14.png|center]]
 
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..).


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>

Versione delle 16:06, 19 feb 2024


Manuale utente rev. 1
“Modulo Esprinet importazione catalogo”
File:Immagine1.png
File:Immagine2.png
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

Indice

1 Introduzione
2 Installazione del modulo in Dolibarr ERP&CRM
3 Configurazione del modulo
4 Esprinet importazione catalogo

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.

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

File:Immagine3.png

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
File:Immagine4.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: 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

File:Immagine5.png

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

File:Immagine6.png

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

Template:Clear

File:Immagine7.png

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:

File:Immagine8.png

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

File:Immagine9.png

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

File:Immagine10.png

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

File:Immagine11.png

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

Template:Clear

File:Immagine12.png

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

Template:Clear

File:Immagine13.png

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

Template:Clear

File:Immagine14.png

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=86"