ESPECIFICACIÓN FUNCIONAL DEL SERVICIO WEB DE CONSULTA A CIBI PARA LA CONTRATACIÓN CENTRALIZADA DE SUMINISTROS ELÉCTRICOS

Transcripción

1 ESPECIFICACIÓN FUNCIONAL DEL SERVICIO WEB DE CONSULTA A CIBI PARA LA CONTRATACIÓN CENTRALIZADA DE SUMINISTROS ELÉCTRICOS SGTIC-SGACC-ServiciWebCIBI-V104 Página 1 de 15

2 CONTROL DE VERSIONES Versión Autr / Autres Fecha Cambis realizads /06/2014 Primera versión SGTIC /07/2014 Revisión cnjunta /SGACC y DGPE /09/2014 Revisión /SGACC /10/2014 Revisión cnjunta /SGACC y DGPE /11/2014 Revisión /SGACC SGTIC-SGACC-ServiciWebCIBI-V104 Página 2 de 15

3 ÍNDICE 1 INTRODUCCIÓN DEFINICIÓN SGTIC-SGACC-ServiciWebCIBI-V104 Página 3 de 15

4 1 Intrducción El presente dcument pretende cnstituir una base para la especificación funcinal y la planificación de la cnsulta pr parte de la Dirección General de Racinalización y Centralización de la Cntratación (DGRCC) de bienes inmuebles gestinads pr la Dirección General de Patrimni del Estad (DGPE) para la cntratación centralizada de suministrs eléctrics SGTIC-SGACC-ServiciWebCIBI-V104 Página 4 de 15

5 2 Definición 2.1 Planteamient Se prpne implementar en la Central de Infrmación de Bienes Inventariables (CIBI), desarrllada pr la Subdirección General de Aplicacines de Cntabilidad y Cntrl (SGACC), un servici web que será invcad pr una nueva aplicación desarrllada pr la Subdirección General de Tecnlgías de la Infrmación y Cmunicacines (SGTIC) del Ministeri. Dich servici web devlverá infrmación relativa a aquells bienes que cumplan ls requisits que se especifiquen en su invcación. 2.2 Parámetrs de entrada La invcación al servici web se realizará asignand valr a ls parámetrs de entrada, entendids cm arguments del métd crrespndiente al servici web. En cas de prprcinarse valr para cualquiera de ests parámetrs, será tenid en cuenta cm cndición necesariamente a cumplir en el filtr que se realice en la extracción. Se definen ls siguientes parámetrs de entrada: Códig del cmplej El códig emplead para identificar de manera única un cmplej Códig del edifici Códig del bien El códig emplead para identificar de manera única un edifici El códig emplead para identificar de manera única un bien Pr ej., Denminación del cmplej El valr prprcinad se interpretará cm N caracteres incluids en la denminación del cmplej Pr ej., EUROCIS Denminación del edifici bien El valr prprcinad se interpretará cm N caracteres incluids en la denminación del edifici del bien Pr ej., CASETA COMANDANCIA Y VARADERO Nta: Se trata de un únic parámetr que se emplea para filtrar pr la denminación del edifici y del bien Códig de prvincia Se emplea la cdificación del INE El dat del país n es un parámetr de entrada puest que se entiende que tdas las cnsultas se refieren a bienes en España Pr ej., 40 (Segvia) SGTIC-SGACC-ServiciWebCIBI-V104 Página 5 de 15

