TVA CERFA 3310-CA3
Módulo Dolibarr · TVA CERFA 3310-CA3

Documentación

Guía completa de instalación, configuración y uso — v4.1.1

Instalación

Requisitos previos

  • Dolibarr 19.0 → 23.x o superior
  • PHP 7.4 → 8.5
  • MySQL 5.7+ o MariaDB 10.3+
  • Permisos de escritura en la carpeta htdocs/custom/

Método 1 — Instalación desde DoliStore (recomendado)

  1. Adquiera el módulo
    Acceda a DoliStore y adquiera el módulo TVA CERFA 3310-CA3.
  2. Descargue el archivo ZIP
    Desde su área de cliente de DoliStore, descargue el archivo ZIP del módulo.
  3. Despliegue en Dolibarr
    En Dolibarr: Inicio → Configuración → Módulos → Desplegar/instalar un módulo externo, y seleccione el archivo ZIP.
  4. Active el módulo
    Una vez desplegado, active «Declaraciones IVA (CERFA 3310-CA3)» en la sección Finanzas / Contabilidad.

Método 2 — Instalación manual

# Acceda a la carpeta custom de Dolibarr cd /var/www/dolibarr/htdocs/custom/ # Descomprima el archivo unzip module_tva_cerfa_3310-4.1.1.zip # Ajuste los permisos chmod -R 755 tva_cerfa_3310/ chown -R www-data:www-data tva_cerfa_3310/
Importante: Si las tablas de la base de datos no se crean automáticamente durante la activación, acceda a la página principal del módulo y haga clic en «Instalar tablas».

Configuración

Tras la activación del módulo, acceda a la página de configuración mediante Configuración → Módulos → TVA CERFA 3310-CA3 → Configuración.

1. Modo de declaración

El módulo gestiona el cuadro principal del formulario CA3 (CERFA 3310-CA3), régimen real normal. El régimen simplificado CA12 no está contemplado.

Alcance actual: Solo el cuadro principal de la CA3 (página 1) se calcula automáticamente. No están contemplados en esta versión: los anexos 3310-TER, 3310-A y 3310-TIC, las líneas de importaciones (I1–I6, en proceso de consolidación), el IVA sobre productos petrolíferos, y las tres casillas de encabezado de la CA3 (representante del sujeto pasivo único art. 256 C, régimen de consolidación DGE art. 1693 ter, declaración «ninguna»).

2. Conservación de ejercicios

Defina el número de ejercicios fiscales a conservar (recomendado: mínimo 3 años para cumplir las obligaciones legales).

3. Cuentas de inmovilizado

Las cuentas de inmovilizado se utilizan para el cálculo del IVA deducible en inmovilizado (línea 19). Utilice el asistente de detección para identificarlas automáticamente (generalmente las cuentas que comienzan por 2).

4. Cuentas intracomunitarias

Configure las cuentas para las operaciones intracomunitarias (adquisiciones de bienes UE, servicios extranjeros UE y fuera de la UE).

5. Tipo de IVA para facturas europeas

Seleccione el tipo de IVA francés a aplicar al realizar la inversión del sujeto pasivo sobre facturas de proveedores de la UE. Si no se configura, el módulo utiliza el IVA indicado en la factura.

6. Opción OSS

Si realiza ventas a distancia B2C intracomunitarias por encima del umbral de 10 000 €, puede declarar mediante la ventanilla OSS. Active la opción correspondiente en la configuración para que el módulo excluya correctamente estas operaciones del cálculo CA3 nacional.

Uso

Crear una declaración de IVA

  1. Acceda al módulo
    Vaya a Contabilidad/Tesorería → Impuestos → TVA CERFA 3310-CA3.
  2. Cree una nueva declaración
    Haga clic en «Nueva declaración» y seleccione el período (mensual o trimestral según su régimen).
  3. Calcule los importes
    Haga clic en «Calcular IVA» para extraer automáticamente los datos de sus facturas validadas y su libro mayor.
  4. Verifique y ajuste
    Compruebe los importes calculados. Los 10 controles (R1–R10) se verifican automáticamente: cualquier punto bloqueante se señala antes de poder continuar.
  5. Valide la declaración
    Una vez levantados los controles, valide la declaración para fijarla.
  6. Genere el PDF
    Haga clic en «Generar PDF» para obtener el justificante completo de la declaración.

Ciclo de vida de una declaración

Estado Descripción Acciones posibles
Borrador Declaración en preparación Modificar, Calcular, Eliminar
Validada Declaración validada, controles levantados Bloquear, Generar PDF, Anular
Bloqueada Declaración finalizada y presentada Generar PDF únicamente
Flujo irreversible: El paso al estado Bloqueada es definitivo. Una declaración bloqueada ya no puede modificarse. Solo es posible una anulación explícita (estado Anulada) si se detecta un error con posterioridad.

Reglas de cálculo del IVA

IVA devengado — principales líneas

