Via Oberta – Agència Tributària (AEAT)

Document d’integració del servei.

Podreu trobar els XSD's del servei en aquest repositori sota el directori /schema.

Control del document

Informació general

| Títol: | Via Oberta – AEAT. Document d’integració del servei|

Índex

1. Introducció
2. Transmissions de dades disponibles
3. Missatgeria dels serveis

1 Introducció

Aquest document detalla la missatgeria associada al servei de consulta d’informació associada als diferents serveis de l’Agència Tributària (en endavant AEAT).

Per poder realitzar la integració cal conèixer prèviament la següent documentació:

Document de Missatgeria Genèrica de la PCI del Consorci AOC.

2 Transmissions de dades disponibles

Les dades disponibles a través del servei són les que es presenten a continuació:

EMISSORS: AEAT (Agència Tributària)

PRODUCTE		MODALITAT	DESCRIPCIO
AEAT_IAE	Impost d’Activitats Econòmiques	AEATIAE	Consulta del conjunt d’epígrafs de l’IAE en els quals està matriculat el contribuent a la data actual.
AEAT_DADES	Dades tributàries	ECOT101	Obligacions tributàries segons llei de contractes.
AEAT_DADES	Dades tributàries	ECOT102	Obligacions tributàries per a autorització de transport.
AEAT_DADES	Dades tributàries	ECOT103	Obligacions tributàries per a subvencions i ajuda.
AEAT_DADES	Dades tributàries	ECOT104	Obligacions tributàries per a permisos de residència i treball.
AEAT_DADES	Dades tributàries	SCPWIJ1R	Consulta del domicili fiscal d’un contribuent.
AEAT_DADES	Dades tributàries	INFOCAT	Consulta de dades cadastrals d’un contribuent.
AEAT_DADES	Dades tributàries	VERIFICAR_NIF	Verificació de NIF (qualitat de dades identificatives).
AEAT_IRPF	Renda	IRPF	Certificat IRPF d’un contribuent en un exercici fiscal.
AEAT_IRPF	Renda	C2	Nivell de renda
AEAT_IRPF	Renda	C4	Renda per a prestacions socials
AEAT_IRPF	Renda	C6	Renda per a beques.
AEAT_IRPF	Renda	PPE	Pensions Públiques Exemptes.

Totes les consultes del producte tenen disponible la versió imprimible del resultat de la consulta en format PDF. Per més detalls adreceu-vos a l’apartat Extensions de missatgeria del document de missatgeria genèrica.

3 Missatgeria dels serveis

A continuació es detalla la missatgeria corresponent al bloc de dades específiques de les modalitats de consum del producte AEAT.

⚠️ L’emissor de les dades requereix que s’informin les dades del funcionari que realitza la consulta. Així, cal informar l’element Funcionario del bloc de dades genèriques:
/Peticion/Funcionario i //SolicitudTransmision/DatosGenericos/Solicitante/Funcionario.
El nom i cognoms del funcionari han de seguir el format Cognom1 Cognom2 Nom.

Consulta d’epígrafs de l’IAE (AEATIAE)

Consulta del conjunt d’epígrafs de l’Impost d’Activitats Econòmiques (en endavant IAE) en el quals un contribuent es troba matriculat a la data actual.

3.1.1 Petició – dades genèriques

Element	Descripció
//DatosGenericos/Titular/TipoDocumentacion	Tipus de documentació (NIF, NIE, CIF).
//DatosGenericos/Titular/Documentacion	Documentació.
//DatosGenericos/Titular/NombreCompleto	Nom complert del contribuent. Requerit únicament en cas de persona física.

3.1.2 Resposta – dades específiques

Element	Descripció
respostaConsultaIAE/DatosEspecificos	Bloc de dades corresponent a la resposta.
//DatosEspecificos/FechaProceso	Data en la que és vàlida la resposta (AAAA-MM-DD).
//DatosEspecificos/ReferenciaPet	Referència única de la resposta per el conjunt de totes les activitats econòmiques.
//DatosEspecificos/NombreCompleto	Nom del contribuent consultat tal i com figura a les bases de dades identificatives de l'AEAT.
//DatosEspecificos/NroActividades	Número d’activitats pel titular (màxim 10).
//DatosEspecificos/Actividades	Bloc de dades corresponent a l’informació d’una activitat
//DatosEspecificos/Actividades/Seccion	Secció o tipus d'activitat: 1: empresarial 2: professional 3: artista 4: activitat econòmica no subjecte a IAE
//DatosEspecificos/Actividades/Epigrafe	Epígraf de l’IAE. Per exemple 6622 equival a 662.2
//DatosEspecificos/Actividades/DescActividad	Descripció de l’activitat econòmica.
//DatosEspecificos/Actividades/FechaInicio	Dada d’alta en l’activitat (AAAA-MM-DD).
/DatosEspecificos/Actividades/FechaFin	Dada de baixa en l’activitat (AAAA-MM-DD).
//DatosEspecificos/Actividades/Referencia	Referència o clau que identifica cada activitat econòmica.
respostaConsultaIAE/resultat/codiResultat	Codi de resultat de la consulta. Per més detalls vegeu l’apartat 3.1.2.1 d’aquest document.
respostaConsultaIAE/resultat/descripcio	Descripció del resultat.

3.1.2.1 Codis de resultat

1000: Titular identificat i amb activitats econòmiques.
1002: Titular no identificat a l’AEAT.
1006: No procedeix facilitar la informació sol·licitada.
1008: Titular identificat i sense amb activitats econòmiques.
0502: Error en la comunicació amb l’emissor final.

3.2 Consulta de domicili fiscal (SCPWIJ1R)

Consulta del domicili fiscal d’un contribuent.

