Instituto Nacional de la Seguridad Social - Consulta de datos económicos (TSD)

Palabras clave

Seguridad Social

Detalles

Permite consultar información de los datos económicos de las prestaciones en la tarjeta social digital (TSD).

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 sólo se pueden realizar en modo síncrono.

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

  • Finalidad: Finalidad o trámite para el que se realiza la consulta al servicio.
  • IdExpediente: 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. Valores posibles: Si ó Ley.

 

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

  1. TipoDocumentacion + Documentacion, del nodo /DatosGenericos/Titular/.

El Nombre y Apellidos de la persona titular son datos opcionales, pero si se informan en la petición, el servicio verificará que se correspondan con el nº de documento.

 

En el mensaje de Petición sólo podrá venir informado el nodo /DatosEspecificos/Consulta/, aunque los datos son todos opcionales.

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

  • anio: Año sobre el que se quieren consultar los datos. Formato AAAA. Opcional.
  • clavePropiaEntidad: Clave propia entidad sobre la que se realizará la consulta. Opcional. Si se incluye la clave propia entidad, no se tendrá en cuenta la documentación (tipo y nº de documento del titular) y la consulta será exclusivamente sobre la clave propia entidad enviada en la petición.

 

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

  • DatosTraza:
    • IdTraza: Identificador de traza administrativa registrado en el sistema de actividad de NISAE. Obligatorio.
    • IdSolicitud: Identificador de solicitud asociado a la petición que se ha tramitado.
    • FechaCertificado: Fecha en la que se ha emitido la respuesta. Obligatorio. Formato: AAAA-MM-DDTHH:mm:ss.

 

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

Ver valores posibles en Tabla 1.

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

Ver descripción en Tabla 1.

 

  • listadoIpf: Listado de personas resultante de la consulta.

Si existieran varios IPF se separará la información enviándola en varios bloques.

 

Se recogen en los siguientes apartados los diferentes esquemas en los que se desglosan los datos relativos a las prestaciones encontradas.

 

Ver descripción de los datos en el archivo DatosEspecificos-Retorno-listadoIpf.docx

En la tabla (Tabla 1) se describen los estados devueltos por el servicio de Consulta de Datos económicos de la Tarjeta Social Digital en el nodo DatosEspecificos/Retorno/EstadoResultado.

 

Código de estado

Descripción del estado

0000

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

0001

Coincidencia del IPF y retorno de todos los datos del sistema.

1001

No hay coincidencia con el IPF introducido en el sistema.

1004

El AÑO no cumple con el formato correcto.

1005

No hay coincidencia con el AÑO introducido en el sistema.

1006

La CLAVE no cumple con el formato correcto.

1007

No hay coincidencia con los valores introducidos en el sistema.

1008

IPF sin datos económicos en la BBDD.

Tabla 1. Códigos de estado devueltos por el Servicio de Consulta de Datos económicos de la Tarjeta Social Digital.

Dispone de la información completa en el manual de integración.