altaDocumentoOriginal
[[TOC]]
Esta operación se utiliza para dar de alta documentos originales.
Dichos documentos deben estar firmados con PAdES o XADES con un certificado valido y activo. En ENI este documento tiene el estado de elaboración EE01 original.
En caso de de que el documento sea un PAdES y en el PDF incluya la copia autentica imprimible (con firmante y CSV), se deberá pasar indicar también el parámetro CSV en el alta del documento.
La copia autentica imprimible debe hacer constar que es copia autentica del documento original que está almacenado en SANDRA.
Esto es necesario en contraposición con el
altadocumentoDigitalizado, que es similar aaltaDocumentoOriginal, en cuanto a requisitos de firma, pero que deja el documento con el estado de elaboración EE03 copia autentica de documento papel. En ese caso el pdf puede contener la diligencia de digitalización en la que se indique que es copia autentica del documento papel.
(sandra-suite-v1.0.22 PRO 16/07/2020). Se permite la incorporación de documentos firmados con CSV. En este caso en el documento en el documento debe aparecer que el documento está firmado con CSV (y el CSV). En la llamada al servicio habrá que indicar el CSV con el que se firmó el documento.
El uso de este servicio esta restringido a las aplicaciones EA.
Pueden usarlo las aplicaciones sectoriales para lo indicado en el apartado uso desde el presentador
Para dar de alta un documento original se requiere un documento firmado. Si el documento que se quiere incorporar al expediente no está firmado, pero se desea incorporarlo después de la firma de un funcionario, lo mas practico es usar el servicio firmaDocumentos o firmaIncorporaAExpediente y no usar este servicio.
- Si la aplicación se envía el documento a portafirmas (con el servicio antiguo) y recupera el original desde la propia aplicación se debe usar
firmaDocumentoofirmaIncorporaAExpediente - Si desde la aplicación se ha firmado un documento con DUMAS que devuelve el documento original y es la aplicación la que lo da de alta en el expediente. El nuevo desarrollo firma con sello (en la plataforma EVA) permitirá indicar el expediente donde almacenar el documento firmado. Mientras se aconseja subir la copia autentica con altadocumentoOtros o una copia firmada con altaDocumentoDigitalizado
Las credenciales (aplicacion, apikey e idTransacción) y los parámetros codigoProcedimiento, departamentoTramitador y clase de documento son validados como se indica [aquí](/Credenciales y Validación)
En este caso hay que indicar el expediente (parámetro referenciaExpediente) y opcionalmente la carpeta (parámetro carpeta).
En el parámetro referenciaOrigen se debe indicar una referencia única y propia de la aplicación que da alta y que permita agrupar todos documento que se están dando de alta en la misma presentación (por ejemplo, la referencia de la solicitud).
El parametro sufijoNombreNatural sirve para añadir un texto al "nombre natural" del documento. El nombre natural es un metadato obligatorio ENI, que se obtiene de la clase de documento definida en DEXEL.
Por ejemplo: si el documento que se da de alta es un DA036, el nombre natural por defecto es "Informe". Se puede añadir el sufijoNombreNatural " de fiscalización" (SANDRA no añade el espacio por defecto al concatenar, por si se quieren añadir signos de puntuación, por ejemplo). El nombre natural que se incorporara al documento y que verá el gestor en el expediente será "Informe de fiscalizacion". También en expedientes con pluralidad de interesados, se puede utilizar para facilitar la identificación visual en el expediente de los documentos que solo afecten a alguno de ellos, añadiendo el nombre o nif como sufijo del nombre natural.
En el parámetro csv es necesario incorporarlo solo en el caso de que la imagen del documento incorpore la copia autentica de documento original o cuando el documento esté firmado únicamente con CSV. De esta forma podrá ser verificado en sede. Habitualmente este parámetro solo lo utilizarán las herramientas de firma que den de alta en SANDRA los documentos firmados (portafirmas, DUMAS, Registro y presentador).
En el parámetro fichero se indica el documento PDF en base64. Este parámetro tiene dos atributos:
- nombreFormato: No es necesario indicarlo en las peticiones. Este atributo solo se devuelve en las respuestas con el formato detectado por SANDRA. El formato devuelto será necesariamente uno de los admitidos (PDF, JPG, JPEG, PNG, TIF, DOC, DOCX, XLS, XLSX, RTF, TXT, XML, ODT, ODS, ODP, ODG)
- nombreFichero: Se debe indicar el nombre del fichero y debe incluir su extensión (p.e. Memoria_Proyecto_23423-2019.DOCX)
El nombre del fichero y su extensión puede consultarse a través de la operación de consultaDocumentos en el campo nombre documento.
Los parametros XML clave-valor que utiliza el servicio son de uso interno. Actualmente solo se utiliza un único parámetro XML denominado eA_referenciaEa. Sirve para guardar el identificador en Portafirmas de documentos que se dan de alta como originales desde la integración con Portafirmas (esto no afecta a las aplicaciones sectoriales.). Este parámetro se guarda:
- En INSIDE como metadato adicional ReferenciaEa del documento.
- En el maestro de documentos, DEL_MAESTRO_DOCUMENTOS.referencia_ea
- Se devuelve en la consulta del documento
Devuelve la referencia del documento ENI (campo identificador) y opcionalmente el CSV
En caso de error devuelve alguno de los errores indicados aquí
En casos excepcionales, se puede requerir la presentación de documentos originales. Si la presentación es electrónica, estos documentos deberán estar firmados con un formato valido para el ENI y con un certificado reconocido en vigor. Estas comprobaciones son las que realiza altaDocumentoOriginal.
En este caso, se permite el uso de altaDocumentoOriginal desde los formularios especificos. Como el resto de los documentos que trata el formulario, los documentos son DI (documentos del interesado) o AN (anexos) que quedan en **Presandra **a la espera que se complete la presentación y no es necesario indicar el expediente. En estos documentos el metadato origen es ciudadano, que es lo que obliga a que estos documentos queden en preSandra.
El uso normal para las aplicaciones sectoriales es para dar de alta documentos DA (origen es administración) dándose de alta directamente en SANDRA, y por tanto, sería obligatorio indicar un expediente ya existente en SANDRA.
Este uso aún no esta activado. En DEXEL, cuando se asocian los anexos a un procedimiento, se puede indicar si se requiere que estos anexos sean o no originales. Actualmente, esa indicación no tiene ningún efecto en la presentación telemática (a través del presentador) que da de alta todos los anexos como "otros" (EE99) con altaDocumentoOtros.
Cuando se active ese uso, el presentador dará de alta estos documentos como originales (EE01) con altaDocumentoOriginal, devolviendo un error en el caso de que los documentos no estén firmados electrónicamente o sean incorrectos.
