envioComunicacionInterior
[[TOC]]
Esta operación se utiliza para el envió fehaciente de documentos entre los departamentos internos de la CARM. Estas comunicaciones interiores se realizan desde un departamento origen en el ámbito de un procedimiento concreto (o servicio), y se dirigen a un departamento destino también en el marco de un procedimiento concreto (o servicio).
Los posibles orígenes y destinos son los procedimientos / departamentos tramitadores definidos en DEXEL y que en SANDRA disponen de espacios particulares donde se almacenan y custodian los expedientes de ese tipo.
En general, los procedimientos (o servicios) de estos departamento destino estarán definidos en DEXEL como procedimientos (o servicios) internos.
Los documentos y los anexos a comunicar deben estar incorporados en un expediente de dicho procedimiento para garantizar su inalterabilidad:
- documento principal: Es el documento que se quiere comunicar. Dado que se dirige directamente a un procedimiento concreto (o servicio) del destinatario, se entiende que ese es el asunto de la comunicación. Puede ser una petición de informe, una solicitud de ampliación de crédito, un petición de registro de documentos, etc.. No es necesaria elaborar una diligencia de comunicación para indicar los documentos que se remiten ya que se genera de forma automática y se almacena en el expediente como justificante de la comunicación interior.
- anexos: Son documentos adicionales que están en el mismo expediente que el principal y que están asociados a la comunicación.
En ese mismo expediente donde están los documentos que se comunican, es donde se almancenan los documentos que genera SANDRA automáticamente.
Estos son los siguientes:
- el justificante de la comunicación interior que indica que documentos del expediente han sido comunicados. La clase de documento es EDAxxx (donde DAxxx es la clase del documento principal comunicado)
- el acuse de recepción de dichos documentos, por parte del destinatario que acepta la entrega. Su clase de documento es CDAxxx (donde DAxxx es la clase del documento principal comunicado).
- el acuse de rechazo de dichos documentos cuando el destinatario considera que es un error su remisión.Su clase de documento es ZDAxxx (donde DAxxx es la clase del documento principal comunicado).
Ejemplo del Justificante comunicación interior EDAxxx
Ejemplo de acuse de recepción CDAxxx
Ejemplo de acuse de rechazo ZDAxxx
La comunicación se realiza con el método envioComunicacionInterior.
Las credenciales (aplicacion, apikey e idTransacción) y los parámetros codigoProcedimiento, departamentoTramitador y referenciaExpediente son validados como se indica aquí
También se comprueba que existen los documentos principales (referenciaDocumento) y anexos (referenciaAnexos) en el expediente (referenciaExpediente).
Si todas las comprobaciones son correctas:
-
Se genera un evento de salida 11-CI-SALIDA en la bandeja de eventos del origen al que estará vinculado el justificante de envío- Este documento lleva en el propio PDF la referencia de todos los documentos que se comunican. La fase inicial del evento es 07-COMUNICACION ENVIADA.
-
Se genera un evento de entrada 12-CI-ENTRADA en la bandeja de eventos del destino al que estarán vinculados todos los documentos recibidos.
El receptor puede revisar los documentos asociados al evento de entrada y marcar la comunicación como leída o rechazada, lo que modifica la fase del evento origen a 08-COMUNICACIÓN LEÍDA O 09-COMUNICACIÓN RECHAZADA y genera los acuses de recibo o rechazo correspondientes.
Desde las aplicaciones se modifica el estado de la bandeja con el procedimiento bandejaCambiaEstadoEvento lo que en este caso también generará el acuse de recibo o rechazo para el emisor.
El destinatario puede tratar esta entrada como cualquier evento de solicitud y crear un expediente o incorporarlo a uno ya existente (con la operación generaExpedienteSolicitud).
Los documentos recibidos a todos los efectos ya pertenecen al procedimiento de destino y son accesibles por cualquier aplicación o usuario autorizado a ese procedimiento / departamento tramitador. Tanto en el origen como en el destino el documento es el mismo y tiene la misma referencia ENI.
En el ámbito de determinados procedimientos el emisor y receptor pueden acordar que en la comunicación se incorporen algunos datos estructurados que faciliten la mecanización por parte del receptor.
Para ello, existe en la operación un campo item que es una secuencia de elementos clave/valor y que permiten el traspaso de los datos acordados.
Por ejemplo, se podría acordar entre un organismo y la DG de presupuestos que junto con una solicitud de modificación de crédito, ademas de los documentos correspondientes, se adjuntara un campo con clave = XML y valor = BASE64(de un XML en con los datos de la partidas / proyectos e importes a modificar). Esto abre la puerta a que los destinatarios elaboren formularios para las solicitudes internas y que además sean capaces de incorporar la información tabulada que sea legible para la aplicación del destinatario.
Cuando se trate de una comunicación interior que responde a una comunicación interior previa, es posible indicar el nº evento de la comunicación a la que se está respondiendo. El emisor original, que ahora es receptor, recibirá un nuevo evento 12-CI-ENTRADA con los documentos que se le hayan remitido y además aparecerá indicado el expediente al que se refiere la comunicación (es el mismo desde el que se hizo la comunicación original).
Debe quedar claro que un expediente en evento de tipo 12-CI-ENTRADA es solo para facilitarle la información al gestor, que será el responsable de llevar los documentos al expediente, desde DELFOS o a través de la operación generaExpedienteSolicitud.
Se indica que la operación se ha realizado con éxito. En caso de error devuelve alguno de los errores indicados aquí
- La operación ya devuelve el nº de evento cuando la comunicación termina correctamente. Esto permite que las aplicaciones puedan controlar las comunicaciones realizadas asociándolas a su gestión. Issue #86
Con la implantación de [Documentos con instancias múltiples](Documentos con instancias múltiples) ahora es posible comunicar los documentos a otros procedimientos/departamentos aunque ya se hubieran comunicado antes.
- En los acuses de envió se mostrará la referencia ENI de los documentos con el sufijo de copia relativo al procedimiento/departamento origen.
- En los acuses de recepción se mostrará la referencia ENI de los documentos con el sufijo de copia relativo al procedimiento/departamento destino.
Obsérvese que los documentos con la misma referencia ENI en el acuse de envio y recepción pueden tener distintos números de copia.