Esportazioni CSV per ordini e fatture: estrarre i dati da PrestaShop

Revisionato e aggiornato a giugno 2026 — strumenti di esportazione nativi, SQL Manager e trappole della codifica CSV verificati su PrestaShop 1.7, 8 e 9.

Prima o poi ogni negozio PrestaShop si scontra con lo stesso limite: i dati che ti servono sono dentro il negozio, ma le persone e i sistemi che devono usarli sono altrove. Il tuo commercialista vuole i totali degli ordini suddivisi per aliquota IVA. Il magazzino vuole gli ordini di oggi non ancora spediti come lista di prelievo. Tu vuoi le fatture dell'ultimo trimestre in un foglio di calcolo che puoi ordinare e analizzare con tabelle pivot. PrestaShop contiene tutto — la questione è come ottenere dal back office un CSV pulito, senza caratteri illeggibili, colonne disallineate o file che il gestionale contabile rifiuta di importare.

Questa guida riguarda nello specifico l'esportazione di ordini e fatture in CSV: cosa offrono davvero gli strumenti nativi di PrestaShop, quali trappole di codifica e formato locale possono corrompere silenziosamente quei file, e come estrarre esattamente le colonne che ti servono. Esportare il catalogo prodotti è un altro lavoro, con particolarità proprie — per quello, leggi importazione ed esportazione dei prodotti in PrestaShop.

Cosa offre PrestaShop già di base

PrestaShop offre due modi nativi per estrarre i dati degli ordini, e la maggior parte dei commercianti conosce solo quello più limitato.

Il pulsante Esporta nella pagina elenco

Apri Ordini → Ordini e nella barra degli strumenti in alto trovi un pulsante Esporta. Cliccalo e PrestaShop ti consegna un CSV dell'elenco ordini esattamente come appare nella griglia — ed è qui il limite. Esporta le colonne visibili dell'elenco (riferimento, cliente, totale, pagamento, stato, data), rispettando i filtri che hai impostato sulla griglia, e nulla di più. Non puoi aggiungere la partita IVA di fatturazione, non puoi separare il totale in imponibile e imposta, e non puoi estrarre le righe per singolo prodotto. È l'istantanea di una schermata, non uno strumento di reportistica. Lo stesso pulsante esiste in Clienti → Clienti e nel catalogo, con la stessa limitazione a colonne fisse.

SQL Manager — lo strumento potente di cui nessuno parla

Il secondo percorso è nascosto sotto Parametri avanzati → Database → SQL Manager. Ti permette di scrivere una query SQL di sola lettura SELECT sul database ed esportare il risultato direttamente in CSV. Vuoi tutti gli ordini del mese scorso con la partita IVA del cliente, il totale fattura suddiviso tra imponibile e lordo, e il nome del corriere? È una sola query che unisce ps_orders, ps_customer, ps_address e ps_order_invoice, e SQL Manager la esporta con un clic.

Il limite, detto chiaramente: serve SQL. Le tabelle degli ordini non sono intuitive — i totali sono distribuiti su più colonne (total_paid, total_paid_tax_incl, total_paid_tax_excl), i dati della fattura stanno in una tabella separata ps_order_invoice collegata all'ordine, e le ripartizioni delle imposte sono sparse in ps_order_detail_tax. Sbaglia una join e conterai righe due volte senza accorgertene, oppure perderai gli ordini che non hanno ancora una fattura. Per una richiesta amministrativa una tantum è lo strumento più capace presente nel core; per un report che esegui ogni mese, modificare SQL a mano invecchia in fretta — ed è proprio il vuoto che il resto di questa guida affronta.

Per renderlo concreto, ecco una query di sola lettura che puoi incollare in SQL Manager per un'esportazione contabile mensile — riferimento ordine, totali netto e lordo, e numero fattura, per un intervallo di date:

SELECT o.id_order,
       o.reference,
       o.total_paid_tax_excl,
       o.total_paid_tax_incl,
       oi.number AS invoice_number,
       o.date_add
FROM ps_orders o
LEFT JOIN ps_order_invoice oi
  ON oi.id_order = o.id_order
WHERE o.date_add >= '2026-06-01 00:00:00'
  AND o.date_add <  '2026-07-01 00:00:00'
ORDER BY o.id_order;

Il LEFT JOIN è importante: mantiene anche gli ordini che non hanno ancora una fattura (un INNER JOIN li eliminerebbe silenziosamente). Legge soltanto — non scrive nulla. Aggiungi AND o.valid = 1 se vuoi solo gli ordini che PrestaShop considera vendite effettive. Va bene per un'estrazione occasionale; il problema inizia quando esegui la stessa query, la riformatti e la invii via email ogni settimana — è quella ripetizione che gli esportatori senza SQL qui sotto eliminano.

Le trappole che corrompono un CSV PrestaShop

