TVA CERFA 3310-CA3
Modulo Dolibarr · TVA CERFA 3310-CA3

Documentazione

Guida completa all'installazione, configurazione e utilizzo — v4.1.1

Installazione

Prerequisiti

  • Dolibarr 19.0 → 23.x o superiore
  • PHP 7.4 → 8.5
  • MySQL 5.7+ o MariaDB 10.3+
  • Permessi di scrittura sulla cartella htdocs/custom/

Metodo 1 — Installazione tramite DoliStore (consigliata)

  1. Acquistate il modulo
    Andate su DoliStore e acquistate il modulo TVA CERFA 3310-CA3.
  2. Scaricate l'archivio ZIP
    Dal vostro spazio cliente DoliStore, scaricate il file ZIP del modulo.
  3. Distribuite in Dolibarr
    In Dolibarr : Home → Configurazione → Moduli → Distribuire/installare un modulo esterno, quindi selezionate il file ZIP.
  4. Attivate il modulo
    Una volta distribuito, attivate « Dichiarazioni IVA (CERFA 3310-CA3) » nella sezione Finanza / Contabilità.

Metodo 2 — Installazione manuale

# Posizionatevi nella cartella custom di Dolibarr cd /var/www/dolibarr/htdocs/custom/ # Decomprimete l'archivio unzip module_tva_cerfa_3310-4.1.1.zip # Regolate i permessi chmod -R 755 tva_cerfa_3310/ chown -R www-data:www-data tva_cerfa_3310/
Importante : Se le tabelle del database non vengono create automaticamente durante l'attivazione, andate alla pagina principale del modulo e cliccate su « Installa le tabelle ».

Configurazione

Dopo l'attivazione del modulo, accedete alla pagina di configurazione tramite Configurazione → Moduli → TVA CERFA 3310-CA3 → Configurazione.

1. Modalità di dichiarazione

Il modulo tratta il quadro principale del modulo CA3 (CERFA 3310-CA3), regime ordinario. Il regime semplificato CA12 non è supportato.

Perimetro attuale : Solo il quadro principale della CA3 (pagina 1) è calcolato automaticamente. Non sono ancora supportati in questa versione : gli allegati 3310-TER, 3310-A e 3310-TIC, le righe di importazioni (I1–I6, in corso di consolidamento), l'IVA sui prodotti petroliferi, e le tre caselle di intestazione della CA3 (rappresentante del soggetto passivo unico art. 256 C, regime di consolidamento DGE art. 1693 ter, dichiarazione « nulla »).

2. Conservazione degli esercizi

Definite il numero di anni fiscali da conservare (consigliato : minimo 3 anni per rispettare gli obblighi di legge).

3. Conti delle immobilizzazioni

I conti delle immobilizzazioni servono al calcolo dell'IVA deducibile sulle immobilizzazioni (riga 19). Utilizzate l'assistente di rilevamento per identificarli automaticamente (generalmente i conti che iniziano con 2).

4. Conti intracomunitari

Configurate i conti per le operazioni intracomunitarie (acquisti di beni UE, servizi esteri UE e extra UE).

5. Aliquota IVA per fatture europee

Selezionate l'aliquota IVA francese da applicare in sede di inversione contabile delle fatture fornitore UE. Se non configurata, il modulo utilizza l'IVA indicata sulla fattura.

6. Opzione OSS

Se effettuate vendite a distanza B2C intracomunitarie che superano la soglia di 10 000 €, potete dichiarare tramite lo sportello OSS. Attivate l'opzione corrispondente nella configurazione affinché il modulo escluda correttamente tali operazioni dal calcolo CA3 nazionale.

Utilizzo

