obtenDocumento

[[TOC]]

Uso general

La operación obtén documento se utiliza para recuperar el documento firmado o no, en su formato original. Si el documento no esta firmado devolverá el documento en cualquiera de los formatos ENI admitidos, con el que se dio de alta en SANDRA. [Ver formatos y tamaños de documentos admitidos](/Formatos y tamaños de documentos admitidos)

Si el documento esta firmado devuelve el documento según el formato de firma usado. Solo si el formato de firma es PAdES el documento es legible. Actualmente las aplicaciones corporativas utilizan los formatos de firma siguientes:

• Registro presencial (PAdES) para la digitalización certificada. Contiene la copia autentica.El original es legible
• Presentador (PAdES). Contiene la copia autentica. El original es legible
• Portafirmas (XAdES). Original y copia autentica son documentos separados. El original no es legible
• Dumas(XAdES). Original y copia autentica son documentos separados. El original no es legible

En cualquier caso se puede obtener la visualización ENI del documento con el servicio visualizaDocumento. Este servicio, con independencia del formato de firma o del formato original del documento, devuelve siempre un documento PDF con los metadatos del documento y el documento.

Está en estudio la creación de un servicio obtenContenidoDocumento, que independientemente de si el documento está o no firmado, devuelve siempre el contenido en el formato original del documento.

Parámetros de invocación

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

la referenciaDocumentoOrigen contiene la referencia del documento ENI que se quiere recuperar. Lógicamente se comprueba que pertenece al departamento y procedimiento tramitador y que la aplicación tiene autorización a dicho procedimiento/departamento.

En caso de éxito

Se indica que la operación se ha realizado con éxito. Devuelve la referencia el documento ENI

En caso de error

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