3.2.1 Petició – dades genèriques

Element	Descripció
//DatosGenericos/Titular/TipoDocumentacion	Tipus de documentació (NIF, NIE, CIF).
//DatosGenericos/Titular/Documentacion	Documentació.
//DatosGenericos/Titular/NombreCompleto	Nom complert del contribuent. Requerit únicament en cas de persona física.

3.2.2 Resposta – dades específiques

Element	Descripció
respostaConsultaDomiciliFiscal/DatosEspecificos	Bloc de dades corresponent a la resposta.
//DatosEspecificos/CABECERA/REFERENCIA_S	Referència única de la resposta emesa per l’AEAT.
//DatosEspecificos/CABECERA/FECHA_EMISION_S	Data d’emissió de la resposta.
//DatosEspecificos/CABECERA/TIPO_RESPUESTA_S	Tipus de resposta.
/DatosEspecificos/CABECERA/NOMBRE_COMPLETO_S	Nom del contribuent consultat tal i com figura a les bases de dades identificatives de l'AEAT.
//DatosEspecificos/DIRECCION/ADMON_FISC_S	Administració fiscal.
//DatosEspecificos/DIRECCION/TIPO_DOMI_S	Tipus de domicili: 20: domicili fiscal a Espanya 21: domicili fiscal a l’estranger
//DatosEspecificos/DIRECCION/FECH_DOMI_S	Data d’actualització del darrer domicili.
//DatosEspecificos/DIRECCION/TIPO_VIA_S	Tipus de via.
//DatosEspecificos/DIRECCION/CODIGO_VIA_S	Codi INE de la via.
//DatosEspecificos/DIRECCION/VIAPBL_S	Nom llarg de la via pública.
//DatosEspecificos/DIRECCION/VIAPBC_S	Nom curt de la via pública.
//DatosEspecificos/DIRECCION/TIPO_NUM_S	Tipus número.
//DatosEspecificos/DIRECCION/NUMERO_EN_S	Número del domicili a la via.
//DatosEspecificos/DIRECCION/CALIF_NUM_S	Qualificador del número
//DatosEspecificos/DIRECCION/BLOQUE_S	Bloc.
//DatosEspecificos/DIRECCION/PORTAL_S	Portal
//DatosEspecificos/DIRECCION/ESC_S	Escala
//DatosEspecificos/DIRECCION/PISO_S	Planta o pis.
//DatosEspecificos/DIRECCION/PTA_S	Porta.
//DatosEspecificos/DIRECCION/COMPLEMENTO_S	Dades complementàries del domicili, p.e. "Urbanización", "Centro Comercial", "Polígono", "Edificio", etc
//DatosEspecificos/DIRECCION/POBLACION_S	Nom de la localitat / població si és diferent al municipi.
//DatosEspecificos/DIRECCION/CODPOST_S	Codi postal
//DatosEspecificos/DIRECCION/CODMUNI_S	Codi de municipi.
//DatosEspecificos/DIRECCION/MUNICIPIO_S	Nom del municipi.
//DatosEspecificos/DIRECCION/CODPROV_S	Codi de província
//DatosEspecificos/DIRECCION/NOMPROV_S	Nom de la província
//DatosEspecificos/DIRECCION/E_MAIL_S	Adreça de correu electrònic.
//DatosEspecificos/DIRECCION/TFNO_FIJO_S	Telèfon fix.
//DatosEspecificos/DIRECCION/TFNO_MOVIL_S	Telèfon mòbil.
//DatosEspecificos/DIRECCION/FAX_S	Fax.
respostaConsultaDomiciliFiscal/resultat/codiResultat	Codi de resultat de la consulta. Per més detalls vegeu l’apartat 3.1.2.1 d’aquest document
respostaConsultaDomiciliFiscal/resultat/descripcio	Descripció del resultat.

3.2.2.1 Codis de resultat

1000: Titular identificat.
1002: Titular no identificat a l’AEAT.
0502: Error en la comunicació amb l’emissor final.

3.3 Consulta d’estar al corrent de pagament d’obligacions tributàries (ECOT10X)

Les següents modalitats permeten consultar si una persona o entitat es troba al corrent de pagament de les seves obligacions tributàries

ECOT101: obligacions tributàries segons llei de contractes.
ECOT102: obligacions tributàries per a autorització de transport
ECOT103: obligacions tributàries per a subvencions i ajuda
ECOT104: obligacions tributàries per a permisos de residència i treball.

En les respostes s'indica el caràcter positiu o negatiu de la certificació i en les respostes negatives s'indica el motiu o motius de l’incompliment:

Manca de presentació d'una autoliquidació o declaració a la que el contribuent estigués obligat en els darrers dotze mesos precedents als dos mesos immediatament anteriors a la data de sol·licitud.
Manteniment de deutes o sancions tributàries en període executiu amb l'AEAT sense que aquestes es trobin aplaçades, fraccionades o suspeses.
Tenir pendents d'ingrés responsabilitats civils derivades de delicte contra la Hisenda Pública declarades per sentència ferma.
No estar donat d'alta al cens d'empresaris, professionals o retenidors, quan es tracti de persones o entitats obligades a estar en aquest cens i no estar donat d'alta en l'Impost d'Activitats Econòmiques, quan es tracti de subjectes passius no exempts de l'impost.

3.3.1 Petició – dades genèriques

Element	Descripció
//DatosGenericos/Titular/TipoDocumentacion	Tipus de documentació (NIF, NIE, CIF)
//DatosGenericos/Titular/Documentacion	Documentació.
//DatosGenericos/Titular/NombreCompleto	Nom complert del contribuent. Requerit únicament en cas de persona física. Alternativament es poden informar els elements Nombre, Apellido1 i Apellido2 del mateix bloc Titular.

