Signatures

Los endpoints de Signatures te permiten gestionar las validaciones de firma de un documento y administrar firmas 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}/signature-validations

Update validations

Actualiza la configuración de validaciones de firma de un documento.

Request body

Name
signatureValidations
Type
object
Description
Objeto con las validaciones a actualizar.
Name
signatureValidations.autografa
Type
boolean
Description
Firma autógrafa. Default: true.
Name
signatureValidations.FEA
Type
boolean
Description
Firma Electrónica Avanzada. Default: false.
Name
signatureValidations.eIDAS
Type
boolean
Description
Validación eIDAS. Default: false.
Name
signatureValidations.nom151
Type
boolean
Description
NOM-151-SCFI. Default: false.
Name
signatureValidations.firmaBiometrica
Type
boolean
Description
Firma biométrica. Default: false.

Request

PATCH

/v2/documents/{id}/signature-validations

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

PATCH/v2/documents/{document_id}/signature-state

Update signature state

Actualiza el estado del flujo de firma de un documento.

Request body

Name
status
Type
string
Description
Nuevo estado. Valores posibles:
- SELLOS_PDF — Generando sellos PDF
- RECOLECTANDO_FIRMANTES — Recolectando firmantes
- ESPERANDO_FIRMAS — Esperando firmas
- GENERANDO_PDF — Generando PDF final
- TODOS_FIRMARON — Todas las firmas completadas

curl -X PATCH "https://api.allsign.io/v2/documents/DOC_UUID/signature-state" \
  -H "Authorization: Bearer ALLSIGN_LIVE_SK" \
  -H "Content-Type: application/json" \
  -d '{"status": "ESPERANDO_FIRMAS"}'

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

Delete signature

Elimina una firma y su registro de acceso asociado de un documento.

Path parameters

Name
document_id
Type
string
Description
ID del documento (UUID).
Name
signature_id
Type
string
Description
ID de la firma a eliminar (UUID).

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

Response (200)

{
  "success": true,
  "detail": "Signature and associated HasAccess record deleted successfully"
}