Especificaciones de Esquema de Comunicación con SIIF

Transcripción

1 De Especificacines de Esquema de Cmunicación cn SIIF A Mntevide, Octubre de 2009

2 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa INDICE 1 INTRODUCCIÓN A QUIÉN ESTÁ DIRIGIDO? PROPÓSITO DEL SISTEMA ARQUITECTURA DOCUMENTACIÓN ANEXA METODOS INGRESO DE MOVIMIENTOS Afectacines Originales y de Mdificacines Cmprmiss Originales y de Mdificacines Obligacines Originales y de Mdificacines Dcuments 3 etapas en 1 Originales y de Mdificacines Brrad de Dcuments de Obligacines y 3 etapas en Partidas de Afectación Originales y de Mdificacines Partidas de Cmprmis Originales y de Mdificacines Partidas de Obligación y Dcuments 3 etapas en 1 Originales y de Mdificacines Retencines Originales y de Mdificacines Cesines Embargs Originales y de Mdificacines Tip Impuest Originales y de Mdificacines CONSULTAS Estad de Slicitudes Carga Inicial Carga Inicial y Ajustes Cnciliación Pririzadas Intervenidas Facturas Pagas Facturas Pagas Ttalmente Pág de 24

3 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa 1 INTRODUCCIÓN 1.1 A quién está dirigid? Este dcument está enfcad a aquellas persnas que desean aprender ls parámetrs que se utilizan en la cmunicación cn el Web Services que publica ciertas funcinalidades del SIIF (Sistema Integrad de Infrmación Financiera) 1.2 Prpósit del sistema Se brinda un mecanism de cmunicación alternativa a las distintas entidades de la Administración Central, para el intercambi de infrmación cn el SIIF de frma autmática, a diferencia del actual mecanism de cmunicación y transferencia de dats dnde se deben cnectar al sistema y acceder manualmente a ciertas pcines para descargar ls archivs de dats. Se cntempla una cmunicación ágil y segura entre ls clientes de CGN (ej. MVOTMA) y el SIIF, evitand tener que hacerl a través de la web y usand cm intercambi archivs de tip XML (cn la misma infrmación que tienen ls TXTs hasta ahra). El sistema cntempla la implementación de un Web Services para el SIIF cn varis métds que permiten la publicación de las siguientes funcinalidades: Mvimients: AfecOrigYdeMdif CmpOrigYDeMdif OblOrigYMdif Dc3Et1OrigYMdif BrrDcOblY3Et1 PartAfecOrigYMdif PartCmpOrigYMdif PartOblYDc3Et1OrigMd RetOrigYMdif CesOEmbOrigYMdif DetallesSIIF PartAfecOrigYMdif PartCmpOrigYMdif PartOblYDc3Et1OrigMd RetencinSIIF RetOrigYMdif CesinOEmbargSIIF CesOEmbOrigYMdif Pág de 24

4 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa ImpuestsSIIF TipImpOrigYMdif Cnsultas Estad de Slicitudes CargaInicial CargaInicialYAjustes Cnciliación Pririzadas Intervenidas Facturas Pagas Facturas Pagas Ttalmente 1.3 Arquitectura 1.4 Dcumentación anexa En el archiv Diseñ de interfaces entre SIIF - K2B.dc se encuentra la especificación de ls camps que se utilizan en las funcinalidades implementadas. Pr tal mtiv se debe referir al mism para btener infrmación más precisa de ls camps cm pr ejempl el tip, larg y si es bligatri. En la carpeta Archivs XSD se encuentran ls archivs Entrada_Nueva.xsd, CnsultaWS.xsd y msgerrrws.xsd que cntienen el frmat de ls xml de entrada para el ingres de mvimients. En la carpeta Ejempls se encuentran archivs xml cn el frmat para realizar pruebas de mvimients. Pág de 24