3.3.2 Resposta – dades específiques

Element	Descripció
respostaConsultaObligacionsTributaries/DatosEspecificos/ Referencia	Referència única de la resposta.
respostaConsultaObligacionsTributaries/DatosEspecificos FechaEmision	Data en la que és vàlida la resposta (AAAA-MM-DD).
respostaConsultaObligacionsTributaries/DatosEspecificos/ ObligacionesTributarias/CodigoCertificado	Indica si el contribuent està al corrent o no de obligacions tributàries. Els possibles valors que pot tenir són POSITIVO o NEGATIVO.
respostaConsultaObligacionsTributaries/DatosEspecificos/ ObligacionesTributarias/TipoNegativo	Codi de la causa en cas de no estar al corrent de pagament. Per més detalls vegeu l’apartat d’aquest 3.4.2.1 document
respostaConsultaObligacionsTributaries/DatosEspecificos/ ObligacionesTributarias/Incumplimientos/NumeroRegistrosExistentes	Número total d’incompliments
respostaConsultaObligacionsTributaries/DatosEspecificos/ ObligacionesTributarias/Incumplimientos/NumeroRegistrosFacilitados	Número d’incompliments.
respostaConsultaObligacionsTributaries/DatosEspecificos/ ObligacionesTributarias/Incumplimientos/DatosIncumplimiento/Ejercicio	Exercici de l’incompliment.
respostaConsultaObligacionsTributaries/DatosEspecificos/ ObligacionesTributarias/Incumplimientos/DatosIncumplimiento/Modelo	Model tributari associat a l’incompliment.
respostaConsultaObligacionsTributaries/DatosEspecificos/ ObligacionesTributarias/Incumplimientos/DatosIncumplimiento/Periodo	Període associat a l’incompliment.
respostaConsultaObligacionsTributaries/resultat/codiResultat	Codi de resultat de la consulta. Per més detalls vegeu l’apartat 3.4.2.2 d’aquest document.
respostaConsultaObligacionsTributaries/resultat/descripcio	Descripció del resultat.

3.3.2.1 Codis de la causa de la negativitat

Tipus negatiu	Causa negativitat
A	"No está al corriente de obligaciones tributarias por incumplimiento de presentación de declaraciones o autoliquidaciones"
B	"No está al corriente de pago de deudas tributarias en periodo ejecutivo"
C	"No está al corriente de obligaciones tributarias por incumplimiento de presentación de declaraciones o autoliquidaciones y constancia de deudas tributarias en periodo ejecutivo"
F	"No está al corriente de obligaciones tributarias por tener alguna sentencia según el artículo 305.1/308.3 de la Ley Orgánica 10/1995, de 23 de noviembre, del Código Penal"
G	"No está al corriente de obligaciones tributarias por tener alguna sanción según el artículo 186.1/2 letra b) de la Ley 58/2003, de 17 de diciembre, General Tributaria"
H	"No está al corriente de obligaciones tributarias por baja censal detectada"
M	"No está al corriente de obligaciones tributarias por delito fiscal"
N	"No está al corriente de obligaciones tributarias por incumplimiento de presentación de declaraciones o autoliquidaciones, constancia de deudas tributarias en periodo ejecutivo y delito fiscal"
O	"No está al corriente de obligaciones tributarias por incumplimiento de presentación de declaraciones o autoliquidaciones y delito fiscal"
P	"No está al corriente de pago de deudas tributarias en periodo ejecutivo y delito fiscal"
Q	"No está al corriente de obligaciones tributarias por incumplimiento de presentación de declaraciones o autoliquidaciones y baja censal detectada"
R	"No está al corriente de pago de deudas tributarias en periodo ejecutivo y baja censal detectada"
S	"No está al corriente de obligaciones tributarias por delito fiscal y baja censal detectada"
T	"No está al corriente de obligaciones tributarias por incumplimiento de presentación de declaraciones o autoliquidaciones, constancia de deudas tributarias en periodo ejecutivo, delito fiscal y baja censal detectada"
U	"No está al corriente de obligaciones tributarias por incumplimiento de presentación de declaraciones o autoliquidaciones, delito fiscal y baja censal detectada
V	"No está al corriente de pago de deudas tributarias en periodo ejecutivo, delito fiscal y baja censal detectada"
X	"No está al corriente de obligaciones tributarias por incumplimiento de presentación de declaraciones o autoliquidaciones, constancia de deudas tributarias en periodo ejecutivo y baja censal detectada"

3.3.2.2 Codis de resultat

1000: Titular identificat.
0233: Titular no identificat a l’AEAT. Reviseu les dades identificatives del contribuent.
1009: Titular amb C.I. revocat. Remetre a l’interessat a la seva Administració Tributària.
1011: No procedeix per titular il·localitzable. Remetre a l’interessat a la seva Administració Tributària.
1012: Sense oficina gestora. Remetre a l’interessat a la seva Administració Tributària.
1013: Sense oficina recaptadora. Remetre a l’interessat a la seva Administració Tributària.
1014: Titular de baixa. Remetre a l’interessat a la seva Administració Tributària.
1015: Titular en procés concursal. Remetre a l’interessat a la seva Administració Tributària.
0502: Error en la comunicació amb l’emissor final.

3.4 Certificat IRPF d’un contribuent

La següent modalitat permet obtenir el certificat IRPF d’un contribuent en un exercici fiscal determinat.

⚠️ La declaració Individual o Conjunta és una característica de la pròpia declaració però la informació de les partides que conté no és pot disgregar. Així, no es diferencia el que pertany al Declarant o el que pertany al Cònjuge

3.4.1 Petició – dades genèriques

