INTEGRACIÓN DE TASAS EN APLICACIONES DE GESTIÓN

Versión	Fecha	Autor
Integración de Tasas en aplicaciones de gestión	01/10/2016	Jose Luis Martínez del Amor

INTEGRACIÓN DE LAS TASAS EN LAS APLICACIONES DE GESTIÓN

En la integración de las tasas en las aplicaciones de gestión, intervienen los siguientes elementos:

1. La aplicación cliente, es decir, donde se han de integrar las tasas.
2. La API de tasas.
3. La aplicación iTasas, encargada de solicitar la tasa a Tributos y que se integrará en las aplicaciones.
4. La aplicación Tasas donde se realizarán las configuraciones necesarias.
5. Opcionalmente la aplicación JACINTA para la impresión del documento de autoliquidación o la que utilice la aplicación cliente para la impresión de documentos.

CONSIDERACIONES PREVIAS

El módulo de TASAS, dispone de la API y de la aplicación iTasas para realizar su trabajo, es decir, realizar la solicitud, y comprobar el pago, pero cada aplicación será la encargada de habilitar los registros y controles necesarios para asociar la tasa al trámite realizado.

PREPARACIÓN

Para implementar la generación de las tasas en un aplicación, se precisa:

1. Solicitar la configuración de la tasa a Tributos. La solicitud la ha de realizar la unidad gestora.
2. Crear la configuración de la tasa en TASAS.TASASCFG, con los datos proporcionados por Tributos, con las siguientes consideraciones:

Esta configuración se realizará utilizando la aplicación Tasas, la cual es capaz de obtener todos los atributos necesarios para la configuración. Básicamente la configuración consiste en:

1. Crear un registro para la tasa con TAS_CODIGO=0
2. Se crea un registro por cada hecho imponible y UGI. Se da la posibilidad de que algunas tasas estén compuestas por varios hechos imponibles distintos o repetidos, en tal caso se indicarán separados por el carácter “|”, por ejemplo: H00001|H00001.
3. Si el hecho imponible tiene atributos, éstos se expresarán con la siguiente notación: <CodigoAtributo1=ValorAtributo1>#<CodigoAtributo..n=ValorAtributo..n>. En caso de existir un solo atributo se admite poner el valor del mismo . Si el valor de un código de atributo es variable, se expresará <CodigoAtributo=?>. En los casos en los que la tasa disponga de varios hechos imponibles, se indicará la cadena de atributos separada por el carácter “|” conservando el mismo orden que los hechos imponibles indicados en el punto anterior, por ejemplo: NUME=1#TIPO=2|NUME=2.

El esquema de funcionamiento es el siguiente:

• Ejemplo.jpg

  Descripción1

IMPLANTACIÓN

Se ha creado una aplicación llamada iTasas para la expedición y consulta de pago de tasas capaz de trabajar en modo embebido para que pueda integrarse en las aplicaciones cliente.

Para integrar la gestión de tasas en una aplicación de gestión, se precisa:

1. La solicitud de la tasa que se realiza en dos fases:

a) Generación de una pre-tasa y obtención del código IDTASA, utilizando una de las funciones de la API:

TASAS.PTASASAPI.SPSOLICITARTASA (

cCodigoTasa,	/* Código de la tasa */
TipoIPF,	/* D */
NIF,	/* NIF */
NOMBRE,	/* Nombre */
DIRECCION,	/* Dirección */
CP,	/* Codigo Postal */
POBLACION,	/* Población */
PROVINCIA,	/* Provincia */
Representante_NIF,	/* NIF del representante de existir*/
Representante_NOMBRE,	/* Nombre del representante */
Representante_DIRECCION,	/* Dirección */
Representante_CP,	/* Código Postal */
Representante_POBLACION,	/* Población */
Representante_PROVINCIA,	/* Provincia */
OBSERVACIONES,	/* Observaciones */
APLICACION,	/* Código de aplicación de gestión */
EXPEDIENTE );	/* Referencia o expediente */

En el caso de conocer de antemano el beneficio fiscal se puede llamar a la función:

