Personalizzazione dei numeri di fattura e ordine: perché i numeri predefiniti non bastano

Valido per PrestaShop 1.6, 1.7, 8 e 9. Le chiavi di configurazione riportate sotto sono stabili in queste versioni; le etichette dei menu cambiano leggermente tra una versione e l'altra, quindi verifica il percorso esatto nella tua installazione. Nulla di quanto segue costituisce consulenza legale o fiscale: saranno il tuo commercialista e le norme locali a stabilire come deve essere strutturata una sequenza conforme nel tuo Paese.

Appena installato, PrestaShop assegna a ogni ordine un riferimento come "XKJHQWER" e fa partire le fatture dal numero 1. Per un catalogo di prova è un dettaglio invisibile. Nel momento in cui inizi a ricevere ordini reali diventa un problema: un addetto all'assistenza che non riesce a ripetere un numero d'ordine al telefono, un commercialista che non capisce quale documento corrisponda a cosa, e un ispettore fiscale che vuole sapere perché alla fattura #4521 segue la #4598 senza nulla in mezzo. Questa guida riguarda nello specifico i numeri: il riferimento dell'ordine e la sequenza di fatture/note di credito, cosa PrestaShop consente di modificare dal back office, dove si ferma e come ottenere uno schema di numerazione che il tuo commercialista possa approvare e la tua squadra usare davvero.

È un tema volutamente circoscritto. Il formato del PDF della fattura, le regole legali Paese per Paese su cosa debba contenere una fattura e il passaggio alla fatturazione elettronica strutturata sono problemi distinti, con risposte proprie, collegati alla fine. Qui restiamo sulla numerazione.

Cosa offre PrestaShop in modo nativo, e cosa no

In PrestaShop convivono due sistemi di numerazione diversi, che i commercianti confondono di continuo.

Il riferimento dell'ordine è il codice visibile al cliente generato nel momento in cui viene effettuato un ordine. PrestaShop lo crea in Order::generateReference() come stringa alfanumerica casuale in maiuscolo (la classica forma "XKJHQWER"). Non è sequenziale, non è configurabile dal back office e non contiene alcun significato. È quello che compare nell'email di conferma, in Ordini → Ordini e che il cliente ti legge al telefono.

Il numero di fattura è diverso: viene assegnato solo quando una fattura viene effettivamente generata (quando un ordine raggiunge uno stato contrassegnato come fattura disponibile) ed è una sequenza continua. Puoi controllarlo in minima parte da Ordini → Fatture (PrestaShop 1.7 e successivi: Vendi → Ordini → Fatture):

Questo copre le basi e, per un negozio con un solo Paese e un solo punto vendita, potrebbe essere tutto ciò che ti serve. Le lacune emergono appena la configurazione diventa anche solo un po' più esigente:

• Il riferimento dell'ordine resta casuale. Nessuna impostazione nativa lo modifica. Magazzino e assistenza restano costretti a leggere "XKJHQWER" ad alta voce.
• Nessun controllo sugli zeri iniziali. I numeri di fattura avanzano 1, 2, 3 … 999 senza modo di imporre una larghezza fissa come 00001: quindi non si ordinano né si allineano bene nelle esportazioni.
• Le note di credito native hanno una propria numerazione di base e un prefisso, ma una formattazione personalizzata limitata. PrestaShop genera le note di credito come tipo di documento separato con contatore e prefisso distinti, ma offre poco controllo su formattazione, azzeramento o serie rispetto a un modulo dedicato. Alcune giurisdizioni richiedono che le note di credito stiano in una serie chiaramente separata e autoesplicativa.
• L'anno è l'unico periodo di azzeramento. Se il tuo commercialista usa sequenze mensili, l'opzione nativa non basta.
• La differenziazione per negozio è grossolana. In un multinegozio puoi variare il prefisso per negozio, ma costruire manualmente uno schema pulito e specifico per mercato è macchinoso.

E quindi? Perché la numerazione conta davvero

È la parte che i commercianti sottovalutano finché qualcosa non si rompe. Tre vantaggi concreti:

