Document d integració del servei

(1)

Realitzat per: Departament de Desenvolupament Versió: 1.1

Data: 13/08/2013

Document d’integració del servei

(2)

Control del document

Informació general

Títol: Via Oberta – Registre d’Entitats. Document d’integració del servei

Creat per: Departament de Desenvolupament A revisar per: Departament de Desenvolupament A aprovar per: Departament de Desenvolupament Llista de distribució:

Nom del document: DI - Via Oberta - Registre Entitats.doc

Històric de revisions

Versió Data Autor Comentaris

V1.0 30/06/2010 Roger Noguera Arnau Creació del document

V1.1 25/11/2010 Roger Noguera Arnau Joc de proves

(3)

DI - Via Oberta - Registre Entitats.doc, ii

Índex

1 Introducció ... 1

2 Transmissions de dades disponibles ... 1

3 Missatgeria dels serveis ... 1

3.1 Dades d’inscripció (ENTITAT_INSCRIPCIO) ... 1

3.1.1 Petició – dades específiques ... 1

3.1.2 Resposta – dades específiques ... 2

3.2 Òrgans de govern (ENTITAT_ORGANS) ... 3

3.2.1 Petició – dades específiques ... 3

3.2.2 Resposta – dades específiques ... 4

3.3 Consulta de dades (ENTITAT_DADES) ... 5

3.3.1 Petició – dades específiques ... 6

3.3.2 Resposta – dades específiques ... 6

4 Joc de proves ... 8

(4)

1 Introducció

Aquest document detalla la missatgeria associada al servei del Registre d’Entitats.

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

Generalitat de Catalunya – Departament de Justícia

PRODUCTE MODALITAT DESCRIPCIO

REGISTRE_ENTITATS ENTITAT_INSCRIPCIO Consulta de dades d’inscripció d’una entitat.

ENTITAT_ORGANS Consulta de càrrecs corresponents als Òrgans de Govern d’una entitat.

ENTITAT_DADES Consulta de domicili, finalitats i ànims de lucre.

3 Missatgeria dels serveis

A continuació es detalla la missatgeria corresponent a les modalitats de consum del producte Registre d’Entitats.

3.1 Dades d’inscripció (ENTITAT_INSCRIPCIO)

Aquesta modalitat permet consultar la data d’inscripció d’una entitat, la data d’inscripció i el seu estat i aplica únicament a entitats de tipus Fundació, Associació, Federació i Associació Juvenil.

3.1.1 Petició – dades específiques

Element Descripció

PeticioConsultaInscripcio/NomEntitat Nom de l'entitat a consultar. S'admeten noms

parcials.

(5)

DI - Via Oberta - Registre Entitats.doc

3.1.2 Resposta – dades específiques

Element Descripció

RespostaConsultaInscripcio/PeticioConsultaInscripcio Bloc que conté les dades informades a la petició.

RespostaConsultaInscripcio/Entitat/NumInscripcio Número d'inscripció de l'entitat.

RespostaConsultaInscripcio/Entitat/DataInscripcio Data en la qual va ser inscrita l'entitat.

RespostaConsultaInscripcio/Entitat/

CodiDemarcacioTerritorial

Codi de demarcació territorial on pertany l'entitat.

RespostaConsultaInscripcio/Entitat/

DescripcioDemarcacioTerritorial

Descripció de demarcació territorial on pertany l'entitat.

RespostaConsultaInscripcio/Entitat/NomEntitat Nom de la entitat.

RespostaConsultaInscripcio/Entitat/TipusEntitat Tipus de l'entitat:

 1: Fundació

 2: Associació

 3: Federació

 4: Associació Juvenil

(6)

Element Descripció RespostaConsultaInscripcio/Entitat/Estat Estat de la inscripció:

 Pendent inscripció

 Inscrita

 Extingida

 Trasllat

 Baixa sense inscripció

RespostaConsultaInscripcio/Resultat Bloc que informa del resultat de la consulta (vegeu l’apartat 3.1.2.1).

3.1.2.1 Resultat

Element Descripció

//CodiResultat Codi de resultat. 0: consulta realitzada correctament, 1: error realitzant la consulta.

//Descripcio Literal descriptiu del resultat de la consulta.

3.2 Òrgans de govern (ENTITAT_ORGANS)

