Viafirma Documents

Estado del proceso de firma

Revisión: 14-mayo-2019

Para conocer el estado de un proceso podrás consumir el servicio MESSAGES/STATUS tal y como te explicamos a continuación:

Type Service Format Security
GET /api/v3/messages/status application/json OAuth 1.0

Ejemplo GET status

GET api/v3/messages/status/{messageCode}

Donde messageCode corresponde al código que devuelto por viafirma para cada nueva solicitud de proceso de firma.

Respuesta

Tendrás una respuesta en formato json con el estado y hora de la última actualización, tal y como te explicamos a continuación:

{
  "status": "{string}",
  "lastUpdated": "{timestamp}"
}

Donde:

  • status: corresponde a uno de los valores posibles para cada tipo de proceso de firma. Los procesos podrán estar asociados a distintos workflows y por tanto no todos los valores de estados estarán disponibles. Los status válidos que permitirá saber si el documento ya ha sido firmado y, por tanto, permite ser descargado, son los siguientes: RESPONSED
  • lastUpdated: fecha y hora de la última actualización del proceso en formato milliseconds.

Errores

Los posibles errores serán devuelto en formato json:

{
    "code": "number",
    "type": "string",
    "message": "string"
}
Code Type Message Desc
111 Error Error al recuperar información temporal. No element found with code=1541350495399R63 El código de mensaje no existe o ya ha sido eliminado.

En esta otra guía te enseñamos cómo listar las PETICIONES relacionadas con un grupo