# Esportazione Contabile — Guida completa

> Panoramica DataFirefly Esportazione Contabile (dfaccountingexport) genera le vostre registrazioni contabili PrestaShop in otto formati: FEC (obbligo legale francese, articolo A-47 A-1 del Codice delle Procedure Fiscali francese), Sage 100, EBP…

- Pagina: <https://www.datafirefly.com/it/documentation/dfaccountingexport/>
- Lingua: it
- Aggiornato il: 2026-09-17
- Altre lingue: [fr](https://www.datafirefly.com/documentation/dfaccountingexport/index.md), [en](https://www.datafirefly.com/en/documentation/dfaccountingexport/index.md), [es](https://www.datafirefly.com/es/documentation/dfaccountingexport/index.md), [de](https://www.datafirefly.com/de/documentation/dfaccountingexport/index.md), [pl](https://www.datafirefly.com/pl/documentation/dfaccountingexport/index.md), [nl](https://www.datafirefly.com/nl/documentation/dfaccountingexport/index.md), [pt](https://www.datafirefly.com/pt/documentation/dfaccountingexport/index.md)
- Indice: <https://www.datafirefly.com/it/documentation/llms.txt>

## Panoramica

DataFirefly Esportazione Contabile (`dfaccountingexport`) genera le vostre registrazioni contabili PrestaShop in otto formati: **FEC** (obbligo legale francese, articolo A-47 A-1 del Codice delle Procedure Fiscali francese), **Sage 100**, **EBP Compta**, **Ciel XIMPORT**, **Quadratus ASCFIC**, **Pennylane**, **Tiime** e **Indy**. Il modulo legge gli ordini pagati e le note di credito del periodo scelto, costruisce le registrazioni (registro vendite VE e registro note di credito AV), ripartisce automaticamente per aliquota IVA e produce un file pronto da inviare al vostro commercialista o da importare nel vostro software contabile.

## Installazione

1. Nel back-office di PrestaShop, andate su **Moduli → Gestore moduli → Carica un modulo**.
2. Caricate il file `dfaccountingexport.zip`.
3. Il modulo crea automaticamente la tabella `ps_dfae_export_log` (cronologia delle esportazioni) e una scheda **Esportazione contabile** sotto il menu **Ordini**.

Compatibilità: PrestaShop 8.0 a 9.x, PHP 7.4 minimo (consigliato 8.1+), multinegozio supportato.

## Configurazione

Aprite **Moduli → dfaccountingexport → Configura**. La configurazione è organizzata in pannelli.

### Registri

- **Codice registro vendite** (predefinito `VE`) e la sua descrizione.
- **Codice registro note di credito** (predefinito `AV`) e la sua descrizione.

### Piano dei conti

I valori predefiniti seguono il Piano Contabile Generale francese. Tutti i numeri sono modificabili:

- `411` — Clienti (conto generale, radice)
- `707` — Vendite di merci
- `4457` — IVA a debito
- `708` — Spese di spedizione fatturate
- `709` — Sconti e abbuoni
- Conti di tesoreria: un conto per modalità di pagamento, configurati nel pannello dedicato (vedere la sezione Registro incassi)

**Modalità di ripartizione**: per aliquota IVA (predefinita), per categoria prodotto, o nessuna. In modalità aliquota, ogni aliquota incontrata genera un sottoconto: `707000` (20 %), `707010` (10 %), `707055` (5,5 %), `707021` (2,1 %). L'IVA a debito segue la stessa logica sul conto `4457`.

**Conti esatti per aliquota IVA** (dalla 1.2.0): un pannello separato permette di imporre un numero di conto così com'è per una data aliquota, per esempio `707100` per le vendite al 20 % e `445720` per l'IVA corrispondente, al posto del suffisso automatico. L'impostazione si applica anche all'IVA sulle spedizioni della stessa aliquota. Lasciate il campo vuoto per mantenere il suffisso automatico.

### Conti cliente (dalla 1.3.0)

L'impostazione **Gestione dei conti cliente** offre tre modalità:

- **Conto collettivo unico + conto ausiliario per cliente** (predefinita): tutte le registrazioni cliente passano dal conto 411 configurato sopra, e il dettaglio per cliente finisce nelle colonne ausiliarie `CompAuxNum` / `CompAuxLib`, nella forma `C000123` per il cliente 123. È lo schema atteso dalla maggior parte degli studi: un solo conto cliente a bilancio, con riconciliazione dei pagamenti e sollecito degli insoluti sempre possibili.
- **Conto collettivo unico, senza conto ausiliario**: il solo conto 411, senza alcuna colonna ausiliaria. Il cliente non è più identificabile nel file.
- **Un conto generale per cliente**: `411001`, `411002` e seguenti, costruiti dalla radice 411 e dall'identificativo cliente. Era il comportamento delle versioni dalla 1.0 alla 1.2.

Il campo **Etichetta del conto collettivo** («Clients» di default) serve da descrizione del conto generale nelle due modalità collettive. Resta costante di proposito: in un FEC, uno stesso numero di conto non deve portare descrizioni diverse da una riga all'altra. Il nome del cliente resta nella colonna ausiliaria.

I negozi aggiornati da una versione precedente mantengono automaticamente il loro comportamento. La vecchia impostazione «Conto ausiliario cliente» viene convertita in _un conto generale per cliente_ se era attivata, in _conto collettivo senza ausiliario_ altrimenti. Nessuna esportazione cambia finché non scegliete voi stessi un'altra modalità.

### Opzioni

- **SIREN**: indispensabile per il FEC. Il nome file regolamentare è `SIREN + FEC + data di chiusura` (es. `123456789FEC20261231.txt`). Senza SIREN configurato, il file contiene letteralmente la parola «SIREN» e non è conforme per una presentazione fiscale.
- **Stati ordine inclusi**: predefiniti «Pagamento accettato» e «Consegnato». Selezionate gli stati che il vostro flusso considera contabilizzabili.
- **Codifica di uscita**: UTF-8 o ISO-8859-15. Sage, Ciel e Quadratus preferiscono spesso ISO; Pennylane, Tiime e il FEC restano in UTF-8.

## Generare un'esportazione

1. Andate su **Ordini → Esportazione contabile**.
2. Scegliete il **periodo** (data di inizio / data di fine). Il filtro si applica alla data di fattura per gli ordini e alla data di creazione per le note di credito.
3. Selezionate il **formato** tra gli otto disponibili.
4. Cliccate su **Anteprima**: il modulo calcola, senza generare file, il numero di ordini, il numero di righe di registrazione, il totale dare e il totale avere. Un banner verde conferma l'equilibrio perfetto; un banner rosso segnala uno scostamento.
5. Cliccate su **Esporta**: il file viene generato e scaricato immediatamente, e l'operazione viene registrata nella cronologia.

### Logica delle registrazioni — registro vendite

Per ogni ordine pagato: dare `411` (cliente, IVA inclusa), avere `707xxx` per aliquota (vendite nette), avere `4457xxx` per aliquota (IVA), avere `708` (spedizione netta) e dare `709` (sconti) ove applicabile. Un aggiustamento automatico di arrotondamento (scostamento < 0,10 €) viene iniettato sul conto IVA per garantire l'equilibrio: i centesimi residui di IVA sono un classico delle esportazioni e-commerce.

### Logica delle registrazioni — registro note di credito

Gli `OrderSlip` del periodo generano registrazioni speculari nel registro AV: avere `411`, dare `707xxx`, dare `4457xxx`. Le note di credito sono incluse nella verifica di equilibrio globale.

## Gli otto formati in dettaglio

- **FEC** — 18 colonne separate da pipe, date AAAAMMGG, importi positivi con senso dare/avere, UTF-8 senza BOM. Conforme all'articolo A-47 A-1 del LPF francese.
- **Sage 100** — CSV punto e virgola: Registro;Data;NumDocumento;ContoGenerale;ContoAusiliario;Descrizione;Senso;Importo;Valuta.
- **EBP Compta** — Tabulato con dare/avere in colonne separate e codice di riconciliazione.
- **Ciel XIMPORT** — Larghezza fissa 81 caratteri, importi di 13 caratteri con zeri iniziali.
- **Quadratus ASCFIC** — Larghezza fissa, importi in centesimi interi.
- **Pennylane** — CSV moderno, UTF-8 forzato, punto decimale, date ISO.
- **Tiime** — CSV punto e virgola con date GG/MM/AAAA.
- **Indy** — CSV semplificato per liberi professionisti.

Il conto ausiliario cliente alimenta le colonne previste da FEC, Sage 100, EBP, Quadratus, Pennylane e Tiime. Ciel XIMPORT e Indy non ne prevedono nel loro layout: in modalità collettiva senza ausiliario, questi due formati sono i soli a non perdere nulla rispetto alle altre modalità.

I layout **Ciel XIMPORT** e **Quadratus ASCFIC** conoscono varianti a seconda dello studio contabile. Fate validare il primo file dal destinatario prima di passare in produzione.

## Registro incassi (dalla 1.1.1)

Opzionale e disattivato di default. Attivate **Genera il registro incassi** nel pannello **Conti di tesoreria per modalità di pagamento** della configurazione.

### Mappatura modalità di pagamento verso conto

Il pannello elenca automaticamente i vostri moduli di pagamento (installati e presenti nello storico ordini, con contatore ordini). Inserite un conto accanto a ogni modulo, per esempio `580000` contanti, `580100` assegni, `580200` carta, `580300` bonifici, `580400` PayPal. Un campo lasciato vuoto ricade sul **conto predefinito**, ereditato dal vecchio conto banca all'aggiornamento.

### Logica delle registrazioni

Ogni pagamento registrato (`ps_order_payment`) nel periodo genera, nel registro di banca (BQ): dare conto di tesoreria / avere `411` cliente (con conto ausiliario se attivato). La data di registrazione è la **data del pagamento**, non la data di fattura: un ordine di marzo pagato in aprile esce negli incassi di aprile, in coerenza con i vostri estratti conto. Gli importi negativi (transazioni di rimborso) invertono automaticamente il senso dare/avere. Il documento porta il riferimento `RG` seguito dal numero di pagamento e dal riferimento ordine, per facilitare la riconciliazione.

## Cronologia delle esportazioni

Ogni esportazione è registrata nel database (`ps_dfae_export_log`): formato, periodo, numero di ordini e righe, totali dare/avere, nome file, operatore, marca temporale. Le ultime 20 esportazioni sono visualizzate in fondo alla schermata di esportazione.

## FAQ e risoluzione dei problemi

### Il mio commercialista vuole un solo conto 411000 per tutti i clienti, come faccio?

Impostate **Gestione dei conti cliente** su _Conto collettivo unico + conto ausiliario per cliente_. Tutte le registrazioni passano dal conto 411 configurato, e ogni cliente conserva la sua identificazione nelle colonne ausiliarie. Se lo studio non vuole alcuna traccia del cliente nel file, scegliete la modalità senza ausiliario. La modifica è immediata: basta rilanciare l'esportazione del periodo interessato, il modulo ricalcola tutto a ogni generazione.

### L'anteprima mostra uno scostamento dare/avere, cosa fare?

Uno scostamento superiore a 0,10 € indica generalmente un ordine con tassazione atipica (imposta personalizzata, ecotassa, arrotondamento di valuta). Riducete il periodo per isolare l'ordine problematico, verificate la sua configurazione fiscale e rilanciate l'anteprima.

### Il file FEC viene rifiutato dallo strumento di controllo della DGFiP

Verificate prima che il SIREN sia configurato, poi che il periodo esportato corrisponda all'esercizio, e che la codifica sia rimasta UTF-8. Se il controllo riguarda le descrizioni dei conti, assicuratevi di essere in modalità collettiva con una descrizione fissa: un conto generale che cambia descrizione da una riga all'altra viene segnalato come anomalia. Lo strumento «Test Compta Demat» della DGFiP permette di validare il file in locale.

### Posso esportare più formati per lo stesso periodo?

Sì, senza riconfigurare: selezionate semplicemente un altro formato e rilanciate l'esportazione. Ogni generazione viene registrata separatamente.

### Il modulo modifica i miei dati degli ordini?

No. Il modulo è strettamente in sola lettura su ordini, fatture e note di credito. La sua unica scrittura nel database è la registrazione della cronologia.