6 Códig de municipi Códig pstal Se emplea la cdificación del INE Si se especifica un valr para este parámetr, deberá especificarse también un valr para el códig de prvincia Pr ej., si se desea especificar el municipi Riaza, se especificará: Códig de prvincia: 40 (Segvia) Códig de municipi: 170 (Riaza) Debe tenerse en cuenta que el códig pstal es un dat de captura pcinal en CIBI, pr l que n es fiable de cara a emplearl cm parámetr de filtrad Pr ej Dirección del bien El valr prprcinad se interpretará cm N caracteres incluids en la dirección del bien Pr ej. ONCE DE JUNIO, 9 Nta: La ambigüedad inherente a la cdificación de la dirección hace recmendable emplear este parámetr cn cautela Referencia catastral El valr prprcinad se interpretará cm ls primers N dígits/caracteres de la referencia catastral (de un máxim de 20) Las referencias catastrales almacenadas en CIBI pueden clasificarse en ls siguientes tips: Referencias que siguen la cdificación de la DG del Catastr del MINHAP: Se cmpnen de 20 caracteres, siend ls 14 primers ls que se emplean para determinar la ubicación física del bien inmueble La gran mayría emplea la siguiente cdificación ( Para urban: Finca parcela (7 dígits) Hja del plan (7 dígits) Para fincas rústicas Prvincia (2 dígits) Municipi (3 dígits) Sectr (1 dígits) Plígn (3 dígits) Parcela (5 dígits) Una minría n cumple la cdificación anterir. Es el cas pr ejempl de: SGTIC-SGACC-ServiciWebCIBI-V104 Página 6 de 15

7 Ls diseminads, que sn referencias catastrales antiguas (per vigentes) que crrespnden a una urbana (casa) sbre finca rustica Ls BICE (Bienes Inmuebles de Características Especiales): Aerpuerts, Puerts, Centrales Nucleares, Autpistas, etc. Referencias de ls territris frales (País Vasc y Navarra), que emplean cdificacines prpias SGTIC-SGACC-ServiciWebCIBI-V104 Página 7 de 15

8 2.3 Cndicines del servici Unicidad del códig CIBI Actualmente en CIBI n se puede garantizar que un determinad bien (y su crrespndiente códig CIBI) se crrespnda cn un únic edifici, aunque sí pueden tmarse medidas para tratar aquells cass minritaris que cnstituyan una excepción a esta cndición. Para ell se va a emplear un nuev tip de entidad Edifici : El edifici se cncreta en CIBI cm una agrupación de bienes, que cnsta además de un cnjunt de atributs prpis La DGPE asume la respnsabilidad de decidir e instrumentar el alta y mantenimient de edificis, en su cas a prpuesta de la DGRCC El detalle del alta, mantenimient y cnsulta de esta nueva entidad a través de CIBI se trata en trs dcuments funcinales Gestión de ls Cmplejs Ls cmplejs sn cnjunts de edificis que cmparten determinadas características. Para permitir su incrpración en CIBI se va a emplear un nuev tip de entidad Cmplej : Un cmplej se cncreta en una agrupación de bienes y/ de edificis, cn tr cnjunt de atributs prpis. Sól pueden asciarse a cmplejs bienes que n estén ya previamente asciads a edificis La DGPE asume la respnsabilidad de decidir e instrumentar el alta y mantenimient de cmplejs, en su cas a prpuesta de la DGRCC El detalle del alta, mantenimient y cnsulta de esta nueva entidad a través de CIBI se trata en trs dcuments funcinales Situación del bien A efects de este servici web: Sól se cnsiderarán aquells bienes que estén dads de alta (se excluyen ls que están de baja, así cm ls bienes que están en situacines transitrias cm En curs de alta y Alta sól para expedientes ) La DGPE remitirá a la DGRCC un listad cn las psibles situacines jurídicas de bienes para determinar aquellas que en su cas sea cnveniente descartar (pr ejempl, Cedid, Entregad en Gestión y Cncesión Administrativa ) A futur, se estudiará la psibilidad de frecer infrmación sbre aquells bienes que hayan sid dads de baja, cn bjet de generar las alertas para desasciar ls crrespndientes CUPS SGTIC-SGACC-ServiciWebCIBI-V104 Página 8 de 15

9 2.4 Parámetrs de salida Cm resultad de la invcación, se prprcinará un cnjunt de dats pr cada un de ls cmplejs, edificis y bienes que cumplan tds ls requisits especificads a través de ls parámetrs de entrada. La salida se realizará a través de un ficher cn frmat XML cn ls siguientes elements: Cmplej Edifici Bien Este element sól aparecerá en la salida cuand se cumplan las siguientes cndicines El cmplej en sí cumple ls criteris de filtrad Al mens un de sus bienes y/ edificis cumple ls criteris de filtrad Este element, en cas de existir, cnstará de Parámetrs de salida prpis del cmplej Element hij Edific, en cas de que el cmplej se cmpnga de algún edifici y éste cumpla ls criteris de filtrad Element hij Bien, en cas de que el cmplej se cmpnga directamente de algún bien, y éste cumpla ls criteris de filtrad Este element sól aparecerá en la salida cuand se cumplan las siguientes cndicines El edifici en sí cumple ls criteris de filtrad Al mens un de sus bienes cumple ls criteris de filtrad Puede aparecer, según el cas Sin ser hij de ningún element Cmplej, siempre que n esté vinculad cn ningún cmplej Cm hij de un element Cmplej, siempre que exista tal vinculación Este element, en cas de existir, cnstará de Parámetrs de salida prpis del edifici Al mens un element hij Bien, crrespndiente a aquells bienes que cumplan ls criteris de filtrad Este element aparecerá siempre Puede aparecer, según el cas Sin ser hij de ningún element Edifici Cmplej, siempre que n esté vinculad cn ninguna de estas ds entidades Cm hij de un element Edifici (y a su vez, en su cas, siend el Edifici un element hij del Cmplej), cuand exista tal vinculación Cm hij de un element Cmplej, cuand exista tal vinculación SGTIC-SGACC-ServiciWebCIBI-V104 Página 9 de 15

10 Cnstará de ls parámetrs de salida prpis del bien Pr tant, la salida se rganizará en tres blques: <listacmplejs>, <listaedificis> y <listabienes>. Cada un de ls blques incluirá en su cas ls siguientes elements XML rganizads secuencialmente: Element Cmplej: Element Edifici: Element Bien: <cmplej> Parámetrs de salida prpis del cmplej <edificis> <edifici> Sól si aplica (*) </edifici> </edificis> <bienes> </cmplej> <bien> </bien> </bienes> Sól si aplica (*) (*) Td element Cmplej incluirá siempre al mens un element hij, ya sea de tip Edifici bien de tip Bien <edifici> </edifici> <bien> </bien> Parámetrs de salida prpis del edifici <bienes> <bien> </bien> </bienes> Parámetrs de salida prpis del bien SGTIC-SGACC-ServiciWebCIBI-V104 Página 10 de 15

11 Ls parámetrs de salida prpis del cmplej sn: Códig del cmplej Denminación del cmplej Ls parámetrs de salida prpis del edifici sn: Códig del edifici Denminación del edifici Ls parámetrs de salida prpis del bien sn: Códig CIBI del bien Siempre estará infrmad Nmbre del bien Denminación del bien en CIBI Pr ej., EDIFICIO DE TALLERES Códig de prvincia Siempre estará infrmad Códig de municipi Siempre estará infrmad Códig de lcalidad Códig pstal Dirección Siempre estará infrmad N siempre estará infrmad, puest que su captura es pcinal en CIBI Siempre estará infrmad Pr ej. CR NAL V PK,220 HM 860 Naturaleza del bien Situación Siempre estará infrmad Pdrá valer: Superficie ttal Finca rústica Slar sin edificar Edifici en Cnstrucción Edifici terminad Pr el mment, siempre serán bienes en situación de Alta SGTIC-SGACC-ServiciWebCIBI-V104 Página 11 de 15

12 Observacines En CIBI se dispne de ds dats que pueden emplearse para este prpósit El dat de superficie ttal del bien El agregad del dat de superficie dispnible para cada terna {Bien, Situación jurídica, Usuari} Se acuerda prprcinar el dat de superficie ttal del bien Un bien puede tener asciadas varias bservacines, pr l que se cnsiderará cm un camp multivalr Queda pendiente cncretar ls tips de bservacines que pueden ser más relevantes de cara a este servici Referencia catastral Un bien puede tener asciadas varias referencias catastrales, pr l que se cnsiderará cm un camp multivalr Se prprcinará la referencia catastral cmpleta SGTIC-SGACC-ServiciWebCIBI-V104 Página 12 de 15

13 3 Detalle del métd de filtrad intern SUBSECRETARÍA Ntación: L1: Cada element de la lista es un códig de bien L2: Cada element de la lista es una pareja (códig de edifici, códig de bien), en dnde el códig del bien se crrespnde cn un bien que necesariamente frma parte del edifici al que se refiere el códig de edifici L3: Cada element de la lista es un triplete (códig de cmplej, códig de edifici, códig de bien), en dnde el códig del bien se crrespnde cn un bien que necesariamente frma parte del cmplej al que se refiere el códig de cmplej Si un cmplej se relacina directamente cn un bien, el códig de edifici estará vací Pass a realizar: 1. Si se ha prprcinad valr para ls parámetrs de filtrad exclusivs a nivel de cmplej (el códig de cmplej y/ la denminación del cmplej) a. L3 se carga cn ls tripletes (códig de cmplej, códig de edifici, códig de bien) extraíds para aquells códigs de cmplejs crrespndientes a cmplejs que cumplan tds ls parámetrs de filtrad i. Si n hay ningún cmplej que cumpla tds ls parámetrs de filtrad, entnces retrnar una lista vacía b. Si se ha prprcinad valr para ls parámetrs de filtrad exclusivs a nivel de edifici (el códig del edifici), eliminar ls elements de L3 en dnde el códig de edifici n cumpla dichs parámetrs de filtrad c. Si se ha prprcinad valr para ls parámetrs de filtrad cmunes a nivel de edifici y bien (la denminación del edifici bien), eliminar ls elements de L3 en dnde se cumplan las siguientes ds cndicines 1. El códig de edifici n cumple el criteri de filtrad 2. El códig de bien n cumple el criteri de filtrad d. Si se ha prprcinad valr para ls parámetrs de filtrad exclusivs a nivel de bien (el códig del bien, el códig de prvincia, etc.), eliminar ls elements de L3 en dnde el códig de bien n cumpla dichs parámetrs de filtrad e. Retrnar un listad cn ls distints códigs de cmplej presentes en L3 2. Si n a. Si se ha prprcinad valr para ls parámetrs de filtrad exclusivs a nivel de edifici (el códig de edifici) i. L2 se carga cn las parejas (códig de edifici, códig de bien) extraídas para aquells códigs de edifici crrespndientes a edificis que cumplan tds ls parámetrs de filtrad 1. Si n hay ningún edifici que cumpla tds ls parámetrs de filtrad, entnces retrnar una lista vacía ii. Si se ha prprcinad valr para ls parámetrs de filtrad cmunes a nivel de edifici y bien (la denminación del edifici bien), eliminar ls elements de L2 en dnde se cumplan las siguientes ds cndicines 1. El códig de edifici n cumple el criteri de filtrad 2. El códig de bien n cumple el criteri de filtrad iii. Si se ha prprcinad valr para ls parámetrs de filtrad exclusivs a nivel de bien (el códig del bien, el códig de prvincia, etc.), eliminar ls elements de L2 en dnde el códig de bien n cumpla dichs parámetrs de filtrad SGTIC-SGACC-ServiciWebCIBI-V104 Página 13 de 15

14 iv. Retrnar un listad cnsistente en la unión de 1. La lista de aquells códigs de edifici de L2 que n pertenecen a un cmplej 2. La lista de aquells códigs de cmplej crrespndientes a ls edificis de L2 que pertenecen a un cmplej b. Si n i. Si se ha prprcinad valr para ls parámetrs de filtrad cmunes a nivel de edifici y bien (la denminación del edifici bien) 1. L2 se carga cn las parejas (códig de edifici, códig de bien) en dnde se cumpla al mens una de las siguientes ds cndicines a. El códig de edifici cumple el criteri de filtrad b. El códig de bien cumple el criteri de filtrad (y el bien pertenece al edifici) 2. A L2 se le añaden las parejas ( vací, códig de bien) crrespndientes a bienes que n frman parte de ningún edifici per que sí cumplen el criteri de filtrad 3. Si se ha prprcinad valr para ls parámetrs de filtrad exclusivs a nivel de bien (el códig del bien, el códig de prvincia, etc.), eliminar ls elements de L2 en dnde el códig de bien n cumpla dichs parámetrs de filtrad 4. Retrnar un listad cnsistente en la unión de a. La lista de aquells códigs de edifici de L2 que n pertenecen a un cmplej b. La lista de aquells códigs de cmplej crrespndientes a ls edificis de L2 que pertenecen a un cmplej c. La lista cn ls códigs de bienes de L2 de las parejas en dnde el códig de edifici estaba vací ii. Si n 1. Si se ha prprcinad valr para ls parámetrs de filtrad exclusivs a nivel de bien (el códig del bien, el códig de prvincia, etc.) a. L1 se carga cn ls códigs de ls bienes crrespndientes a bienes que cumplan tds ls parámetrs de filtrad b. Retrnar un listad cnsistente en la unión de i. La lista de aquells códigs de bienes de L1 que n pertenecen a un cmplej ni a un edifici ii. La lista de aquells códigs de edificis que cumplen las siguientes ds cndicines 1. Sn edificis a ls que pertenecen ls bienes de L1 2. Sn edificis que n frman parte de un cmplej iii. La lista de aquells códigs de cmplejs que cumplen una de las siguientes ds cndicines 1. Sn cmplejs a ls que pertenecen directamente ls bienes de L1 2. Sn cmplejs a ls que pertenecen ls edificis de ls bienes de L SGTIC-SGACC-ServiciWebCIBI-V104 Página 14 de 15

15 4 Ejempl de invcación y salida del servici web A cntinuación se prprcina un ejempl cn dats ficticis de invcación del servici web cn bjet de aclarar el frmat de salida. Las características de dicha invcación sn las siguientes: Se emplean ls siguientes parámetrs de filtrad Denminación del edifici bien: TORRE Códig de prvincia: 46 Hay 2 bienes CIBI que cumplen ests parámetrs de filtrad El bien cn códig n frma parte de ningún edifici cmplej (es decir, es en sí mism un edifici) El bien cn códig frma a su vez parte del edifici E000012, que agrupa dich bien cn el bien cn códig Hay 1 edifici que cumple ests parámetrs de filtrad Es el edifici E Este edifici está frmad pr ls bienes CIBI y A su vez, este edifici frma parte del cmplej C000014, que agrupa dich edifici y el bien CIBI cn códig Cm resultad, el servici web devuelve un ficher XML cn el cntenid que se indica en el ficher EjemplSalidaWSCIBI.xml que se anexa a este dcument SGTIC-SGACC-ServiciWebCIBI-V104 Página 15 de 15