TASAS.PTASASAPI.SPSOLICITARTASABF (

cCodigoTasa,	/* Código de la tasa */
TipoIPF,	/* D */
NIF,	/* NIF */
NOMBRE,	/* Nombre */
DIRECCION,	/* Dirección */
CP,	/* Codigo Postal */
POBLACION,	/* Población */
PROVINCIA,	/* Provincia */
Representante_NIF,	/* NIF del representante de existir*/
Representante_NOMBRE,	/* Nombre del representante */
Representante_DIRECCION,	/* Dirección */
Representante_CP,	/* Código Postal */
Representante_POBLACION,	/* Población */
Representante_PROVINCIA,	/* Provincia */
OBSERVACIONES,	/* Observaciones */
APLICACION,	/* Código de aplicación de gestión */
EXPEDIENTE,	/* Referencia o expediente */
CODBENFISCAL_,	/* Código de Beneficio Fiscal */
DESBENFISCAL_);	/* Descripción de Beneficio Fiscal */

Ambas funciones devuelven un identificador IDTASA;

b) Llamada a la aplicación iTasas pasándole el código IDTASA obtenido en el punto anterior. (Ver Anexo I) La aplicación tiene varios modos de ser invocada, depende de cada aplicación cliente elegir el que más se ajuste a sus necesidades:

Modo normal: Presenta la pantalla de emisión de la tasa con los datos del contribuyente, los datos de la tasa, un selector de beneficio fiscal y una tabla con los importes calculados. Un segundo acceso a una tasa previamente emitida genera un error de “Tasa no encontrada”. El formato de la URL es:

http://vm-rest:8080/itasas/recuperarTasa.ctrl?id=IDTASA&nif=NIF_CONTRIBUYENTE

Modo normal retornando documento de auto-liquidación: Igual que el modo normal con las diferencias de que al final del proceso retorna el documento estándar de la auto-liquidación. Si la tasa ya ha sido emitida en lugar del error vuelve a retornar el documento de auto-liquidación. El formato de la URL es:

http://vm-rest:8080/itasas/recuperarTasa.ctrl?id=IDTASA&nif=NIF_CONTRIBUYENTE&documento=S

Modo embebido: Presenta la pantalla de emisión de la tasa sin los datos del contribuyente, es decir, sólo muestra los datos de la tasa, un selector de beneficio fiscal y una tabla con los importes calculados. Un segundo acceso a una tasa previamente emitida genera un error de “Tasa no encontrada”. El formato de la URL es:

http://vm-rest:8080/iTasas/recuperarTasa.ctrl?incrustado=S&id=IDTASA

Modo servicio REST: Este modo se puede utilizar desde clientes que puedan definir el Beneficio Fiscal en el momento de grabar la pre-tasa y no necesiten el selector. El resultado de la llamada es un JSON con el N28 generado o un mensaje de error si no se puede emitir. Un segundo acceso a una tasa previamente emitida genera un error de “Tasa no encontrada”. El formato de la URL es:

http://vm-rest:8080/iTasas/service/emitirTasa.ctrl?id=ID&nif=NIF_CONTRIBUYENTE

C) La aplicación iTasas actualiza la información de la pre-tasa con el código N28 los importes, y el beneficio fiscal si se permite su selección.

2. Una vez realizada la petición y obtenido el N28, se devolverá el control a la aplicación cliente, que utilizando el código IDTASA, lanzará la impresión del formulario, bien el genérico o el específico de la aplicación cliente. (Ver Anexo II)

3. Comprobación de pagos:

a) Se ha creado una función en la API, que realiza las tareas de consulta con la Agencia Tributaria y actualización de los datos en el módulo de tasas. Esta utilidad dispone de una doble funcionalidad:

1. Consultar/actualizar una tasa con un IDTASA concreto:

TASAS.PTASASAPI.ComprobarPagosTasas(IDTASA,pvStatus)

2. Consultar/actualizar todas las pendientes de pago:

TASAS.PTASASAPI.ComprobarPagosTasas(NULL,pvStatus)

Haciendo uso de la capacidad de comprobación de todos los pagos pendientes, se ha programado un CRON de ORACLE que se lanza diariamente permitiendo disponer de la información de pagos al día siguiente de la generación de la autoliquidación. Esta tarea genera un log de actividad.

