Extender plazo de firma de un SET caducado

Última revisión: 18 Mayo 2022

Un SET 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/set/extendSignaturePeriod

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

Ejemplo:

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

Response: "string" (setCode ampliado)

Dónde se define la caducidad del SET

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}}",
"title" :     "Título de mi SET",
"description" : "descripción de mi SET",
"expires": 1652876355000,
"recipients": [
    {
      "key": "signer1",
      "presential" : true
    }
  ],
  "messages" : [{
        "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.