viafirma inbox :: manual de integración

prepareComposeRequestAdvanced

Prepara una petición y devuelve la dirección a la que tendremos que redireccionar. Una vez enviada la petición al WS, la aplicación tendrá que redireccionar a una ventana de navegador a la url proporcionada en la repuesta de la llamada donde se solicitará el certificado digital del usuario que envía la petición. Tras proporcionar dicho certificado, aparecerá la pantalla de redacción de peticiones con los datos ya cumplimentados (excepto el destinatario de la petición). Al pulsar el botón de “Enviar”, una vez enviada la petición, el usuario será redireccionado a la url de retorno proporcionada en la petición inicial.

A modo resumen, la secuencia de pasos a seguir son los siguientes:

  • Realizar una petición a prepareComposeRequestAdvanced pasando datos (firmante,fichero, etc.). En la respuesta viene una URL.
  • Hacer redirect a esa URL (salto). El usuario está en la pantalla de redacción de peticiones de firma, ya en la pantalla con datos precargados: el fichero, el asunto, etc.
  • Cuando el usuario envía la petición, Inbox responde a la URL de retorno pasada en la llamada del paso 1. En esa URL Inbox pasa por querystring los siguientes datos:
    • res= ok si todo ha ido bien o errores (peticionnoexiste, usercancel, errorviafirma, …)
    • message= (si hay error, mensaje de error)
    • label= ID de la petición creada (Ej. R032-ICG9-RDD0-KWHR )

Parámetros

  • senderPersonId (String) (Obligatorio): PersonId del usuario remitente de la petición (deberá ser el mismo que luego seleccione su certificado)
  • addresseePersonId (Obligatorio): PersonId del usuario destinatario de la petición (deberá ser el mismo que luego seleccione su certificado)
  • subject (String) (Obligatorio): Asunto del mensaje
  • message (String): Mensaje del mensaje
  • documentName (String) (Obligatorio): Nombre del documento enviado
  • documentContent (byte[]) (Obligatorio): Byte array del documento enviado
  • returnUrl (String): Url donde se redireccionará al usuario al enviar la petición
  • notificationUrl (String): Url donde se notificarán los cambios realizado en la nueva petición creada.
  • authSignType (AuthSignType): Plataforma empleada para realizar la firma

Respuesta

ComposeRequestResponseDTO

  • RedirectUrl: Url donde tendremos que redireccionar el navegador para que salte la pantalla de redacción de Viafirma Inbox.