Calculado a partir de las facturas de clientes validadas en el período (facturas rectificativas de clientes deducidas).

Línea CERFA Descripción Tipo
08IVA al tipo normal20 %
9BIVA al tipo intermedio10 %
09IVA al tipo reducido5,5 %
11IVA al tipo especial2,1 %
10IVA DOM8,5 %
17Del cual inversión del sujeto pasivo — adquisiciones intracomunitarias de bienes (B2) y servicios extranjeros UE/fuera UE (A3, art. 283-2)20 %
Línea 16 (Total IVA bruto debido) = Σ(Líneas 08 + 9B + 09 + 11 + 10 + …)

IVA soportado — principales líneas

Calculado a partir de las facturas de proveedores validadas en el período (facturas rectificativas de proveedores tenidas en cuenta).

Línea CERFA Descripción
19IVA sobre inmovilizado (cuentas de clase 2)
20IVA sobre otros bienes y servicios (gastos, gastos generales)
22Crédito de IVA reportado desde la línea 27 del período anterior
Línea 23 (Total IVA deducible) = Línea 19 + Línea 20 + Línea 22 + …

Resultado del período

Línea CERFADescripción
32IVA a pagar = Línea 16 − Línea 23 (si positivo)
25Crédito de IVA = Línea 23 − Línea 16 (si negativo)
26Devolución de crédito solicitada (manual)
27Crédito a reportar = Línea 25 − Línea 26 → alimentará la línea 22 del próximo período
Cadena de créditos: La línea 22 de cada declaración se alimenta automáticamente de la línea 27 del período anterior. Nunca debe romperse esta cadena — es un invariante bloqueante del módulo.

Controles fiscales (R1–R10)

Se verifican automáticamente diez reglas de coherencia antes de cualquier validación. Son bloqueantes: es imposible validar una declaración incoherente. Ejemplos de reglas verificadas: coherencia base × tipo = IVA, neutralidad de la inversión del sujeto pasivo (línea 17 ↔ deducible correspondiente), línea 22 coherente con el período anterior.

Redondeo legal: Todos los importes se redondean al entero más próximo, conforme a los requisitos de la administración fiscal francesa (DGFiP).

IVA en operaciones europeas e inversión del sujeto pasivo

Adquisiciones intracomunitarias de bienes (B2)

Cuando adquiere bienes a un proveedor establecido en la UE, el IVA se autoliquida mediante inversión del sujeto pasivo: declara a la vez el IVA devengado (línea 17) y el IVA deducible correspondiente (línea 20), con neutralidad total si los bienes dan derecho a deducción.

Servicios extranjeros UE y fuera de la UE — inversión del sujeto pasivo art. 283-2 (A3)

Los servicios adquiridos a prestadores no establecidos en Francia (UE o terceros países) están sujetos a inversión del sujeto pasivo en aplicación del artículo 283-2 del CGI. Figuran en la línea A3 (base) y en la línea 17 (IVA).

Configuración del tipo para facturas europeas

  1. Acceda a la configuración del módulo.
  2. En «Tipo de IVA para facturas europeas», seleccione el tipo francés a aplicar (generalmente 20 %).
  3. Si deja «Utilizar el IVA de la factura», el módulo utilizará el IVA consignado en la factura importada.

Ejemplo — Factura de proveedor alemán

Importe sin IVA: 1 000 €
IVA en la factura: 19 % (190 €) — tipo alemán, no deducible en Francia
Tipo de inversión del sujeto pasivo configurado: 20 %
IVA autoliquidado calculado: 1 000 € × 20 % = 200 €
→ 200 € declarados en línea 17 (devengado) + 200 € línea 20 (deducible si derecho a deducción total)

Régimen OSS — ventas B2C a distancia (umbral 10 000 €)

Si sus ventas a distancia B2C intracomunitarias superan 10 000 € en el año natural, queda bajo el régimen OSS (One Stop Shop). Estas ventas tributan al tipo del país del consumidor y se declaran a través del OSS — no figuran en su CA3 nacional. El módulo gestiona este alcance mediante la opción OSS de la configuración.

Por debajo del umbral de 10 000 €: Puede facturar al tipo de IVA del país del consumidor, pero declarar las bases en la línea A1 al tipo normal francés (20 %). El módulo aplica esta regla: no debe interpretarse una base A1 al 20 % como un error si la facturación inicial se realizó a un tipo extranjero inferior.

Gestión del inmovilizado

El IVA sobre inmovilizado se trata por separado (línea 19) para respetar las reglas fiscales francesas. Se excluye automáticamente de la línea 20 para evitar cualquier doble contabilización.

Identificación automática de cuentas

El módulo identifica el inmovilizado a partir de los asientos del libro mayor con imputación contable en:

  • las cuentas de clase 2 (inmovilizado material e intangible);
  • cualquier otra cuenta configurada manualmente en el asistente.
