- Interoperability
Prohibition of consulting test data in the production environment in Interoperability services
Personal Income Tax (IRPF) data for the 2021 financial year can now be consulted via Via Oberta. Consultation methods are also available for exempt public pensions received by a natural or legal person and for information on cadastral data from the AEAT.
With regard to the calculated certificates of income (individual income level, income for social benefits and income for scholarships) are calculated on the basis of the registration design provided by the State Tax Administration Agency (AEAT) and, for therefore, the consistency of its results depends on the data sender. In the event that you detect inconsistencies in the query data, please send an email to Support and we will contact the AEAT.
In the Service Letter you will find the composition of the income level certificates and all the necessary information: how to make the queries, what data is obtained, query examples and the possible result or error codes.
Adaptations in the integrations for fiscal year 2021: New data schema and own namespace
Consumer administrations of the service through EACAT screens can consume directly, without the need to make transformations or request new authorizations.
For the administrations that consume these services in an integrated way, we remind you that for the 2021 financial year a different data schema will be used with the namespace specific to their financial year. In this sense, the XSD to be used to validate the answers for the 2021 exercise is not the same as that used for the 2020 exercise, but depending on the requested exercise, the answers must be validated with an XSD file or another.
Integration documentation
All the necessary documentation to make these adaptations is available at https://github.com/ConsorciAOC/VO-AEAT
This documentation may be subject to modifications introduced by the AEAT. In any case, a new publication will be made warning of changes.
Errors in the integrated consumption of IRPF 2020 in case of not having made the necessary adaptations
The AEAT has applied the adaptations in the Web Services for the year 2020, which affect all administrations that consume these services in an integrated way, as we communicated in this post https://www.aoc.cat/blog/2022/nous-desenvolupaments-en-la-integracio-dels-serveis-web-irpf-2020-i-2021/
In the event that your company has not made the adaptation to consider the specific namespace for this year, it is very likely that the queries in an integrated way for the year 2020 will return an error, and that you can only consume the data from this exercise using EACAT screens, until you have adapted to the new requirements.
Data dictionaries
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:
Income Dictionary 2020
Income Dictionary 2021
https://sede.agenciatributaria.gob.es/Sede/ayuda/disenos-registro/modelos-100-199.html