Creare una dichiarazione IVA

  1. Accedete al modulo
    Andate in Contabilità/Tesoreria → Imposte → TVA CERFA 3310-CA3.
  2. Create una nuova dichiarazione
    Cliccate su « Nuova dichiarazione » e selezionate il periodo (mese o trimestre secondo il vostro regime).
  3. Calcolate gli importi
    Cliccate su « Calcola IVA » per estrarre automaticamente i dati dalle vostre fatture validate e dal libro mastro.
  4. Verificate e rettificate
    Controllate gli importi calcolati. I 10 controlli fiscali (R1–R10) sono verificati automaticamente : qualsiasi punto bloccante viene segnalato prima di poter continuare.
  5. Validate la dichiarazione
    Una volta superati i controlli fiscali, validate la dichiarazione per cristallizzarla.
  6. Generate il PDF
    Cliccate su « Genera PDF » per ottenere il giustificativo completo della scheda di dichiarazione.

Ciclo di vita di una dichiarazione

Stato Descrizione Azioni possibili
Bozza Dichiarazione in corso di preparazione Modificare, Calcolare, Eliminare
Validata Dichiarazione validata, controlli superati Bloccare, Generare PDF, Annullare
Bloccata Dichiarazione finalizzata e depositata Generare PDF soltanto
Workflow irreversibile : Il passaggio allo stato Bloccata è definitivo. Una dichiarazione bloccata non può più essere modificata. Solo un annullamento esplicito (stato Annullata) è possibile se viene rilevato un errore successivamente.

Regole di calcolo dell'IVA

IVA a debito — righe principali

Calcolata a partire dalle fatture clienti validate nel periodo (note di credito clienti dedotte).

Riga CERFA Descrizione Aliquota
08IVA all'aliquota normale20 %
9BIVA all'aliquota intermedia10 %
09IVA all'aliquota ridotta5,5 %
11IVA all'aliquota particolare2,1 %
10IVA DOM8,5 %
17Di cui inversione contabile — acquisti intracomunitari di beni (B2) e servizi esteri UE/extra-UE (A3, art. 283-2)20 %
Riga 16 (Totale IVA lorda dovuta) = Σ(Righe 08 + 9B + 09 + 11 + 10 + …)

IVA a credito — righe principali

Calcolata a partire dalle fatture fornitore validate nel periodo (note di credito fornitore considerate).

Riga CERFA Descrizione
19IVA sulle immobilizzazioni (conti di classe 2)
20IVA su altri beni e servizi (oneri, spese generali)
22Credito IVA riportato dalla riga 27 del periodo precedente
Riga 23 (Totale IVA deducibile) = Riga 19 + Riga 20 + Riga 22 + …

Risultato del periodo

Riga CERFADescrizione
32IVA da versare = Riga 16 − Riga 23 (se positivo)
25Credito IVA = Riga 23 − Riga 16 (se negativo)
26Rimborso del credito richiesto (a mano)
27Credito da riportare = Riga 25 − Riga 26 → alimenterà la riga 22 del periodo successivo
Catena dei crediti : La riga 22 di ogni dichiarazione è alimentata automaticamente dalla riga 27 del periodo precedente. Non interrompere mai questa catena — è un invariante bloccante del modulo.

Controlli fiscali (R1–R10)

Dieci regole di coerenza vengono verificate automaticamente prima di qualsiasi validazione. Sono bloccanti : è impossibile validare una dichiarazione incoerente. Esempi di regole verificate : coerenza base × aliquota = IVA, neutralità dell'inversione contabile (riga 17 ↔ deducibile corrispondente), riga 22 coerente con il periodo precedente.

Arrotondamento legale : Tutti gli importi sono arrotondati all'intero più vicino, conformemente ai requisiti dell'amministrazione fiscale francese (DGFiP).

IVA sulle operazioni europee e inversione contabile

Acquisti intracomunitari di beni (B2)

Quando acquistate beni da un fornitore stabilito nell'UE, l'IVA è soggetta ad inversione contabile : dichiarate sia l'IVA a debito (riga 17) sia l'IVA deducibile corrispondente (riga 20), per una perfetta neutralità se i beni danno diritto alla detrazione.