Aquesta modalitat permet consultar el càrrecs corresponents als Òrgans de govern d’una determinada i aplica únicament a entitats de tipus Fundació, Associació, Federació i Associació Juvenil.

La consulta es pot realitzar informant el número d’inscripció i el tipus d’entitat o informant el nom de l’entitat.

La llista de càrrecs pot incloure dades de persones físiques i de persones jurídiques.

3.2.1 Petició – dades específiques

Element Descripció

PeticioConsultaOrgansGovern/NomEntitat Nom de l'entitat a consultar. Es necessari posar el nom complert.

PeticioConsultaOrgansGovern/NumInscripcioEntitat/

NumInscripcio

Número d'inscripció de l'entitat.

(7)

Element Descripció

PeticioConsultaOrgansGovern/NumInscripcioEntitat/

TipusEntitat

Tipus de l'entitat:

 1: Fundació

 2: Associació

 3: Federació

 4: Associació Juvenil PeticioConsultaOrgansGovern/NumInscripcioEntitat/

CodiDemarcacioTerritorial

Codi de demarcació territorial on pertany l'entitat (retornat per la modalitat ENTITAT_INSCRIPCIO).

3.2.2 Resposta – dades específiques

Element Descripció

RespostaConsultaOrgansGovern/

PeticioConsultaOrgansGovern

Bloc que conté les dades informades a la petició.

RespostaConsultaOrgansGovern/PersonaFisica Bloc que conté dades de persona física que pertany a l’òrgan de govern.

//PersonaFisica/Carrec Càrrec.

//PersonaFisica/Nom Nom.

//PersonaFisica/PrimerCognom Primer cognom.

//PersonaFisica/SegonCognom Segon cognom.

//PersonaFisica/NIF NIF.

//PersonaFisica/VigenciaCarrec Vigència del càrrec:

 Vitalici

 DD-MM-AAAA

RespostaConsultaOrgansGovern/PersonaJuridica Bloc que conté dades de persona jurídica que pertany a l’òrgan de govern.

//PersonaJuridica/Carrec Càrrec.

//PersonaJuridica/Denominacio Denominació.

//PersonaJuridica/NomRepresentant Nom del representant.

//PersonaJuridica/PrimerCognomRepresentant Primer cognom del representant.

//PersonaJuridica/SegonCognomRepresentant Segon cognom del representant.

//PersonaJuridica/NIFRepresentant NIF del representant.

//PersonaJuridica/VigenciaCarrec Vigència del càrrec:

 Vitalici

(8)

Element Descripció

 DD-MM-AAAA

RespostaConsultaOrgansGovern/Resultat Bloc que informa del resultat de la consulta (vegeu l’apartat 3.1.2.1).

3.3 Consulta de dades (ENTITAT_DADES)

Aquesta modalitat permet consultar les següents dades d’una determinada entitat:

 Adreça de correspondència de l’entitat

 Adreça oficial de l’entitat

 Finalitat, amb la utilitat pública i objecte i finalitats de l’entitat

 Si l’entitat és amb ànim de lucre o no

Les dades corresponents a les adreces i finalitats apliquen únicament a entitats de tipus Fundació, Associació, Federació i Associació Juvenil.

En canvi, la informació d’ànim de lucre, només aplica a entitats de tipus Associació, Federació i

Associació Juvenil.

(9)

3.3.1 Petició – dades específiques

Element Descripció

PeticioConsultaDadesEntitat/NomEntitat Nom de l'entitat a consultar. Es necessari posar el nom complert.

PeticioConsultaDadesEntitat/NumInscripcioEntitat/

NumInscripcio

Número d'inscripció de l'entitat.

PeticioConsultaDadesEntitat/NumInscripcioEntitat/

TipusEntitat

Tipus d'entitat:

 1: Fundació

 2: Associació

 3: Federació

 4: Associació Juvenil PeticioConsultaDadesEntitat/NumInscripcioEntitat/

CodiDemarcacioTerritorial

Codi de demarcació territorial on pertany l'entitat (retornat per la modalitat ENTITAT_INSCRIPCIO).

3.3.2 Resposta – dades específiques

Element Descripció

RespostaConsultaDadesEntitat/

PeticioConsultaDadesEntitat

Bloc que conté les dades informades a la petició.

RespostaConsultaDadesEntitat/DireccioOficial Bloc que conté les dades de l’adreça oficial de l’entitat (vegeu l’apartat 3.3.2.1).