Sicurezza in caso di controlli. Le norme UE richiedono una numerazione delle fatture sequenziale e univoca basata su una o più serie, e molte autorità fiscali si aspettano che eventuali salti siano spiegabili e documentati: un salto che non sai spiegare è il tipo di dettaglio che trasforma una verifica ordinaria in una verifica seria. Ciò che è conforme cambia da Paese a Paese, e quel livello di dettaglio appartiene alle guide legali, non a questa: vedi personalizzazione delle fatture: modelli PDF e requisiti legali per ciò che ogni mercato richiede nel documento, e la panoramica sulla normativa e-commerce nell'UE per gli obblighi più ampi. Il punto, per la numerazione, è semplice: una sequenza prevedibile e controllata è ciò che rende possibile avere "nessun salto inspiegabile" fin dall'inizio.

Assistenza più rapida. Un cliente che legge "ORD-2026-00142" al tuo operatore permette una ricerca al primo colpo. Lo stesso cliente che legge "XKJHQWER" viene frainteso sulla K o sulla Q, salta un carattere, e perdi due minuti a confermare lo spelling. Moltiplicalo per ogni chiamata all'assistenza.

Contabilità che si importa senza problemi. Che il tuo contabile usi Datev, Xero o un gestionale locale, si aspetta un formato coerente e numeri a larghezza fissa che si ordinino correttamente. Impostare il formato giusto prima della prima esportazione costa molto meno che riconciliare una discrepanza più avanti.

Progettare uno schema di numerazione robusto

Prima di toccare qualsiasi impostazione, definisci lo schema su carta. Uno schema valido è leggibile, auto-datante e a larghezza fissa. Un modello pratico:

• Prefisso che identifica documento e mercato. RE per una Rechnung tedesca, FA per una facture francese, INV per una fattura generica in inglese.
• Anno (e mese, se il tuo commercialista usa serie mensili). Rende il documento auto-datante, così non serve incrociarlo con altri dati per sapere quando è stato emesso.
• Contatore con zeri iniziali, 00001, non 1, così tutto si allinea e si ordina correttamente.
• Una serie separata per le note di credito, usa un contatore distinto per le note di credito, salvo approvazione del tuo commercialista o delle regole locali per una serie condivisa; una nota di credito è un tipo di documento autonomo e una serie distinta è di solito più chiara.

Questo produce formati come RE-2026-00001 o FV/00001/06/2026. La regola più importante della forma esatta è una sola: sceglila una volta e non cambiarla a metà periodo. Cambiare formato durante un esercizio fiscale crea registrazioni confuse e apparenti "buchi" che i revisori non apprezzano. Se devi cambiare, fallo al cambio d'anno e lascia una nota scritta per il tuo commercialista.

Ottenere il pieno controllo: la strada del modulo

Quando le impostazioni native non bastano, e per il riferimento dell'ordine non bastano subito, due dei nostri moduli colmano il vuoto, ciascuno governando uno dei due sistemi di numerazione.

Il nostro modulo Order Number sostituisce il riferimento casuale dell'ordine con uno significativo e sequenziale. Funziona sovrascrivendo la classe core Order, quindi il nuovo riferimento arriva ovunque arrivasse quello vecchio: lista del back office, account del cliente, email di conferma, senza modifiche al tema. Costruisci il formato con i segnaposto: {YYYY} per l'anno, {MM} per il mese, {NNNNNN} per un contatore con zeri iniziali, persino {PAYMENT} per includere il metodo di pagamento. Che cosa ti dà in pratica? Un riferimento come ORD-2026-000142, che il cliente può rileggere senza errori e che il magazzino può scansionare e cercare all'istante: la principale frizione quotidiana nella gestione degli ordini, eliminata.

Il nostro modulo Invoice Number fa lo stesso sul lato documenti, andando ben oltre il semplice prefisso-con-anno nativo. Imposti un prefisso personalizzato, inserisci il segnaposto {YYYY}, scegli la larghezza del contatore con {NNNN} o {NNNNNN}, imposti l'azzeramento annuale o mensile e, la parte che il core non gestisce in modo pulito, usi una sequenza separata e formattata in modo indipendente per le note di credito. E quindi? Dai al commercialista esattamente il formato richiesto, nella larghezza precisa che si importa senza correzioni manuali, con le note di credito in una serie propria chiaramente etichettata. La postura di conformità (continua, controllata, spiegabile) e la comodità contabile nascono dalla stessa impostazione.

Per il contenuto della nota di credito, più che per il suo numero, corretti dettagli fiscali, riferimenti alla fattura originale e formattazione del documento adatta alla contabilità. Serve Financial Revolution, che migliora le note di credito generate da PrestaShop in caso di rimborso. Numerazione e contenuto del documento sono volutamente ambiti separati; usa lo strumento che risolve il problema che hai davanti.

