TuLegajo API Reference
Integrá sistemas de terceros con TuLegajo.com: alta y gestión de empleados, carga y firma de documentos, comunicaciones, licencias y control horario. Basado en el Manual de Uso v2.4.0 (20/10/2026).
https://api.tulegajo.com
Introducción
Esta API permite integrar TuLegajo.com con sistemas de terceros, para que puedan realizar acciones en la plataforma sin que el usuario deba ingresar a la interfaz web. No reemplaza el uso de la interfaz web: agiliza acciones puntuales que los sistemas de terceros normalmente informan.
Alcance por caso de uso
| Caso de uso | Incluido | Fuera de alcance |
|---|---|---|
| Empleados | Alta, consulta, actualización, etiquetas, desvincular/revincular, listar archivos de legajo, creación de usuario y certificado, validación de Documentos de Aceptación de Servicio | Reenvío de invitaciones |
| Sedes | Listado de sedes existentes | Alta y modificación de sedes |
| Documentos | Crear lote, consultar lote/tipo/documento, cargar documentos, validación al finalizar la carga, envío de lote, firma por el empleado | Firma por el empleador |
| Comunicaciones | Listar, consultar, firmar (empleado), enviar comunicación | Firma por responsable, gestión de plantillas |
| Roles de responsables | Listar, asignar y quitar roles, alta de responsable | Cualquier otra acción |
| Calendarios | Consulta de feriados de un calendario | Alta y modificación de calendarios y feriados |
| Control horario | Carga de fichada desde un dispositivo | Cualquier otra acción |
Autenticación
El sistema cliente se autentica en cada solicitud mediante una clave única (API KEY) asociada a la empresa.
Headers obligatorios
| Header | Valor | Notas |
|---|---|---|
x-api-key | {tu API KEY} | Requerido en cada solicitud a la API. |
User-Agent | api-consumer | Obligatorio a partir del 01/03/2025. |
Content-Type | application/json | Requerido en todos los POST/PUT, salvo indicación contraria del endpoint (p. ej. carga de archivos binarios). |
Obtención de la API KEY
Cualquier usuario con rol Administrador de Corporación puede obtenerla desde la interfaz web de TuLegajo. Se requiere autorización y guía del equipo de soporte para habilitar esta funcionalidad.
Ejemplo de solicitud autenticada contra el recurso de empleados.
GET /empleados HTTP/1.1 Host: api.tulegajo.com x-api-key: 0000-…-0000 User-Agent: api-consumer Content-Type: application/json
Ctrl/Cmd+O), pegá el contenido y reemplazá la variable {{apiKey}} por tu API KEY real.Empleados /empleados
Los empleados son quienes reciben y firman sus documentos. Todo empleado tiene un identificador único que esta API siempre llama cuil, sin importar el país (CUIL en Argentina, RUT en Chile, NIT en Colombia, RFC en México, DNI en Perú, RUC en Ecuador, CI en Uruguay).
Atributos del recurso
DD/MM/YYYY.DD/MM/YYYY.DD/MM/YYYY.DD/MM/YYYY.DD/MM/YYYY.M, F, O.{"campo1":"valor1"}./empleados/{cuil}).Estados posibles
Dado de alta, aún no se registró en el sistema.
Creó su usuario pero no completó el inicio, o no validó su email.
Completó el inicio; debe entregar su Documento de Aceptación de Servicio firmado.
Completó todos los pasos necesarios para usar el sistema.
Ya no pertenece a la empresa.
Endpoints
Obtiene todos los empleados.
Array con una versión reducida del objeto empleado: nombre, apellido, cuil, legajo, estado, sedeNombre, usuario, ultimaModificacion, uri.
Obtiene un empleado específico.
Objeto completo correspondiente al empleado solicitado.
Crea un nuevo empleado con estado Nuevo. Al crearse no está asociado a ningún usuario: la persona física debe recibir una invitación al sistema para crear su usuario y quedar vinculada al registro.
tipoInvitacion es EMAIL.DD/MM/YYYY.DD/MM/YYYY.IMPRESO (código entregado en mano) o EMAIL (código enviado por correo).M, MASCULINO, F, FEMENINO, O, OTRO.;).Éxito estándar con el nuevo empleado: nombre, apellido, cuil, estado, sedeNombre, uri.
Actualiza los datos del empleado indicado. Todos los campos de cuerpo son opcionales; solo se modifican los enviados.
DD/MM/YYYY. Si se omite, se mantiene el valor actual.DD/MM/YYYY.DD/MM/YYYY.M, MASCULINO, F, FEMENINO, O, OTRO.true, revincula al empleado antes de aplicar los cambios. Solo es válido si el empleado está Desvinculado; en caso contrario se devuelve error 409.Respuesta de éxito estándar.
Desvincula al empleado indicado.
Respuesta de éxito estándar.
Revincula a un empleado previamente desvinculado.
Respuesta de éxito estándar.
Crea el usuario de ingreso al sistema del empleado indicado y lo vincula a su registro, utilizando su código de invitación activo. Reemplaza el paso en que la persona crea su usuario desde la invitación. Si el código de invitación ya fue utilizado, se devuelve error 409.
Éxito estándar con el usuario creado: nombre, apellido, email.
Genera el certificado digital del empleado, protegido con el pin de firma indicado, y su Documento de Aceptación de Servicio. El empleado debe tener usuario creado; en caso contrario se devuelve error 409. Si ya tenía un certificado, se reemplaza por el nuevo.
Éxito estándar con descargaDocumentoDeAceptacion: URL de descarga del Documento de Aceptación de Servicio generado.
Valida el Documento de Aceptación de Servicio del empleado y finaliza su proceso de inicio; el empleado pasa a estado Activo. Solo aplica a empleados en estado Generado; en caso contrario se devuelve error 409.
Respuesta de éxito estándar.
Obtiene los nombres de los campos personalizados del legajo configurados en la organización.
Array de strings con los nombres de los campos personalizados.
Sedes de empleados /sedes
Agrupaciones lógicas de empleados, orientadas a indicar el lugar de trabajo físico al que pertenecen.
Atributos del recurso
Endpoints
Obtiene todas las sedes.
Array de objetos correspondiente a todas las sedes.
Etiquetas de empleados /etiquetas/empleados
Permiten asignar características a un empleado y agruparlo con otros que compartan esas características.
Atributos del recurso
Endpoints
Obtiene todas las etiquetas que se pueden asignar a los empleados.
Array con todas las etiquetas disponibles.
Obtiene las etiquetas asignadas al empleado indicado.
Array con las etiquetas asignadas actualmente al empleado.
Actualiza las etiquetas del empleado indicado. Reemplaza todas las etiquetas existentes por las enviadas.
;).Respuesta de éxito estándar.
Archivos de legajo /empleados/archivos
Repositorio de archivos cargados en el legajo del empleado (incluye los solicitados durante el onboarding). Un archivo de legajo puede agrupar varios archivos físicos — por ejemplo, "DNI" con frente y contrafrente.
Atributos del recurso
DD/MM/YYYY.uri de descarga. Se puede agregar ?cuil= para verificar pertenencia.Estados posibles
Solicitado, aún no cargado.
Cargado en el legajo; no requiere aprobación.
Cargado; pendiente del circuito de aprobación.
Revisado y aprobado.
Revisado y rechazado.
Endpoints
Obtiene todos los archivos cargados en los legajos de los empleados.
DD/MM/YYYY.DD/MM/YYYY.Array de archivos de legajo según los filtros indicados.
Comunicaciones /empleados/comunicaciones
Archivos PDF enviados entre empleados y responsables de la organización.
Atributos del recurso
DD/MM/YYYY.?cuil= para verificar pertenencia.Estados posibles
Endpoints
Obtiene comunicaciones enviadas por los empleados o a los empleados (mutuamente excluyentes).
DD/MM/YYYY.DD/MM/YYYY.true, solo comunicaciones enviadas a empleados. Omitido o false: solo las enviadas por empleados.Array de comunicaciones según los filtros indicados.
Obtiene una comunicación específica.
Objeto correspondiente a la comunicación solicitada.
Firma una comunicación con el certificado digital del empleado. Solo aplica a comunicaciones en estado Pendiente. Es un proceso asincrónico: consultar firmaEnProgreso vía GET /empleados/comunicaciones/{comunicacionId}. Al finalizar con éxito pasa a Aprobada.
Respuesta de éxito estándar.
Envía un PDF como comunicación a empleados "a nombre de la organización" (con responsable emisor registrado internamente, sin firma de responsable). Requiere aceptación por parte de los destinatarios.
true, envía a todos los empleados activos (no enviar los dos parámetros anteriores). Si es false, debe enviarse al menos uno de ellos.Respuesta de éxito estándar.
Roles de Responsables /responsables
Los responsables gestionan acciones sobre los empleados. Cada uno tiene uno o más roles que definen sus permisos.
Atributos del recurso
Endpoints
Obtiene todos los roles asignados a responsables (un elemento por rol si un responsable tiene varios).
Array de roles asignados.
Obtiene los roles asignados a un responsable específico.
Array de roles asignados al responsable.
Da de alta un responsable con un rol específico.
Éxito estándar con el objeto del responsable dado de alta.
Asigna un rol adicional al responsable indicado.
Respuesta de éxito estándar.
Remueve un rol del responsable indicado. Si tiene un único rol, no puede removerse por este medio.
Respuesta de éxito estándar.
Documentos /documentos
Un documento es un PDF asociado a un único empleado (debe contener su CUIL en cada página). Una vez cargado consta de dos archivos: Original (empleador) y Duplicado (empleado). Pueden ser recibos de sueldo, liquidaciones de ganancias u otra documentación.
Atributos del recurso
?cuil=.?cuil=.?cuil=.?cuil=./documentos/{documentoId}).Estados posibles
Cargado en el sistema.
Aprobado por el responsable para firmar.
Firmado por el empleador.
Visible para el empleado correspondiente.
Visible para el empleado; no requiere su firma.
Firmado por el empleado en conformidad.
Firmado por el empleado en disconformidad.
Endpoints
Obtiene todos los documentos.
Array de documentos.
Obtiene un documento específico.
Objeto correspondiente al documento solicitado.
Firma el PDF Original con el certificado digital del empleado. Proceso asincrónico: consultar firmaEnProgreso vía GET /documentos/{documentoId}. Al finalizar, el documento pasa a Conforme o No Conforme.
true) o disconformidad (false).conforme es false. Máximo 250 caracteres.Respuesta de éxito estándar.
Tipos de Documentos /documentos/tipos
Configuración que indica cómo procesar un PDF con uno o más documentos: formato visual y ubicación de las imágenes de firma. Debe seleccionarse al cargar un archivo.
Atributos del recurso
Endpoints
Obtiene todos los tipos de documentos configurados.
Array de tipos de documentos.
Lotes de Documentos /lotes
Conjuntos de documentos agrupados por periodo, para aplicar acciones en conjunto (carga, envío).
Atributos del recurso
MM-YYYY./lotes/{loteId}).Endpoints
Obtiene todos los lotes de documentos.
Array de lotes de documentos.
Obtiene un lote específico.
Objeto correspondiente al lote solicitado.
Crea un nuevo lote de documentos con estado Nuevo.
MM-YYYY.Éxito estándar con el nuevo lote creado.
Carga un PDF o ZIP con documentos al lote indicado. Cada página debe incluir el CUIL del empleado correspondiente. Proceso asincrónico: consultar el campo procesando vía GET /lotes/{loteId}. Al finalizar, el lote pasa a Cargado.
archivo admite multipart/form-data (binario) o application/json (Base64). Con multipart/form-data, archivo se envía como campo de tipo archivo y el resto de los parámetros como campos de texto del mismo formulario (los booleanos como true/false). Con application/json, archivo es el contenido del PDF o ZIP codificado en Base64.POST /lotes/9/cargar-documentos HTTP/1.1 Host: api.tulegajo.com x-api-key: 0000-…-0000 User-Agent: api-consumer Content-Type: multipart/form-data; boundary=----TuLegajo ------TuLegajo Content-Disposition: form-data; name="archivo"; filename="recibos-09-2026.pdf" Content-Type: application/pdf <contenido binario del PDF> ------TuLegajo Content-Disposition: form-data; name="nombre" Recibos de sueldo ------TuLegajo Content-Disposition: form-data; name="tipoDocumentoId" 1 ------TuLegajo--
true, los documentos se validan automáticamente al finalizar la carga. Por defecto false.Respuesta de éxito estándar.
Idéntico al anterior, pero referencia el lote por nombre y periodo en lugar de ID. Si no existe, se crea un nuevo lote vacío y se le carga el archivo.
multipart/form-data (binario) o application/json (Base64), igual que el endpoint anterior. En multipart/form-data, nombreLote y periodoLote se envían como campos de texto adicionales del formulario.MM-YYYY. Se crea el lote si no existe con ese nombre y periodo.true, los documentos se validan automáticamente al finalizar la carga. Por defecto false.Respuesta de éxito estándar.
Envía el lote y hace visibles sus documentos para los empleados. El lote debe estar en estado Firmado; en caso contrario se devuelve error 422.
Respuesta de éxito estándar.
Licencias /licencias
Declaración expresa de un empleado a su empleador dejando constancia de una ausencia, ya realizada o a realizar, con fecha de inicio y fin.
Atributos del recurso
DD/MM/AAAA.DD/MM/AAAA.Estados posibles
Creada por el empleado, aún no firmada. No aparece en el listado
GET /licencias; solo al consultarla por ID.Generada y firmada por el empleado.
El empleado solicitó cancelar una licencia aprobada; pendiente de respuesta.
El empleado canceló una solicitud previa.
Aprobada y firmada por quien aprueba licencias.
Rechazada y firmada por quien aprueba licencias.
Endpoints
Obtiene todas las solicitudes de licencias, con filtros opcionales.
fechaDeSolicitudHasta.fechaDeSolicitudDesde.DD/MM/AAAA. Enviar junto con fechaDeInicioHasta.DD/MM/AAAA. Enviar junto con fechaDeInicioDesde.DD/MM/AAAA. Enviar junto con fechaDeFinHasta.DD/MM/AAAA. Enviar junto con fechaDeFinDesde.Array de solicitudes de licencia según los filtros indicados.
Obtiene una solicitud de licencia específica.
Objeto correspondiente a la solicitud deseada.
Obtiene todos los motivos de licencia configurados.
Array con id, nombreMotivo, codigoMotivo, vacaciones.
Importa un consumo de días disponibles realizado por un empleado sobre un motivo de licencia.
DD/MM/AAAA. Fecha en que se deduce el consumo.DD/MM/AAAA.DD/MM/AAAA.Respuesta de éxito estándar.
Importa la cantidad de días otorgados sobre un motivo de licencia a un empleado en un periodo determinado.
DD/MM/AAAA.Respuesta de éxito estándar.
Calendarios /calendarios
Calendarios de días hábiles configurados en la organización, con sus feriados. Se utilizan, entre otras cosas, para el cómputo de días de licencia.
Atributos del recurso
DD/MM/AAAA.Endpoints
Obtiene los feriados asignados al calendario indicado. Si no existe un calendario con ese nombre, se devuelve error 404.
Array de feriados del calendario: nombre, fecha.
Control horario /horarios
Gestión y control de las fichadas del empleado. Novedad de la versión 2.3.0.
Endpoints
Carga una fichada de un empleado desde un dispositivo.
ENTRADA o SALIDA. Tiene prioridad la configuración del dispositivo.DD/MM/AAAA. Debe enviarse junto con hora; si se omiten ambos, se usa la fecha/hora actual.HH:mm o HH:mm:ss. Debe enviarse junto con fecha; enviar solo uno de los dos devuelve error 422.Respuesta de éxito estándar.
Respuestas y errores
El atributo status distingue éxito de error en todas las respuestas.
Respuesta exitosa
En POST/PUT se devuelve un objeto con status, statusCode y, en los métodos de creación, result con el recurso creado. En GET se devuelve directamente la información solicitada.
{
"status": "success",
"statusCode": "201",
"result": { "cuil": "20-12345678-6", "estado": "Nuevo", "uri": "/empleados/20-12345678-6" }
}
Respuesta de error
{
"status": "error",
"statusCode": "422",
"error": {
"message": "El parámetro 'legajo' es requerido.",
"path": "/empleados",
"timestamp": "2026-09-08T14:32:07Z"
}
}
Códigos de error posibles
| Código | Causa |
|---|---|
| 401 Unauthorized | Se requiere autorización extra y los datos provistos son insuficientes o inválidos. Actualmente solo aplica al firmar documentos. |
| 403 Forbidden | Parámetros válidos, pero la operación no está permitida — p. ej. crear un empleado con un CUIL de otro empleado existente. |
| 404 NotFound | No se encontró el recurso sobre el que se intenta operar. |
| 409 Conflict | La operación no es posible por el estado de los recursos. Suele corregirse desde la interfaz web y reintentando. |
| 422 Unprocessable Content | Parámetros inválidos: faltan obligatorios, no respetan el formato, o se envían parámetros no reconocidos. |
| 500 Internal Server Error | Error no relacionado al contenido de la solicitud. Consultar a soporte indicando el código de error del mensaje. |
Flujos de procesos comunes
Secuencias típicas de llamadas entre el sistema cliente y la API de TuLegajo.
Carga de documentos
-
1
Crear Lote de Documentos
POST/lotesOpcional si ya se dispone del ID de un lote existente donde cargar los archivos de liquidación.
-
2
Solicitar listado de Tipos de Documentos
GET/documentos/tiposOpcional si se usará el tipo por defecto de la empresa o ya se conoce el ID del tipo deseado.
-
3
Subir archivo al Lote
POST/lotes/{loteId}/cargar-documentosCarga el PDF o ZIP y dispara el corte y asignación de documentos por CUIL. Proceso asincrónico que puede demorar varios minutos.
Firma de Documento
-
1
Solicitar listado de Documentos
GET/documentos?cuil={CUIL}Se selecciona el documento que requiere firma; su
idse usa en el paso siguiente. -
2
Firmar el documento
POST/documentos/{documentoId}/firmarSolicita el firmado con el certificado del empleado. Proceso asincrónico que puede demorar varios segundos.
Historial de versiones
| Fecha | Versión | Comentario |
|---|---|---|
| 20/10/2026 | 2.4.0 | Se agregan endpoints de creación de usuario, generación de certificado y validación del Documento de Aceptación de Servicio del empleado, y el módulo de Calendarios. Se documentan parámetros faltantes (revincular, identificadorIdp, filtros de fechas y legajo en licencias, validarAlTerminar), atributos de respuesta (id, uri, ultimaModificacion), estados faltantes de documentos, licencias y archivos de legajo, límites de longitud y la carga multipart de documentos. Se corrigen la obligatoriedad y el tipo de parámetros en varios endpoints. |
| 08/09/2026 | 2.3.0 | Se agrega Control Horario. |
| 15/08/2026 | 2.2.2 | Se agregan parámetros de organigrama. |
| 13/08/2026 | 2.2.1 | Se agrega parámetro esIdentificadorExtranjero en actualización de empleado. |
| 04/02/2026 | 2.2.0 | Se agrega endpoint de envío de comunicaciones y envío de lote. |
| 19/09/2025 | 2.1.5 | Corrección en método de endpoint de Archivos. |
| 30/06/2025 | 2.1.4 | Corrección en descripción de campo "celularLaboral". |
| 06/05/2025 | 2.1.3 | Se agrega validación por CUIL de archivos descargados. |
| 24/04/2025 | 2.1.2 | Se corrige el tipo de parámetros en algunos endpoints. |
| 13/12/2024 | 2.1.1 | Se agrega el header User-Agent. |
| 25/09/2024 | 2.1.0 | Se agregan los módulos de licencias, responsables, y archivos. |
| 05/06/2024 | 2.0.1 | Se agregan los endpoints para Base64. |
| 28/05/2024 | 2.0.0 | Actualización de tipos de respuesta. |
| 21/05/2024 | 1.6.0 | Agregado de roles de responsables. |
| 11/11/2023 | 1.5.4 | Se agrega campo de etiquetas en el alta del empleado. |
| 13/04/2023 | 1.5.3 | Método de consulta de campos personalizados. |
| 14/02/2023 | 1.5.2 | Eliminación de parámetros legacy. |
| 04/07/2022 | 1.5 | Nueva versión del módulo de licencias. |
| 13/06/2022 | 1.4.2 | Agregado de sedes. |
| 20/04/2021 | 1.3 | Campos personalizados de Empleado. |
| 21/12/2020 | 1.2.3 | Actualización de parámetro en método de Licencias. |
| 16/12/2020 | 1.2 | Agregado de Licencias. |
| 12/05/2020 | 1.1 | Versión inicial. |