4. Aplicaciones de gestión:

La aplicación cliente deberá crear las estructuras de datos necesarias para asociar las tasas generadas a los trámites y será la encargada de consultar si se ha registrado el pago en el módulo de tasas, mostrar el resultado obtenido y realizar las actuaciones pertinentes utilizando para ello la función de la API

TASAS.PTASASAPI.SPSelDatosTasa(IDTASA)

Lo conveniente en caso de que así se requiera es que a continuación de lanzar el proceso de comprobación de pagos genérico, se lance el particular de cada aplicación de gestión y es aquí cuando se puede informar de forma automática a los gestores del resultado de la comprobación. (Ver Anexo IV)

APLICACION TASAS

Se ha desarrollado una aplicación para la comprobación de la configuración y gestión de las tasas autorizadas (Ver Anexo III) con las siguientes funcionalidades:

1. Emisión de tasas y generación del documento de autoliquidación genérico.
2. Comprobación de pagos de las tasas emitidas.
3. Configuración de las tasas para su utilización con iTasas (Pendiente).

Esta aplicación se utiliza para probar la integración con los servicios que ofrece Tributos.

La URL de acceso es: http://tasas.murciaeduca.es (http://tasas.murciaeduca.es)

ANEXO I

Ejemplo de integración de itasas en una aplicación de gestión, en este caso Plumier XXI:

(Ver procedimiento completo en eduwiki)

ANEXO II

Autoliquidación genérica, se utiliza cuando la aplicación de gestión no precisa la integración de la tasa con el documento del trámite:

Documento del trámite con integración de la información de autoliquidación:

ANEXO III

Generación de tasa:

[[Image:|top]]

Comprobación de ingresos:

Por Quincena

Por N28

Por Fechas:

ANEXO IV

Correo informativo sobre las tasas emitidas y cobradas:

De: non-reply@carm.es [1]
Enviado el: viernes, 4 de marzo de 2016 0:20
Para: ALMAGRO MEROÑO, JUAN FRANCISCO
Asunto: Resumen Estadísticas de Tasas

Resumen Estadísticas de Tasas:
Fecha: 04/03/2016

Aplicación:PLUMIER

• Fecha Devengo:03/03/16 Emitidas:12 Cobradas:2 Incidencias:0
• Fecha Devengo:02/03/16 Emitidas:4 Cobradas:3 Incidencias:0
• Fecha Devengo:01/03/16 Emitidas:2 Cobradas:2 Incidencias:0

Correo informativo al centro sobre las tasas emitidas y cobradas:

De: non-reply@carm.es [2]
Enviado el: viernes, 26 de febrero de 2016 0:18
Para: ALMAGRO MEROÑO, JUAN FRANCISCO
Asunto: Resumen Estadísticas de Tasas

Resumen Estadísticas de Tasas:
Fecha: 25/02/2016

Aplicación:PLUMIER Centro: IES MIGUEL DE CERVANTES, MURCIA (MURCIA) ( Código Centro:30006197 )

Tasas Emitidas

   NRE:5694962 Importe a Pagar: 21,40

Tasas Pagadas

   NRE:5694962 Importe a Pagar: 21,40 Importe Pagado: 21,40

Correo informativo al centro sobre incidencias en la verificación de pagos:

De: non-reply@carm.es [3]
Enviado el: lunes, 29 de febrero de 2016 0:16
Para: ALMAGRO MEROÑO, JUAN FRANCISCO
Asunto: Urgente: Incidencias en Tasas

Incidencias en la verificación de pagos de tasas:

Fecha: 29/02/2016

Aplicación:PLUMIER Centro: IES RAMÓN Y CAJAL, MURCIA (MURCIA) ( Código Centro:30008558 )

NRE:3011769

Incidencia en Fecha:1

Revise si este alumno ha sido incluido en alguna propuesta y ésta no ha sido tramitada (enviada) elimine al alumno de la propuesta y vuelva a incluirlo para actualizar los datos. Si la propuesta ya está tramitada contacte con el Servicio de Títulos de la Consejería.