solicitaCertificado

[[TOC]]

Uso general

Esta operación se utiliza para solicitar certificados a través de la plataforma de interoperabilidad.

Parámetros de invocación

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

El campo peticionDeIntercambio incluye el XML que contiene la petición a interoperabilidad y que se debe construir conforme a lo que se indique en la plataforma de interoperabilidad

En caso de éxito

• El resultado que proporciona la plataforma de interoperabilidad está en el campo respuestaIntercambio (es la respuesta XML).

• A nivel de esquema XML, SANDRA devuelve en la respuestaIntercambio, como elemento raíz: getCertSatPDFResponse | getCertSatV3PDFResponse (para V2 | V3, respectivamente), envolviendo al elemento Respuesta2PDF (para V2) o RespuestaPDF (para V3).
• A nivel de implementación, es importante definir mapeo, tanto de datos genéricos y sobre todo de los datos específicos de la respuesta de certificado, que se puedan llevar al evento de la bandeja de entrada y/o al maestro de documentos.

• También devuelve el nº de evento generado que estará en fase: 02-COMPLETADO y estado: 01-PENDIENTE DE LEER

• Además a SANDRA se habrán incorporado dos documentos en el expediente indicado. Estos documentos son:

  • Un documento XML que contiene los datos obtenidos directamente de la plataforma de interoperabilidad. Este documento es que deben utilizar las aplicaciones sectoriales para el procesamiento automático de la respuesta. la clase de este documento es XCExxx (Xml del CErtificado)
  • Un documento PDF con CSV generado por la CARM y que refleja en un formato legible los datos del fichero XML. Este documento es legible para los gestores que pueden ver directamente el resultado del certificado. La clase de este documento es CExxx (certificado)

El evento que se genera tiene los siguientes valores:

• Tipo: 10-CERTIFICADO
• Fase: 02-COMPLETADA
• Estado: 01-PENDIENTE DE LEER
• Ambito: certificados
• Expediente: Expediente donde se han almacenado los documentos.
• Referencia Origen: Identificador de la petición obtenido en la llamada al método generarIdPeticion de emisionCertificadosSatWS.

En caso de error

NO se crea evento y devuelve un mensaje SOAP Fault, que debe trasladar, en la descripción del mismo, información significativa del error que devuelve la plataforma a Sandra. En todo caso se devolverá alguno de los errores indicados aquí