Element	Descripció
//DatosGenericos/Titular/TipoDocumentacion	Tipus de documentació NIF (DNI, NIE).
//DatosGenericos/Titular/Documentacion	Documentació.
//DatosGenericos/Titular/NombreCompleto	Nom complert del contribuent. Requerit únicament en cas de persona física. Alternativament es poden informar els elements Nombre, Apellido1 i Apellido2 del mateix bloc Titular.

3.4.2 Petició – dades específiques

Element	Descripció
peticioConsultaIRPF/DatosEspecificos/Ejercicio	Exercici fiscal.

3.4.3 Resposta – dades específiques (exercicis 2019 i anteriors)

Element	Descripció
respostaConsultaIRPF/DatosEspecificos/Cabecera/Referencia	Referència única de la resposta.
respostaConsultaIRPF/DatosEspecificos/Cabecera/FechaEmision	Data de generació de la resposta (AAAA-MM-DD).
respostaConsultaIRPF/DatosEspecificos/Cabecera/Ejercicio	Exercici fiscal.
respostaConsultaIRPF/DatosEspecificos/Cabecera/TipoRespuesta	Tipus de resposta: IM: imputacions IR: renda
respostaConsultaIRPF/DatosEspecificos/Imputaciones	Bloc de dades corresponent a les imputacions. Per més detalls vegeu l’apartat 3.4.3.1 d’aquest document.
respostaConsultaIRPF/DatosEspecificos/irpf	Bloc de dades corresponent a les dades d’IRPF. Per més detalls vegeu l’apartat 3.4.3.2 d’aquest document.
respostaConsultaIRPF/resultat/codiResultat	Codi de resultat de la consulta. Per més detalls vegeu l’apartat 0 d’aquest document.
respostaConsultaIRPF/resultat/resultat/descripcio	Descripció del resultat.

3.4.3.1 Imputacions

Element	Descripció
//Imputaciones/Cabecera
//Imputaciones/DatosEconomicos/Texto	Text explicatiu de la imputació.
//Imputaciones/DatosEconomicos/Signo
//Imputaciones/DatosEconomicos/Enteros
//Imputaciones/DatosEconomicos/Decimales
//Imputaciones/Cola

3.4.3.2 IRPF

Element	Descripció
//irpf/CabeceraRenta/NifSolicitante	NIF de l’Organisme que sol·licita la informació.
//irpf/CabeceraRenta/NombreSolicitante	Nom de l’Organisme que sol·licita la informació.
//irpf/CabeceraRenta/PrimerDeclarante	Titular de la declaració.
//irpf/CabeceraRenta/SegundoTitular	Segon titular de la declaració.
//irpf/CabeceraRenta/Modelo	Model de la declaració (100 o MODELO: 100).
//irpf/CabeceraRenta/Tributacion	Tipus de tributació. En funció de l’exercici pot venir informat com a: TRIBUTACION: I o INDIVIDUAL TRIBUTACION: C o CONJUNTA
//irpf/CabeceraRenta/OrigenDatos	Origen de les dades (3).
//irpf/Importes	No s’informa en la modalitat IRPF, únicament en les modalitats C2 i C4. Per més detalls vegeu l’apartat 3.5.2 d’aquest document.
//irpf/DatosEconomicos	Bloc de dades corresponent a dades econòmiques.
//irpf/DatosEconomicos/DEGrupo
//irpf/DatosEconomicos/DECasilla	Número de casella de la declaració.
/irpf/DatosEconomicos/DESigno	Blanc si positiu, - si negatiu.
//irpf/DatosEconomicos/DEEnteros
//irpf/DatosEconomicos/DEDecimales
//irpf/OtrosDatos	Bloc de dades corresponent a altres dades
//irpf/OtrosDatos/ODDDescripcion	Descripció de dades auxiliars, en aquest cas Nivell de Renda (4).
//irpf/OtrosDatos/ODSigno
//irpf/OtrosDatos/ODEnteros
//irpf/OtrosDatos/ODDecimales
//irpf/DatosCola	Per més detalls vegeu la taula següent.