RespostaConsultaDadesEntitat/

DireccioCorrespondencia

Bloc que conté les dades de l’adreça de correspondència de l’entitat (vegeu l’apartat 3.3.2.1).

RespostaConsultaDadesEntitat/UtilitatPublica Utilitat pública de l'entitat (Sí / No).

RespostaConsultaDadesEntitat/AnimLucre Booleà (cert / fals). Aplica a entitats de tipus Associació, Federació i Associació Juvenil.

RespostaConsultaDadesEntitat/Finalitat Finalitats de l’entitat.

RespostaConsultaDadesEntitat/Resultat Bloc que informa del resultat de la consulta

(vegeu l’apartat 3.1.2.1).

(10)

(11)

3.3.2.1 Direcció

Element Descripció

//Pais País.

//Provincia Província.

//Municipi Municipi.

//Comarca Comarca.

//Poblacio Població.

//CodiPostal Codi postal.

//TipusVia Tipus de via.

//NomVia Nom de la via.

//Numero Número.

//Bloc Bloc.

//Escala Escala.

//Pis Pis.

//Porta Porta.

4 Joc de proves

El joc de proves del servei proporcionat per l’emissor final, vàlid per a l’entorn de pre-producció, és el que es detalla a continuació.

El servei de proves de l’emissor està disponible de 8:30 a 22:30.

Nom entitat Número inscripció Tipus entitat Codi demarcació territorial

Coordinadora de Barraques 23 3 2

(12)

Annex – exemple de missatges

Dades d’inscripció (ENTITAT_INSCRIPCIO)

Exemple petició

<CodigoCertificado>ENTITAT_INSCRIPCIO</CodigoCertificado>

<CodigoProducto>REGISTRE_ENTITATS</CodigoProducto>

<Finalidad>MONITORITZACIO</Finalidad>

</DatosAutorizacion>

</Emisor>

<NombreCompletoFuncionario>FUNCIONARI</NombreCompletoFuncionario>

</Funcionario>

</Atributos>

</Emisor>

<Finalidad>MONITORITZACIO</Finalidad>

<NombreCompletoFuncionario>FUNCIONARI</NombreCompletoFuncionario>

</Funcionario>

</Solicitante>

</Titular>

<CodigoCertificado>ENTITAT_INSCRIPCIO</CodigoCertificado>

<IdTransmision>EXPEDIENT</IdTransmision>

</Transmision>

</DatosGenericos>

<!--

<caoc:ExtensionesPeticion xmlns:caoc="http://www.aocat.net/scsp/esquemes/caoc- extensions">

<caoc:PDF>true</caoc:PDF>

<caoc:Evidencia>true</caoc:Evidencia>

</caoc:ExtensionesPeticion>

-->

<NomEntitat>Coordinadora de Barraques</NomEntitat>

(13)

Exemple petició

</PeticioConsultaInscripcio>

</DatosEspecificos>

</SolicitudTransmision>

</Solicitudes>

</Peticion>

Exemple resposta

<res:Respuesta xmlns:res="http://gencat.net/scsp/esquemes/respuesta">

<res:Atributos>

<res:CodigoCertificado>CONSULTA_EMPRESA</res:CodigoCertificado>

<res:CodigoProducto>RELI</res:CodigoProducto>

<res:IdPeticion>RELI_001</res:IdPeticion>

<res:IdSolicitanteOriginal/>

<res:NomSolicitanteOriginal/>

<res:NumElementos>1</res:NumElementos>

<res:TimeStamp>2009-07-30T12:17:35.970+02:00</res:TimeStamp>

<res:Emisor>

<res:NifEmisor>Q0801175A</res:NifEmisor>

<res:NombreEmisor>CAOC</res:NombreEmisor>

</res:Emisor>

<res:Estado>

<res:CodigoEstado>0003</res:CodigoEstado>

<res:CodigoEstadoSecundario/>

<res:LiteralError>OK</res:LiteralError>

<res:TiempoEstimadoRespuesta>0</res:TiempoEstimadoRespuesta>

</res:Estado>

<res:Funcionario>

<res:NombreCompletoFuncionario>FUNCIONARI AUTORITZAT</res:NombreCompletoFuncionario>

<res:NifFuncionario>NIF</res:NifFuncionario>

