Módulo de Cálculo

Retenciones 2024
A partir del 8 de febrero

Versión 1.00 febrero 2024

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

Índice
1 INTRODUCCIÓN .................................................................................................................................................... 3
2 FUNCIONALIDADES ............................................................................................................................................. 4
3 BREVE DESCRIPCIÓN DEL PROCESO ............................................................................................................ 5
4 DISTRIBUCIÓN DEL MÓDULO DE CÁLCULO ............................................................................................... 6
5 INTERFAZ PARA LA EJECUCIÓN DEL PROGRAMA ................................................................................... 7
5.1 EJECUCIÓN DESDE LÍNEA DE COMANDOS. ............................................................................................................ 7
5.2 INVOCACIÓN DESDE UN PROGRAMA JAVA ............................................................................................................ 8
6 VALIDACIONES ..................................................................................................................................................... 9
6.1 FICHEROS XML ................................................................................................................................................... 9
6.2 OTRAS VALIDACIONES ........................................................................................................................................ 9
7 RECURSOS MÍNIMOS ......................................................................................................................................... 10
8 APÉNDICE 1 .......................................................................................................................................................... 11
9 APÉNDICE 2 .......................................................................................................................................................... 12
10 APÉNDICE 3 ...................................................................................................................................................... 13

S.G. Aplicaciones 2 Agencia Tributaria - Departamento de Informática Tributaria

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

1 Introducción
MÓDULO DE CÁLCULO RETENCIONES 2024 (a partir del 8 de febrero)
El objetivo de este programa es facilitar el cálculo desde fichero de las retenciones del IRPF para el ejercicio
2023 (desde 1 de febrero), con objeto de dar cumplimiento a lo establecido en el apartado 3 de la
disposición adicional trigésima quinta de la Ley 35/2006, reguladora del IRPF, añadida por el Real Decreto-
ley 20/2011, de 30 de diciembre, de medidas urgentes en materia presupuestaria, tributaria y financiera para
la corrección del déficit público (BOE del 31).

S.G. Aplicaciones 3 Agencia Tributaria - Departamento de Informática Tributaria

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

2 Funcionalidades
* La interfaz con todos nuestros módulos será estándar.
* Nuestros módulos no dialogan en modo alguno con el usuario final, es decir, a la entrega de
un fichero de entrada provocan la generación de una serie de ficheros de salida. No muestran mensajes, ni
cuadros de diálogo.
* El fichero de errores se borra al final de la ejecución, si está vacío. Su contenido, en cualquier caso,
se borra en la siguiente ejecución (si es sobre el mismo fichero).
* Con relación al nombre de los archivos de la línea de comando, simplemente se exige que sean
válidos. No se exige que se detalle el camino completo, aunque se admite, al igual que se admiten nombres
UNC del tipo \\servidor\recurso.
* Cada campo únicamente admitirá los caracteres definidos según su tipo de dato.

S.G. Aplicaciones 4 Agencia Tributaria - Departamento de Informática Tributaria

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

3 Breve Descripción del Proceso

El programa toma como datos de entrada los contenidos en el fichero definido como
nombrearchivodatos cuyo diseño debe ajustarse al esquema W3C (fichero
AEATRetenciones2024.xsd) para ficheros XML.
Como resultado del cálculo obtendrá un fichero de resultados o de errores.
La descripción de los ficheros de salida y error puede consultarse en el documento adjunto
previamente citado.

S.G. Aplicaciones 5 Agencia Tributaria - Departamento de Informática Tributaria

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

4 Distribución del Módulo de Cálculo

El Módulo de Cálculo se compone del siguiente archivo:

ModRet20241.jar

S.G. Aplicaciones 6 Agencia Tributaria - Departamento de Informática Tributaria

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

5 Interfaz para la Ejecución del Programa

5.1 Ejecución desde línea de comandos.
La sintaxis de la llamada al programa para su ejecución es la siguiente:
java –jar ModRet20241.jar /E:nombrearchivodatos /R:nombrearchivoerrores
/S:nombrearchivosalida [/I:nombreinformacion]

Donde:
• Los identificadores de argumento (o de parámetro) son OBLIGATORIOS y se deben escribir
LITERALMENTE y con su valor pegado a los dos puntos (:).
Son los siguientes:
/E: /R: /S: /I:
Los corchetes [ ] indican argumento opcional y las llaves { } indican valor alternativo.
• nombrearchivodatos indica el fichero que contiene los datos de entrada que van a servir
como base del cálculo. El fichero tiene extensión deberá ser un documento XML acorde con el
esquema W3C (fichero AEATRetenciones2024.xsd). Es OBLIGATORIO y admite ruta completa.
• nombrearchivosalida indica el nombre del fichero que contiene el resultado de los
cálculos.
Es OBLIGATORIO y admite ruta completa.
• nombrearchivoerrores indica el nombre del fichero que contiene la relación de errores, si
los hubiera.
Es OBLIGATORIO y admite ruta completa.
• nombreinformacion indica el tipo de información adicional que deseamos imprimir. Los valores
admitidos son:
• version: Imprime la versión del programa por la salida estándar con el formato
“Retenciones 2024 vX.XX”
Es OPCIONAL.
Ejemplo:
java –jar ModRet20241.jar /E:ret.xml /R:”c:\erroresRet.xml”
/S:”c:\salidaRet.xml”

