Ejecuta una firma real automática SHA-512/CAdES. Requiere usuario activo asociado a la empresa, una sola cuenta con ese nombre, un único certificado vigente, válido, enrolado y autorizado, y una rúbrica disponible en PNG/JPG compatible. La selección cuenta únicamente certificados personales vigentes, válidos, enrolados y autorizados para el usuario, tenant y empresa. Los vencidos, futuros, revocados o no habilitados no cuentan. Si queda exactamente uno se utiliza; si quedan varios se rechaza la ambigüedad. Se aplica exclusivamente la rúbrica propia de eSignSoft resuelta con usp_GetEstiloFirmas_Esign; no se sustituye por una rúbrica empresarial o personal de eCoTek. No acepta PDF cifrado, ya firmado ni páginas con rotación sin normalizar. Las posiciones se expresan desde la esquina superior izquierda. Las notificaciones se encolan después de verificar y persistir la firma: Para/CC se respetan y el PDF se adjunta. Un fallo de correo no repite la firma. Reenviar el cuerpo idéntico y el mismo idOperacion devuelve el resultado persistido; no crear UUID nuevos ante una desconexión. Límite: 20 solicitudes por minuto por IP. aparienciaFirma permite imagenTexto, soloImagen o soloTexto (predeterminado soloImagen); los datos de texto proceden del usuario y certificado en servidor, nunca de texto libre del consumidor. Solo texto no necesita imagen de rúbrica. En notificaciones, tipo es to o cc.
Solicitud
Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros de ruta
Parámetros del Body application/jsonRequerido
Ejemplos
{"idOperacion":"d658873c-9fa4-4b81-bc9a-d5fc10a33098","usuario":"44878327","pdfBase64":"REEMPLAZAR_POR_BASE64_CANONICO_DEL_PDF","posicionesRubrica":[{"pagina":1,"x":40,"y":40,"ancho":150,"alto":60}],"enviarNotificaciones":true,"notificaciones":[{"correoElectronico":"destinatario@example.com","nombre":"Destinatario de prueba","tipo":"to"},{"correoElectronico":"copia@example.com","nombre":"Responsable con copia","tipo":"cc"}],"aparienciaFirma":"imagenTexto"}
PDF firmado y verificado. Puede ser el resultado de una operación anterior idéntica; nunca implica una segunda firma.
Encabezados
Bodyapplication/json
Ejemplo
{"idOperacion":"d658873c-9fa4-4b81-bc9a-d5fc10a33098","estado":"Completado","pdfFirmadoBase64":"BASE64_DEL_PDF_FIRMADO","huellaSha256":"BBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBBB","estadoNotificacion":"Pendiente","exito":true,"mensaje":"El PDF se firmó correctamente. Las notificaciones están pendientes de envío; no es necesario volver a firmar.","nombreArchivoSugerido":"documento-firmado-d658873c9fa44b81bc9ad5fc10a33098.pdf"}