LANBIDE - Consulta de Importes por Periodo de Renta de Garantía de Ingresos (RGI)
Detalles
Permite obtener información de los importes pagados y devueltos por la persona consultada en un periodo. Este servicio devolverá información SOLO si la persona se encuentra como titular de la misma.
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.
- 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.
- IdExpediente: Identificador o Nº de expediente asociado a la solicitud o al nº de documento para el que se realiza la consulta. Obligatorio.
Los datos mínimos a aportar relativos a la persona sobre la que se va a realizar la consulta son:
- TipoDocumentacion + Documentacion, del nodo /DatosGenericos/Titular/
+
- Anio ó FechaDesde + FechaHasta del nodo /DatosEspecificos/Consulta/DatosConsulta/.
A continuación, se detallan los campos incluidos dentro del nodo Consulta:
- DatosConsulta:
Los siguientes datos son excluyentes entre sí, o se indica el año o se indican fechas desde/hasta.
- Anio: Indica el año para el que se quiere realizar la consulta de los importes anuales percibidos por la persona titular. Formato AAAA.
- FechaDesde: Fecha desde para limitar la búsqueda de los importes percibidos por la persona titular. El formato será AAAA-MM-DD.
Si se informa este campo será obligatorio informar FechaHasta.
- FechaHasta: Fecha hasta para limitar la búsqueda de los importes percibidos por la persona titular. El formato será AAAA-MM-DD.
Si se informa este campo será obligatorio informar FechaDesde.
*Dispone de la información completa en el manual de integració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.
- DatosConsulta: Vendrá informado el año o las fechas desde/hasta que se hayan informado en la petición.
- Anio: Indica el año para el que se ha realizado la consulta de los importes. Formato AAAA.
- FechaDesde: Fecha desde la que se ha realizado la consulta de los importes.
El formato será AAAA-MM-DD.
- FechaHasta: Fecha hasta la que se ha realizado la consulta de los importes.
El formato será AAAA-MM-DD.
- 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.
En la tabla (Tabla 1) se describen los códigos de estado devueltos por el servicio de Consulta de Importes Periodo de Renta de Garantía de Ingresos (RGI):
|
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 []. |
Se dará cuando se produzcan errores de validación en los datos de entrada. |
|
0003 |
TRAMITADA. |
Se han encontrado personas coincidentes con los parámetros especificados. |
|
1 |
Debe indicar número y tipo de documento o nombre y apellidos. |
|
|
2 |
Los parámetros de entrada no son correctos. |
El cedente no considera correctos los datos enviados en la petición. |
|
3 |
Existe más de un expediente para el nombre y apellidos indicado. |
|
|
4 |
Error genérico de base de datos. |
Se dará cunado se produzcan errores de negocio en el servicio del cedente. |
|
5 |
No se ha encontrado ninguna persona con los parámetros especificados. |
|
Tabla 1. Códigos de estado devueltos por el Servicio de Consulta de Importes Periodo de Renta de Garantía de Ingresos (RGI).
*Dispone de la información completa en el manual de integración.