ATENCIÓN: Esta distribución contiene todos los módulos de cálculo

publicados por la Agencia Tributaria desde el ejercicio 2020 en adelante,
de modo que se podrá acceder a los cálculos de retenciones de cualquiera
de dichos ejercicios. Más información en el APÉNDICE 2.

S.G. Aplicaciones 7 Agencia Tributaria - Departamento de Informática Tributaria

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

5.2 Invocación desde un programa java

Opcionalmente, si el módulo de cálculo se utiliza desde una aplicación Java, es posible integrarlo como una
librería más de dicha aplicación e invocar el proceso de cálculo desde su código fuente:
1. Se deberá incluir el fichero ModRet2023.jar (y el resto de archivos necesarios) en el classpath de
la aplicación que utilice el módulo de cálculo, tanto en compilación como en ejecución.
2. Para lanzar el proceso se deberá invocar alguno de los métodos estáticos procesarFicheroXml1
de la clase es.aeat.pret.c200.mc.c231.ModuloCalculo. Por ejemplo:

import es.aeat.pret.c200.mc.c241.ModuloCalculo;
.....
ModuloCalculo.procesarFicheroXml(“entrada.xml”,“errores.xml”,“”,“salida.xml”);

ATENCIÓN: Esta distribución contiene todos los módulos de cálculo

distribuidos por la Agencia Tributaria desde el ejercicio 2020 en
adelante, de modo que se podrá acceder a los cálculos de retenciones de
dichos ejercicios. Más información en el APÉNDICE 3.

1 Consulte la ayuda javadoc incluida en la distribución del módulo de cálculo.

S.G. Aplicaciones 8 Agencia Tributaria - Departamento de Informática Tributaria

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

6 Validaciones
El Programa no realiza el cálculo cuando no se superen las validaciones descritas a continuación.
6.1 Ficheros XML
Los ficheros XML de entrada deberán ajustarse al esquema W3C que se puede descargar desde la página
web de la Agencia Tributaria (fichero AEATRetenciones2024.xsd).
6.2 Otras Validaciones
Se realizarán además las validaciones que se indican en el documento
ALGORITMO_RETENCIONES_2024_xx_xxx.pdf, que se puede descargar desde la página web de la
Agencia Tributaria, donde se describe el algoritmo para el cálculo de retenciones.

S.G. Aplicaciones 9 Agencia Tributaria - Departamento de Informática Tributaria

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

7 Recursos Mínimos
64 MB de memoria RAM mínima.
Disco duro con espacio libre mínimo de 2 MB.
Multiplataforma: Sistemas Windows, Mac OS X, GNU/Linux y, en general, cualquier plataforma capaz de
ejecutar un Máquina Virtual Java compatible con Java 8.

S.G. Aplicaciones 10 Agencia Tributaria - Departamento de Informática Tributaria

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

8 APÉNDICE 1
El Módulo de Cálculo de Retenciones ya ha dejado de utilizar SLF4J2 como sistema de logging, siendo este
sustituido por el sistema de logging estándar de la plataforma Java.

No obstante, en el caso de que se emplee el módulo de cálculo para alguno de los ejercicios anteriores al
2023, se seguirá utilizando dicho sistema, por lo que se deberán seguir distribuyendo las librerías:

slf4j-api-1.6.1.jar
slf4j-jdk14-1.6.1.jar

2 Simple Logging Facade for Java: Para más información vea http://www.slf4j.org

S.G. Aplicaciones 11 Agencia Tributaria - Departamento de Informática Tributaria

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

9 APÉNDICE 2
Esta distribución contiene todas las versiones del módulo de cálculo publicadas por la Agencia Tributaria
desde el ejercicio 2020 en adelante, de forma que mediante este único módulo de cálculo y modificando la
línea de comandos se podrá acceder a los cálculos de retenciones de cualquiera de dichos ejercicios.

• Retenciones 2020 (todo el ejercicio)

java -classpath ModRet20200.jar;slf4j-api-1.6.1.jar;slf4j-jdk14-1.6.1.jar

es.aeat.pret.c200.mc.ModuloCalculo /E:nombrearchivodedatos
/S:nombrearchivodesalida /R:nombrearchivodeerrores

• Retenciones 2021 hasta la publicación del RD 899/2021:

java -classpath ModRet2021RD8992021.jar;slf4j-api-1.6.1.jar;slf4j-jdk14-

