1.- Introducción a BENT para integradores

ÍNDICE DEL CONTENIDO



1.- ¿Qué es BENT?


BENT es el aplicativo que expone mediante servicios web de tipo SOAP la funcionalidad de realizar envíos a algunos de los organismos que forman parte del gobierno de Aragón. Un envío tiene un origen y un destinatario y al menos un documento. Desde el puntos de vista de los integradores BENT no permite realizar envíos a gestores de unidades, sólo permite realizar envíos a unidades.





2.- ¿Qué funcionalidades ofrece BENT mediante sus servicios?


Mediante los servicios web que publica el core podrás obtener las siguientes funcionalidades:

  • Crear un envío.

    • Crear envíos con origen ciudadano, administración (dentro de gobierno de aragón) o una administración externa a Gobierno de Aragón.

3.- ¿Cómo funciona BENT?


3.1.- Módulos de BENT

Portal Privado

Los usuarios son dados de alta en la aplicación asociados a los organismos que les corresponda, una vez hecho esto acceden a la aplicación cargando su certificado y seleccionando uno de los organismos que tenga asociados en SIU. Al entrar en la aplicación el usuario podrá acceder tanto a su bandeja personal como a las bandejas de los organismos en los que haya sido dado de alta en la aplicación y podrá consultar los envíos correspondientes, filtrarlos, y realizar determinadas acciones.

Los envíos realizados por aplicaciones externas se visualizarán en este portal en las bandejas correspondientes, siempre que el usuario esté dado de alta en BENT asociado a las mismas, o en su defecto en su bandeja personal si es el caso.

Portal Administrativo

Este portal es utilizado por los usuarios autorizados tanto para realizar cambios en la configuración de la aplicación como para llevar a cabo actuaciones de soporte. A través de este portal se darán de alta, por ejemplo, las aplicaciones que vayan a integrarse con BENT para realizar envíos. Los cambios de configuración en la aplicación se harán igualmente desde este portal, o también el seguimiento y regeneración de envíos con estado erróneo.

Core de la aplicación

Este módulo es donde se ubican todos los servicios que ofrece BENT.



3.2.- Uso de BENT como integrador

El primer punto a tener en cuenta para integrarse con BENT y crear envíos en la aplicación será registrar la aplicación como integradora. Para esto debe ponerse en contacto con el equipo y se dará de alta aplicación con los parámetros que correspondan. En el apartado 5, más abajo, se explican los parámetros que deben establecerse al dar de alta la aplicación.

Al realizar envíos a BENT desde una aplicación externa hay varios conceptos a tener en cuenta, en primer lugar la petición será distinta en función del origen del envío, distinguiendo:

  • Envío con origen ciudadano

  • Envío con origen administración interna

  • Envío con origen administración externa

Los detalles de cómo afecta esta casuística a la parametrización están en el manual de integración, sin embargo aún se debe de tener en cuenta otro aspecto concerniente a los registros a efectuar. En el caso que no sea un envío con origen administración interna, se debería efectuar el registro de salida correspondiente antes de realizar la integración con el método createIssue de BENT. En caso contrario, BENT sí se encarga de realizar este registro y no será necesario.

Para realizar el registro de salida correspondiente es necesario integrarse con SRT previamente, para lo cual lo mejor sería consultar su manual. Cabe mencionar en este punto que los envíos en BENT pasan por varios estados y si no se realizan los registros que correspondan en cada caso un envío no llegará a su destino. El envío creado no llegará a ser visible en la bandeja receptora hasta que complete el proceso de registro en BENT también, o en el caso que este registro se complete con error (finaliza en error si después de 5 intentos no ha sido posible registrar correctamente).

 

Los envíos creados en BENT generan notificaciones SGA también en función del resultado de la operación:

  • Si un envío se dirige a una bandeja sin gestores, el envío será creado y se notificará a soporte para realizar las acciones que sean necesarias

  • Si el envío es completado correctamente los gestores de la bandeja o el gestor en concreto al que se dirija el envío será notificado

  • Si el envío finaliza en error el receptor será también notificado por SGA

Otro aspecto a tener en cuenta, es si el envío va a ser generado con documentos editables o no. Los documentos que aparezcan editables en el envío tendrán algunos atributos modificables desde el portal privado de BENT (descripcion, procedimiento, organismo productor, tipo de documento). El que un documento se establezca como editable o no dependerá del procedimiento que lleve asociado y si este procedimiento está establecido como editable en la configuración de BENT.

Como explicábamos anteriormente, los envíos pueden finalizar en estado de error si falla alguno de los registros que realiza BENT internamente. En estos casos existe una tarea programada que realiza reintentos y otra que notifica a soporte los que han finalizado definitivamente en error, por lo tanto no es algo de lo que deba preocuparse el integrador.