EHALO Manual del programador: Servicios Web
Contents
1. 9 46 EIQUIDACION WS asi 9 5 MODO DE EMPLEO o ccncconcconconocnnnocinocnnonnnonnconncconoconoconnconncnoc nono ccconconaconacononcnonss 11 T A SERVICIOS WEB Teralco 1 INTRODUCCI N Debido a la necesidad de integrar EHALO con otras aplicaciones ste ha sido dotado de un conjunto de Servicios Web en el que poder realizar las principales funciones de la aplicaci n A continuaci n se detallan este conjunto as como su modo de uso y su lista de errores DOCUMENTO T A SERVICIOS WEB Teralco 2 WSDL Y DATOS DE ACCESO 2 1 Entorno de desarrollo El documento wsdl que describe el servicio web se encuentra disponible en la direcci n http b6lehalo 8080 ehalo services EHALO wsdl Es necesario pedir acceso y usuario al responsable del proyecto en la Diputaci n Provincial de Almer a 2 2 Entorno de producci n El documento wsdl que describe el servicio web se encuentra disponible en la direcci n http b13lehalo 8080 ehalo services EHALO wsadl Es necesario pedir acceso y usuario al responsable del proyecto en la Diputaci n Provincial de Almer a T SERVICIOS WEB Teralco 3 SERVICIOS WEB 3 1 Consulta de Padrones Este servicio web sirve para consultar los datos relacionados con los padron2. T JA SERVICIOS WEB Teralco TABLA DE CONTENIDO 1 INTRODUCCI N ds 4 2 WSDL Y DATOS DE ACCESO sesesssooesssoosssssossssoossssoosessoossssoossssoossssoossssoossssoosssssossssoos 5 2 1 ENTORNO DE DESARROLLO 5 22 ENTORNO DE 5 3 SERVICIOS rnk EENE 6 3 1 CONSULTA DE PADRONES ocooocnnonccnnncnconnononecnnnanannnnnnonocnonanannnnnnencnronannnnn none ncoronanannnnnnanicnns 6 3 2 CONSULTA DE DATOS OBJETO TRIBUTARIO POR PADR N cococccccononnncnanoncnnnnnancncnnnananinnna 6 33 CONSULTA OBJETO 6 3 4 ALTALIQUIDACI N cocccononcncnononnncnnnononocnnononccnnnnonccnnnnnnonnnn none 7 3 5 OBTENER CARTA DE PAGO coooooccccnononnncnononnncnnnonononnnononcnnnn non conan no nrnnnn nn nr tastte nr anna nn nr cana nn cian 7 4 ESTRUCTURAS DE DATOS ssssesesssooesssooesssoosssssooesssoossssooeessoossssoosssoossssooeessoosessooosssoossssose 8 Ale PADRONW cid 8 42 DATOOBIETOW Sarra E E N 8 43 OBJETOTRIBUTARIOWS ccocononocnnonccnnnnononanonenccnonanannnnnnononnonannnnnnonenonnnnnnnn nono ne cronanannnnnnanic ss 8 44 9 4 5 CONCEPTOLIQUIDACIONWS
3. metros Entrada String login String password int idEntidad boolean esAlta LiquidacionWS liquidaci n ObjetoTributarioWsS objetoTriburario Par metros Salida Liquidacionws Todos los par metros son obligatorios En caso de s lo querer realizar una consulta acerca de la liquidaci n habr a que establecer a false el par metro esAlta 3 5 Obtener carta de pago Mediante este servicio obtenedremos un documento en PDF que contiene una carta de pago La especificaci n es Nombre obtenerCartaPago Par metros Entrada String login String password int idEntidad String codigoPadron String ejercicio int numeroFijo Par metros Salida byte Todos los par metros son obligatorios La llamada a este m todo devuelve un array de bytes Estos deber n volcarse en un fichero con extensi n pdf para que puedan ser interpretados por el programa Acrobat Reader En caso de no poder generarse el fichero el valor devuelto ser nulo DOCUMENTO T SERVICIOS WEB Teralco 4 ESTRUCTURAS DE DATOS 4 1 PadronWS Nombre Tipo Descripci n codigo Texto C digo identificativo del padr n nombre Texto Nombre del padr n descripcionPadron Texto Breve descripci n 4 2 DatoObjetoWS Nombre Tipo Descripci n nombre Texto Nombre del dato nombreCorto Texto Nombre corto tipoDato Texto Tipo del dato p
4. T Teralco pg DIPUTACI N DE ALMER A EHALO Manual del programador Servicios Web T SERVICIOS WEB Teralco Control del documento Hist rico de la versi n VERSI N ELABORACI N REVISI N APROBACI N Fecha Responsable Fecha Responsable Responsable 1 0 22 06 2009 Javier Aliaga Montesinos 1 1 17 08 2009 Alejandro Such 31 08 2009 Rub n Villar 31 08 2009 Rub n Villar Berenguer Escudero Escudero 1 2 03 09 2009 Alejandro Such 03 09 2009 Rub n Villar 03 09 2009 Rub n Villar Berenguer Escudero Escudero 1 3 07 09 2009 Alejandro Such 14 09 2009 Rub n Villar 14 09 2009 Rub n Villar Berenguer Escudero Escudero Cambios respecto a la versi n anterior VERSI N PUNTO MODIFICACI N RESPECTO VERSI N ANTERIOR INDICE 1 0 Versi n inicial 1 1 3 1 A adido un par metro de entrada 1 1 3 2 Se cambia el par metro de salida devuelto 1 1 3 4 Eliminada la consulta de datos objeto ya que ahora se devuelven junto con el objeto tributario 1 1 3 4 Eliminado el par metro de entrada datosObjetoWS Estos datos ahora forman parte del objeto tributario 1 1 4 A adido ResConsultaDatosObjetoPadr n ConceptoLiquidacionWS 1 2 4 A adida la obligatoriedad de los par metros en las estructuras de datos 1 3 3 5 A adido el m todo de obtenci n del PDF de la carta de pago Lista de distribuci n DOCUMENTO EHALO 01 Servicios Web doc
5. es de una entidad La especificaci n es Nombre consultaPadron Par metros Entrada String login String password String codigoPadron int idEntidad Par metros Salida Padronws Todos los par metros son obligatorios con excepci n del par metro codigoPadron El valor de ste puede ser nu11 en funci n de si se quiere obtener una lista de todos los padrones de la entidad o nicamente extraer informaci n detallada sobre un padr n en concreto 3 2 Consulta de Datos Objeto Tributario por Padr n Este servicio web sirve para consultar los datos de un objeto tributario de un padr n asociado a una entidad La especificaci n es Nombre consultaDatosO0bjetoPadron Par metros Entrada String login String password int idEntidad String codigoPadron Par metros Salida ResConsultaDatosO0bjetoPadron Todos los par metros son obligatorios 3 3 Consulta Objeto Tributario Este servicio web sirve para consultar los objetos tributarios asociados a una entidad La especificaci n es Nombre consulta0bjeto Par metros Entrada String login String password int idEntidad DOCUMENTO T SERVICIOS WEB Teralco String codigoPadron String clave Par metros Salida ObjetoTributarioWws Todos los par metros son obligatorios 3 4 Alta Liquidaci n Este servicio web sirve para dar de alta una liquidaci n La especificaci n es Nombre altaLiquidacion Par
6. n Texto Bonificaci n importe Texto Importe importeCobrado Texto Importe cobrado importeAPagar Texto Importe a pagar pendiente Texto Importe pendiente recargoEjecutiva Texto Recargo ejecutiva 4 6 LiquidacionWS A continuaci n se define el objeto Liquidaci nWS Los atributos que aparecen subrayados son obligatorios para realizar un alta de manera correcta Nombre Tipo Descripci n codigoPadron Texto C digo del padron al que pertenece la liquidaci n ejercicio Texto Ejercicio al que pertenece la liquidaci n Ej 2009 claveObjetoTributario Texto Clave que identifica al objeto tributario DOCUMENTO T SERVICIOS WEB Teralco nifContribuyente Texto Nif del contribuyente nombreContribuyente Texto Nombre del contribuyente direccionContribuyente Texto Direcci n del contribuyente nifRepresentante Texto Nif del representante nombreRepresentante Texto Nombre del representante direccionRepresentante Texto Direcci n del representante numeroF ijo Entero Numero fijo de la liquidaci n importe Texto Importe importeCobrado Texto Importe cobrado recargoEjecutiva Texto Recargo de la liquidaci n cpr Texto Cadena que representa la carta de pago observaciones Texto Observaciones de la liquidaci n pendiente Texto Indica si la liquidaci n esta pendiente conceptos ConceptoLiquidacionWS Vector con los c
7. onceptos de la liquidaci n DOCUMENTO T SERVICIOS WEB Teralco 5 MODO DE EMPLEO Vamos a ver qu llamadas debemos hacer para dar de alta una liquidaci n 1 consultaPadron gt Si no conocemos sobre que padr n queremos dar de alta la liquidaci n 2 consultaDatosO0bjetoPadron gt Consultamos los datos del objeto para darlos de alta 3 altaLiquidacion gt Damos de alta la liquidaci n El primer paso es optativo ya que si conocemos el c digo del padr n no es necesario invocarlo DOCUMENTO
8. uede ser Entero Texto Decimal valorDato Texto Valor del dato 4 3 ObjetoTributarioWS En caso de realizar un alta de un objeto tributario es importante que los atributos que se encuentran subrayados tengan asignados valores v lidos no nulos Nombre Tipo Descripci n clave Texto Clave identificativa del objeto codigoTipo0bjeto Texto C digo que identifica el tipo del objeto tributario nifTitular Texto Documento del titular del objeto tributario nombreMunicipio Texto Nombre del municipio donde se dar de alta el objeto calle Texto Calle del objeto tributario numero Texto Numero de la calle del objeto piso Texto Piso del objeto tributario codigoRecorrido Texto C digo usado para calcular el recorrido DOCUMENTO T SERVICIOS WEB Teralco vigenciaDesde Texto Fecha que indica desde cuando es vigente el objeto datosObjeto DatoObjetoWST Array con todos los datos que caracterizan objeto tributario 4 4 ResConsultaDatosObjetoPadron Nombre Tipo Descripci n nombreClave Texto Nombre de la clave del tipo de objeto datosObjeto DatoObjetoWS Array con todos los datos que caracterizan objeto tributario 4 5 ConceptoLiquidacionWS Nombre Tipo Descripci n baseLiquidable Texto Base liquidable bonificacio
Download Pdf Manuals
Related Search