Servizi esteri UE ed extra-UE — inversione contabile art. 283-2 (A3)

I servizi acquistati da prestatori non stabiliti in Francia (UE o paesi terzi) sono soggetti ad inversione contabile ai sensi dell'articolo 283-2 del CGI. Compaiono alla riga A3 (base) e alla riga 17 (IVA).

Configurazione dell'aliquota per fatture europee

  1. Accedete alla configurazione del modulo.
  2. In « Aliquota IVA per fatture europee », selezionate l'aliquota francese da applicare (generalmente 20 %).
  3. Se lasciate « Usa l'IVA della fattura », il modulo utilizzerà l'IVA riportata sulla fattura importata.

Esempio — Fattura fornitore tedesco

Importo imponibile : 1 000 €
IVA sulla fattura : 19 % (190 €) — aliquota tedesca, non deducibile in Francia
Aliquota inversione contabile configurata : 20 %
IVA in inversione contabile calcolata : 1 000 € × 20 % = 200 €
→ 200 € dichiarati riga 17 (a debito) + 200 € riga 20 (deducibile se diritto alla detrazione totale)

Regime OSS — vendite B2C a distanza (soglia 10 000 €)

Se le vostre vendite a distanza B2C intracomunitarie superano 10 000 € nell'anno civile, rientrate nel regime OSS (One Stop Shop). Tali vendite sono tassate all'aliquota del paese del consumatore e dichiarate tramite OSS — non figurano nella vostra CA3 nazionale. Il modulo gestisce questo perimetro tramite l'opzione OSS della configurazione.

Al di sotto della soglia di 10 000 € : Avete la possibilità di fatturare all'aliquota IVA del paese del consumatore, ma di dichiarare le basi alla riga A1 all'aliquota normale francese (20 %). Il modulo applica questa regola : non interpretare una base A1 al 20 % come un errore se la fatturazione iniziale era a un'aliquota estera inferiore.

Gestione delle immobilizzazioni

L'IVA sulle immobilizzazioni è trattata separatamente (riga 19) per rispettare le norme fiscali francesi. Viene automaticamente esclusa dalla riga 20 per evitare qualsiasi doppio conteggio.

Identificazione automatica dei conti

Il modulo identifica le immobilizzazioni a partire dalle scritture del libro mastro con imputazione contabile su :

  • i conti di classe 2 (immobilizzazioni materiali e immateriali) ;
  • qualsiasi altro conto configurato manualmente nell'assistente.
Utilizzate l'assistente di rilevamento dei conti (pagina di configurazione) per pre-compilare automaticamente l'elenco dei conti delle immobilizzazioni dal vostro piano dei conti Dolibarr.

Calcolo dell'IVA deducibile sulle immobilizzazioni

Il modulo estrae l'IVA dalle fatture fornitore di cui almeno una riga ha imputazione contabile su un conto di immobilizzazione. Tale IVA alimenta esclusivamente la riga 19 ; la parte « altri beni e servizi » della stessa fattura alimenta la riga 20.

Controllo imputazione contabile rigoroso : Se una fattura non dispone di alcuna imputazione contabile (nessun conto movimentato nel libro mastro), viene esclusa dal calcolo — anche se la sua IVA è nulla. Questo comportamento è intenzionale e non configurabile.

Aggiornamento del modulo

  1. Eseguite il backup dei dati
    Effettuate un backup completo del database Dolibarr e dei file del modulo prima di qualsiasi operazione.
  2. Scaricate la nuova versione
    Recuperate l'ultima versione da DoliStore. La cronologia delle versioni è disponibile nella pagina delle note di versione.
  3. Disattivate il modulo
    In Dolibarr, disattivate temporaneamente il modulo TVA CERFA 3310-CA3.
  4. Sostituite i file
    Sovrascrivete i vecchi file con quelli della nuova versione (metodo manuale) oppure utilizzate la funzione « Distribuire un modulo esterno » di Dolibarr.
  5. Riattivate il modulo
    Riattivate il modulo per avviare l'aggiornamento automatico del database.
  6. Verificate il funzionamento
    Ricalcolate una dichiarazione esistente e confrontate i totali per assicurarvi che non sia stata introdotta alcuna regressione.