La maggior parte dei reclami del tipo "l'esportazione non funziona" non riguarda dati mancanti — riguarda un file che si apre male. Tre aspetti causano quasi tutti i problemi, e vale la pena capirli perché colpiscono allo stesso modo l'esportazione nativa, le esportazioni da SQL Manager e qualunque modulo.

Le correzioni sono poco scenografiche ma imprescindibili: scrivere il file in UTF-8 con BOM, così Excel legge correttamente gli accenti con un doppio clic; mantenere il punto come separatore decimale e lasciare che il software di importazione applichi il formato locale; e racchiudere tra virgolette ogni campo testuale che potrebbe contenere una virgola, virgolette o un a capo. Un'esportazione ben costruita fa tutte e tre le cose per te. Quando ti arrangi con SQL Manager, in particolare, il BOM è quello che dimenticherai — ed è il motivo per cui gli stessi dati si vedono bene in Google Sheets ma risultano corrotti nell'Excel di un collega.

Oltre l'esportazione integrata: scegliere colonne e filtri

L'esigenza reale di tutti i giorni non è "tutti gli ordini" — è "questi ordini, con queste colonne." Lavori diversi richiedono forme diverse degli stessi dati, ed è esattamente ciò che l'Esporta nativo della lista non può fare. È il motivo per cui esiste il nostro Orders CSV List Exporter: aggiunge al back office una vera schermata di esportazione in cui scegli le colonne e restringi le righe, senza scrivere una riga di SQL.

Cosa significa in pratica? Scegli da gruppi di colonne — informazioni sull'ordine, numeri di fattura / bolla di consegna, totali (ogni importo imponibile e lordo separatamente), cliente, indirizzi completi di consegna e fatturazione inclusa la partita IVA, e righe prodotto — e selezioni solo quelle necessarie per un determinato report. Poi restringi le righe per intervallo di date, uno o più stati ordine e metodo di pagamento, in qualunque combinazione. "Tutti gli ordini pagati e spediti del mese scorso, con numeri fattura e totali suddivisi per imposta" diventa questione di pochi clic invece che di una query. Il modulo scrive in UTF-8 con BOM e con la corretta gestione delle virgolette nei campi, quindi il file si apre pulito in Excel al primo tentativo — le trappole sopra sono già gestite. Funziona interamente dal back office e legge i dati aggiornati senza toccare il core, quindi un aggiornamento non può romperlo.

Siamo precisi su cosa è e cosa non è: è un'esportazione su richiesta, che lanci quando ti serve, con le colonne e i filtri che scegli — non uno schedulatore, non un caricatore FTP, non una pipeline di invio email. Se il tuo obiettivo è ottenere in pochi secondi, senza SQL, un file pronto per la contabilità o per il magazzino, è esattamente il lavoro per cui è pensato.

Le fatture richiedono un'esportazione propria

I dati delle fatture non sono semplicemente "ordini con un altro nome." Una fattura è un documento contabile legale con un proprio numero progressivo, una propria data, una propria ripartizione per aliquota, e non sempre corrisponde uno a uno a un ordine. Per la contabilità, di solito vuoi usare la fattura come unità, non l'ordine — per questo il nostro Invoice CSV List Exporter è uno strumento separato: filtra per intervallo di date, stato ordine e metodo di pagamento, e genera un CSV strutturato per l'importazione contabile invece che per il prelievo in magazzino.

Vale la pena evidenziare un punto a monte: un'esportazione è pulita solo quanto la numerazione su cui si basa. Se i numeri fattura hanno buchi o ripartenze — cosa comune dopo i test, o quando la sequenza predefinita di PrestaShop si reimposta in modo anomalo — il commercialista respingerà il file anche se il CSV è ordinatissimo. Una numerazione progressiva e senza salti è lo scopo del nostro modulo Invoice Number, e conviene sistemarla prima di iniziare a esportare per la dichiarazione fiscale.

Esportazioni frequenti e come strutturarle

Contabilità mensile

Filtra per l'intervallo di date del mese e per gli stati che contano come vendita effettiva (di solito Pagamento accettato, Spedito, Consegnato — non Annullato o Errore di pagamento). Includi numero fattura, data fattura, totali netto e lordo, e partita IVA del cliente. Consegnalo al commercialista o importalo direttamente nel tuo software contabile. Farlo dall'esportatore fatture mantiene corretta l'unità per i libri contabili.

Liste di prelievo per il magazzino

Filtra per la data di oggi e per gli stati "da preparare", includi righe prodotto, quantità e indirizzo di consegna, e salta tutto ciò che è finanziario. È essenzialmente un'attività di evasione ordine; se il punto in cui perdi tempo è il flusso di prelievo e imballaggio, l'esportazione è solo una parte di un quadro più ampio trattato in flussi di gestione ordini che ti fanno risparmiare ore.

Report IVA e OSS

Per le dichiarazioni OSS dell'Unione Europea servono le vendite suddivise per Paese di destinazione e aliquota. Esporta i totali fattura con il Paese di consegna e gli importi IVA per aliquota, poi crea una tabella pivot nel foglio di calcolo per Paese. È l'esportazione in cui BOM e gestione del separatore decimale contano di più — un errore con la virgola decimale può gonfiare silenziosamente il totale di un Paese.

