bandejaConsultaEventos
[[TOC]]
Los eventos son hechos asociados a la tramitación electrónica que ocurren en el ámbito de la CARM. Aunque estos eventos se puedan generar en distintos servicios o en distintas administraciones, se almacenan centralizadamente y su consulta se puede realizar con la operación bandejaConsultaEventos.
MUY IMPORTANTE: Para optimizar el rendimiento de la bandeja de eventos, las aplicaciones sectoriales solo deben utilizar este servicio para descargar los eventos nuevos en sus propios sistemas y no para consultar directamente desde sus propias bandejas. Los eventos descargados deben ser modificados con la operación bandejaCambiaEstadoEvento para cambiar el estado del evento a decargado(true). Este cambio tiene el mismo efecto que si se cambia el estado del evento a 02-LEIDO.
Si un evento descargado (true) es modificado en SANDRA, se le actualizará el campo descargado a false, con lo que la aplicación sectorial podrá volver a descargarlo.
Los eventos disponibles se pueden consultar en aquí
En cualquier consulta hay que indicar las credenciales (aplicacion, apikey e idTransacción) y los parámetros codigoProcedimiento, departamentoTramitador que son validados como se indica [aquí](/Credenciales y Validación). Excepto idTransaccion, estos campos son obligatorios en cualquier consulta.
Este servicio tiene dos formas de uso: consulta simple o detalle
La forma simple permite recuperar hasta 998 registros de la bandeja de entrada, pero el resultado solo devuelve los campos principales de la bandeja.
El único campo obligatorio en la consulta es estado (ademas, de las credenciales, procedimiento y departamento tramitador)
Por ejemplo: Si el tratamiento de la bandeja se va a realizar desde una aplicación sectorial, para recuperar los registros sin procesar se deberán consultar los eventos con el campo descargado (false). La aplicación sectorial debería almacenará estos registros y marcarlos con el campo descargado (true).
La respuesta de esta forma de invocación muestra el número de entradas devueltas con el elemento numero Registros. Si el numeroRegistros es mayor que de 999 quiere decir que la consulta ha recuperado más de 999 registros pero solo devolverá los 999 primeros.
Si el numeroRegistros es 1000, se debe entender que la consulta ha devuelto que con esos parámetros de consulta hay más de 999 registros pero solo se devuelven los 999 primeros.
En esta consulta simple únicamente devolverá los valores principales del evento:
CODIGO PROCEDIMIENTO: Código de procedimiento GSE
DEPARTAMENTO TRAMITADOR: Código del departamento que gestiona el evento. Es la codificación de GESPER. Es importante para los procedimientos comunes pues permite que cada departamento gestione los expedientes propios.
NUMERO EVENTO: Código secuencial unico para todo SANDRA. Se proporciona automáticamente cuando se crea el evento.
EVENTO: tipo de evento. Los eventos disponibles se pueden consultar en aquí
FECHA: La fecha y hora en la que se graba el evento.
FASE: Son estados temporales por los que pasan los distintos tipos de evento. En general con los estados finales se indica que los documentos ya están en el expediente. Las fases de los eventos se pueden consultar en aquí
ESTADO: Los estados de los eventos se pueden consultar en aquí
CLASE_DOCUMENTO: Se corresponde con el código del documento que sobre el que se informa. En el caso de una solicitud es el DI005, en el caso de la subsanación DI049 (viene en el XML de control).
NOMBRE NATURAL: Es la descripcion de la clase de documento.
REFERENCIA ORIGEN: Si el evento es del tipo 01-SOLICITUD este campo contiene Identificador único de 20 caracteres
alfanuméricos, generado por la aplicación sectorial. Según el tipo de evento puede contener distintas referencias.
NUMERO REGISTRO: Si la operación se ha registrado de entrada, incluye el número de registro. En otras operaciones notificaciones o comunicaciones incluye la referencia de la aplicación que lo ha gestionado.
NIF_INTERESADOS: En la presentación puede haber más de un interesado. Esta es la relación de los NIFS que aparecen en la solicitud.
FECHA EFECTOS: (sandra-suite-v1.0.22 PRO 16/07/2020). Este valor se incorpora a la bandeja de eventos e indica la fecha y hora en la que produce efecto el acto administrativo asociado al evento. El campo FECHA solo recoge la fecha en la que se graba el evento puede consultar ejemplos aquí
Ademas devolverá los siguientes campos:
- En el campo *interesadoID *o solo vendrán los NIFs de los interesados.
- tieneCertificados: True, indica que en esta solicitud se ha dado el consentimiento o no a una relación de certificados.
- tieneRepresentante: True, indica que esta solicitud/tramite tiene los datos representante.
- tieneComunicacion: True, indica que en esta que esta solicitud/tramite tiene los datos de comunicación / notificación con el interesado.
- tieneTasa: True, indica que en esta solicitud se ha generado una tasa.
- tienePago: True, indica que en esta solicitud se ha pagado la tasa.
La forma Detalle solo permite recuperar un registro de la bandeja de entrada, puesto que es necesario indicar el nº de evento, pero devuelve el detalle de cada uno de estos elementos.
La siguiente tabla muestra un resumen de la información que recoge la bandeja de entrada en las diferentes solicitudes o trámites.
datosInteresados
Contiene los datos de los interesados codificados en la solicitud.
El nodo está preparado para codificar Identificadores nacionales (NIF) u otros. También distingue las personas físicas o jurídicas.
datosCertificados
Contiene las referencias de los certificados definidos en DEXEL para este procedimiento, a los que el ciudadano ha dado consentimiento y a las que no. Actualmente en el presentador solo se permite dar el consentimiento a todos los certificados. No se puede hacer individualmente.
datosRepresentante
Indica la forma de representación y los datos del representante. Las formas de representación pueden ser:
- 01-CERTIFICADO DE REPRESENTANTE DE PERSONA JURÍDICA
- 02-REA
- 03-RFH
- 04-DOCUMENTO APORTADO
- 05-GESTIONADO APLICACION SECTORIAL.
Si la representación se ha acreditado con un documento, el elemento documento contiene la referencia del documento ENI presentado.
datosComunicacion
Indica la forma de comunicación seleccionada por el ciudadano y los detalles en función de la forma seleccionada. Las vías de comunicación son las siguientes:
- 01-NOTIFICACION POR COMPARECENCIA EN SEDE
- 02-NOTIFICACION POSTAL
- 03-NOTIFICACION POR DIRECCION ELECTRONICA HABILITADA
- 98-COMUNICACION ELECTRONICA
- 99-COMUNICACION POSTAL
datosTasa Contiene el detalle de la tasa generada.
datosPago
Contiene el detalle del pago generado
En caso de error:
En caso de error devuelve alguno de los errores indicados aquí