1. APICore10
Esigtek
  • eSigTek
    • Factory APIs
      • APICore10
        • Autenticar empresa y obtener token JWT
          POST
        • Firmar PDF con certificado y rúbrica del usuario
          POST
        • Obtener rúbrica de usuario en Base64 y metadatos de archivo
          POST
      • Login Externo
        GET
      • Firma Digital ElRemanso
        POST
      • Firma Digital ElRemanso Consulta
        GET
      • Solicitud Firma Electrónica CROSLAND
        POST
      • Consulta Firma Electronica CROSLAND
        GET
      • Firma Digital AU - Demo
        POST
      • Carga Masiva Trabajador G4S
        POST
      • Carga Masiva Sucursal G4S
        POST
      • Carga Documento Amazon S3
        POST
      • Consulta DNI
        GET
      • Consulta RUC
        GET
      • Firma Digital MEDIPERU
        POST
      • Firma Digital AU - eBIZ
        POST
      • SignatureDetails
        GET
    • Integración DELOSI
      • Upload Documento
      • Importar Trabajadores
      • Autenticacion Delosi
    • Integración Genérica
      • Upload Documento
      • Importar Trabajadores
      • Autenticacion
    • Factory EMEMSA
      • Crear Documento
      • Documento by NroDocumento
      • Procesar Excel Data - eFormats
    • Bajas Activos DELOSI
      • Autenticacion
      • Creación Documento Baja Activos
    • Minsur
      • Authenticate
      • Documentos Mensuales
      • Crear Background Job
      • Get Background Job By GUID
    • Utils
      • Verify email deliverability
      • Forzar validación manual
      • Validación Masiva email
    • Seguimiento Baja Activos
      GET
    • Consulta de DNI
      GET
    • Autenticacion
      POST
    • GetTemplateById
      POST
  • MovilAPP
    • Login
    • GetDashboard
    • GetFirmaById
    • SetFirmaById
    • GetLegajos
    • GetDocumentos
    • Firmar Documento
    • GetLegajoTipoDocumental
    • GetTipoBandeja
    • uploadLegajos
    • UpdateComunicado
    • GetComunicados
    • SetUsuarioToken
    • RejectDocumento
    • DeleteLegajoById
    • GetUrl
    • GetLegajos
    • FirmarDocumento
    • GetDashboard
    • Authenticate
    • GetFirmaById
    • SetFirmaById
    • UploadFirma
    • UploadFoto
    • UpdateTrabajador
    • UpdatePassword
    • GetEmpresaPorUsuario
    • GetDocumentoPorId
    • GetDocumentos
    • GetUsuarioById
    • Login
  • Raíz
  • Schemas
    • Sample Schemas
      • Pet
      • Category
      • Tag
    • AutenticacionEmpresa
    • TokenEmpresa
    • PosicionRubrica
    • NotificacionFirma
    • SolicitudFirmaPdf
    • ResultadoFirmaPdf
    • ConsultaRubricaUsuario
    • RubricaUsuario
    • ErrorIntegracion
  1. APICore10

Firmar PDF con certificado y rúbrica del usuario

Prod Env
https://prod.your-api-server.com
Prod Env
https://prod.your-api-server.com
POST
/api/integrations/{pathEmpresa}/pdf-signing/sign
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"
}

Ejemplos de solicitud

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://prod.your-api-server.com/api/integrations/esigtek/pdf-signing/sign' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "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"
}'

Respuestas

🟢200
application/json
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"
}
🟠400
🟠401
🟠403
🟠404
🟠409
🟠413
🟠429
🔴503
Modificado en 2026-11-20 12:44:53
Anterior
Autenticar empresa y obtener token JWT
Siguiente
Obtener rúbrica de usuario en Base64 y metadatos de archivo
Built with