Proyecto Compras y Contrataciones Estatales Asunto Web Service de actualizaciones del Catlogo de Artculos, Servicios y Obras de la Administracin P!blica Fecha "#$%&$'%"" (istorial de )evisiones Fecha Versin Descripcin Autor "#$%&$'%"" "*% +ocumentacin del WS ,ue permite mantener actualizada una copia de algunas tablas del catlogo de artculos, servicios y obras de la Adm* P!blica -nti )ebelese '.$%/$'%"" '*% Se incluyen todas las tablas del catlogo de artculos, servicios y obras de la Adm* P!blica -nti )ebelese ".$%.$'%"' '*% Se cambia t0rmino 12ienes1 por 1Artculos1 en cartula, y logos en todas las pginas -nti )ebelese %3$%"$'%". .*% 4uevos atributos a nivel de la tabla de artculos y 5amilias Se actualizan re5erencias y logos para la ACCE -nti )ebelese 4ombre actual del arc6ivo7 doc89s8act8catalogo*odt Andes ".:# piso /; <ontevideo =ruguay >el*$?a@7 AB#C/D 'C%"*'C'CE Email7 in5ormatica*comprasFacce*gub*uy 999*acce*gub*uy Tabla e contenios CA)G>=HA******************************************************************************************************************** " >abla de contenidos******************************************************************************************************* ' -ntroduccin******************************************************************************************************************* . Especi5icacin**************************************************************************************************************** & Estructura del catlogo************************************************************************************************** 3 doc_ws_act_catalogo.odt Pgina 2 de 16 !"TRODUCC!#" ACCE 6a puesto a disposicin la in5ormacin contenida en el Catlogo de Artculos, Servicios y Obras ,ue utiliza el Estado, actualmente en7 el sitio 9eb de compras p!blicas 999*comprasestatales*gub*uy el sistema in5ormtico de gestin de compras utilizado en la Administracin Central y en otras instituciones p!blicas AS-CED En uso desde 6ace varios aIos por el Estado, el Catlogo contiene ms de .%,%%% artculos agrupados en 5amilias, y cada artculo tiene variantes y detalles, 5ormando una estructura de rbol con ms de '%%,%%% 6oJas* Ha inter5az desarrollada permite, a partir de una carga inicial realizada por !nica vez ,ue se obtiene descargando la e@portacin del Catlogo disponible en el sitio 9eb de compras estatales, actualizar va un servicio 9eb en 5orma peridica las actualizaciones ,ue se realicen al mismo* El mantenimiento del Catlogo es realizado por ACCE, utilizando para ello los servicios de una <esa de Ayuda ,ue atiende re,uerimientos provenientes de las instituciones p!blicas usuarias del servicio* Es inter0s de ACCE poner esta in5ormacin a disposicin de cual,uier interesado* Entendemos ,ue la integracin con el Catlogo reviste un alto inter0s para empresas proveedoras de sistemas de in5ormacin al Estado y ,ue utilicen estos datos, aun,ue tambi0n puede ser !til en general para cual,uier institucin, p!blica o privada* Ha in5ormacin contenida en el Catlogo es de uso libre, y el acceso a trav0s de la inter5az no tiene costo* doc_ws_act_catalogo.odt Pgina 3 de 16 $%P$C!F!CAC!#" El WS de actualizaciones del catlogo dispone de una sola operacin llamada KfindActualizacionesCatalogo ,ue debe recibir como parmetro una 5ec6a Atipo K@s7dateLD. El valor de este parmetro est restringido a como m@imo .% das previos a la 5ec6a de la invocacin* Ha operacin devuelve una lista con todas las actualizaciones realizadas a cada entidad del catlogo con 5ec6a de operacin mayor o igual al parmetro, ordenadas de 5orma ascendente seg!n dic6a 5ec6a* Cada elemento de la lista corresponde a una actualizacin, y contiene la siguiente in5ormacin7 ?ec6a de la operacin Operacin AA, 2 o < D Entidad a5ectada A continuacin se presenta un eJemplo de resultado obtenido al invocar el servicio con la 5ec6a K'%""M%&M'3L7 &soapen'($n'elope )*lns(soapen'+,http(--sche*as.)*lsoap.org-soap-en'elope-,/ &soapen'(0oy/ &ns(1inActualizacionesCatalogoResponse )*lns(ns+,http(--2s.ser'er.co*prasestatales.gub.uy,/ &ns(return/ &ns(actualizacionesArr/ &ns(ART3%$RV3O0RA/ &ns(F$C4A30A5A )si(nil+,true, )*lns()si+,http(--222.26.org-7889-:;L%che*a<instance,-/ &ns(;OT!VO30A5A )si(nil+,true, )*lns()si+,http(--222.26.org-7889-:;L%che*a<instance,-/ &ns(CLA%3COD/=&-ns(CLA%3COD/ &ns(COD/>>?>?&-ns(COD/ &ns(CO;PRA0L$/%&-ns(CO;PRA0L$/ &ns(D$%CR!PC!O"/L!;P!ADOR D$ A!R$ CO;PR!;!DO&-ns(D$%CR!PC!O"/ &ns($%P3T$C"!CA% )si(nil+,true, )*lns()si+,http(--222.26.org-7889-:;L%che*a<instance,-/ &ns(FA;!3COD/7&-ns(FA;!3COD/ &ns(!"D3A@RUPA0L$/"&-ns(!"D3A@RUPA0L$/ &ns(!"D3ART3%$RV/A&-ns(!"D3ART3%$RV/ &ns(!"D3FRACC!O"/"&-ns(!"D3FRACC!O"/ &ns(!"D3@$%T!O"A0L$/"&-ns(!"D3@$%T!O"A0L$/ &ns(!"D3T!PO3D$TALL$ )si(nil+,true, )*lns()si+,http(--222.26.org-7889-:;L%che*a<instance,-/ &ns(OD@/9A7888&-ns(OD@/ &ns(%U0C3COD/9&-ns(%U0C3COD/ &ns(%U0F3COD/>&-ns(%U0F3COD/ &ns(U";$3COD/77&-ns(U";$3COD/ doc_ws_act_catalogo.odt Pgina 4 de 16 &ns(VAR3COD/9&-ns(VAR3COD/ &-ns(ART3%$RV3O0RA/ &ns(F$C4A/7899<8?<7B&-ns(F$C4A/ &ns(OP$RAC!O"/A&-ns(OP$RAC!O"/ &-ns(actualizacionesArr/ &ns(actualizacionesArr/ &ns(F$C4A/7899<8?<7B&-ns(F$C4A/ &ns(OP$RAC!O"/A&-ns(OP$RAC!O"/ &ns(%!"O"!;O/ &ns(F$C4A30A5A )si(nil+,true, )*lns()si+,http(--222.26.org-7889-:;L%che*a<instance,-/ &ns(;OT!VO30A5A )si(nil+,true, )*lns()si+,http(--222.26.org-7889-:;L%che*a<instance,-/ &ns(AR%$3COD/>>?>?&-ns(AR%$3COD/ &ns(D$%CR!PC!O"/%PRAC L!;P!ADOR D$ A!R$ CO;PR!;!DO&-ns(D$%CR!PC!O"/ &-ns(%!"O"!;O/ &-ns(actualizacionesArr/ &-ns(return/ &-ns(1inActualizacionesCatalogoResponse/ &-soapen'(0oy/ &-soapen'($n'elope/
Ha lista de entidades del catlogo para la cuales se pueden obtener actualizaciones a trav0s del WS, es la siguiente Aver estructura asociada en K$%TRUCTURA D$L CATLO@OLD7 Artculos, servicios y obras ?amilias Sub5amilias Clases Subclases ObJetos del gasto Sinnimos Ade las descripciones de los artculosD =nidades de medida =nidades de medida de c$artculo -mpuestos -mpuestos de c$artculo Nariantes <edidas Presentaciones <edidas de variante de c$artculo doc_ws_act_catalogo.odt Pgina 5 de 16 Colores Colores de c$artculo <arcas +etalles de variante de c$artculo PorcentaJes de impuestos Ha =)H del WS+H del WS por -nternet es la siguiente, seg!n la versin de SOAP7 SOAP "*"7 6ttp7$$999*comprasestatales*gub*uy$9s$ActualizacionCatalogoWS$Actualizacio nCatalogoService*ActualizacionCatalogoService(ttpSoap""EndpointO9sdl SOAP "*'7 6ttp7$$999*comprasestatales*gub*uy$9s$ActualizacionCatalogoWS$Actualizacio nCatalogoService*ActualizacionCatalogoService(ttpSoap"'EndpointO9sdl Para a,uellos organismos ,ue est0n conectados a la )E+uy, la =)H del WS+H es la siguiente Aen el caso de poder resolver nombres con los +4S de la )E+uyD7 SOAP "*"7 6ttp7$$sice*compras*red*uy7/%/%$9s$ActualizacionCatalogoWS$ActualizacionCat alogoService*ActualizacionCatalogoService(ttpSoap""EndpointO9sdl SOAP "*'7 6ttp7$$sice*compras*red*uy7/%/%$9s$ActualizacionCatalogoWS$ActualizacionCat alogoService*ActualizacionCatalogoService(ttpSoap"'EndpointO9sdl Ha misma direccin pero directamente con la -P de )ed=P, es la siguiente7 SOAP "*"7 doc_ws_act_catalogo.odt Pgina 6 de 16 6ttp7$$"%*'##*#%*'%'7/%/%$9s$ActualizacionCatalogoWS$ActualizacionCatalogo Service*ActualizacionCatalogoService(ttpSoap""EndpointO9sdl SOAP "*'7 6ttp7$$"%*'##*#%*'%'7/%/%$9s$ActualizacionCatalogoWS$ActualizacionCatalogo Service*ActualizacionCatalogoService(ttpSoap"'EndpointO9sdl $%TRUCTURA D$L CATLO@O A continuacin se detalla la estructura de las tablas ,ue representan las entidades del catlogo, ,ue se pueden mantener actualizadas 6aciendo uso del WS de actualizaciones del catlogo* En el arc6ivo de importacin del catlogo ,ue se deJa disponible para descargar en el sitio 9eb de compras estatales, actualizado en 5orma semanal, se incluye un script SQH AA4S-D ,ue permite crear estas tablas en cual,uier base de datos, as como un script de importacin basado en sentencias de K-4SE)>L SQH AA4S-D para cada una de las tablas* doc_ws_act_catalogo.odt Pgina 7 de 16 doc_ws_act_catalogo.odt Pgina 8 de 16 TA0LA( Art3%er'3Obra Ca*po Tipo Restricciones Descripcin cod 4=<E)-CA:D CHANE O2H-RA>O)-O Cdigo del artculo, servicio u obra descripcion NA)C(A)A'%%D O2H-RA>O)-O +escripcin completa 5ami8cod 4=<E)-CA'D O2H-RA>O)-O ?amilia a la ,ue pertenece el artculo sub58cod 4=<E)-CA'D O2H-RA>O)-O Sub5amilia a la ,ue pertenece el artculo clas8cod 4=<E)-CA'D O2H-RA>O)-O Clase a la ,ue pertenece el artculo subc8cod 4=<E)-CA.D O2H-RA>O)-O Subclase a la ,ue pertenece el artculo var8cod 4=<E)-CA&D O2H-RA>O)-O Nariante del artculo* AEJemplo7 talleD unme8cod 4=<E)-CA.D =nidad de medida por de5ecto en ,ue se compra imp8cod 4=<E)-CA'D -mpuesto por de5ecto ind8art8serv NA)C(A)A"D O2H-RA>O)-O -ndica el tipo7 artculo, servicio u obra ind85raccion NA)C(A)A"D O2H-RA>O)-O -ndicador de di5cil 5raccionamiento ind8gestionable NA)C(A)A"D O2H-RA>O)-O -ndica si cual,uiera puede iniciar la compra o 6ay alguien encargado ind8agrupable NA)C(A)A"D O2H-RA>O)-O El art* se compra mediante compra agrupada Aen 5orma conJunta para varias reparticionesD stocSeable NA)C(A)A"D -ndica si el artculo es KstocSeableL stocS8contable NA)C(A)A"D -ndica en caso de ser stocSeable si dic6o stocS debe re5leJarse contablemente o simplemente interesa llevarse su inventario ind8tipo8detalle NA)C(A)A"D -ndica el tipo de detalle de la variante del artculo Amedicamento, repuestoD odg 4=<E)-CA:D O+R asignado al artculo esp8tecnicas NA)C(A)A'%%%D Especi5icaciones t0cnicas del artculo 5ec6a8baJa +A>E ?ec6a de baJa del artculo doc_ws_act_catalogo.odt Pgina 9 de 16 motivo8baJa NA)C(A)A'%%D <otivo de baJa del artculo o motivo de baJa de la compra del artculo comprable NA)C(A)A"D O2H-RA>O)-O -ndica si el artculo es comprable TA0LA( Fa*ilias Ca*po Tipo Restricciones Descripcin cod 4=<E)-CA'D CHANE O2H-RA>O)-O Cdigo de la 5amilia descripcion NA)C(A)A:%D O2H-RA>O)-O +escripcin de la 5amilia comprable NA)C(A)A"D O2H-RA>O)-O Si tiene valor K4L, entonces se indica ,ue agrupa artculos e@clusivamente no comprables 5ec6a8baJa +A>E ?ec6a de la baJa motivo8baJa NA)C(A)A'%%D <otivo de la baJa TA0LA( %ubFlias Ca*po Tipo Restricciones Descripcin 5ami8cod 4=<E)-CA'D CHANE O2H-RA>O)-O Cdigo de la 5amilia a la ,ue pertenece cod 4=<E)-CA'D Cdigo de la sub5amilia descripcion NA)C(A)A:%D O2H-RA>O)-O +escripcin de la sub5amilia 5ec6a8baJa +A>E ?ec6a de la baJa motivo8baJa NA)C(A)A'%%D <otivo de la baJa doc_ws_act_catalogo.odt Pgina 10 de 16 TA0LA( Clases Ca*po Tipo Restricciones Descripcin 5ami8cod 4=<E)-CA'D CHANE O2H-RA>O)-O Cdigo de la 5amilia a la ,ue pertenece sub58cod 4=<E)-CA'D Cdigo de la sub5amilia a la ,ue pertenece cod 4=<E)-CA'D Cdigo de la clase descripcion NA)C(A)A3%D O2H-RA>O)-O +escripcin de la clase 5ec6a8baJa +A>E ?ec6a de la baJa motivo8baJa NA)C(A)A'%%D <otivo de la baJa TA0LA( %ubClases Ca*po Tipo Restricciones Descripcin 5ami8cod 4=<E)-CA'D CHANE O2H-RA>O)-O Cdigo de la 5amilia a la ,ue pertenece sub58cod 4=<E)-CA'D Cdigo de la sub5amilia a la ,ue pertenece clas8cod 4=<E)-CA'D Cdigo de la clase a la ,ue pertenece cod 4=<E)-CA.D Cdigo de la subclase descripcion NA)C(A)A'##D O2H-RA>O)-O +escripcin de la subclase 5ec6a8baJa +A>E ?ec6a de la baJa motivo8baJa NA)C(A)A'%%D <otivo de la baJa TA0LA( OD@s Ca*po Tipo Restricciones Descripcin odg 4=<E)-CA:D CHANE O2H-RA>O)-O O+R AObJeto del gastoD descripcion NA)C(A)A:#D O2H-RA>O)-O +escripcin del O+R 5ec6a8baJa +A>E ?ec6a de la baJa TA0LA( %inoni*os Ca*po Tipo Restricciones Descripcin arse8cod 4=<E)-CA:D CHANE O2H-RA>O)-O Cdigo del artculo, servicio u obra doc_ws_act_catalogo.odt Pgina 11 de 16 descripcion NA)C(A)A'%%D O2H-RA>O)-O +escripcin del sinnimo TA0LA( Uniaes3;e Ca*po Tipo Restricciones Descripcin cod 4=<E)-CA.D CHANE O2H-RA>O)-O Cdigo de la unidad de medida descripcion NA)C(A)A'#D O2H-RA>O)-O +escripcin de la unidad de medida 5ec6a8baJa +A>E ?ec6a de baJa motivo8baJa NA)C(A)A'%%D <otivo de baJa TA0LA( Art3Uniaes3;e Ca*po Tipo Restricciones Descripcin arse8cod 4=<E)-CA:D CHANE O2H-RA>O)-O Cdigo del artculo, servicio u obra unme8cod 4=<E)-CA.D Cdigo de la unidad de medida asociada al artculo, servicio u obra 5ec6a8baJa +A>E ?ec6a de baJa motivo8baJa NA)C(A)A'%%D <otivo de baJa TA0LA( !*puestos Ca*po Tipo Restricciones Descripcin cod 4=<E)-CA'D CHANE O2H-RA>O)-O Cdigo del impuesto descripcion NA)C(A)A.%D O2H-RA>O)-O +escripcin del impuesto 5ec6a8baJa +A>E ?ec6a de baJa motivo8baJa NA)C(A)A'%%D <otivo de baJa TA0LA( Art3!*puestos Ca*po Tipo Restricciones Descripcin arse8cod 4=<E)-CA:D CHANE O2H-RA>O)-O Cdigo del artculo, servicio u obra imp8cod 4=<E)-CA'D Cdigo del impuesto asociado al artculo, servicio u obra 5ec6a8baJa +A>E ?ec6a de baJa motivo8baJa NA)C(A)A'%%D <otivo de baJa TA0LA( Variantes doc_ws_act_catalogo.odt Pgina 12 de 16 Ca*po Tipo Restricciones Descripcin cod 4=<E)-CA&D CHANE O2H-RA>O)-O Cdigo de la variante descripcion NA)C(A)A:%D O2H-RA>O)-O +escripcin de la variante unme8cod 4=<E)-CA.D O2H-RA>O)-O Cdigo de la unidad de medida de la variante 5ec6a8baJa +A>E ?ec6a de baJa motivo8baJa NA)C(A)A'%%D <otivo de baJa TA0LA( ;eias Ca*po Tipo Restricciones Descripcin cod 4=<E)-CA#D CHANE O2H-RA>O)-O Cdigo de la medida descripcion NA)C(A)A:%D O2H-RA>O)-O +escripcin de la medida 5ec6a8baJa +A>E ?ec6a de baJa motivo8baJa NA)C(A)A'%%D <otivo de baJa doc_ws_act_catalogo.odt Pgina 13 de 16 TA0LA( Presentaciones Ca*po Tipo Restricciones Descripcin cod 4=<E)-CA.D CHANE O2H-RA>O)-O Cdigo de la presentacin descripcion NA)C(A)A:%D O2H-RA>O)-O +escripcin de la presentacin unme8cod 4=<E)-CA.D O2H-RA>O)-O Cdigo de la unidad de medida de la presentacin 5ec6a8baJa +A>E ?ec6a de baJa motivo8baJa NA)C(A)A'%%D <otivo de baJa TA0LA( ;e3Variantes Ca*po Tipo Restricciones Descripcin arse8cod 4=<E)-CA:D CHANE O2H-RA>O)-O Cdigo del artculo, servicio u obra med8cod8v ariante 4=<E)-CA#D Cdigo de la medida de la variante pres8cod 4=<E)-CA.D Cdigo de la presentacin med8cod8pr es 4=<E)-CA#D Cdigo de la medida de la presentacin 5ec6a8baJa +A>E ?ec6a de baJa motivo8baJa NA)C(A)A'%%D <otivo de baJa TA0LA( Colores Ca*po Tipo Restricciones Descripcin cod 4=<E)-CA.D CHANE O2H-RA>O)-O Cdigo del color descripcion NA)C(A)A:%D O2H-RA>O)-O +escripcin del color 5ec6a8baJa +A>E ?ec6a de baJa motivo8baJa NA)C(A)A'%%D <otivo de baJa doc_ws_act_catalogo.odt Pgina 14 de 16 TA0LA( Art3Colores Ca*po Tipo Restricciones Descripcin arse8cod 4=<E)-CA:D CHANE O2H-RA>O)-O Cdigo del artculo, servicio u obra colo8cod 4=<E)-CA.D Cdigo del color asociado al artculo, servicio u obra 5ec6a8baJa +A>E ?ec6a de baJa motivo8baJa NA)C(A)A'%%D <otivo de baJa TA0LA( ;arcas Ca*po Tipo Restricciones Descripcin cod 4=<E)-CA&D CHANE O2H-RA>O)-O Cdigo de la marca descripcion NA)C(A)A&%D O2H-RA>O)-O +escripcin de la marca 5ec6a8baJa +A>E ?ec6a de baJa motivo8baJa NA)C(A)A'%%D <otivo de baJa TA0LA( Det3Variantes Ca*po Tipo Restricciones Descripcin cod 4=<E)-CA/D CHANE O2H-RA>O)-O Cdigo del detalle de variante descripcion NA)C(A)A.%%D O2H-RA>O)-O +escripcin del detalle de variante marc8cod 4=<E)-CA&D O2H-RA>O)-O Cdigo de la marca arse8cod 4=<E)-CA:D O2H-RA>O)-O Cdigo del artculo, servicio u obra med8cod8v ariante 4=<E)-CA#D O2H-RA>O)-O Cdigo de la medida de la variante pres8cod 4=<E)-CA.D O2H-RA>O)-O Cdigo de la presentacin med8cod8pr es 4=<E)-CA#D O2H-RA>O)-O Cdigo de la medida de la presentacin 5ec6a8baJa +A>E ?ec6a de baJa motivo8baJa NA)C(A)A'%%D <otivo de baJa TA0LA( Porcs3!*puestos Ca*po Tipo Restricciones Descripcin imp8cod 4=<E)-CA'D Cdigo de los impuestos doc_ws_act_catalogo.odt Pgina 15 de 16 CHANE O2H-RA>O)-O 5ec6a8vigencia +A>E ?ec6a de vigencia del porcentaJe asociado a los impuestos porcentaJe 4=<E)-CA&,'D O2H-RA>O)-O PorcentaJe asociado a los impuestos doc_ws_act_catalogo.odt Pgina 16 de 16