<res:EMailFuncionario/>

<res:CertificadoDigital/>

</res:Funcionario>

</res:Atributos>

<res:Transmisiones>

<res:TransmisionDatos>

<res:DatosGenericos>

<res:Emisor>

<res:NombreEmisor>CAOC</res:NombreEmisor>

<res:NifEmisor>Q0801175A</res:NifEmisor>

</res:Emisor>

<res:Solicitante>

<res:IdentificadorSolicitante>9821920002</res:IdentificadorSolicitante>

<res:NombreSolicitante>Consorci AOC</res:NombreSolicitante>

<res:Finalidad>PROVES</res:Finalidad>

<res:Consentimiento>Si</res:Consentimiento>

<res:Funcionario>

<res:NombreCompletoFuncionario>FUNCIONARI AUTORITZAT</res:NombreCompletoFuncionario>

<res:NifFuncionario>NIF</res:NifFuncionario>

<res:EMailFuncionario/>

<res:CertificadoDigital/>

</res:Funcionario>

</res:Solicitante>

<res:Titular>

<res:TipoDocumentacion>CIF</res:TipoDocumentacion>

<res:Documentacion>CIF_EMPRESA</res:Documentacion>

<res:NombreCompleto/>

<res:Nombre/>

<res:Apellido1/>

<res:Apellido2/>

</res:Titular>

<res:Transmision>

<res:CodigoCertificado>CONSULTA_EMPRESA</res:CodigoCertificado>

<res:FechaGeneracion/>

<res:IdSolicitud>1</res:IdSolicitud>

<res:IdTransmision>EXPEDIENT</res:IdTransmision>

</res:Transmision>

</res:DatosGenericos>

<res:DatosEspecificos>

(14)

Exemple resposta

<EmpresaResposta xmlns:ns="http://www.openuri.org/" xmlns:SOAP-

ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.aocat.net/reli">

<NIFEmpresa>CIF_EMPRESA</NIFEmpresa>

<NIFApoderat>NIF_APODERAT</NIFApoderat>

</CriterisCerca>

<TipusDadaEmpresa>DadesIAE</TipusDadaEmpresa>

<Dada>

<Codi>DataPagament</Codi>

</Dada>

<Dada>

<Codi>Seccio</Codi>

</Dada>

<Dada>

<Codi>DataAlta</Codi>

</Dada>

<Dada>

<Codi>PeriodePagament</Codi>

</Dada>

<Dada>

<Codi>Epigraf</Codi>

</Dada>

<Dada>

<Codi>Activitat</Codi>

<Valor>Ajudants de direcció</Valor>

</Dada>

</DadaEmpresa>

</DadaEmpresaResposta>

<TipusDadaEmpresa>InfInstitucionsFinanceres</TipusDadaEmpresa>

<Dada>

<Codi>DataCaducitat</Codi>

</Dada>

</DadaEmpresa>

<TipusDadaEmpresa>InfInstitucionsAsseguradores</TipusDadaEmpresa>

<Dada>

<Codi>EntitatAsseguradora</Codi>

<Valor>ASEGURADORA AXA1</Valor>

</Dada>

<Dada>

<Codi>DataCaducitat</Codi>

</Dada>

<Dada>

<Codi>CapitalAssegurat</Codi>

</Dada>

</DadaEmpresa>

<TipusDadaEmpresa>Certificat</TipusDadaEmpresa>

<Dada>

<Codi>DocumentPDfSignat</Codi>

<Valor>

JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFIvRmlsdGVyIC9GbGF0ZURlY29k ZT4+CnN0cmVhbQp4nK1UTW8TQQy9z6/wjV2kndoztmfmCG2pQOXQsBwQ6qnQShURSi78fezdbLuh (...)

PDc4RjY4OTg4OTk1QUE1RUI3NkVENjM2M0NCRjNDNzBFPl0KPj4Kc3RhcnR4cmVmCjEwMTUyCiUl RU9GCg==

(15)

Exemple resposta

</Valor>

</Dada>

<Dada>

<Codi>ValidacioSignatura</Codi>

</Dada>

</DadaEmpresa>

</DadesEmpresaResposta>

<Missatge>Correcte</Missatge>

</ResultatCerca>

</EmpresaResposta>

</res:DatosEspecificos>

</res:TransmisionDatos>

</res:Transmisiones>

</res:Respuesta>