Via Oberta – Renda Garantida Ciutadana

Document d'integració del servei

Històric de revisions

Versió	Data	Autor	Comentaris
V1.0	11/02/2022	Roger Noguera i Arnau	Creació del document

Índex

• 1. Introducció
• 2. Transmissions de dades disponibles
• 3. Missatgeria dels serveis
  • 3.1. Situació d'un ciutadà en relació a la Renda Garantida Ciutadana (RGC_CONSULTA)
    • 3.1.1 Petició – dades específiques
    • 3.1.2 Resposta - dades específiques
  • 3.2. Imports rebuts en un període de temps (RGC_CONSULTA_HISTORIC)
    • 3.2.1 Petició – dades específiques
    • 3.2.2 Resposta - dades específiques
• 4. Joc de proves

1 Introducció

Aquest document detalla la missatgeria associada al servei de consulta de les prestacions Renda Garantida Ciutadana (en endavant RGC) del Departament de Drets Socials.

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

• Document del Servei Via Oberta.
• 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ó:

EMISSOR
Departament de Drets Socials (Generalitat de Catalunya)

PRODUCTE	MODALITAT	DESCRIPCIO
RGC	RGC_CONSULTA	Consulta situació de les prestacions RGC d'un ciutadà.
RGC	RGC_CONSULTA_HISTORIC	Consulta de dades històriques de les prestacions RGC d'un ciutadà.

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 RGC.

3.1 Situació d'un ciutadà en relació a la Renda Garantida Ciutadana (RGC_CONSULTA)

3.1.1 Petició – dades específiques

Element	Descripció
peticioConsultaPrestacions/documentIdentificador	Document identificador del titular que es vol fer la consulta.
peticioConsultaPrestacions/tipusDocument	Tipus de document identificador : 00001: Document nacional d'identitat 00002: Número d'identificació estrangers 00003: Targeta d'identificació Sanitaria 00004: Número d'afiliació de la Seguretat Social 00005: Número d'usuari de la Seguretat Social 00006: Número d'identificació fiscal 00007: Número d'identificació fiscal per estrangers sense NIE 00008: Número d'identificació fiscal per espanyols no residents 00009: Número d'identificador fiscal per a menors de 14 anys i residents 00010: Número identificador per comunitaris 00011: Número dels mossos per a menors 00012: Passaport 00013: Provisional 99999: Desconegut

3.1.2 Resposta – dades específiques

Element	Descripció
respostaConsultaPrestacions/peticioConsultaPrestacions	Bloc de dades corresponent a la petició que genera la resposta.
respostaConsultaPrestacions/resposta/cobra	Indica si el ciutadà percep la Renda Garantida Ciutadana: COBRA NO_COBRA SENSE_INFORMACIO
respostaConsultaPrestacions/resultat/codiResultat	Codi de resultat de la consulta: 0: consulta realitzada correctament. 0502: error realitzant la consulta.
respostaConsultaPrestacions/resultat/descripcio	Descripció del resultat.

3.2 Imports rebuts en un període de temps (RGC_CONSULTA_HISTORIC)

3.2.1 Petició – dades específiques

Element	Descripció
peticioConsultaPrestacionsHistoric/documentIdentificador	Document identificador del titular que es vol fer la consulta.
peticioConsultaPrestacionsHistoric/tipusDocument	Tipus de document identificador : 00001: Document nacional d'identitat 00002: Número d'identificació estrangers 00003: Targeta d'identificació Sanitaria 00004: Número d'afiliació de la Seguretat Social 00005: Número d'usuari de la Seguretat Social 00006: Número d'identificació fiscal 00007: Número d'identificació fiscal per estrangers sense NIE 00008: Número d'identificació fiscal per espanyols no residents 00009: Número d'identificador fiscal per a menors de 14 anys i residents 00010: Número identificador per comunitaris 00011: Número dels mossos per a menors 00012: Passaport 00013: Provisional 99999: Desconegut
peticioConsultaPrestacionsHistoric/dataInici	Data d'inici del període a consultar (AAAA-MM-DD).
peticioConsultaPrestacionsHistoric/dataFi	Data de fi del període a consultar (AAAA-MM-DD).

3.2.2 Resposta – dades específiques

Element	Descripció
respostaConsultaPrestacionsHistoric/peticioConsultaPrestacionsHistoric	Bloc de dades corresponent a la petició que genera la resposta.
respostaConsultaPrestacionsHistoric/resposta/cobra	Indica si el ciutadà percep la Renda Garantida Ciutadana: COBRA NO_COBRA SENSE_INFORMACIO
respostaConsultaPrestacionsHistoric/resposta/imports/import	Bloc de dades corresponent a un import percebut.
//import/valor	Import percebut.
//import/mesAny	Període (AAAA-MM).
respostaConsultaPrestacionsHistoric/resultat/codiResultat	Codi de resultat de la consulta: 0: consulta realitzada correctament. 0502: error realitzant la consulta.
respostaConsultaPrestacionsHistoric/resultat/descripcio	Descripció del resultat.

4 Joc de proves

L'emissor final publica els següent joc de proves a l'entorn de pre-producció

En cas de tindre problemes per accedir als jocs de proves, si us plau, obre un tiquet a través del formulari