Documentos

Haciendas Forales - Consulta de datos de IRPF extendido

Palabras clave

Hacienda: Renta de las Personas Físicas (IRPF)

El requirente debe de identificarse con su certificado y debe tener permisos habilitados para el consumo de este servicio en el ámbito del procedimiento que lo quiera utilizar.

Tipo comunicación: Las peticiones realizadas a este servicio solo se podrán llevar a cabo a través del tipo de comunicación síncrona.

Datos mínimos necesarios para poder realizar una consulta a este servicio:

Expediente: Identificador o Nº de expediente asociado a la solicitud o al nº de documento para el que se realiza la consulta. Obligatorio.

Consentimiento: Consentimiento de la persona interesada cuyos datos se vayan a consultar, salvo que una norma de rango de ley autorice dicha consulta. Obligatorio. Valores posibles: Si ó Ley.

 

Los datos mínimos a aportar relativos al titular sobre el que se va a realizar la consulta son:

 

  1. TipoDocumentacion + Documentacion, + Nombre + Apellido1 (+ Apellido2 si lo tuviera) del nodo /DatosGenericos/Titular/.

Las Haciendas Forales validarán que el Nombre y Apellidos informados en la petición, coinciden con el nº de documento de la persona titular que se está consultando. Solo en ese caso se devolverán datos de IRPF.

En el mensaje de Petición deberá venir informado el nodo /DatosEspecificos/Consulta/.

A continuación, se detallan los campos incluidos dentro del nodo Consulta:

  • DatosConsulta:
    • Territorio: Código de provincia (territorio) cuya Hacienda Foral dispone de la información del IRPF del titular a consultar: 01 (Araba), 20 (Gipuzkoa) o 48 (Bizkaia). Obligatorio.
    • ejercicio: Ejercicio para el cual se desean consultar los datos de IRPF (AAAA). Obligatorio.
      • Entre el 01 de abril y el 30 de julio del año siguiente al del ejercicio consultado se devolverá información de Imputaciones (datos no consolidados o provisionales).
      • A partir del 31 de Julio se devolverá información consolidada del ejercicio anterior.
      • Si se realiza la consulta antes del 01 de abril del año siguiente al del ejercicio consultado se mostrará aviso:

0000 – FECHA DISPONIBILIDAD: A partir del 01 de abril - Imputaciones. A partir del 31 de julio - Datos consolidados.

  • El servicio de Consulta de Datos IRPF extendido sólo está disponible para ejercicios a partir de 2019. Si se realiza la consulta sobre ejercicios anteriores a 2019 se mostrará aviso:

0000 – DATOS NO DISPONIBLES. Datos disponibles de ejercicios a partir de 2019.

Los datos de su consulta se mostrarán de la siguiente forma:

-        DatosTraza:

o   IdTraza: Identificador de traza administrativa registrado en el sistema de actividad de NISAE. Obligatorio.

o   IdSolicitud: Identificador de solicitud asociado a la petición que se ha tramitado. Obligatorio.

o   FechaCertificado: Fecha en la que se ha emitido la respuesta. Obligatorio.

Formato: AAAA-MM-DDTHH:mm:ss.

-        DatosConsulta:

  • Territorio: Código de provincia (territorio) cuya Hacienda Foral dispone de la información del IRPF del titular a consultar: 01 (Araba), 20 (Gipuzkoa) o 48 (Bizkaia). Obligatorio.
  • ejercicio: Ejercicio para el cual se desean consultar los datos de IRPF (AAAA).
    • Entre el 01 de abril y el 30 de julio del año siguiente al del ejercicio consultado se devolverá información de Imputaciones (datos no consolidados o provisionales, obtenidos por las Haciendas Forales de las correspondientes declaraciones informativas).
    • A partir del 31 de Julio, si ha presentado declaración de IRPF, se devolverá información consolidada del ejercicio anterior (obtenida de la declaración de IRPF correspondiente). Si no ha presentado declaración de IRPF, se devolverá información de Imputaciones obtenida por las Haciendas Forales de las correspondientes declaraciones informativas.
    • Si se realiza la consulta antes del 01 de abril del año siguiente al del ejercicio consultado se mostrará aviso:

0000 – FECHA DISPONIBILIDAD: A partir del 01 de abril - Imputaciones. A partir del 31 de julio - Datos consolidados.

  • El servicio de Consulta de Datos IRPF extendido sólo está disponible para ejercicios a partir de 2019. Si se realiza la consulta sobre ejercicios anteriores a 2019 se mostrará aviso:

0000 – DATOS NO DISPONIBLES. Datos disponibles de ejercicios a partir de 2019.


-        EstadoResultado:

o   Resultado: Código de error o estado de la respuesta. Obligatorio.

Ver valores posibles en Tabla 1.

o   Descripcion: Descripción del error o estado de la respuesta.

Ver descripción en Tabla 1.

 

En la tabla (Tabla 1) se describen los estados devueltos por el servicio de Consulta de Datos IRPF extendido en el nodo DatosEspecificos/Retorno/EstadoResultado.

 

Código de estado

Descripción del estado

Cuándo se devuelve este estado

0000

Uno o varios datos obligatorios no han sido informados correctamente [].

 

FECHA DISPONIBILIDAD: A partir del 01 de abril - Imputaciones. A partir del 31 de julio - Datos consolidados.

 

 

DATOS NO DISPONIBLES. Datos disponibles de ejercicios a partir de 2019.

Se dará cuando se produzcan errores de validación en los datos de entrada.

 

Se dará cuando se devuelva el mensaje de aviso informando sobre las fechas de disponibilidad de la información para el ejercicio consultado.

 

Se dará cuando se realice la consulta sobre ejercicios anteriores a 2019.

1

Coinciden todos los datos del titular enviados.

Se dará cuando se ha podido localizar al titular consultado por medio de su documentación y nombre y apellido.

En este caso sí se devuelven datos de IRPF.

2

Solo coincide el DNI del titular enviado.

Se dará cuando se ha podido localizar al titular consultado por medio de su documentación, pero su nombre y apellido no coinciden con la misma.

En este caso no se devuelven datos de IRPF.

3

DNI/NIE no figura en la base de datos de Hacienda.

Se dará cuando no se ha localizado al titular. Su documentación no se encuentra en la base de datos de Hacienda.

En este caso no se devuelven datos de IRPF.

0242

Error Genérico devuelto por el BackOffice.

Lo devuelve el cedente cuando tiene algún problema para recuperar los datos de respuesta desde su negocio.

Contactar con  Izenpe Nisae, Intzidentziak <incidenciasnisae@izenpe.eus>

0314

No está autorizado a obtener datos de este servicio.

Se devuelve cuando el código de procedimiento de la entidad solicitante no tiene autorización vigente en NISAE para consumir el servicio consultado.

Contactar con Izenpe, NISAE <nisae@izenpe.eus>

0401

0401 La estructura del fichero recibido no corresponde con el esquema.

Se devuelve cuando alguno de los datos de la petición no cumple con la definición del esquema (longitud, tipo, patrón…).

0904

Timeout leyendo del emisor

Se devuelve cuando la conexión con el servidor del cedente tarda más de lo establecido.

Inténtelo de nuevo pasados unos minutos.

0997

Servicio no disponible, por favor, inténtelo más tarde

Se devuelve cuando se producen errores incontrolados del sistema o errores genéricos no controlados por el servicio.

Tabla 1. Códigos de estado devueltos por el Servicio de Consulta de Datos IRPF extendido.