Appearance
Aceptar y validar firma completada
POST
/document/{document-id}/signature-scan/{signature-id}/accept
Acepta y valida una firma que ha sido completada por el firmante. Este endpoint finaliza el proceso de firma y confirma que la firma es válida para su uso legal y comercial.
Authorizations
bearerAuth
JWT token de autenticación. Utilice este esquema para autenticar solicitudes con un token JWT.
TypeHTTP (bearer)
Parameters
Path Parameters
document-id*
ID único del documento
Typestring
RequiredExample
123e4567-e89b-12d3-a456-426614174000format
uuidsignature-id*
ID único del escaneo de firma
Typestring
RequiredExample
789f0123-4567-89ab-cdef-012345678901format
uuidRequest Body
application/json
JSON
{
"acceptanceDecision": "string",
"validationCriteria": {
"qualityCheck": true,
"biometricValidation": true,
"identityVerification": true,
"legalCompliance": true,
"timestampValidation": true
},
"acceptanceDetails": {
"acceptedBy": "456b7890-c123-45d6-e789-012345678901",
"acceptanceReason": "Firma cumple con todos los criterios de calidad y validación requeridos",
"reviewNotes": "Firma clara, datos biométricos consistentes, identidad verificada exitosamente",
"organizationRole": "credit_manager",
"delegatedAuthority": false
},
"rejectionDetails": {
"rejectionReason": "string",
"rejectionNotes": "La firma presenta trazos incompletos y presión inconsistente",
"allowRetry": true,
"suggestedCorrections": [
[
"Firmar con mayor presión",
"Completar todos los trazos",
"Utilizar un dispositivo con mejor resolución"
]
]
},
"correctionRequest": {
"correctionType": "string",
"specificRequests": [
{
"fieldId": "signature_field_1",
"requiredAction": "Mejorar calidad de la firma",
"instructions": "Por favor, firme con trazos más firmes y continuos"
}
],
"deadline": "2024-01-16T16:30:00Z",
"notifySignerByEmail": true,
"notifySignerBySMS": true
},
"postAcceptanceActions": {
"generateCertificate": true,
"sendConfirmationToSigner": true,
"notifyOrganization": true,
"triggerWorkflow": "credit_approval_workflow",
"archiveDocument": true,
"createAuditReport": true
},
"metadata": {
"reviewSessionId": "review-session-123456",
"complianceReference": "COMPLIANCE-2024-001",
"businessContext": "Proceso de aprobación de crédito para cliente premium",
"riskLevel": "string"
}
}
Responses
Firma aceptada exitosamente
application/json
JSON
{
"success": true,
"message": "Firma aceptada y validada exitosamente",
"data": {
"signatureScanId": "789f0123-4567-89ab-cdef-012345678901",
"documentId": "123e4567-e89b-12d3-a456-426614174000",
"acceptanceStatus": "string",
"validationResults": {
"overall": "string",
"qualityScore": 95.8,
"validationChecks": {
"qualityCheck": {
"passed": true,
"score": 95.8,
"details": "Firma clara con trazos bien definidos"
},
"biometricValidation": {
"passed": true,
"confidence": 0.98,
"details": "Patrones biométricos consistentes"
},
"identityVerification": {
"passed": true,
"confidence": 0.99,
"details": "Identidad verificada exitosamente"
},
"legalCompliance": {
"passed": true,
"details": "Cumple con regulaciones de firma electrónica"
},
"timestampValidation": {
"passed": true,
"timestamp": "2024-01-15T16:45:30Z",
"details": "Marca de tiempo válida y verificada"
}
}
},
"certificateInfo": {
"certificateId": "123e4567-e89b-12d3-a456-426614174000",
"certificateUrl": "https://api.kuenta.co/certificates/cert-123e4567-e89b-12d3-a456-426614174000/download",
"validityPeriod": {
"validFrom": "2024-01-15T16:46:00Z",
"validUntil": "2029-01-15T16:46:00Z"
},
"issuer": "Kuenta Digital Signatures CA"
},
"postAcceptanceResults": {
"notificationsSent": [
{
"method": "email",
"status": "sent",
"sentAt": "2024-01-15T16:47:00Z"
}
],
"workflowTriggered": {
"workflowId": "credit_approval_workflow",
"status": "triggered",
"triggeredAt": "2024-01-15T16:47:30Z"
},
"auditReportCreated": {
"reportId": "audit-report-789f0123",
"reportUrl": "https://api.kuenta.co/audit-reports/audit-report-789f0123/download",
"createdAt": "2024-01-15T16:48:00Z"
}
},
"timestamps": {
"acceptedAt": "2024-01-15T16:46:00Z",
"processedAt": "2024-01-15T16:48:00Z"
}
}
}