Multinegozio: uno schema per ogni negozio

Se gestisci più negozi, brand diversi, Paesi diversi, canali diversi, ciascuno dovrebbe avere il proprio contatore e il proprio prefisso. Mescolarli produce apparenti salti quando guardi i registri di un singolo negozio e rende impossibile capire a colpo d'occhio quale negozio abbia emesso un documento. Una struttura pulita:

Ogni negozio incrementa e reimposta in modo indipendente, e il mercato è leggibile dal solo prefisso. Le impostazioni delle fatture sono già sensibili al contesto in un multinegozio PrestaShop; il lato del riferimento ordine è dove un modulo si guadagna il suo posto, perché il riferimento casuale nativo non ha alcun concetto di negozio.

Migrare dai numeri predefiniti senza creare duplicati

Passare a un negozio live richiede attenzione: sbaglia il numero iniziale e puoi sovrapporlo a documenti già esistenti. La sequenza sicura:

1. Scegli una data di transizione, preferisci l'inizio di un esercizio fiscale o di un trimestre; se devi cambiare a metà periodo, documenta la modifica e mantieni la vecchia e la nuova serie chiaramente tracciabili.
2. Imposta il prossimo contatore sopra il numero più alto già esistente. Per le fatture è PS_INVOICE_START_NUMBER (o il valore iniziale del modulo); così garantisci l'assenza di duplicati.
3. Lascia intatti i vecchi documenti. Non rinumerare mai retroattivamente le fatture emesse: conservano i numeri originali per tutta la durata di conservazione legale. Solo i nuovi documenti adottano il nuovo formato.
4. Testa l'azzeramento prima di farci affidamento. Se configuri un azzeramento annuale o mensile, verifica su una copia di staging che avvenga davvero, invece di scoprirlo il 1° gennaio.
5. Scrivilo per il tuo commercialista. Una nota di una riga su cosa è cambiato e quando elimina qualsiasi dubbio sul "salto" al momento del passaggio.

Se preferisci controllare o impostare questi valori direttamente, si trovano tutti nella tabella ps_configuration come semplici righe chiave/valore. Leggili prima di cambiare qualsiasi cosa nel back office, così conosci lo stato attuale:

-- Inspect the native invoice-numbering settings
SELECT name, value
FROM ps_configuration
WHERE name IN (
  'PS_INVOICE_PREFIX',
  'PS_INVOICE_USE_YEAR',
  'PS_INVOICE_RESET',
  'PS_INVOICE_START_NUMBER',
  'PS_DELIVERY_PREFIX',
  'PS_DELIVERY_NUMBER'
);

Alcuni di questi valori sono per lingua (in particolare il prefisso), quindi in un negozio multilingua la riga può trovarsi invece in ps_configuration_lang, indicizzata da id_lang. Il posto più sicuro per impostarli resta il back office, che scrive la riga corretta per il giusto contesto di negozio e lingua; considera l'SQL sopra come un modo per vedere lo stato attuale, e fai un backup prima di qualsiasi scrittura manuale. Il prossimo numero sequenziale di fattura non è memorizzato in una singola riga di configurazione: PrestaShop lo ricava dal valore number più alto già presente in ps_order_invoice, combinato con il valore iniziale, ed è proprio per questo che impostare il numero iniziale sopra il documento esistente più alto (invece di rinumerare qualcosa) è la scelta a prova di duplicati.

Errori comuni

• Cambiare formato a metà anno. La fonte classica di contabilità confusa e salti inspiegabili. Sposta il cambio solo al confine di un periodo.
• Una sola serie per fatture e note di credito. Alcune giurisdizioni o alcuni commercialisti richiedono o preferiscono una serie separata: verifica localmente; anche dove una serie condivisa è consentita, mescolare tutto crea complicazioni contabili. Mantieni INV- e una serie distinta per le note di credito.
• Lasciare il contatore senza zeri iniziali. Numeri di larghezza diversa si ordinano male nei fogli di calcolo e nelle esportazioni. Usa una larghezza fissa fin dal primo giorno.
• Dimenticare che esiste il riferimento dell'ordine. I commercianti sistemano i numeri di fattura e lasciano gli ordini con il riferimento casuale, poi si chiedono perché le chiamate all'assistenza siano ancora lente. Sono due sistemi separati: correggili entrambi.
• Non numerare le bolle di consegna in modo coerente. Hanno meno vincoli legali, ma una sequenza irregolare delle bolle di consegna costa comunque tempo alla tua squadra di magazzino.

