DF ERP Bridge — Esportazione ERP pianificata (Sage 100, EBP, Cegid, Codial)

DF ERP Bridge esporta automaticamente i tuoi ordini, clienti e stock di PrestaShop verso il tuo software gestionale — Sage 100, EBP, Cegid, Codial — o verso un formato generico CSV, XML o JSON. I file vengono generati con la cadenza che definisci e consegnati automaticamente via FTP/FTPS o e-mail, sotto il controllo di un cron. Questa guida copre l’installazione, la creazione dei profili, i formati, i trasporti, la pianificazione e la sicurezza.

Installazione

1. Nel back office, apri Moduli > Gestione moduli, clicca su Carica un modulo e rilascia il file dferpbridge.zip.
2. Una volta installato, clicca su Configura.
3. Alla prima installazione viene generato automaticamente un token cron e la conservazione dei registri è impostata a 30 giorni. Entrambi si possono modificare nella sezione Impostazioni in fondo alla pagina di configurazione.

Creare un profilo di esportazione

Un profilo descrive un’esportazione: quali dati, in quale formato, verso quale destinazione e con quale frequenza. Puoi creare tutti i profili che desideri. Clicca su Aggiungi un profilo e compila i campi.

Campi principali

• Nome del profilo — un’etichetta che ti aiuta a identificarlo (es. «Ordini verso Sage — giornaliero»).
• Dati da esportare — Ordini, Clienti o Stock.
• Formato ERP — Sage 100, EBP, Cegid, Codial, o un formato generico CSV / XML / JSON.
• Trasporto — Caricamento FTP o allegato e-mail.
• Frequenza — Oraria, Giornaliera o Settimanale. Valutata a ogni chiamata del cron.
• Filtro stati dell’ordine — (solo ordini) selezione multipla; lascia vuoto per esportare tutti gli stati.
• Esportazione incrementale — esporta solo i record creati dall’ultima esecuzione.
• Attivo — un profilo inattivo viene ignorato dal cron ma può comunque essere eseguito manualmente.

I formati di esportazione

I quattro preset ERP vengono prodotti in codifica Windows-1252, con separatore punto e virgola, fine riga CRLF e decimali con virgola — la convenzione attesa dagli strumenti di importazione francesi. I formati generici vengono generati in UTF-8.

Sage 100

File .txt a due livelli: righe di testata «E» seguite dalle loro righe di dettaglio «L», in una struttura compatibile con l’importazione di documenti di Sage 100 Gestion Commerciale. Le spese di spedizione vengono aggiunte in una riga dedicata «PORT». L’ordine delle colonne è rimappabile nella procedura guidata «formato di importazione configurabile» di Sage.

EBP

File .csv piatto con riga di intestazioni, una riga per riga d’ordine (i campi di testata vengono ripetuti). Adatto all’importazione configurabile di EBP Gestion Commerciale.

Cegid

Documento .xml strutturato in DOCUMENTS / DOCUMENT con un blocco ENTETE e un blocco LIGNES, per l’integrazione di documenti in stile Cegid Business / XRP Flex.

Codial

File .csv piatto con intestazioni, una riga per riga d’ordine, pensato per il modulo di importazione configurabile di Codial.

Generici CSV / XML / JSON

Per qualsiasi altro strumento (Odoo, Dolibarr, un ERP interno, un foglio di calcolo), questi formati esportano tutti i campi in UTF-8. Il CSV generico include un BOM per un’apertura corretta in Excel; l’XML annida le righe sotto ogni ordine; il JSON incapsula i record in un involucro con entità, data e numero.

Trasporti

FTP / FTPS

Indica l’host, la porta (21 per impostazione predefinita), l’utente, la password e il percorso remoto (es. /exports/prestashop). La modalità passiva e l’SSL esplicito (FTPS) sono supportati tramite interruttori dedicati.

E-mail

Il file viene inviato come allegato all’indirizzo indicato in E-mail destinatario. I modelli e-mail sono forniti in francese e inglese.

Pianificazione tramite cron

Il pannello Esecuzione pianificata (cron) mostra l’URL protetto da richiamare. Aggiungilo al tuo crontab o a un servizio di cron. A ogni chiamata vengono eseguiti solo i profili la cui frequenza è scaduta (con una tolleranza di 5 minuti).

*/15 * * * * curl -s "https://il-tuo-negozio.tld/module/dferpbridge/cron?token=IL_TUO_TOKEN" > /dev/null 2>&1

Parametri opzionali dell’URL:

• id_profile=N — esegue un solo profilo.
• force=1 — ignora il controllo della frequenza ed esegue comunque.

Esecuzione manuale

Ogni profilo dispone di un pulsante Esegui ora sotto l’elenco, che avvia l’esportazione immediatamente ignorando la frequenza — utile per testare un profilo dopo la configurazione.

Esportazione incrementale e filtri

In modalità incrementale, gli ordini e i clienti esportati sono solo quelli creati dopo la data dell’ultima esecuzione riuscita, il che evita duplicati nel tuo ERP. Lo stock viene sempre esportato come istantanea completa, indipendentemente da questa impostazione.

Per gli ordini, il filtro stati limita l’esportazione agli stati selezionati (ad esempio «Pagamento accettato» e «Spedito»). Ogni ordine include le sue righe di dettaglio, l’IVA per riga, le spese di spedizione e l’indirizzo di fatturazione completo (SIRET, IVA intracomunitaria).

Registro delle esportazioni e conservazione

Le ultime 20 esportazioni compaiono nel back office con il loro stato (successo, vuoto, errore), il numero di record, il file generato e un eventuale messaggio. I registri più vecchi del periodo di conservazione configurato (30 giorni per impostazione predefinita) vengono ripuliti automaticamente a ogni esecuzione del cron.

Sicurezza

• L’URL del cron è protetto da un token confrontato in tempo costante; una chiamata senza token valido restituisce un errore 403.
• La password FTP viene cifrata a riposo e decifrata solo al momento della connessione.
• Puoi rigenerare il token del cron dalle Impostazioni; il vecchio URL smette allora di funzionare.

Risoluzione dei problemi

«Invalid token» durante la chiamata del cron

Verifica che il token nell’URL corrisponda esattamente a quello mostrato nel pannello cron. Se è stato rigenerato, aggiorna il tuo crontab.

L’esportazione FTP non riesce

Assicurati che l’estensione PHP FTP sia disponibile sul server, che l’host e l’utente siano corretti e che il percorso remoto esista. Prova ad attivare o disattivare la modalità passiva a seconda del tuo server.

Il profilo viene eseguito ma non viene prodotto alcun file

Lo stato «vuoto» significa che nessun record corrispondeva ai filtri (ad esempio nessun nuovo ordine dall’ultima esecuzione in modalità incrementale, o un filtro di stati troppo restrittivo).

I formati XML danno errore

I preset Cegid e XML generico richiedono l’estensione PHP XMLWriter, standard sulla maggior parte degli hosting PrestaShop.

Compatibilità

• PrestaShop 8.0, 8.1, 8.2 e 9.x
• PHP da 7.4 a 8.3
• Multinegozio
• Estensione PHP FTP richiesta per il trasporto FTP; XMLWriter richiesto per i formati XML