Extender plazo de firma de un proceso caducado

Última revisión: 04 Noviembre 2022

Una solicitud estado EXPIRED no permite ser firmado pero podrás ampliar su plazo a través del método extendSignaturePeriod.

Method: PUT
Content-Type: application/json
Service: /api/v3/messages/extendSignaturePeriod

{
"messageCode": (required) string,
"expires": (required) timestamp milliseconds
}

Ejemplo:

{
"messageCode": "AAAA9999999999999R999",
"expires": 1652897955000
}

Response: "string" (messageCode ampliado)

Dónde se define la caducidad de la solicitud

Por defecto la fecha de caducidad se hereda de la siguiente configuración:

• definida en la request,
• en ausencia de la anterior, se usa la configuración definida en el grupo utilizado,
• en ausencia de la anterior, se usa la configuración definida en el API utilizada,
• en ausencia de la anterior, se usa la configuración general definida en el backend del sistema.

Caducidad definida en la request

La caducidad es OPCIONAL a la hora de crear una nuevo SET, pero si se desea definir una caducidad por defecto basta con incluir el atributo opcional EXPIRES, medido en timestamp milliseconds.

{
"groupCode": "{{groupCode}}",
  "workflow" : {
    "expires": 1652876355000
  },
  "document" : {
    "templateType": "url",
    "templateReference": "{{pdf_url_sample}}"
  },
  "policies" : [ {
    "signatures" : [ {
      "type" : "CLIENT",
      "recipientKey" : "signer1"
    } ]
  } ]
}

Caducidad definida en el Grupo

Entre las poropiedades del grupo de trabajo se permite definir una caducidad por defecto de las peticiones realizadas desde el panel web de Viafirma Documents, y también aquellas peticiones definidas por APIs que no tuvieran definidas una caducidad. Solo el adminitrador del grupo propietario de la API podrá acceder desde el panel web de Viafirma Documents para definir esta propiedad.

Caducidad definida en el API

Entre las propiedades de las credenciales del API se puede definir una fecha de caducidad por defecto de todas las peticiones, y se mide en minutos. Solo el adminitrador del grupo propietario de la API podrá acceder desde el panel web de Viafirma Documents para definir esta propiedad.