1.6.1.jar es.aeat.pret.c200.mc.c210.ModuloCalculo /E:nombrearchivodedatos
/S:nombrearchivodesalida /R:nombrearchivodeerrores

• Retenciones 2021 a partir de la publicación del RD 899/2021

java -classpath ModRet20220.jar;slf4j-api-1.6.1.jar;slf4j-jdk14-1.6.1.jar

es.aeat.pret.c200.mc.c211.ModuloCalculo /E:nombrearchivodedatos
/S:nombrearchivodesalida /R:nombrearchivodeerrores

• Retenciones 2022
java -classpath ModRet20220.jar;slf4j-api-1.6.1.jar;slf4j-jdk14-1.6.1.jar
es.aeat.pret.c200.mc.c220.ModuloCalculo /E:nombrearchivodedatos
/S:nombrearchivodesalida /R:nombrearchivodeerrores

• Retenciones 2023 desde el 1 a 31 de enero

java -classpath ModRet20230.jar;slf4j-api-1.6.1.jar;slf4j-jdk14-1.6.1.jar
es.aeat.pret.c200.mc.c230.ModuloCalculo /E:nombrearchivodedatos
/S:nombrearchivodesalida /R:nombrearchivodeerrores

• Retenciones 2023 desde el 1 de febrero

java -classpath ModRet20231.jar;slf4j-api-1.6.1.jar;slf4j-jdk14-1.6.1.jar
es.aeat.pret.c200.mc.c231.ModuloCalculo /E:nombrearchivodedatos
/S:nombrearchivodesalida /R:nombrearchivodeerrores

• Retenciones 2024 desde el 1 de enero hasta el 7 de febrero

java -classpath ModRet20240.jar;slf4j-api-1.6.1.jar;slf4j-jdk14-1.6.1.jar
es.aeat.pret.c200.mc.c240.ModuloCalculo /E:nombrearchivodedatos
/S:nombrearchivodesalida /R:nombrearchivodeerrores

• Retenciones 2024 a partir del 8 de febrero

Tal y como se describe en el punto 5.1 de este documento.

S.G. Aplicaciones 12 Agencia Tributaria - Departamento de Informática Tributaria

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

10 APÉNDICE 3
Esta distribución contiene todas las versiones del módulo de cálculo publicadas por la Agencia Tributaria
desde el ejercicio 2020 en adelante, de forma que mediante este único módulo de cálculo embebido como
una librería dentro de un programa java se podrá acceder a los cálculos de retenciones de cualquiera de
dichos ejercicios.

• Retenciones 2020 (todo el ejercicio):

import es.aeat.pret.c200.mc.ModuloCalculo;
.....
ModuloCalculo.procesarFicheroXml(“entrada.xml”,“errores.xml”,“”,“salida.xml”);

• Retenciones 2021 hasta la publicación del RD 899/2021:

import es.aeat.pret.c200.mc.c210.ModuloCalculo;
.....
ModuloCalculo.procesarFicheroXml(“entrada.xml”,“errores.xml”,“”,“salida.xml”);

• Retenciones 2021 a partir de la publicación del RD 899/2021:

import es.aeat.pret.c200.mc.c211.ModuloCalculo;
.....
ModuloCalculo.procesarFicheroXml(“entrada.xml”,“errores.xml”,“”,“salida.xml”);

• Retenciones 2022
•
import es.aeat.pret.c200.mc.c220.ModuloCalculo;
.....
ModuloCalculo.procesarFicheroXml(“entrada.xml”,“errores.xml”,“”,“salida.xml”);

S.G. Aplicaciones 13 Agencia Tributaria - Departamento de Informática Tributaria

Módulo de Cálculo Retenciones 2024. A partir del 8 de febrero

• Retenciones 2023 desde 1 a 31 de enero

import es.aeat.pret.c200.mc.c230.ModuloCalculo;
.....
ModuloCalculo.procesarFicheroXml(“entrada.xml”,“errores.xml”,“”,“salida.xml”);

• Retenciones 2023 desde el 1 de febrero

import es.aeat.pret.c200.mc.c231.ModuloCalculo;
.....
ModuloCalculo.procesarFicheroXml(“entrada.xml”,“errores.xml”,“”,“salida.xml”);

• Retenciones 2024 desde el 1 de enero hasta el 8 de febrero

import es.aeat.pret.c200.mc.c240.ModuloCalculo;
.....
ModuloCalculo.procesarFicheroXml(“entrada.xml”,“errores.xml”,“”,“salida.xml”);

• Retenciones 2024 a partir del 8 de febrero

import es.aeat.pret.c200.mc.c241.ModuloCalculo;
• Retenciones 2024 desde xx de xxxxx
.....
ModuloCalculo.procesarFicheroXml(“entrada.xml”,“errores.xml”,“”,“salida.xml”);
Tal y como se describe en el punto 5.2 de este documento.

S.G. Aplicaciones 14 Agencia Tributaria - Departamento de Informática Tributaria