Dove finisce la numerazione e inizia il resto della conformità

La numerazione è solo una parte del lavoro necessario per gestire correttamente documenti e imposte in PrestaShop. Gli elementi vicini, ciascuno con la propria guida:

• Cosa deve mostrare il PDF della fattura e come costruirne il modello, personalizzazione delle fatture: modelli PDF e requisiti legali.
• Fatturazione elettronica strutturata dove è obbligatoria (SDI italiano, riforma francese e altro), fatturazione elettronica in Europa: quali Paesi la richiedono.
• Gestire correttamente l'IVA oltre confine. IVA nell'UE: OSS, IOSS e cosa deve gestire il tuo negozio PrestaShop e la guida pratica alla configurazione delle imposte in PrestaShop.
• Come appaiono i prezzi prima del pagamento, regole di visualizzazione dei prezzi in Europa.
• Gestione dei rimborsi dall'inizio alla fine, di cui la nota di credito è un passaggio, resi e rimborsi: rendere il processo semplice per tutti.

Domande frequenti

Posso rendere sequenziale il riferimento ordine di PrestaShop senza un modulo?

Non dal back office. Il riferimento dell'ordine proviene da Order::generateReference(), che restituisce una stringa casuale in maiuscolo, e non esiste un'impostazione nativa che lo modifichi. Gli unici modi per renderlo sequenziale sono sovrascrivere tu stesso la classe Order oppure usare un modulo che lo faccia: il numero di fattura è configurabile nativamente, ma il riferimento dell'ordine no.

Perché la mia numerazione delle fatture ha dei salti?

Quasi sempre perché un ordine ha generato una fattura ed è stato poi annullato o rimborsato, oppure perché uno stato che non ti aspettavi producesse fattura aveva attivo l'indicatore "Fattura". Il numero è stato assegnato e il documento è stato successivamente stornato, lasciando un buco. In diversi Paesi UE un salto è accettabile solo se puoi spiegarlo, quindi la soluzione pratica è di processo, non di cancellazione: conserva il documento stornato, annota il motivo e non rinumerare mai per "chiudere" il salto. Se i salti siano tollerati o meno dipende dalla tua giurisdizione: conferma con il tuo commercialista.

Sto migrando un negozio esistente: a cosa imposto il numero iniziale?

Impostalo a un numero superiore di uno rispetto al numero di fattura più alto che hai già emesso. PrestaShop ricava il prossimo numero dai documenti esistenti più il valore iniziale, quindi un numero iniziale superiore al massimo attuale garantisce l'assenza di collisioni. Non abbassare mai il numero iniziale sotto un documento emesso e non rinumerare mai retroattivamente le vecchie fatture: conservano i loro numeri originali per tutto il periodo di conservazione legale.

Fatture e note di credito dovrebbero condividere la stessa serie numerica?

Di solito no. Una nota di credito è un tipo di documento distinto, e molti commercialisti e alcune giurisdizioni preferiscono o richiedono una serie separata e autoesplicativa. PrestaShop assegna alle note di credito un proprio contatore di base; se ti serve una serie di note di credito formattata in modo indipendente, con un proprio azzeramento, è qui che il modulo Invoice Number va oltre l'opzione nativa. Verifica la regola locale prima di condividere una serie.

Cambiare il prefisso della fattura rinumera le mie vecchie fatture?

No. Il prefisso e i segnaposto dell'anno si applicano ai documenti generati dopo la modifica dell'impostazione; le fatture già emesse conservano il formato con cui sono state create, perché PrestaShop memorizza il numero assegnato su ogni riga ps_order_invoice. È anche il motivo per cui dovresti cambiare formato solo al confine di un periodo: mescolare due formati nello stesso esercizio fiscale produce registrazioni che i revisori trovano confuse.

La numerazione dei documenti è una di quelle impostazioni che nessuno nota quando funziona e tutti notano il giorno in cui è sbagliata. Decidi lo schema una volta sola, prefisso leggibile, data incorporata, larghezza fissa, note di credito in una serie propria, impostalo dal back office o con un modulo che colmi le lacune native, poi lascialo stabile. Se fatto bene, svolge il suo lavoro in silenzio attraverso ogni controllo, chiamata di assistenza e chiusura d'anno, per tutta la vita del negozio.