Element	Descripció
//DatosCola/DCDatosPersonales/DCLiteral	Dades personals del primer declarant.
//DatosCola/DCDatosPersonales/DCEstadoCivil/DCFecha	Data a la que correspon l’estat civil
//DatosCola/DCDatosPersonales/DCEstadoCivil/DCContenido	Text de l’estat civil.
//DatosCola/DCDatosPersonales/DCEstadoCivil/DCFechaNac	Data de naixement.
//DatosCola/DCDatosPersonales/DCEstadoCivil/DCMinusvalia	Clau de minusvalidesa.
//DatosCola/DCDatosConyuge/DCLiteral	Dades personals del cònjuge.
//DatosCola/DCDatosConyuge/DCFechaNac	Data de naixement del cònjuge
//DatosCola/DCDatosConyuge/DCMinusvalia	Clau de minusvalidesa
//DatosCola/DCDatosHijos/DCLiteral	Fills o descendents solters menors de 25 anys o discapacitats que conviuen amb els contribuents.
//DatosCola/DCDatosHijos/DCNumHijos	Bloc de dades corresponent a les dades d’un fill
//DatosCola/DCDatosHijos/DCNumHijos/DCNombreHijo	Nom del descendent.
//DatosCola/DCDatosHijos/DCNumHijos/DCFechaNacim	Data de naixement.
//DatosCola/DCDatosHijos/DCNumHijos/DCFechaAdopc	Data d’adopció.
//DatosCola/DCDatosHijos/DCNumHijos/DCMinusvalia	Clau de minusvalidesa.
//DatosCola/DCDatosHijos/DCNumHijos/DCVinculacion	Vinculació del descendent
//DatosCola/DCDatosAscend/DCLiteral
//DatosCola/DCDatosAscend/DCNumAscend	Bloc de dades corresponent a les dades d’un ascendent.
//DatosCola/DCDatosAscend/DCNumAscend/DCNombreAscenf	Nom de l’ascendent.
//DatosCola/DCDatosAscend/DCNumAscend/DCFechaNacim	Data de naixement de l’ascendent.
//DatosCola/DCDatosAscend/DCNumAscend/DCMinusvalia	Clau de minusvalidesa.
//DatosCola/DCDatosAscend/DCNumAscend/DCVinculacion	Vinculació de l’ascendent.
//DatosCola/DCDatosAscend/DCNumAscend/DCConvivencia	Convivència de l’ascendent amb el titular.
//DatosCola/DCDatosVivienda/DCLiteral
//DatosCola/DCDatosVivienda/DCNumViviendas	Bloc de dades corresponent a les dades d’una vivenda.
//DatosCola/DCDatosVivienda/DCNumViviendas/DCContrib	Contribuent amb participació a la vivenda habitual:Declarante o Conyuge.
//DatosCola/DCDatosVivienda/DCNumVivendas/DCParticipac	Percentatge de participació.
//DatosCola/DCDatosVivienda/DCNumViviendas/DCRefCatastr	Referència cadastral de la vivenda.
//DatosCola/DCDatosVivienda/DCNumViviendas/DCSituacion	Territori espanyol excepte País Basc i Navarra País Basc i Navarra Sense referència cadastral A l’estranger
//DatosCola/DCDatosVivienda/DCNumViviendas/DCTitularidad	Titularitat de la vivenda habitual: Propiedad,Usufructo, Arrendamiento, Otras situaciones.
//DatosCola/DCDatosInmuebles/DCLiteral	Identificació de resta d’immobles urbans
//DatosCola/DCDatosInmuebles/DCNumInmuebles	Bloc de dades corresponent a les dades d’unimmoble.
//DatosCola/DCDatosInmuebles/DCNumInmuebles/DCContrib	Contribuent titular de l’immoble: Común,Declarante, Conyuge, Hijo.
//DatosCola/DCDatosInmuebles/DCNumInmuebles/DCTitularidad	Percentatge de titularitat.
//DatosCola/DCDatosInmuebles/DCNumInmuebles/DCSituacion	Territori espanyol excepte País Basc i Navarra País Basc i Navarra Sense referència cadastral A l’estranger
//DatosCola/DCDatosInmuebles/DCNumInmuebles/DCRefcatastr	Referència cadastral de l’immoble.
//DatosCola/DCDatosInmuebles/DCNumInmuebles/DCUso	Ús de l’immoble: Arrendamiento, A disposición de sus titulares, Arrendamiento y a disposición de sus titulares.
//DatosCola/DCDatosInmuebles/DCNumInmuebles/DCRentaImputada	Renda imputada a l’immoble

3.4.3.3 Codis de resultat

1000: Titular identificat
Si ha presentat declaració d’IRPF en l’exercici sol·licitat es faciliten les dades de renda de la persona declarant (TipoRespuesta = IR; DL, per exercicis iguals i posteriors a 2020).
Si el contribuent no presenta declaració d’IRPF per no tenir-hi obligació (TipoRespuesta = IM), es subministren set dades de renda procedents d’imputacions de tercers que corresponen a:
1. Rendiments del treball.
2. Retencions de rendiments del treball.
3. Rendiments del capital mobiliari.
4. Retencions del capital mobiliari.
5. Guanys patrimonials sotmesos a retenció.
6. Retencions de guanys patrimonials.
7. Despeses deduïbles de rendiments de treball.

1009: No existeix cap imputació rellevant. No consta declaració de l’impost per no figurar obligat i no figuren imputacions de l’interessat
1010: Exercici no disponible.
1011: Existeixen diverses declaracions o una de complementària. No es facilita informació.
1024: El titular no té consideració de contribuent per aquest impost
0502: Error en la comunicació amb l’emissor final.

3.4.4 Resposta – dades específiques (exercicis 2020 i posteriors)

El servei de l'IRPF presenta canvis al bloc DatosEspecificos de la missatgeria de resposta a partir de l'exercici 2020 segons el següent schema. En aquests casos, es retornen totes les caselles de la declaració que no incompleixen la declaració de dades.

Així, per aquests exercicis els nodes que vindran informats en cas que hi hagi renda són els elements Declaracion (en cada exercici definit per un namespace propi) i NivelRentaDeclaracion enlloc de l'element irpf informat fins l'exercici 2019.

Per tal de conèixer el significat dels elements de la resposta de cada exercici, cal utilitzar un diccionari de dades que està publicat a la seu electrònica de l'AEAT:

https://sede.agenciatributaria.gob.es/Sede/ayuda/disenos-registro/modelos-100-199.html -> https://sede.agenciatributaria.gob.es/static_files/Sede/Disenyo_registro/DR_100_199/archivos_23/diccionarioXSD_2023.properties

Pel que fa al diccionari i als paràmetres de les dades subministrades, s'han d'interpretar de la següent manera:

PARTIDA DE RENTAWEB = [1][2][3][4]

