Signatures

Gestiona las validaciones de firma de un documento y administra firmantes individuales.

La información de firmas de un documento se devuelve como parte del campo signersData al consultar un documento. No necesitas llamar a un endpoint separado para ver el estado de las firmas.

Para modificar documentos activos (anular, agregar o eliminar firmantes), consulta los endpoints de Corrección.

PATCH/v2/documents/{document_id}

Update validations

Las validaciones de firma se actualizan mediante el endpoint general de actualización de documento. Incluye el campo signatureValidation en el body del PATCH /v2/documents/{document_id}.

Request body (campo relevante)

Name
signatureValidation
Type
object
Description
Objeto con las validaciones a actualizar.
Name
signatureValidation.autografa
Type
boolean
Description
Firma autógrafa. Default: true.
Name
signatureValidation.FEA
Type
boolean
Description
Firma Electrónica Avanzada. Default: false.
Name
signatureValidation.eIDAS
Type
boolean
Description
Validación eIDAS. Default: false.
Name
signatureValidation.nom151
Type
boolean
Description
NOM-151-SCFI. Default: false.
Name
signatureValidation.biometric_signature
Type
boolean
Description
Firma biométrica (selfie comparada contra ID). Default: false. Este es el nombre canónico del campo (el que aparece en el objeto signatureValidation del documento). Como input también se acepta el alias firmaBiometrica.

Request

PATCH

/v2/documents/{document_id}

curl -X PATCH "https://api.allsign.io/v2/documents/DOC_UUID" \
  -H "Authorization: Bearer ALLSIGN_LIVE_SK" \
  -H "Content-Type: application/json" \
  -d '{
    "signatureValidation": {
      "autografa": true,
      "nom151": true,
      "FEA": false
    }
  }'

DELETE/v2/documents/{document_id}/signers/{signature_id}

Delete signer

Elimina un firmante y su registro de acceso asociado de un documento. Consulta los endpoints de Corrección para el flujo completo de modificación de documentos activos.

Efectos en cascada: eliminar un firmante soft-elimina los roles que tenía asignados y deja sus variables como "Sin asignar". El response surface esos efectos en deletedRoleIds, unassignedVariableNames y vacatedRoleIds.

Response

Name
success
Type
boolean
Description
true si el firmante se eliminó correctamente.
Name
detail
Type
string
Description
Mensaje legible del resultado.
Name
deletedRoleIds
Type
array
Description
IDs de los roles soft-eliminados como consecuencia de quitar al firmante.
Name
unassignedVariableNames
Type
array
Description
Nombres de las variables que quedaron "Sin asignar" al liberar los roles.
Name
vacatedRoleIds
Type
array
Description
IDs de roles que quedaron vacantes (compatibilidad; hoy se emite como arreglo vacío).

Estos tres campos también se emiten en snake_case (deleted_role_ids, unassigned_variable_names, vacated_role_ids) por compatibilidad.

Path parameters

Name
document_id
Type
string
Description
ID del documento (UUID).
Name
signature_id
Type
string
Description
ID del firmante a eliminar (UUID).

curl -X DELETE "https://api.allsign.io/v2/documents/DOC_UUID/signers/SIG_UUID" \
  -H "Authorization: Bearer ALLSIGN_LIVE_SK"

Response (200)

{
  "success": true,
  "detail": "Firmante eliminado correctamente",
  "deletedRoleIds": [],
  "unassignedVariableNames": [],
  "vacatedRoleIds": []
}