viafirma inbox :: manual de integración

prepareWorkflowRequest

Prepara una petición y devuelve la dirección a la que tendremos que redireccionar. Una vez enviada la petición, 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. Una vez proporcionado dicho certificado, aparecerá la pantalla de redacción de peticiones con los datos ya cumplimentados junto con los destinatarios a los que se enviará la petición (en función del workflow seleccionado). 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:

  1. Realizar una petición a prepareWorkflowRequest pasando datos (firmante,fichero, etc.). También debemos indicar el publicAccessId del workflow que queremos utilizar en la petición. En la respuesta viene una URL. Manual de Integración :: viafirma inbox Página 23 de 34
  2. Hacer redirect a esa URL (salto). El usuario será reenviado a la pantalla de redacción de peticiones con todos los datos precargados, incluso los datos de los destinatarios que serán aquellos usuarios que pertenezcan al flujo seleccionado.
  3. Cuando el usuario pulse el botón de envío de 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 (prticionnoexiste, usercancel, errorviafirma, …)
    • message= (si hay error, mensaje de error)
    • label= ID de la petición creada (Ej. R032-ICG9-RDD0-KWHR )

Parámetros

  • personId (String) (Obligatorio): PersonId del usuario remitente de la petición (deberá ser el mismo que luego seleccione su certificado)
  • documentName (String) (Obligatorio): Nombre del documento enviado
  • documentContent (byte[]) (Obligatorio): Byte array del documento enviado
  • workflowId (String) (Obligatorio): Identificador público del workflow seleccionado
  • 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.

Respuesta

WorkflowRequestResponseDTO

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