Utilice el asistente de detección de cuentas (página de configuración) para prellenar automáticamente la lista de cuentas de inmovilizado desde su plan contable de Dolibarr.

Cálculo del IVA deducible sobre inmovilizado

El módulo extrae el IVA de las facturas de proveedores en las que al menos una línea tiene imputación contable en una cuenta de inmovilizado. Este IVA alimenta exclusivamente la línea 19; la parte de «otros bienes y servicios» de la misma factura alimenta la línea 20.

Control de imputación contable estricto: Si una factura no dispone de ninguna imputación contable (ninguna cuenta movida en el libro mayor), queda excluida del cálculo — incluso si su IVA es cero. Este comportamiento es intencionado y no es configurable.

Actualización del módulo

  1. Realice una copia de seguridad
    Efectúe una copia de seguridad completa de su base de datos Dolibarr y de los archivos del módulo antes de cualquier operación.
  2. Descargue la nueva versión
    Obtenga la última versión desde DoliStore. El historial de versiones está disponible en la página de notas de versión.
  3. Desactive el módulo
    En Dolibarr, desactive temporalmente el módulo TVA CERFA 3310-CA3.
  4. Sustituya los archivos
    Sobreescriba los archivos anteriores con los de la nueva versión (método manual) o utilice la función «Desplegar un módulo externo» de Dolibarr.
  5. Reactive el módulo
    Reactive el módulo para lanzar la actualización automática de la base de datos.
  6. Verifique el funcionamiento
    Recalcule una declaración existente y compare los totales para asegurarse de que no se introduce ninguna regresión.
Consejo: Consulte las notas de versión para conocer las novedades, correcciones y posibles acciones manuales requeridas en cada actualización.

Resolución de problemas

Las tablas de la base de datos no se han creado
Acceda a la página principal del módulo y haga clic en «Instalar tablas». Si el error persiste, verifique que el usuario MySQL dispone de los permisos CREATE TABLE sobre la base de datos de Dolibarr.
Los importes de IVA son incorrectos
Verifique:
  • la configuración del tipo de IVA para facturas europeas;
  • las cuentas de inmovilizado configuradas (una cuenta mal clasificada puede trasladar el importe de la línea 20 a la línea 19);
  • las fechas del período seleccionado (fecha de factura frente a fecha contable);
  • el estado de las facturas — solo se tienen en cuenta las facturas validadas;
  • la imputación contable en el libro mayor (las líneas sin imputación quedan excluidas).
El PDF no se genera
Verifique:
  • que el módulo PDF (TCPDF) está activado en Dolibarr;
  • los permisos de escritura en la carpeta documents/ de Dolibarr;
  • la configuración de PHP: memory_limit ≥ 128 MB, max_execution_time ≥ 60 s.
Un control bloquea la validación
Lea atentamente el mensaje de error mostrado — cada regla R1–R10 indica con precisión la línea incoherente y el valor esperado. Corrija la imputación contable o los parámetros de configuración que originan la discrepancia.

Preguntas frecuentes

¿Qué versiones de Dolibarr son compatibles?

El módulo es compatible con Dolibarr 19.0 → 23.x.

¿Qué tipos de IVA francés gestiona?

El módulo contempla los cinco tipos vigentes en la Francia metropolitana y DOM: 20 %, 10 %, 5,5 %, 2,1 % y el tipo DOM 8,5 %.

¿El módulo gestiona las facturas rectificativas?

Sí. Las facturas rectificativas de clientes se deducen del IVA devengado; las de proveedores se deducen del IVA soportado.

¿Puedo modificar una declaración validada?

Una declaración validada (estado Validada) puede modificarse mientras no esté bloqueada. Una vez Bloqueada, ya no puede modificarse — solo es posible una anulación explícita.

¿El módulo cubre el cuadro completo de la CA3?

No — y está documentado. La versión actual calcula automáticamente el cuadro principal de la CA3 (página 1). Los elementos siguientes no están aún cubiertos: anexos 3310-TER, 3310-A y 3310-TIC; líneas de importaciones I1–I6 (en proceso de consolidación); IVA sobre productos petrolíferos; casillas de encabezado especiales (representante del sujeto pasivo único, régimen DGE, declaración ninguna). Consulte las notas de versión para seguir el avance.

¿El módulo gestiona el régimen simplificado (CA12)?

No. El módulo trata únicamente el régimen real normal (formulario CA3). El régimen simplificado CA12 no está contemplado.

¿Cómo funciona el reporte del crédito de IVA?

La línea 22 (crédito reportado) se alimenta automáticamente de la línea 27 del período anterior, que corresponde al crédito remanente tras una posible devolución solicitada (línea 26). Esta cadena es un invariante bloqueante: cualquier ruptura es detectada por el control R correspondiente.

¿Cómo obtener ayuda?

Consulte esta documentación y luego contacte con el soporte: tvacerfa3310@ptitetete.org — respuesta en 24–48 h laborables.