bandejaAltaEvento

• Introducción
• Uso general
• Parámetros de invocación
  • En caso de éxito
  • En caso de error

Introducción

Esta operación está reservada a las aplicaciones y operaciones EA (Registro Presencial, SIR, Presentador (SEDE), Sandra (comunicaciones interiores), Portafirmas, Dumas, Interoperabilidad, Notificaciones, etc). No obstante, se describe la operación brevemente.

Uso general

Permite dar de alta entradas en la bandeja de eventos a las aplicaciones EA que proporcionan operaciones de tramitación. El objeto de la bandeja de eventos es que las aplicaciones sectoriales tengan un único repositorio donde consultar todos los "eventos" que afectan a la tramitación de sus procedimientos.

Los distintos tipos de eventos que existen en la Bandeja están descritos aquí.

Al igual que en bandejaModificaEvento, si el evento incluye tasas, el estado y fase del evento se determina en función de las tasas y estado de los pagos. Para más detalle ver bandejaModificaEvento

(sandra-suite-v1.0.22 PRO 16/07/2020). En general, no es necesario indicar el expediente. Es obligatorio para los tipos de evento 07a-NOTIFICACION OBLIGADOS, 07b-NOTIFICACION VOLUNTARIOS y 07c-NOTIFICACION PAPEL, puesto que la notificación debe incorporarse al expediente desde el mismo momento de su emisión. En otros tipos de evento, por ejemplo de tipo 02-SOLICITUD SEDE ESPECIFICA, no es necesario puesto que no existe el expediente aún. En otros eventos, por ejemplo de tipo 05-TRAMITE GENÉRICO, puede venir indicado opcionalmente.

Parámetros de invocación

Las credenciales (aplicacion, apikey e idTransacción) y los parámetros codigoProcedimiento, departamentoTramitador son validados para asegurar de que se tratan de aplicaciones EA. Estas tienen acceso a cualquier procedimiento y departamento tramitador.

evento: Se indica alguno de los eventos admitidos según los definidos aquí.
claseDocumento: Indica la clase de documento principal que incorpora el evento, debe indicarse siempre.

Por ejemplo, en un evento de solicitud telemática o presencial, el documento principal puede ser un DI005 que corresponde al documento firmado por el ciudadano.

referenciaOrigen: se debe indicar una referencia única y propia de la aplicación que da alta el evento y que permita agrupar todos documentos implicados en la operación (por ejemplo, todos los documentos firmados en una misma operación del portafirmas). El atributo ambito debe identificar a la aplicación EA.

Si no se pasa el ámbito en la petición, SANDRA interpreta que el ámbito por defecto es sectorial. Los ámbitos admitidos actualmente son los siguientes:
(se pueden consultar con select * from DEL_AMBITO_REF_ORIGEN)

• certificados
• delfos
• eventos
• notificaciones
• portafirmas
• registr@-rm -> deprecated (ahora se usa sin la arroba)
• registro-rm
• sectorial

Los siguientes parámetros afectan en este momento únicamente a la solicitud/trámite telemático (realizado por el presentador). En algunos casos también son alimentados por eventos del registro presencial aunque este irá ampliando su funcionalidad para incorporar más datos. Mientras solo se pueden obtener de los propios documentos presentados.

Son los siguientes:

numeroRegisto: Si el evento corresponde a una operación que ha pasado por el registro.
datosInteresados: Se incorporan al evento los datos de lo interesados.
datosCertificados: Se indica para que certificados de interoperabilidad se ha dado consentimiento y para cuales no. datosRepresentación: Si el trámite lo realiza un representante se indica en estos campos.
datosComunicación: Se indica la forma de comunicación elegida por el interesado (postal o notificación electrónica) y otros datos relacionados según se trate (correo electrónico, sms, dirección postal).
datosTasa: Si la operación ha generado tasas, aquí se indican sus datos. También se incluyen aquí los datos de los pagos si estos se han realizado antes de la presentación (datosPago)

expediente: si la operación se refiere a un expediente ya existen en SANDRA (por ejemplo para trámites de subsananción)

expedienteExterno: si la operación se refiere a un expediente que no existe en SANDRA (por ejemplo para trámites de subsananción de expediente que aún se gestionen en papel)

En la versión 1.0.31 (21/09/2021) se ha añadido la fecha_efectos como nuevo parámetro para evitar que se tenga que añadir posteriormente con modificando el evento. El registro es el que usa esta funcionalidad.

En caso de éxito

La operación da de alta el evento.
Se devuelve

• procedimiento,
• departamento,
• el número de evento y
• la fecha en la que se graba (necesaria para las sincronizaciones).

El descargado se pone a false si es aplicación EA u ofimática la que hace el alta (en otro caso se pone a true).

En caso de error

En caso de error devuelve alguno de los errores indicados aquí