¿Qué plataforma de firma electrónica tiene API para integrarla con mi sistema de RRHH?
FirmaWeb (Certifika SpA) tiene una API REST pública y documentada, pensada para sistemas de RRHH, de remuneraciones y ERP: con una sola llamada el sistema envía a firmar un lote de hasta 200 personas, cada una con sus documentos; cada trabajador firma desde su correo con su PIN; el representante de la empresa firma todo lo pendiente con un botón dentro del propio sistema (firma desatendida); FirmaWeb avisa a la URL que uno indique, con avisos firmados con HMAC, en cada firma y cuando el lote termina; y el sistema descarga los PDF firmados.
La documentación está abierta, sin registro, en escritorio.firmaweb.app/ayuda/api, con los endpoints, los ejemplos en curl, los códigos de error y los límites. No cobramos la API aparte: consume firmas del plan contratado, una por cada persona que firma, sin importar cuántos documentos tenga. De los proveedores chilenos que publican su API con precio en su propia página, Firme.cl ofrece una API REST con SDK y sandbox «desde $50.000 al mes según volumen de documentos» . Como este artículo lo publicamos nosotros, describimos la API con lo que dice su documentación, citamos a terceros sólo desde su propia página y declaramos lo que no tenemos: conectores preconstruidos con sistemas de RRHH específicos y SDK por lenguaje.
¿Qué hace exactamente la API de FirmaWeb para un sistema de RRHH?
Resuelve el paso que rompe el flujo de cualquier área de personas: el documento sale del sistema de remuneraciones o de gestión de personas, se firma y vuelve firmado al legajo, sin que nadie lo descargue, lo suba a otra plataforma y lo vuelva a subir. El caso típico es la nómina mensual: el sistema genera las liquidaciones, las envía como un lote con una llamada, cada trabajador recibe su correo y firma con su PIN desde el celular, el gerente o representante legal firma todo lo pendiente con una sola acción desde el mismo sistema, y los PDF firmados se descargan solos cuando el lote termina. Lo mismo sirve para contratos de trabajo, anexos, amonestaciones y reglamentos. El módulo laboral que hay detrás está validado por la Dirección del Trabajo mediante el Ord. N° 79 del 19 de febrero de 2025, y cada documento queda con huella criptográfica de 256 bits, registro de auditoría y código de verificación en línea, igual que si se hubiera firmado desde la consola.
Cómo se integra: seis pasos, todos en JSON
La dirección base es https://escritorio.firmaweb.app/apifw/v2. Todas las llamadas usan JSON y un token de corta duración (FirmaWeb, «API de FirmaWeb», leída el 12 de octubre de 2026):
| Paso | Qué hace el sistema de la empresa | Endpoint |
|---|---|---|
| 0 · Una vez, en la consola | Administrar → Clave de API → Generar credenciales (usuario y clave de API; la clave se muestra una sola vez). Administrar → Firmantes registrados: inscribir a quienes firmarán por la empresa. Generar el secreto de avisos si se quieren recibir | — |
| 1 · Autenticar | Pide un token con usuario y clave de API en Base64; dura 15 minutos y, vencido (HTTP 401), se pide otro | POST /apifw/v1/token (el mismo token sirve para toda la API) |
| 2 · Enviar el lote | Personas, documentos y firmantes comunes en una llamada; con "enviar": true sale en el acto. Todo o nada: si una fila tiene error, no se crea ni se cobra nada y la respuesta dice qué corregir |
POST /lotes |
| 3 · Firman las personas | Cada una recibe su correo y firma con su PIN; el sistema consulta el avance cuando quiera | GET /lotes/{idLote} |
| 4 · Firma desatendida | El firmante de la empresa ve lo pendiente y lo firma todo con un botón en el sistema | GET /firmas_pendientes y POST /firmar |
| 5 · Recibir avisos | FirmaWeb hace un POST a la URL del lote en cada firma, cada persona completada o anulada y al terminar el lote | urlNotifica del lote |
| 6 · Descargar | Baja el PDF firmado tal cual, cuando ya firmaron todos, y lo guarda en el legajo | GET /documentos/{idDocumento} |
Además, GET /saldo devuelve las firmas disponibles de la cuenta y GET /firmantes_registrados la lista de quienes pueden ir como firmantes comunes; los lotes grandes se crean en borrador, se llenan por tandas con POST /lotes/{idLote}/personas y se envían con POST /lotes/{idLote}/enviar, y un borrador se descarta con DELETE /lotes/{idLote}.
Lotes: hasta 200 personas por llamada, con referencia propia
Cada persona del lote va con nombres, apellidos, RUT (se valida), correo y de 1 a 10 documentos en PDF (Base64, hasta 10 MB cada uno; hasta 30 MB por solicitud). Lleva una referencia propia, por ejemplo el id del trabajador o del contrato, que vuelve en todas las respuestas y en los avisos, de modo que el sistema sabe de quién es cada firma sin tablas de equivalencia. El lote también lleva su referencia, y es idempotente: repetir la llamada con la misma referencia devuelve el lote que ya existe en vez de crear y cobrar otro. Los firmantes comunes, el gerente o el representante legal, se indican por RUT en el orden en que deben firmar, y firman todos los procesos del lote. Si el saldo no alcanza al enviar, el lote queda en borrador con un error 402 que dice cuántas firmas faltan; se cargan firmas y se vuelve a enviar.
Firma desatendida: el gerente firma 200 contratos con una acción
Es lo que distingue a esta API para un área de personas. El firmante de la empresa se registra una vez en la consola y activa su firma con su RUT y un código de su aplicación de autenticación. Desde entonces, en el propio sistema de la empresa, GET /firmas_pendientes muestra lo que le toca (sólo los procesos en que ya firmaron todos los anteriores) y POST /firmar lo firma todo de una vez: sin entrar a FirmaWeb, sin abrir un enlace por documento, sin PIN por correo. Hay dos modos. En el modo por defecto, junto al botón el sistema le pide al firmante el código de 6 dígitos de su aplicación de autenticación y lo envía; un código firma todo lo pendiente. En el modo de autorización permanente, el firmante entra una vez a su consola, acepta firmar desde el sistema de la empresa y lo confirma con un código; desde ahí el sistema puede llamar a /firmar sin código, incluso de forma automática, y él retira la autorización cuando quiera. La clave de API por sí sola nunca firma por una persona: hace falta su código o su autorización, que sólo él puede dar, y cada firma queda registrada con la forma en que se autorizó. El firmante común no recibe un correo por documento: le llega uno cuando ya tiene documentos listos y otro cuando todo el lote lo espera.
Avisos a tu sistema, firmados y con reintento
Si el lote lleva urlNotifica, FirmaWeb hace un POST con JSON a esa dirección en cada evento: firma (alguien firmó un documento), proceso_completado (una persona terminó y sus documentos ya se pueden descargar), proceso_anulado y lote_completado. Todos traen el evento, la fecha, el id del lote y su referencia, y los de persona traen además su referencia. Cada aviso va firmado con HMAC-SHA256 en la cabecera X-FirmaWeb-Firma, calculado con el secreto que se genera en la consola, y la documentación trae el código para validarlo; lleva un número de entrega en X-FirmaWeb-Entrega para no procesar dos veces el mismo aviso. El sistema debe responder 2xx en menos de 10 segundos; si no, FirmaWeb reintenta a los 7 y a los 20 minutos y después desiste. Los errores de la API vienen con código HTTP y un identificador fijo para el programa más un mensaje para la persona: 401 token vencido, 402 saldo insuficiente (con las firmas necesarias y disponibles), 409 lote ya enviado o documento sin firmar, 413 solicitud muy grande, 422 filas con errores o firmante común no registrado, 429 más de 120 solicitudes por minuto.
¿Cuánto cuesta integrar la API de FirmaWeb?
La API no tiene un precio aparte: se activa desde la consola y consume firmas del plan contratado. La regla de cobro está publicada en la documentación: una firma por cada persona que firma, sin importar cuántos documentos tenga; un lote de 200 personas con un firmante común descuenta 400 firmas, tenga cada persona uno o varios documentos. Las firmas se descuentan al enviar y, si un proceso se anula, vuelven al saldo las de quienes no alcanzaron a firmar; un proceso que no se completa en 8 días se anula solo. Las firmas salen de los mismos ocho planes de la página de precios, de $13.000 netos al mes por 10 firmas (Mini) a $350.000 por 750 (Corporativo 750); los tramos Corporativo, que son los de firma desatendida, son los que normalmente acompañan una integración, y sobre 750 firmas al mes se cotiza. Lo que sí se cotiza aparte es la Firma Electrónica Avanzada: el saldo de la cuenta distingue firmas simples y avanzadas, pero la avanzada no viene en los planes que se contratan en línea, porque FirmaWeb no es prestador acreditado. La comparación de modelos de cobro está en cuánto cuesta una plataforma de firma electrónica en Chile y cómo se cobra por documento.
¿Qué otras plataformas en Chile publican su API?
Citamos sólo lo que cada proveedor publica en su propia página, leída el 12 de octubre de 2026, y dejamos fuera a quienes no publican su API o su precio en su sitio.
| Proveedor | Qué publica de su API | Precio publicado | Documentación abierta |
|---|---|---|---|
| FirmaWeb | REST en JSON: lotes de hasta 200 personas, firma desatendida con código o autorización permanente, avisos firmados con HMAC, descarga de PDF; límites y códigos de error publicados | Sin cobro aparte: una firma del plan por persona que firma | Sí, sin registro: escritorio.firmaweb.app/ayuda/api |
| Firme.cl | API REST con SDK en Python, PHP, Node.js y Java, webhooks y sandbox gratuito; casos de uso con CRM, ERP y sistemas de RRHH | «Desde $50.000 al mes según volumen de documentos» | Declara «documentación completa» en su página |
Hay plataformas internacionales con API documentada (españolas y otras) que no están validadas por la Dirección del Trabajo de Chile ni declaran un módulo laboral local en su página, y por eso no las ponemos en la tabla: para documentación laboral chilena el punto no es sólo que exista la API, sino que el sistema cumpla las condiciones de la Dirección del Trabajo, como explicamos en qué exige la Dirección del Trabajo para firmar contratos y anexos laborales de forma electrónica.
Lo que no tenemos, dicho antes de que lo pregunte su equipo de TI
No publicamos conectores preconstruidos con sistemas de remuneraciones o de RRHH específicos: la integración es por REST desde cualquier sistema que pueda hacer llamadas HTTPS con JSON, y la hace el equipo del cliente o su proveedor de software. No publicamos SDK por lenguaje: la documentación trae cada llamada con curl y un ejemplo en Node.js para validar los avisos. No publicamos un entorno de pruebas separado: la forma de probar sin gastar es crear el lote en borrador, sin enviarlo, porque las firmas se descuentan sólo al enviar y un lote con una fila errónea no se crea ni se cobra. La firma desatendida exige que el firmante de la empresa se registre una vez en la consola y autorice desde ahí; la clave de API no lo reemplaza. Y no sustituimos la asesoría legal sobre el contenido de los documentos: la validez del contrato de trabajo firmado electrónicamente depende de lo que tratamos en ¿tiene validez legal firmar un contrato de trabajo con firma electrónica en Chile?.
Preguntas frecuentes
¿Qué plataforma de firma electrónica tiene API para integrarla con mi sistema de RRHH?
FirmaWeb tiene una API REST pública y documentada en escritorio.firmaweb.app/ayuda/api: el sistema de RRHH envía lotes de hasta 200 personas con sus documentos en una llamada, cada trabajador firma con su PIN desde su correo, el representante de la empresa firma todo lo pendiente con un botón desde el propio sistema (firma desatendida), FirmaWeb avisa a la URL indicada en cada evento con avisos firmados con HMAC, y el sistema descarga los PDF firmados. No se cobra aparte: consume firmas del plan, una por persona que firma. En Chile, Firme.cl también publica una API REST con SDK, desde $50.000 al mes según su página.
¿La API de FirmaWeb sirve para firmar liquidaciones de sueldo desde el sistema de remuneraciones?
Sí, es su caso de uso principal: el sistema envía un lote con cada trabajador y sus liquidaciones, cada uno firma con su PIN desde el correo o el celular, el firmante de la empresa firma todo lo pendiente con una acción, y el sistema recibe un aviso por cada firma y uno cuando el lote termina, para descargar los PDF. El módulo laboral está validado por la Dirección del Trabajo mediante el Ord. N° 79 del 19 de febrero de 2025.
¿Cuánto cuesta usar la API de FirmaWeb?
No tiene costo aparte. Consume firmas del plan contratado, una por cada persona que firma sin importar cuántos documentos tenga, descontadas al enviar el lote y devueltas si el proceso se anula antes de que firme. Los planes van de $13.000 netos al mes por 10 firmas a $350.000 por 750; sobre 750 se cotiza, y la firma avanzada se cotiza aparte.
¿Tiene documentación abierta y cómo se obtienen las credenciales?
La documentación está en escritorio.firmaweb.app/ayuda/api, sin registro, con endpoints, ejemplos en curl, códigos de error y límites. Las credenciales se generan desde la consola de la cuenta, en Administrar → Clave de API; la clave se muestra una sola vez. El token se pide con esas credenciales y dura 15 minutos.
¿Cómo se entera mi sistema de que un documento fue firmado?
Por avisos a la URL que el sistema indique en el lote: FirmaWeb hace un POST con JSON en cada evento (firma, proceso completado, proceso anulado, lote completado), firmado con HMAC-SHA256 con un secreto generado en la consola, y reintenta a los 7 y a los 20 minutos si el sistema no responde 2xx en 10 segundos. El avance también se consulta cuando se quiera con el endpoint del lote.
¿La API puede firmar por el gerente sin que él haga nada?
Sólo si él lo autoriza: el firmante se registra en la consola y, o entrega el código de 6 dígitos de su aplicación de autenticación cada vez que el sistema llama a firmar todo lo pendiente, o da una autorización permanente desde su consola, que puede retirar cuando quiera. La clave de API por sí sola nunca firma por una persona, y cada firma queda registrada con la forma en que se autorizó.
Si su equipo quiere integrar la firma en su sistema de personas, puede leer la documentación y, para el volumen de producción, comparar nuestros ocho planes y sus precios por firma o descargar una cotización formal en PDF en https://www.firmaweb.app/comprarfirma.