New developments in the integration of the IRPF 2020 and 2021 Web Services

The AEAT has informed us of a new approach to personal income tax Web services that affects all the administrations that consume these services in an integrated way, involving annual adaptations to consume the data of each new fiscal year. Administrations that consume income services only through the EACAT platform will not have to make any adaptations.

Affectations by the administrations integrated in the SW IRPF

The new approach of the AEAT involves modifications to the WS IRPF in order to offer in the same service, information for the years 2020 and 2021, so that from the year 2020 onwards, a specific messaging will be defined, what will require that all integrated organisms to this Web Service they have to adapt their developments annually based on the characteristics of each fiscal year.

Specifically, for each new fiscal year (2020 onwards) there will be a different data schema, with its own namespace, which will involve making annual adjustments based on the characteristics of each fiscal year.

According to the AEAT, this annual change in the scheme responds to the need to incorporate the changes in the model of the income tax return introduced in each fiscal year, since the current web service reproduces the full content of the income tax return. the income.

Exercise 2020 adaptations: exercise-specific namespace

This new approach implies that in order to continue consuming the fiscal year 2020, published last year, it is necessary to make a small adaptation to consider the specific namespace of this year.

In the event that this adaptation is not carried out, at the time the AEAT implements the changes, the queries will no longer work in the integrated query, and the administration will only be able to continue consuming the data for this exercise using EACAT screens.

Adaptations fiscal year 2021: New Data Scheme and own namespace

For the year 2021, a different data schema will be used with the namespace of its year. In this sense, the XSD to be used to validate the responses for the year 2021 is not the same as that used for the year 2020, but depending on the year requested, the answers must be validated with one XSD file or another.

Integration documentation

All the necessary documentation to make these adaptations is available at

This documentation may be subject to modifications introduced by the AEAT. In any case, a new publication will be made warning of changes.

We would like to remind you that, as of the 2020 financial year, the Personal Income Tax Web service is based on a specific dictionary for each financial year, with all the boxes and their descriptions published in:

Dictionary Income 2020

Dictionary Income 2021

The effects on the calculated modalities of the Income will be assumed by the AOC Consortium

The calculated modalities of the IRPF certificate:  “Individual Certificate of income level", “Income certificate for social benefits"I"Certificate of income for scholarships”Are also affected by this new approach.

However, the AOC Consortium is working on adapting these modalities to the format of previous years in order to avoid that both consumer administrations for EACAT screens and those integrated by web services are affected and they have to make new adaptations.