vinculaDocumentoEnExpediente

Un mismo documento electrónico puede pertenecer a distintos expedientes. Con SANDRA, los documentos se remiten mediante comunicación interior a otros procedimientos que los incorporan sus propios expedientes.

El documento es físicamente el mismo y no una copia que consume espacio de almacenamiento.

Sin embargo existían limitaciones cuando los expedientes que debían compartir el documento eran del mismo procedimiento. Esto no era posible y obligaba a duplicar físicamente el documento.

La operación vinculaDocumentoEnExpediente se ha diseñado inicialmente para poder incorporar el mismo documento DA a varios expedientes de un mismo procedimiento y departamento tramitador, sin necesidad de subir varias veces el documento, generando así distintos documentos ENI.

por ejemplo, el caso frecuente de una resolución que afecta a varios expedientes del mismo procedimiento.

Además, la operación también permite incorporar un documento DA (incluido o no en un expediente) a expedientes de otros procedimientos y departamentos tramitadores siempre y cuando la aplicación que realiza la llamada esté autorizada a todos ellos.

Con esta operación, se puede plantear que la comunicación interior es innecesaria entre los servicios que gestiona una misma aplicación sectorial, pues es la que propia aplicación la que orquesta la distribución de estos documentos en base a sus propias reglas de negocio. En cambio en los procedimientos administrativos será necesaria la comunicación interior aunque los procedimientos los gestione la misma aplicación, para dejar constancia en el expediente.

De igual forma, si no tiene permiso en el procedimiento/departamento tramitador de destino, por gestionarlo otro departamento y aplicación, no podrá realizarse la vinculación y la única forma posible será comunicando el documento al procedimiento de destino con la operación envioComunicacionInterior.

En la referencia origen del documento vinculado al expediente de destino, se indica con un ámbito nuevo, que es una "vinculación" adicional del documento. En esa referencia aparece separadas por comas, el procedimiento, departamento y referencia ENI del documento origen. De esta manera quede totalmente determinada la procedencia de la vinculación en el elemento referenciaOrigen del documento vinculado.

Parámetros de invocación

Las credenciales (aplicacion, apikey e idTransacción) y los parámetros codigoProcedimiento y departamentoTramitador son validados como se indica aquí

El parámetro referenciaDocumento, indica el documento origen, que debe pertenecer al procedimiento y departamento indicado anteriormente

Los parametros codigoProcedimientoDestino y departamentoTramitadorDestino se refieren a los del expediente de destino.

La referenciaExpediente indica la referencia del expediennte donde se incluirá el expediente y deberá pertenecer al procedimiento y departamento destino indicado anteriormente.

El parámetro carpeta permite indicar una carpeta donde se incorpora el documento, y si no existe, se crea. Si no se rellena la carpeta en la petición, el documento se vincula en la raíz del expediente destino.

Consideraciones sobre la duplicidad de documentos

El documento puede existir ya en el procedimiento de destino, incluso vinculado a otro expediente. Si es el caso, se creara una copia con sufijo como se indica en Documentos con instancias múltiples.

Ese sufijo no afecta al funcionamiento de las operaciones actuales.

Esta operación es idempotente. si se intenta vincular el mismo documento, al mismo expediente y carpeta en el que ya está vinculado, la operación devuelve los mismos datos que si se hubiera ejecutado en ese momento.

La respuesta devuelve la referencia del documento vinculado, con su eventual sufijo de nº ejemplar, y los datos del expediente, identificador/estado/version/fechaVersion.

En caso de que el documento esté ya vinculado en el expediente, pero en otra carpeta distinta a la que se quiere vincular, se devuelve el error controlado S-443 / "Ya existe el documento en el expediente, en la carpeta {valor_dinámico_hace_referencia_carpeta_ya_vinculado}".