Consiglio : Consultate le note di versione per conoscere le novità, le correzioni e le eventuali azioni manuali richieste ad ogni aggiornamento.

Risoluzione problemi

Le tabelle del database non sono state create
Accedete alla pagina principale del modulo e cliccate su « Installa le tabelle ». Se l'errore persiste, verificate che l'utente MySQL disponga dei diritti CREATE TABLE sul database Dolibarr.
Gli importi IVA sono errati
Verificate :
  • la configurazione dell'aliquota IVA per fatture europee ;
  • i conti delle immobilizzazioni configurati (un conto classificato erroneamente può far passare dalla riga 20 alla riga 19) ;
  • le date del periodo selezionate (data fattura vs data contabile) ;
  • lo stato delle fatture — vengono prese in considerazione solo le fatture validate ;
  • l'imputazione contabile nel libro mastro (le righe senza imputazione sono escluse).
Il PDF non viene generato
Verificate :
  • che il modulo PDF (TCPDF) sia attivo in Dolibarr ;
  • i permessi di scrittura sulla cartella documents/ di Dolibarr ;
  • la configurazione PHP : memory_limit ≥ 128 MB, max_execution_time ≥ 60 s.
Un controllo fiscale blocca la validazione
Leggete attentamente il messaggio di errore visualizzato — ogni regola R1–R10 indica precisamente la riga incoerente e il valore atteso. Correggete l'imputazione contabile o i parametri di configurazione all'origine dello scarto.

Domande frequenti

Quali versioni di Dolibarr sono supportate ?

Il modulo è compatibile con Dolibarr 19.0 → 23.x.

Quali aliquote IVA francesi sono gestite ?

Il modulo supporta le cinque aliquote in vigore in Francia metropolitana e DOM : 20 %, 10 %, 5,5 %, 2,1 % e l'aliquota DOM 8,5 %.

Il modulo gestisce le note di credito ?

Sì. Le note di credito clienti sono dedotte dall'IVA a debito ; le note di credito fornitore sono dedotte dall'IVA deducibile.

Posso modificare una dichiarazione validata ?

Una dichiarazione validata (stato Validata) può essere modificata finché non è bloccata. Una volta Bloccata, non può più essere modificata — è possibile solo un annullamento esplicito.

Il modulo copre il quadro completo della CA3 ?

No — ed è documentato. La versione attuale calcola automaticamente il quadro principale della CA3 (pagina 1). I seguenti elementi non sono ancora coperti : allegati 3310-TER, 3310-A e 3310-TIC ; righe di importazioni I1–I6 (in corso di consolidamento) ; IVA sui prodotti petroliferi ; caselle di intestazione speciali (rappresentante del soggetto passivo unico, regime DGE, dichiarazione nulla). Consultate le note di versione per seguire l'avanzamento.

Il modulo gestisce il regime semplificato (CA12) ?

No. Il modulo tratta esclusivamente il regime ordinario (modulo CA3). Il regime semplificato CA12 non è supportato.

Come funziona il riporto del credito IVA ?

La riga 22 (credito riportato) è alimentata automaticamente dalla riga 27 del periodo precedente, che corrisponde al credito residuo dopo un eventuale rimborso richiesto (riga 26). Questa catena è un invariante bloccante : qualsiasi interruzione viene rilevata dal controllo fiscale R corrispondente.

Come ottenere assistenza ?

Consultate questa documentazione, quindi contattate il supporto : tvacerfa3310@ptitetete.org — risposta entro 24–48 ore lavorative.