5 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa 2 METODOS 2.1 Ingres de mvimients Tds ls mvimients se ingresan a través del métd putslic. Este métd recibe un String cn frmat xml de acuerd a l establecid en el archiv Entrada_Nueva.xsd, prcesa la infrmación y en base al valr de ls camps, realiza ls mvimients crrespndientes. Pr últim devuelve un String cn frmat xml, establecid en el archiv CnsultaWS.xsd, cn el resultad de la peración. Para el mape de XML en bjets Java, se utiliz XMLBeans. De frma que en vez navegar pr el XML cn un DOM cn XPath, directamente usams bjets cn sus getters y sus setters; l cual resulta muy cómd para trabajar cn XML dentr de la aplicación. Dentr de esta técnica hay ds grandes psibilidades tecnlgías (hay más de ds, per entre tdas se destacan estas pr ser las más extendidas y estándar): JAXB (Java Architecture fr XML Binding): El es estándar de Java (l pdems encntrar en el JEE 5). JSR 222 ( XMLBeans: Pdríams decir que es el estándar de "fact" pr estar altamente extendid. En un principi fue un pryect de BEA, que psterirmente dnarn a la cmunidad Apache ( ). En definitiva ls que hace XMLBeans es btener, a partir de un DTD, las clases Java que prcesan ls XML que cumplen ese DTD. El paquete schemas.jar cntiene el cnjunt de clase btenidas de prcesar ls XML Entrada_Nueva.xsd y CnsultaWS.xsd. La clase cm.cgn.ws.cnf.cnf cntiene ls parámetrs de cnfiguración de la aplicación, entre ls que se encuentran ls distints tips de mvimients, el directri de lgs, y ls dats para parámetrs para la cnexión a la Basse de Dats. La clase cm.cgn.ws.da.dbcnnectr cntiene métds para btener una cnexión a la Base de Dats. Actualmente la aplicación esta bteniend la cnexión del pl de cnexines definid en el servidr de aplicacines. Pág de 24

6 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa En la siguiente figura se muestra el diagrama de clase que representa la peración de ingress de mvimients: En la siguiente tabla se muestran ls camps del cabezal que sn cmunes a tds ls mvimients: nr_carga tipregistr tipregistracin añ incis unidad ejecutra tipdcsistaux nrafectsistaux Pág de 24

7 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Afectacines Originales y de Mdificacines Sn ls que tienen ls camps TipRegistr = 1, TipRegistracin = 1 y TipRegistracin = 11 En la siguiente tabla se muestran ls camps que se espera recibir para el mvimient AfecOrigYdeMdif: nrmdifsistaux nrafectacin secafectacin tipmdificacin fechaelabracin mntafectacin tipejecucin tipprgrama tipdcument numerdcument andcrespald fechadcrespald cnceptgast financiamient cdigsir partidasmnext anprccmpra incisprccmpra unidadejecprccmpra tipprccmpra subtipprccmpra nrprccmpra nrampprccmpra resumen nrdcfndrtatri incisdcptgn unidadejecdcptgn nrdcptgn Nrdctransferencia Cmprmiss Originales y de Mdificacines Sn ls que tienen ls camps TipRegistr== 1, TipRegistracin = 2 y TipRegistracin = 12 En la siguiente tabla se muestran ls camps que se espera recibir para el mvimient CmpOrigYDeMdif: nrcmpsistaux nrmdifsistaux nrafectacin nrcmprmis seccmprmis tipmdificacin fechaelabracin mntcmprmis tipejecucin tipprgrama tipdcument numerdcument Pág de 24

8 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa andcrespald fechadcrespald clasedcbenef numdcbenef cnceptgast financiamient cdigsir anprccmpra incisprccmpra unidadejecprccmpra tipprccmpra subtipprccmpra nrprccmpra nrampprccmpra resumen nrdcfndrtatri incisdcptgn unidadejecdcptgn nrdcptgn nrdctransferencia Pág de 24

9 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Obligacines Originales y de Mdificacines Sn ls que tienen ls camps TipRegistr = 1, TipRegistracin = 3 y TipRegistracin = 13 En la siguiente tabla se muestran ls camps que se espera recibir para el mvimient OblOrigYMdif: nrcmpsistaux nrblsistaux nrmdifsistaux nrafectacin nrcmprmis nrbligacin secbligacin tipmdificacin fechaelabracin mntbligacin ttalretencines liquidpagable mntmnext tipejecucin tipprgrama tipdcument numerdcument andcrespald fechadcrespald seriedcument secuenciadcument fecharecepcin fechavencimient clasedcbenef numdcbenef bancctabenef agenciactabenef nrctabenef tipctabenef mnedactabenef cnceptgast financiamient cdigsir anprccmpra incisprccmpra unidadejecprccmpra tipprccmpra subtipprccmpra nrprccmpra nrampprccmpra tipcambi anticip mneda resumen nrdcfndrtatri incisdcptgn unidadejecdcptgn nrdcptgn nrdctransferencia Pág de 24

10 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Dcuments 3 etapas en 1 Originales y de Mdificacines Sn ls que tienen ls camps TipRegistr = 1, TipRegistracin = 4 y TipRegistracin = 14 En la siguiente tabla se muestran ls camps que se espera recibir para el mvimient Dc3Et1OrigYMdif: nrcmpsistaux nrblsistaux nrmdifsistaux nrafectacin nrcmprmis nrbligacin secbligacin tipmdificacin fechaelabracin mntbligacin ttalretencines liquidpagable partidasmnext mntmnext tipejecucin tipprgrama tipdcument numerdcument andcrespald fechadcrespald seriedcument secuenciadcument fecharecepcin fechavencimient clasedcbenef numdcbenef bancctabenef agenciactabenef nrctabenef tipctabenef mnedactabenef cnceptgast financiamient cdigsir anprccmpra incisprccmpra unidadejecprccmpra tipprccmpra subtipprccmpra nrprccmpra nrampprccmpra tipcambi anticip mneda resumen nrdcfndrtatri incisdcptgn unidadejecdcptgn nrdcptgn nrdctransferencia Pág de 24

11 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Brrad de Dcuments de Obligacines y 3 etapas en 1 Sn ls que tienen ls camps TipRegistr = 1, TipRegistracin = 23 y TipRegistracin = 24 En la siguiente tabla se muestran ls camps que se espera recibir para el mvimient BrrDcOblY3Et1: nrcmpsistaux nrblsistaux nrmdifsistaux nrafectacin nrcmprmis nrbligacin secbligacin financiamient Partidas de Afectación Originales y de Mdificacines Sn ls que tienen ls camps TipRegistr = 2, TipRegistracin = 1 y TipRegistracin = 11 En la siguiente tabla se muestran ls camps que se espera recibir para el mvimient PartAfecOrigYMdif: nrmdifsistaux nrafectacin secafectacin prgrama pryect bjetgast auxiliar financiamient mneda tipcredit imprte Partidas de Cmprmis Originales y de Mdificacines Sn ls que tienen ls camps TipRegistr = 2, TipRegistracin = 21 y TipRegistracin = 12 En la siguiente tabla se muestran ls camps que se espera recibir para el mvimient PartCmpOrigYMdif: nrcmpsistaux nrmdifsistaux nrafectacin nrcmprmis seccmprmis prgrama pryect bjetgast auxiliar financiamient mneda tipcredit imprte Pág de 24

12 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Partidas de Obligación y Dcuments 3 etapas en 1 Originales y de Mdificacines Sn ls que tienen ls camps TipRegistr = 2 y TipRegistracin = 3 y TipRegistracin = 13 En la siguiente tabla se muestran ls camps que se espera recibir para el mvimient PartOblYDc3Et1OrigMd: nrcmpsistaux nrblsistaux nrmdifsistaux nrafectacin nrcmprmis nrbligacin secbligacin prgrama pryect bjetgast auxiliar financiamient mneda tipcredit imprte Retencines Originales y de Mdificacines Sn ls que tienen ls camps TipRegistr = 3, TipRegistracin = 3, TipRegistracin = 4, TipRegistracin = 13 y TipRegistracin = 14 En la siguiente tabla se muestran ls camps que se espera recibir para el mvimient RetOrigYMdif: nrcmpsistaux nrblsistaux nrmdifsistaux nrafectacin nrcmprmis nrbligacin secuencia grupacreedr acreedr imprte Pág de 24

13 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Cesines Embargs Originales y de Mdificacines Sn ls que tienen ls camps TipRegistr == 4, TipRegistracin == 3, TipRegistracin = 4, TipRegistracin = 13 y TipRegistracin = 14 En la siguiente tabla se muestran ls camps que se espera recibir para el mvimient CesOEmbOrigYMdif: nrcmpsistaux nrblsistaux nrmdifsistaux nrafectacin nrcmprmis nrbligacin secuencia clasedcbenef numdcbenef bancctabenef agenciactabenef nrctabenef tipctabenef mnedactabenef mntmnext clasedccedente numdccedente cesinembarg getdisplegalcesinemb tipnrmacesinemb imprte Tip Impuest Originales y de Mdificacines Sn ls que tienen ls camps TipRegistr = 5, TipRegistracin = 3, TipRegistracin = 4, TipRegistracin = 13 y TipRegistracin = 14 En la siguiente tabla se muestran ls camps que se espera recibir para el mvimient TipImpOrigYMdif: nrcmpsistaux nrblsistaux nrmdifsistaux nrafectacin nrcmprmis nrbligacin secuencia tipimpuest mntcalcul mntcalculmnext Pág de 24

14 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa 2.2 Cnsultas Estad de Slicitudes En la siguiente figura se muestra el diagrama de clase que representa la peración cnsulta del estad de slicitudes: El métd getslicstatus recibe cm parámetr un dcument XML cm el frmat del archiv CnsultaWS.xsd. Se btiene cm respuesta de un mvimient cuand se quiere cnsultar pr un mvimient particular. Dats de Entrada añ incis unidad_ejecutra nr_carga Dats de Salida tip nr_carga tip_registr tip_registracin an_fiscal incis unidad_ejecutra tip_dc_sist_aux nr_afect_sist_aux nr_cmp_sist_aux Pág de 24

15 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa nr_bl_sist_aux nr_mdif_sist_aux nr_afectacin nr_cmprmis nr_bligacin sec_afectacin sec_cmprmis sec_bligacin prgrama pryect bjet_gast auxiliar mneda tip_credit secuencia grup_acreedr acreedr clase_dc_benef num_dc_benef fch_ing_siif resultad cmentari tip_impuest Pág de 24

16 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Carga Inicial En la siguiente figura se muestra el diagrama de clase que representa la peración cnsulta de Carga inicial: Dats de Entrada Dats de Salida Parámetr Tip Parámetr Tip anifiscal Numéric (4,0) añ fiscal Numéric (4,0) incis Numéric (2,0) incis Numéric (2,0) unidad ejecutra Numéric (3,0) prgrama Numéric (3,0) pryect Numéric (3,0) bjet del gast Numéric (3,0) auxiliar Numéric (3,0) financiamient Numéric (2,0) mneda Numéric (2,0) tip de crédit Numéric (1,0) imprte Numéric (12,0) Pág de 24

17 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Carga Inicial y Ajustes En la siguiente figura se muestra el diagrama de clase que representa la peración cnsulta de Carga inicial y Ajustes: Dats de Entrada Dats de Salida Parámetr Tip Parámetr Tip anifiscal Numéric (4,0) añ fiscal Numéric (4,0) incis Numéric (2,0) incis Numéric (2,0) fechadesde String (8) YYYYMMDD unidad ejecutra Numéric (3,0) fechahasta String (8) YYYYMMDD prgrama Numéric (3,0) pryect Numéric (3,0) bjet del gast Numéric (3,0) auxiliar Numéric (3,0) financiamient Numéric (2,0) mneda Numéric (2,0) tip de crédit Numéric (1,0) imprte Numéric (12,0) Pág de 24

18 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Cnciliación En la siguiente figura se muestra el diagrama de clase que representa la peración cnsulta de Cnciliación: Dats de Entrada Dats de Salida Parámetr Tip Parámetr Tip anifiscal Numéric (4,0) añ fiscal Numéric (4,0) incis Numéric (2,0) incis Numéric (2,0) fechadesde String (8) YYYYMMDD unidad ejecutra Numéric (3,0) fechahasta String (8) YYYYMMDD prgrama Numéric (3,0) tip String(1) S C pryect Numéric (3,0) bjet del gast Numéric (3,0) auxiliar Numéric (3,0) financiamient Numéric (2,0) mneda Numéric (2,0) tip de crédit Numéric (1,0) mnt afectad Numéric (12,0) mnt Numéric (12,0) cmprmetid mnt bligad Numéric (12,0) mnt ajustad Numéric (12,0) Pág de 24

19 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Pririzadas En la siguiente figura se muestra el diagrama de clase que representa la peración cnsulta de de transaccines Pririzadas: Dats de Entrada Dats de Salida Parámetr Tip Parámetr Tip anifiscal Numéric (4,0) Añ Fiscal Numéric (4,0) incis Numéric (2,0) Incis Numéric (2,0) fechadesde String (8) YYYYMMDD Unidad Ejecutra Numéric (3,0) fechahasta String (8) YYYYMMDD Nr.Dc. Afectacin Numéric (6,0 ) Nr. Dc. Numéric (3,0 ) Cmprmis Nr. Dc. Obligación Numéric (3,0 ) Nr. Lte Oblig. Numéric (4) Cncept de Gast Numéric(2,0) Clase Id. Carácter(1) RUC Carácter(12) Añ Prirización Numéric(4,0) Mes de Prirización Numéric(2,0) Sec de Prirización Numéric(3,0) Mneda Numéric (2,0) Mnt Pririzad Numéric(12,0) Pág de 24

20 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Mnt Pagad Fecha Cnfirmad Numéric(12,0) Date Pág de 24

21 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Intervenidas En la siguiente figura se muestra el diagrama de clase que representa la peración cnsulta de transaccines Intervenidas: Dats de Entrada Dats de Salida Parámetr Tip Parámetr Tip anifiscal Numéric (4,0) Añ Fiscal Numéric (4,0) incis Numéric (2,0) Incis Numéric (2,0) fechadesde String (8) YYYYMMDD Unidad Ejecutra Numéric (3,0) fechahasta String (8) YYYYMMDD Nr.Dc. Afectacin Numéric (6,0 ) Nr. Dc. Numéric (3,0 ) Cmprmis Nr. Dc. Obligación Numéric (3,0 ) Sec. Obligación Numéric (3,0 ) Nr. Lte Oblig. Numéric (4) Cncept de Gast Numéric(2,0) Tip de Ejecución Carácter(3) Tip de Mdificación Carácter (1) Financiamient Numéric (2,0) Mneda Numéric (2,0) Tasa de Cambi Numéric (7,4) Clase Id. Carácter(1) Pág de 24

22 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa RUC Mnt Obligación Mnt Retencines Liquid a Pagar Carácter(12) Numéric(12,0) Numéric(12,0) Numéric(12,0) Pág de 24

23 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Facturas Pagas En la siguiente figura se muestra el diagrama de clase que representa la peración cnsulta de Facturas Pagas: Dats de Entrada Dats de Salida Parámetr Tip Parámetr Tip anifiscal Numéric (4,0) añ fiscal Numéric (4,0) incis Numéric (2,0) incis Numéric (2,0) fechadesde String (8) YYYYMMDD unidad ejecutra Numéric (3,0) fechahasta String (8) YYYYMMDD prgrama Numéric (3,0) pryect Numéric (3,0) bjet del gast Numéric (3,0 ) auxiliar Numéric (3,0 ) financiamient Numéric (4) mneda Numéric(2,0) tip de crédit Carácter(3) fecha aprbad Date imprte Numéric (12,0) númer dcument Numéric (3,0 ) afectación númer dcument Numéric (3,0 ) cmprmis númer dcument bligación Numéric (3,0 ) Pág de 24

24 Administración Nacinal de Usinas y Trasmisines Eléctricas Cnsultría Externa Facturas Pagas Ttalmente En la siguiente figura se muestra el diagrama de clase que representa la peración cnsulta de Facturas Pagas Ttalmente: Dats de Entrada Dats de Salida Parámetr Tip Parámetr Tip anifiscal Numéric (4,0) Añ Fiscal Numéric (4,0) incis Numéric (2,0) Incis Numéric (2,0) fechadesde String (8) YYYYMMDD Unidad Ejecutra Numéric (3,0) fechahasta String (8) YYYYMMDD Fechamax Date Nr.Dc. Afectacin Numéric (6,0 ) Nr. Dc. Numéric (3,0 ) Cmprmis Nr. Dc. Obligación Numéric (3,0 ) Nr_lte_bl Numéric (4) Cncept de gast Numéric(2,0) Tip de ejecución Carácter(3) Financiamient Numéric (2,0) Clase id Carácter(1) Ruc Carácter(12) Tasa de Cambi Numéric (7,4) Clase Id. Carácter(1) RUC Carácter(12) Pág de 24