Segmentazione clienti

Esportare i clienti e il loro storico acquisti per una piattaforma marketing è un'esigenza collegata ma distinta — parte dall'elenco clienti, non dagli ordini, e alimenta strumenti email invece della contabilità. Invece di allargare questa guida anche a quel tema, lo trattiamo separatamente; qui l'esportazione ordini serve a contabilità ed evasione.

Domande frequenti

Come esporto gli ordini da PrestaShop in CSV?

Ci sono due percorsi nativi. Il pulsante Esporta in Ordini → Ordini ti dà le colonne visibili della griglia, rispettando i filtri — rapido, ma non puoi aggiungere campi come la partita IVA o separare i totali in imponibile e imposta. Per il pieno controllo, Parametri avanzati → Database → SQL Manager esegue una SELECT di sola lettura ed esporta il risultato; è lo strumento core più potente, ma richiede SQL. Per esportazioni ripetibili, senza SQL, con colonne e filtri scelti, Orders CSV List Exporter aggiunge una vera schermata di esportazione.

Perché il mio CSV esportato mostra caratteri illeggibili come "Müller"?

Excel sta leggendo il file con il formato locale del sistema invece che come UTF-8, perché il file non contiene un byte-order mark (BOM). Scrivi il CSV in UTF-8 con BOM e i nomi accentati vengono visualizzati correttamente con un doppio clic. È la trappola che dimenticherai quando creerai un'esportazione personalizzata tramite SQL Manager — ed è il motivo per cui lo stesso file appare corretto in Google Sheets ma rovinato nell'Excel di un collega.

Perché alcune righe slittano lateralmente o si dividono in colonne extra?

Le cause sono due. Nei formati locali con virgola decimale (DE, FR, PL), un totale come €1.299,00 entra in conflitto con il delimitatore CSV a virgola e finisce distribuito su più colonne — mantieni il punto come separatore decimale e lascia che il software di importazione applichi il formato locale. Inoltre, qualunque campo di testo libero che contiene una virgola ("12, Rue de la Paix") deve essere racchiuso tra virgolette, altrimenti rompe la riga. Un'esportazione ben costruita racchiude tra virgolette ogni campo testuale che potrebbe contenere il delimitatore, virgolette o un a capo.

Devo esportare ordini o fatture per il mio commercialista?

Di solito, le fatture. Una fattura è un documento legale con un proprio numero progressivo, una data e una ripartizione per aliquota, e può non corrispondere uno a uno a un ordine — quindi per la contabilità vuoi la fattura come unità. Invoice CSV List Exporter genera un CSV strutturato per l'importazione contabile. Prima assicurati che la numerazione delle fatture sia senza salti (i test spesso lasciano buchi); il modulo Invoice Number gestisce questo aspetto, e conviene sistemarlo prima di esportare per la dichiarazione fiscale.

Quando vale la pena automatizzare le esportazioni invece di lanciarle a mano?

Quando qualcuno accede, esegue ogni settimana la stessa esportazione con gli stessi filtri, la riformatta e la invia via email alla stessa persona — quello è un processo, non un'attività. Per un flusso davvero in tempo reale, da sistema a sistema (ordini inviati a un ERP nel momento in cui vengono effettuati), la strada è l'API web service di PrestaShop, con Zapier o Make per inoltrare i file. Al di sotto di quella soglia, un'esportazione su richiesta veloce, filtrata e codificata correttamente è meno fragile di una pipeline da mantenere.

Quando automatizzare e quando non ne vale la pena

Le esportazioni manuali vanno benissimo per esigenze occasionali — una richiesta amministrativa una tantum, un'analisi ad hoc. Il test onesto è frequenza e ripetizione: se qualcuno del tuo team entra nel back office, esegue la stessa esportazione con gli stessi filtri, riformatta il file e lo invia via email alla stessa persona ogni singola settimana, quello è un processo da automatizzare, non un'attività da fare a mano. L'API web service di PrestaShop è la strada per un flusso dati realmente in tempo reale, da sistema a sistema (ordini inviati a un ERP appena vengono effettuati), e strumenti come Zapier o Make possono inoltrare un file generato. Per tutto ciò che sta sotto quella soglia, un'esportazione su richiesta veloce, filtrata e codificata correttamente non è solo sufficiente — è meno fragile di una pipeline che devi mantenere.

Il principio alla base di tutto: PrestaShop contiene già dati di ordini e fatture puliti e strutturati. Estrarli bene significa soprattutto due cose — prendere esattamente le colonne e le righe che servono a un determinato lavoro, e scrivere un file che si apra correttamente in qualunque software lo leggerà dopo. Sistemati questi due aspetti, "estrarre i dati" smette di essere un mal di testa ricorrente e diventa un'attività da trenta secondi.