XPath / ruta de la partida en el XML de resposta.
Tipus de dada:
- TIT: indica el titular de les dades.
- LGC: tipus booleans (0: fals, 1 : vertader)
- S_N: tipus que requereixen una resposta Si o No.
- FEC: s'usa per complimentar dates.
- X: tipus alfabètic i alfanumèric.
- P010,P020,P030,P040,P070: partides positives.
- P012,P022,P032,P042,P052: partides amb dos decimals.
- P102: partides positives amb 10 enters i 2 decimals.
- N102: partides numèriques que poden ser negatives i que admeten 2 decimals.
- MOD: mòduls.
Número de casella: cal tenir en compte que les tres primeres pàgines de el model publicat al BOE porten una numeració especial, que no té res a veure amb la numeració de la part econòmica de la declaració. Aquestes pàgines es numeren des de la casella 01 fins a la 127. Aquesta numeració es mostra amb un asterisc (*) que indica que aquesta numeració és de les pàgines inicials. La resta de caselles del model es numeren amb un identificador de 4 dígits. Si el nombre indicat en el diccionari és [###] indica que o bé aquesta partida no té un número associat al model, o és una partida d'una finestra sense numerar.
Descripció de l'etiqueta: literals tal i com apareixen al model.

Per exemple, l'element de la resposta

<SUMTPRNP>100000.00</SUMTPRNP>

es resoldria contra aquesta entrada del diccionar

SUMTPRNP=[/DatosEconomicos/Resultados/RdtoTrabajoRes/SUMTPRNP][N102][0018][Suma de rendimientos netos previos (suma de las casillas [0017])]

3.5 Certificats de renda d’un contribuent (Cx)

Les següents modalitats permeten obtenir els següents certificats de renda d’un contribuent en un exercici fiscal determinat:

C2: Nivell de renda
C4: Renda per a prestacions socials.
C6: Renda per a beques.

3.5.1 Petició

La missatgeria de petició és idèntica a la de consulta del IRPF (tant pel que fa a les dades genèriques com a les específiques).

3.5.2 Resposta

La missatgeria de resposta és idèntica a la de consulta del IRPF. A diferència del certificat d’IRPF, en cas que el titular hagi presentat la declaració del IRPF (TipoRespuesta = IR o DL a partir de l’exercici 2020) en l’exercici sol·licitat el servei informarà l’element Importes segons correspongui en funció de les dades consultades. Si el contribuent no presenta declaració de IRPF per no tenir obligació (TipoRespuesta = IM) es subministren les set dades procedents d’imputacions de tercers detallades en la modalitat anterior.

3.5.2.1 Importes

Element	Descripció
//Importes/Importe	Bloc de dades corresponent a un import del certificat.
//Importes/Importe/Importe	Nom d’import.
//Importes/Importe/Descripcion	Descripció de l’import.
//Importes/Importe/Valor	Valor de l’import.

3.6 Pensions Públiques Exemptes (PPE)

La següent modalitat permet consultar les Pensions Públiques Exemptes d’un contribuent en un exercici fiscal determinat

3.6.1 Petició – dades genèriques

Element	Descripció
//DatosGenericos/Titular/TipoDocumentacion	Tipus de documentació NIF (DNI, NIE).
//DatosGenericos/Titular/Documentacion	Documentació.
//DatosGenericos/Titular/NombreCompleto	Nom complert del contribuent. Requerit únicament en cas de persona física. Alternativament es poden informar els elements Nombre, Apellido1 i Apellido2 del mateix bloc Titular.

3.6.2 Petició – dades específiques

Element	Descripció
peticioConsultaPPE/DatosEspecificos/Ejercicio	Exercici fiscal. El servei ofereix els darrers 5 exercicis des de la data de sol·licitud. Cada exercici estarà disponible al mateix temps que les dades de renda (principis de Juliol).

3.6.3 Petició – dades específiques

Element	Descripció
respostaConsultaPPE/DatosEspecificos/Cabecera/Referencia	Referència única de la resposta.
respostaConsultaPPE/DatosEspecificos/Cabecera/FechaEmision	Data de generació de la resposta (AAAA-MM-DD).
respostaConsultaPPE/DatosEspecificos/Cabecera/Ejercicio	Exercici fiscal.
respostaConsultaPPE/DatosEspecificos/PensionesPublicasExentas /NumeroRegistrosExistentes	Número total de registres de Pensions Públiques Exemptes del titular i exercici sol·licitat existents en el sistema de l’AEAT.
respostaConsultaPPE/DatosEspecificos/PensionesPublicasExentas /NumeroRegistrosFacilitados	Número de Pensions Públiques Exemptes retornades en la resposta (màxim 200)
respostaConsultaPPE/DatosEspecificos/PensionPublicaExenta	Bloc de dades corresponent a un registre de Pensió Pública Exempta. Per més detalls vegeu l’apartat 3.7.3.1 d’aquest document.
respostaConsultaIRPF/resultat/codiResultat	Codi de resultat de la consulta. Per més detalls vegeu l’apartat 3.7.3.2 d’aquest document.
respostaConsultaIRPF/resultat/resultat/descripcio	Descripció del resultat

3.6.3.1 Pensió Pública Exempta

Element	Descripció
//PensionPublicaExenta/NifTitular	NIF del titular.
//PensionPublicaExenta/NombreTitular	Nombre del titular.
//PensionPublicaExenta/NifDeclarante	NIF del declarant.
//PensionPublicaExenta/NombreDeclarante	Nom del declarant.
//PensionPublicaExenta/EjercicioDevengo	Exercici del que es proporcionen les dades.
//PensionPublicaExenta/Clave	Clau de percepció (L – Rendes Exemptes i dietes exceptuades de gravamen).
//PensionPublicaExenta/SubClave	Subclau de percepció: 06: Pensions Exemptes de la Seguretat Social (des de 2019). 07: Pensions Exemptes del règim de classes passives (des de 2019). 08: Pensions familiars de la Seguretat Social per fill a càrrec (des de 2019). 22: Ajuts establerts per les CCAA o entitats locals per atendre col·lectius en risc d'exclusió social, situacions d'emergència social i altres situacions de necessitat (des de 2021). 23: Prestacions per informar els ajuts assignats a certes víctimes de delictes violents i contra la llibertat sexual (des de 2021). 27: Prestacions públiques per maternitat o paternitat exemptes d'IRPF (des de 2019). 28: Prestacions econòmiques establertes per les CCAA en concepte de renda mínima d'inserció (des de 2021). 29: Prestació econòmica de la Seguretat Social corresponent a l'Ingrés Mínim Vital (des de 2021).
//PensionPublicaExenta/Retribucion	Import expressat en cèntims d’euro. Format numèric de 15 posicions. Exemple: 1928557 equival a 19.285,57 €
//PensionPublicaExenta/Retencion	Import expressat en cèntims d’euro. Format numèric de 15 posicions. Exemple: 928557 equival a 9.285,57 €.
//PensionPublicaExenta/Valoracion	Import expressat en cèntims d’euro. Format numèric de 15 posicions. Exemple: 1928557 equival a 19.285,57 €.
//PensionPublicaExenta/IngresosACuenta	Import expressat en cèntims d’euro. Format numèric de 15 posicions. Exemple: 1928557 equival a 19.285,57 €.
//PensionPublicaExenta/IngresosACuentaReperc	Ingressos a compte repercutits. Import expressat en cèntims d’euro. Format numèric de 15 posicions. Exemple: 1928557 equival a 19.285,57 €
//PensionPublicaExenta/ReferenciaRto	Número de referència assignat per l’AEAT.

3.6.3.2 Codis de resultat

1000: Titular identificat, exercici correcte amb dades.
1008: Titular identificat, exercici correcte, sense dades.
1010: Titular identificat, exercici incorrecte
0233: Titular no identificat a l’AEAT.
0502: Error en la comunicació amb l’emissor final.

3.7 Dades cadastrals (INFOCAT)

La següent modalitat permet consultar les dades cadastrals d’un contribuent en un exercici fiscal determinat.

3.7.1 Petició – dades genèriques

Element	Descripció
//DatosGenericos/Titular/TipoDocumentacion	Tipus de documentació NIF.
//DatosGenericos/Titular/Documentacion	Documentació.
//DatosGenericos/Titular/NombreCompleto	Nom complert del contribuent (primer cognom, segons cognom, nom). Requerit únicament en cas de persona física. Alternativament es poden informar els elements nombre, Apellido1 i Apellido2 del mateix bloc Titular

3.7.2 Petició – dades específiques

Element	Descripció
peticioConsultaINFOCAT/DatosEspecificos/Ejercicio	Exercici fiscal. El servei ofereix els darrers 4 exercicis des de la data de sol·licitud.

3.7.3 Resposta – dades específiques

Element	Descripció
respostaConsultaINFOCAT/DatosEspecificos/Cabecera/Referencia	Referència única de la resposta.
respostaConsultaINFOCAT/DatosEspecificos/Cabecera/FechaEmision	Data de generació de la resposta (AAAA-MM-DD).
respostaConsultaINFOCAT/DatosEspecificos/Cabecera/Ejercicio	Exercici fiscal
respostaConsultaINFOCAT/DatosEspecificos/Inmuebles/NumeroRegistrosExistentesTotal	Número total de registres de immobles existents del Padró de Rústica i del Padró d’Urbana pel NIF i exercicis sol·licitats.
respostaConsultaINFOCAT/DatosEspecificos/Inmuebles/NumeroRegistrosFacilitadosTotal	Número total de registres de immobles facilitats del Padró de Rústica i del Padró d’Urbana pel NIF i exercicis sol·licitats.
respostaConsultaINFOCAT/DatosEspecificos/InmueblesPadronRustica	Bloc de dades corresponent als immobles del Padró de Rústica.
respostaConsultaINFOCAT/DatosEspecificos/InmueblesPadronRustica/NumeroRegistrosExistentesPRU	Número total de registres de immobles existents del Padró de Rústica pel NIF i exercicis sol·licitats
respostaConsultaINFOCAT/DatosEspecificos/InmueblesPadronRustica/NumeroRegistrosFacilitadosPRU	Número total de registres de immobles facilitats del Padró de Rústica pel NIF i exercicis sol·licitats.
respostaConsultaINFOCAT/DatosEspecificos/InmueblesPadronRustica/DatosInmueble	Dades de l’immoble. Per més detalls vegeul’apartat 3.7.3.1 d’aquest document.
respostaConsultaINFOCAT/DatosEspecificos/InmueblesPadronUrbana	Bloc de dades corresponent als immobles del Padró d’Urbana.
respostaConsultaINFOCAT/DatosEspecificos/InmueblesPadronUrbana/NumeroRegistrosExistentesPUR	Número total de registres de immobles existents del Padró d’Urbana pel NIF i exercicis sol·licitats.
respostaConsultaINFOCAT/DatosEspecificos/InmueblesPadronUrbana/NumeroRegistrosFacilitadosPUR	Número total de registres de immobles facilitats del Padró d’Urbana pel NIF i exercicis sol·licitats.
respostaConsultaINFOCAT/DatosEspecificos/InmueblesPadronUrbana/DatosInmueble	Dades de l’immoble. Per més detalls vegeul’apartat 3.7.3.1 d’aquest document.
respostaConsultaINFOCAT/resultat/codiResultat	Codi de resultat de la consulta. Per més detalls vegeu l’apartat 3.7.3.2 d’aquest document.
respostaConsultaIRPF/resultat/resultat/descripcio	Descripció del resultat.

3.7.3.1 Codis de resultat

Element	Descripció
//DatosImmueble/ProcedenciaInformación	Codi de procedència de la informació: 00: Territori comú 01: Àlaba 20: Guipúscoa 31: Navarra 48: Biscaia
//DatosImmueble/Naturaleza	Naturalesa de l’immoble (RU – Rústica)
//DatosImmueble/CodigoProvincia	Codi provincial INE en la que es situa l’immoble.
//DatosImmueble/CodigoMunicipio	Codi de municipi INE en el que es situa l’immoble.
//DatosImmueble/ValorCatastral	Valor cadastral expressat en cèntims d’euro. P.e. 4172291 equival a 41.722,91 €.
//DatosImmueble/ValorCatastralSuelo	Valor cadastral del sòl expressat en cèntims d’euro.
//DatosImmueble/ValorCatastralConstruccion	Valor cadastral de la construcció expressat en cèntims d’euro.
//DatosImmueble/ValorCatastralRU	Valor cadastral del ús vivenda inclòs dins del bé expressat en cèntims d’euro.
//DatosImmueble/ClaveUso	Clau d’ús: A - Magatzem i aparcament V - Residencia I - Industrial O - Oficines C - Comercial K - Esportiu T - Espectacles G - Oci i Hosteleria Y - Sanitat i Beneficència E - Cultural R - Religiós M - Solars P - Edifici singular B - Magatzem agrari J - Industrial agrari Z – Agrari
//DatosImmueble/TipologiaLocal	Només té valor per immobles de Padró Urbana. Primer dígit de la tipologia dels locals associats al càrrec. Només en el cas d’ús (A – Magatzem i aparcament): 1: Residencial garatge 2: Industrial 3: Residencial traster
//DatosImmueble/CodigoDerecho	PR - Propietat NP - Nua propietat US - Usdefruit CA - Concessió administrativa DS - Dret de superfície DF - Disfrutador
/DatosImmueble/PorcentajeTitularidad	Percentatge del titular sobre el bé amb respecte a un determinat dret. P.e. 10000 equival a 100,00.
//DatosImmueble/FechaInicioTitularidad	Data d’inici de titularitat (AAAAMMDD).
/DatosImmueble/FechaFinTitularidad	Data de fi de titularitat (AAAAMMDD).
//DatosImmueble/AnioRevisionCatastralMunicipio	Exercici de la valoració col·lectiva del municipi de territori comú (any de revisió del valor cadastral). A partir de l’exercici 2009 inclòs, aquest valor també es té per immobles provinents d’Hisendes Forals.
//DatosImmueble/AnioRevisionCatastral	Exercici de la valoració col·lectiva de bé immoble de territori comú (any de revisió del valor cadastral). A partir de l’exercici 2009 inclòs, aquest valor també es té per immobles provinents d’Hisendes Forals.
//DatosImmueble/MarcaViviendaHabitual	Només té valor per immobles de Padró Urbana. Només es genera la marca de vivenda habitual per immobles de territori comú: 0 - no és vivenda habitual. 1 - per a una única clau 'V' por NIF. 2 - per clau 'A' i tipologia '1' (garatges) fins a dos per NIF. 3 - per clau 'A' i tipologia '3' (trasters) tants com coincideixi amb el domicili de la residència. A partir de 2011 inclòs, es tenen altres valors que indiquen que també són immobles no afectes amb ús 6 (vivenda a disposició de cònjuge anterior): 4 - per una única clau 'V' per NIF. 5 - per clau 'A' i tipologia '1' (garatges) fins a dos per NIF 6 - per clau 'A' i tipologia '3' (trasters) tants com coincideixi amb el domicili de la residència
//DatosImmueble/ReferenciaCatastral	En el cas de territori comú es la referència cadastral estàndard de 20 posicions
//DatosImmueble/CalidadReferenciaCatastral	Qualitat de la referència cadastral: 0: correcta 1: incorrecta

3.7.3.2 Codis de resultat

1000: Titular identificat, exercici correcte amb dades.
1008: Titular identificat, exercici correcte, sense dades.
1010: Titular identificat, exercici incorrecte
0233: Titular no identificat a l’AEAT.
0502: Error en la comunicació amb l’emissor final.

3.8 Verificació de NIF – qualitat de dades identificatives(VALIDAR_NIF)

3.8.1 Petició – dades especifiques

Element	Descripció
peticioVerificacioNIF/contribuent	Bloc de dades corresponent a les dades del contribuent a validar.
//contribuent/nif	Documentació. NIF de la persona física o jurídica sobre la qual es vol efectuar la consulta de verificació.
//contribuent/nom	Cognoms i nom de la persona física o raó social de la persona jurídica sobre la que es vol efectuar la consulta de verificació.

3.8.2 Resposta – dades específiques

Element	Descripció
respostaVerificacioNIF/resposta/contribuent	Bloc de dades corresponent a les dades del contribuent validat.
//contribuent/nif	NIF de la persona física o jurídica, validat i ajustat a 9 posicions amb zeros no significatius si s’escau.
//contribuent/nom	En cas de persona física, cognoms i nom informats a la petició. En cas de persona jurídica, Raó Social tal i com consta en el cens de contribuents de l’AEAT.
//contribuent/resultat	Resultat del procés d’identificació: IDENTIFICADO NO IDENTIFICADO IDENTIFICADO-BAJA IDENTIFICADO-REVOCADO NO PROCESADO
respostaVerificacioNIF/resultat/codiResultat	Codi de resultat de la operació. 0: operació realitzada correctament. 0502: error realitzant l’operació
respostaVerificacioNIF/resultat/descripcio	Descripció del resultat de la operació.

Name		Name	Last commit message	Last commit date
Latest commit History 24 Commits
AEAT-schemes_v2022		AEAT-schemes_v2022
img		img
README.md		README.md

ConsorciAOC/VO-AEAT

Folders and files

Latest commit

History

Repository files navigation