Configurare la numerazione delle fatture su Shopify

Obiettivo

Configurare il numero fattura inviato nei documenti SdI e PEPPOL: cifre, azzeramento annuale, prefisso, suffisso e numero di partenza.

Prerequisiti

• Accesso a Settings > Numerazione fatture nell’app POP for Shopify.

Passi

Nella card Numerazione fatture:

1. Numero di cifre — imposta il padding numerico (es. 4 → il numero 13 diventa 0013).
2. Azzera la numerazione ad ogni cambio anno — se attivo, il contatore riparte da 1 al primo gennaio.
3. Prefisso fattura — testo prima del numero (es. POP-0013).
4. Suffisso — testo dopo il numero (es. 0013-A); disattivato automaticamente se usi l’anno come suffisso.
5. Imposta l’anno come suffisso — aggiunge l’anno al numero (es. 0013/2025), con formato breve (/YY) o lungo (/YYYY) a scelta.

Nella sotto-sezione Prossimo numero disponibile puoi impostare manualmente il prossimo numero fattura e l’anno di riferimento del progressivo (utile dopo una migrazione o per allinearti a una numerazione già in uso altrove) e confermare con Imposta manualmente.

Verifica

• Genera un documento di prova (in sandbox, vedi use-sandbox-environment) e controlla che il numero fattura rispetti cifre, prefisso e suffisso configurati.
• Dopo un’impostazione manuale del numero, il primo documento generato deve usare esattamente quel numero.

Errori comuni

• “Errore nella numerazione delle fatture: {messaggio}” — la generazione del numero fattura ha fallito lato POP; riprova, e se persiste verifica che non ci sia un numero manuale incoerente impostato di recente.
• Il numero non si azzera all’anno nuovo — controlla che Azzera la numerazione ad ogni cambio anno sia attivo; questa impostazione è indipendente dal reset del progressivo file.
• Confondere questa numerazione con il “progressivo file” — la numerazione fattura è il numero legale del documento (SdI/PEPPOL); il progressivo file è un contatore separato usato solo nel nome del file generato. Vedi shopify-file-progressive-number.

Configurazione correlata

Per il contratto dei campi numero fattura nel payload, vedi api/sdi e api/peppol.