E-reporting e Piattaforma Certificata (PDP) — Documentazione
Installare e configurare il modulo e-reporting: regime IVA, periodicità, deposito PDP (API o manuale), ciclo di vita delle fatture e cron automatico.
Questo modulo trasmette all’amministrazione fiscale francese i dati delle tue transazioni B2C (e-reporting) e il ciclo di vita delle tue fatture, nell’ambito della riforma francese della fatturazione elettronica. Genera il flusso nel formato atteso dalla DGFiP (semantica CII, flux 10, in XML e JSON) e lo deposita sulla tua piattaforma certificata (Plateforme Agréée, PDP), oppure ti permette di depositarlo manualmente. Questa guida copre installazione, configurazione e uso quotidiano.
Promemoria normativo. Dal 1° settembre 2026 la ricezione delle fatture elettroniche è obbligatoria per tutte le imprese, mentre l’emissione e l’e-reporting lo diventano per le grandi e medie imprese. Le PMI e le microimprese seguono il 1° settembre 2027. Ogni trasmissione e-reporting mancante è soggetta a una sanzione di 250 € (tetto di 45.000 €/anno).
Prerequisiti
- PrestaShop da 8.0 a 9.x, PHP da 7.4 a 8.3.
- Il tuo numero SIREN (9 cifre).
- La conoscenza del tuo regime IVA (reale normale, reale semplificato o franchigia).
- Per il deposito automatico: i dati di connessione forniti dalla tua piattaforma certificata (URL di deposito, URL di stato, credenziali OAuth2 o chiave API). Non sono necessari in modalità manuale.
Installazione
- Nel back office, apri Moduli > Gestore moduli, clicca su Carica un modulo e seleziona il file ZIP.
- A installazione completata, clicca su Configura. Il modulo crea automaticamente le sue tabelle e una scheda E-reporting sotto Ordini.
- Vai alla scheda Impostazioni per la configurazione iniziale.
Configurazione iniziale
Tutte le impostazioni si trovano nella scheda Impostazioni della pagina di configurazione del modulo.
Identità e regime
- SIREN: il tuo numero di 9 cifre. Identifica il venditore in ogni flusso trasmesso.
- Regime IVA: determina la periodicità delle tue trasmissioni. Reale normale = decadale, reale semplificato = mensile, franchigia = bimestrale.
- Tipo di attività: beni, servizi o mista. Le attività di servizi e miste attivano il tracciamento degli incassi, poiché in esse l’IVA è esigibile all’incasso.
- Data di inizio: prima data a partire dalla quale il modulo raccoglie le transazioni. Impostala non prima della tua data di ingresso nell’obbligo.
Opzioni di raccolta
- Includere le vendite intracomunitarie B2B: aggiunge al flusso le vendite a professionisti di un altro Stato membro dell’UE, anch’esse soggette a e-reporting.
- Includere le note di credito: integra le note di credito nel flusso come importi negativi.
Scelta della modalità di deposito
L’impostazione Modalità PDP determina come vengono trasmessi i flussi.
Modalità manuale
Il modulo genera i flussi; tu li scarichi in XML o JSON e li depositi sul portale della tua piattaforma, poi marchi la trasmissione come depositata. È la modalità consigliata se la tua piattaforma non espone ancora un’API, o se preferisci mantenere il controllo.
Modalità API
Il modulo deposita automaticamente i flussi sulla tua piattaforma. Inserisci:
- URL di deposito e URL di stato forniti dalla tua piattaforma.
- Modalità di autenticazione: OAuth2 (client credentials), chiave API o Bearer statico.
- A seconda della modalità: URL del token, Client ID e Client Secret per OAuth2; oppure chiave API; oppure token Bearer.
- Formato del payload: XML o JSON, a seconda di ciò che si aspetta l’API della tua piattaforma.
Usa il pulsante Testa la connessione PDP per validare le tue credenziali prima della messa in produzione.
Il segreto è conservato. Quando salvi le impostazioni lasciando vuoto il campo Client Secret o Chiave API, viene conservato il valore memorizzato in precedenza. Non devi quindi reinserire il segreto a ogni modifica.
Generare e trasmettere un periodo
Dalla dashboard
La scheda Dashboard mostra i periodi scaduti, ciascuno con la sua scadenza legale. Un periodo in ritardo è segnalato in rosso. Clicca su Genera accanto a un periodo per produrne il flusso. Il pulsante Genera tutto elabora in una volta tutti i periodi scaduti.
Dalla scheda Trasmissioni
La scheda Trasmissioni elenca tutti i flussi generati con il loro stato. Per ogni trasmissione puoi:
- Consultare il dettaglio della ripartizione per aliquota IVA.
- Scaricare il flusso in XML o JSON.
- In modalità API, cliccare su Invia alla PDP.
- In modalità manuale, marcare la trasmissione come depositata, poi accettata o rifiutata secondo il riscontro della piattaforma.
- Eliminare una trasmissione finché non è stata inviata.
Stati di una trasmissione. Una trasmissione attraversa gli stati bozza, generato, inviato, accettato, rifiutato o errore. Una trasmissione già inviata o accettata non può più essere eliminata, per preservare la tua pista di controllo.
Periodicità secondo il regime
Il modulo calcola automaticamente i periodi in base al regime configurato, conformemente al decreto 2022-1299:
- Reale normale — decadale: tre periodi al mese (dall’1 al 10, dall’11 al 20, dal 21 a fine mese). Ogni flusso deve essere depositato entro 10 giorni dalla fine del periodo.
- Reale semplificato — mensile: una trasmissione al mese, da depositare tra il 25 e il 30 del mese successivo.
- Franchigia — bimestrale: una trasmissione ogni due mesi.
Come vengono calcolati gli importi
Il modulo ricostruisce la ripartizione per aliquota IVA dalle righe reali dell’ordine. Aggiunge le spese di spedizione all’aliquota del corriere, integra la confezione regalo e riassorbe le differenze di arrotondamento e gli sconti sulla voce più grande affinché i totali trasmessi corrispondano esattamente ai totali dei tuoi ordini. Gli ordini in valuta estera sono convertiti al tasso registrato al momento della vendita. Le note di credito, se attivate, sono integrate come importi negativi e allocate proporzionalmente sulle aliquote dell’ordine originale.
Ciclo di vita delle fatture
La scheda Ciclo di vita permette di seguire gli stati delle tue fatture: deposito, rigetto, rifiuto e incasso. Gli incassi sono rilevati automaticamente dai pagamenti di PrestaShop, e il passaggio di un ordine a uno stato «pagato» registra lo stato incassato. Puoi anche inserire uno stato manualmente per un dato ordine. Inoltre, ogni scheda ordine del back office mostra un pannello che riassume il suo stato di e-reporting.
Automazione tramite cron
La scheda Dashboard mostra un URL di cron protetto da un token. Configura un’attività pianificata (cron) presso il tuo host per richiamare questo URL, ad esempio una volta al giorno. A ogni chiamata, il modulo genera tutti i periodi scaduti e, se l’opzione Invio automatico è attivata in modalità API, deposita i flussi sulla tua piattaforma.
Mantieni riservato l’URL di cron. Contiene un token che autorizza la generazione e l’invio dei flussi. Non condividerlo pubblicamente. Se ritieni che sia stato esposto, rigenera il token nelle impostazioni.
Modalità test
Attiva la Modalità test per validare l’intera catena senza effetto reale. Ogni flusso trasmesso in questa modalità porta l’indicatore di prova previsto dal formato ufficiale: la tua piattaforma lo tratta come una prova. Un banner MODALITÀ TEST resta visibile nell’interfaccia finché l’opzione è attiva. Disattivala prima della prima trasmissione reale.
Domande frequenti
Sono interessato se vendo solo a privati?
Sì. Le vendite B2C rientrano precisamente nell’e-reporting: i loro dati di transazione devono essere trasmessi periodicamente, anche se non viene emessa alcuna fattura elettronica.
Il modulo funziona con la mia piattaforma certificata?
Il client API è generico e compatibile con qualsiasi piattaforma che esponga un’API REST con autenticazione OAuth2, chiave API o Bearer. Se la tua piattaforma non ha API, la modalità manuale resta disponibile.
È compatibile con il modulo Factur-X di DataFirefly?
Sì. I due moduli sono complementari: Factur-X copre la fatturazione elettronica B2B, questo modulo copre l’e-reporting delle transazioni B2C e il ciclo di vita delle fatture. Possono essere usati insieme senza conflitti.
Cosa succede se installo il modulo a metà anno?
Imposta la Data di inizio alla data a partire dalla quale sei soggetto all’obbligo. Il modulo genera periodi solo a partire da quella data.