Progressivo file: il contatore usato nel nome del documento

Obiettivo

Capire cos’è il “progressivo file” e gestirne il reset (automatico o manuale), separatamente dal numero fattura legale.

Prerequisiti

• Accesso a Settings > Progressivo file nell’app POP for Shopify.

Cos’è

Il progressivo file è il contatore usato nel nome del file XML/PDF generato da POP — non è il numero fattura legale (per quello vedi shopify-invoice-numbering). È rilevante soprattutto per l’invio allo SdI, che richiede nomi file con progressivi ordinati; per PEPPOL non è obbligatorio ma è comunque consigliato mantenerlo ordinato per coerenza amministrativa.

Passi

Nella card Progressivo file:

1. Reset automatico al cambio anno — se attivo, il contatore riparte da 00001 al primo documento generato dell’anno successivo.
2. Resetta progressivo adesso — reset manuale immediato, utile dopo una migrazione o dopo test in sandbox. Usalo solo dopo aver inviato tutti i documenti dell’anno precedente.

La card mostra sempre lo stato attuale (“Stato attuale: anno {anno}, contatore {contatore}”) e la data dell’ultimo reset.

Verifica

• Dopo un reset manuale, genera un nuovo documento e controlla che il contatore nel nome file riparta da 00001.
• Con il reset automatico attivo, verifica che il primo documento generato nel nuovo anno solare riparta da 00001 senza intervento manuale.

Errori comuni

• “Reset the document progressive for {anno} in Settings before generating new files.” — POP blocca la generazione perché il progressivo dell’anno corrente non è stato ancora inizializzato/resettato: vai in Settings ed esegui Resetta progressivo adesso.
• Il progressivo non si azzera a gennaio — verifica che Reset automatico al cambio anno sia attivo; se disattivo il contatore continua a incrementare oltre il cambio anno.
• Confusione con il numero fattura — se il numero che vedi in fattura non cambia dopo un reset qui, stai probabilmente cercando l’impostazione sbagliata: il numero fattura si configura separatamente in shopify-invoice-numbering.

Configurazione correlata

Vedi api/sdi per i requisiti di nomenclatura file richiesti dal Sistema di Interscambio.