TuLegajo Developers

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).

Base URL
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 usoIncluidoFuera de alcance
EmpleadosAlta, consulta, actualización, etiquetas, desvincular/revincular, listar archivos de legajo, creación de usuario y certificado, validación de Documentos de Aceptación de ServicioReenvío de invitaciones
SedesListado de sedes existentesAlta y modificación de sedes
DocumentosCrear lote, consultar lote/tipo/documento, cargar documentos, validación al finalizar la carga, envío de lote, firma por el empleadoFirma por el empleador
ComunicacionesListar, consultar, firmar (empleado), enviar comunicaciónFirma por responsable, gestión de plantillas
Roles de responsablesListar, asignar y quitar roles, alta de responsableCualquier otra acción
CalendariosConsulta de feriados de un calendarioAlta y modificación de calendarios y feriados
Control horarioCarga de fichada desde un dispositivoCualquier otra acción
Prerrequisito: se asume conocimiento previo de los flujos de creación de empleados, carga/firma/envío de documentos y configuración de licencias en la interfaz web, transmitido por el equipo de implementación al administrador de RR.HH.

Autenticación

El sistema cliente se autentica en cada solicitud mediante una clave única (API KEY) asociada a la empresa.

Headers obligatorios

HeaderValorNotas
x-api-key{tu API KEY}Requerido en cada solicitud a la API.
User-Agentapi-consumerObligatorio a partir del 01/03/2025.
Content-Typeapplication/jsonRequerido 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.

HEADER x-api-key: {API_KEY}

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
Cada endpoint de esta guía tiene un botón Postman: copia al portapapeles una colección v2.1 lista para importar, con la URL, headers y un cuerpo de ejemplo ya completado. En Postman: Import → Raw text (o 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

idinteger
Identificador interno de este empleado.
cuilstring
CUIL de este empleado.
nombrestring
Primer nombre de este empleado.
apellidostring
Apellido de este empleado.
sedeCodigostring
Código de la sede a la que pertenece este empleado.
sedeNombrestring
Nombre de la sede a la que pertenece este empleado.
legajostring
Número de legajo de este empleado.
emailCorporativostring
Dirección de correo electrónico corporativa de este empleado.
fechaDeAltastring
Fecha de alta en el sistema, formato DD/MM/YYYY.
fechaDeIngresostring
Fecha de ingreso a la empresa, formato DD/MM/YYYY.
fechaDeIngresoLegalstring
Fecha legal de ingreso a la empresa, formato DD/MM/YYYY.
fechaDeBajastring
Fecha de baja en el sistema, formato DD/MM/YYYY.
fechaDeDesvinculacionstring
Fecha de desvinculación de la empresa, formato DD/MM/YYYY.
celularLaboralCodigoPaisnúmero
Código de país del celular laboral.
celularLaboralnúmero
Número de celular laboral, sin 15 y sin 0 en el código de área.
sexostring
Valores posibles: M, F, O.
camposPersonalizadosstring (JSON)
Mapa de campos personalizados del legajo. Formato {"campo1":"valor1"}.
informacionExtrastring
Información adicional sobre este empleado.
ultimaModificaciondate
Fecha de última modificación de datos del empleado.
estadostring
Ver leyenda de estados debajo.
usuariostring
Usuario de ingreso al sistema de este empleado.
cargostring
Cargo de este empleado.
reportaAstring
CUIL del superior al que reporta en el organigrama.
uristring
Ruta del recurso de este empleado en la API (/empleados/{cuil}).

Estados posibles

Nuevo
Dado de alta, aún no se registró en el sistema.
Pendiente
Creó su usuario pero no completó el inicio, o no validó su email.
Generado
Completó el inicio; debe entregar su Documento de Aceptación de Servicio firmado.
Activo
Completó todos los pasos necesarios para usar el sistema.
Desvinculado
Ya no pertenece a la empresa.

Endpoints

GET/empleados

Obtiene todos los empleados.

Respuesta

Array con una versión reducida del objeto empleado: nombre, apellido, cuil, legajo, estado, sedeNombre, usuario, ultimaModificacion, uri.

GET/empleados/{cuil}

Obtiene un empleado específico.

Parámetros de ruta
cuilRequeridostring
CUIL del empleado solicitado.
Respuesta

Objeto completo correspondiente al empleado solicitado.

POST/empleados

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.

Parámetros de cuerpo
cuilRequeridostring
CUIL del empleado.
esIdentificadorExtranjeroboolean
Indica si el empleado tiene un identificador extranjero en lugar de CUIL.
nombreRequeridostring
Primer nombre. Máximo 250 caracteres.
apellidoRequeridostring
Apellido. Máximo 250 caracteres.
sedeCodigostring
Código de sede. Requerido si la empresa tiene más de una sede.
legajoRequeridostring
Número de legajo. Máximo 250 caracteres.
emailCorporativostring
Requerido si tipoInvitacion es EMAIL.
fechaDeIngresoRequeridostring
Formato DD/MM/YYYY.
fechaDeIngresoLegalstring
Formato DD/MM/YYYY.
celularLaboralCodigoPaisnúmero
Código de país del celular laboral.
celularLaboralnúmero
Sin 15 y sin 0 en el código de área.
tipoInvitacionRequeridostring
Valores: IMPRESO (código entregado en mano) o EMAIL (código enviado por correo).
sexostring
Valores: M, MASCULINO, F, FEMENINO, O, OTRO.
camposPersonalizadosstring (JSON)
Mapa nombre:valor. Los nombres deben coincidir con los definidos en la pestaña "Datos" del legajo. No es necesario incluir todos.
informacionExtrastring
Información adicional sobre el empleado. Máximo 1024 caracteres.
etiquetasstring
Nombres de etiquetas separados por punto y coma (;).
cargostring
Cargo del empleado.
reportaAstring
CUIL del superior en el organigrama.
Respuesta

Éxito estándar con el nuevo empleado: nombre, apellido, cuil, estado, sedeNombre, uri.

PUT/empleados/{cuil}

Actualiza los datos del empleado indicado. Todos los campos de cuerpo son opcionales; solo se modifican los enviados.

Parámetros de ruta
cuilRequeridostring
CUIL del empleado a actualizar.
Parámetros de cuerpo
nombrestring
Máximo 250 caracteres.
apellidostring
Máximo 250 caracteres.
nuevoCuilstring
CUIL nuevo a asignar.
esIdentificadorExtranjeroboolean
Indica si el identificador es extranjero.
sedeCodigostring
Código de sede.
legajostring
Máximo 250 caracteres.
emailCorporativostring
Dirección corporativa.
fechaDeIngresostring
Formato DD/MM/YYYY. Si se omite, se mantiene el valor actual.
fechaDeIngresoLegalstring
Formato DD/MM/YYYY.
fechaDeBajastring
Formato DD/MM/YYYY.
celularLaboralCodigoPaisnúmero
Código de país.
celularLaboralnúmero
Sin 15 y sin 0 en el código de área.
sexostring
Valores: M, MASCULINO, F, FEMENINO, O, OTRO.
camposPersonalizadosstring (JSON)
Los campos no incluidos no se modifican.
informacionExtrastring
Información adicional. Máximo 1024 caracteres.
cargostring
Cargo del empleado.
reportaAstring
CUIL del superior en el organigrama.
revincularboolean
Si es 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

Respuesta de éxito estándar.

POST/empleados/{cuil}/desvincular

Desvincula al empleado indicado.

Parámetros de ruta
cuilRequeridostring
CUIL del empleado a desvincular.
Parámetros de cuerpo
fechaDeDesvinculacionstring
Fecha legal de la desvinculación. Si se omite, se usa la fecha actual.
Respuesta

Respuesta de éxito estándar.

POST/empleados/{cuil}/revincular

Revincula a un empleado previamente desvinculado.

Parámetros de ruta
cuilRequeridostring
CUIL del empleado a revincular.
Respuesta

Respuesta de éxito estándar.

POST/empleados/{cuil}/usuario

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.

Parámetros de ruta
cuilRequeridostring
CUIL del empleado.
Parámetros de cuerpo
nombreRequeridostring
Nombre del usuario. Máximo 250 caracteres.
apellidoRequeridostring
Apellido del usuario. Máximo 250 caracteres.
emailRequeridostring
Correo electrónico del usuario. Se utiliza también como nombre de usuario.
claveRequeridostring
Contraseña del usuario. Máximo 100 caracteres.
Respuesta

Éxito estándar con el usuario creado: nombre, apellido, email.

POST/empleados/{cuil}/certificado

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.

Parámetros de ruta
cuilRequeridostring
CUIL del empleado.
Parámetros de cuerpo
pinFirmaRequeridostring
Pin que protegerá el certificado; se usará luego para firmar documentos y comunicaciones. Máximo 100 caracteres. Si no cumple los requisitos de seguridad de la organización, se devuelve error 422.
Respuesta

Éxito estándar con descargaDocumentoDeAceptacion: URL de descarga del Documento de Aceptación de Servicio generado.

POST/empleados/{cuil}/validar-documento-de-aceptacion

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.

Parámetros de ruta
cuilRequeridostring
CUIL del empleado.
Respuesta

Respuesta de éxito estándar.

GET/empleados/camposPersonalizados

Obtiene los nombres de los campos personalizados del legajo configurados en la organización.

Respuesta

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

codigostring
Código identificador único de la sede.
nombrestring
Nombre de la sede.

Endpoints

GET/sedes

Obtiene todas las sedes.

Respuesta

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

nombrestring
Nombre de la etiqueta. No puede repetirse.

Endpoints

GET/etiquetas/empleados

Obtiene todas las etiquetas que se pueden asignar a los empleados.

Respuesta

Array con todas las etiquetas disponibles.

GET/etiquetas/empleados/{cuil}

Obtiene las etiquetas asignadas al empleado indicado.

Parámetros de ruta
cuilRequeridostring
CUIL del empleado.
Respuesta

Array con las etiquetas asignadas actualmente al empleado.

PUT/etiquetas/empleados/{cuil}

Actualiza las etiquetas del empleado indicado. Reemplaza todas las etiquetas existentes por las enviadas.

Parámetros de ruta
cuilRequeridostring
CUIL del empleado.
Parámetros de cuerpo
etiquetasRequeridostring
Nombres de las etiquetas separados por punto y coma (;).
Respuesta

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

nombrestring
Nombre del archivo de legajo.
fechaDeCargastring
Formato DD/MM/YYYY.
cargadoPorstring
Nombre y apellido del usuario que lo cargó.
empleadostring
Nombre y apellido del empleado dueño del archivo.
cuilstring
CUIL del empleado.
comentariosstring
Comentarios sobre el archivo.
estadostring
Estado del archivo.
archivoslist
Archivos físicos, cada uno con uri de descarga. Se puede agregar ?cuil= para verificar pertenencia.

Estados posibles

Sin subir
Solicitado, aún no cargado.
Subido
Cargado en el legajo; no requiere aprobación.
Pendiente
Cargado; pendiente del circuito de aprobación.
Aprobado
Revisado y aprobado.
Rechazado
Revisado y rechazado.

Endpoints

GET/empleados/archivos

Obtiene todos los archivos cargados en los legajos de los empleados.

Parámetros query
fechaDeCargaDesdestring
Fecha mínima de carga (inclusive), DD/MM/YYYY.
fechaDeCargaHastastring
Fecha máxima de carga (inclusive), DD/MM/YYYY.
cuilstring
CUIL del empleado dueño de los archivos.
Respuesta

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

idinteger
Identificador único de la comunicación.
asuntostring
Asunto de la comunicación.
fechaDeEnviostring
Formato DD/MM/YYYY.
empleadostring
Nombre y apellido del empleado emisor o receptor.
cuilstring
CUIL del empleado.
estadostring
Ver leyenda debajo.
firmaEnProgresoboolean
Indica si el proceso de firma está en curso.
uristring
Enlace de descarga del PDF. Admite ?cuil= para verificar pertenencia.

Estados posibles

Pendiente
Recibida
Aprobada
Rechazada

Endpoints

GET/empleados/comunicaciones

Obtiene comunicaciones enviadas por los empleados o a los empleados (mutuamente excluyentes).

Parámetros query
fechaDeEnvioDesdestring
Formato DD/MM/YYYY.
fechaDeEnvioHastastring
Formato DD/MM/YYYY.
cuilstring
CUIL del empleado emisor o receptor.
enviadasAEmpleadosboolean
Si es true, solo comunicaciones enviadas a empleados. Omitido o false: solo las enviadas por empleados.
Respuesta

Array de comunicaciones según los filtros indicados.

GET/empleados/comunicaciones/{comunicacionId}

Obtiene una comunicación específica.

Parámetros de ruta
comunicacionIdRequeridointeger
Identificador único de la comunicación.
Respuesta

Objeto correspondiente a la comunicación solicitada.

POST/empleados/comunicaciones/{comunicacionId}/firmar

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.

Parámetros de ruta
comunicacionIdRequeridointeger
Comunicación a firmar.
Parámetros de cuerpo
pinFirmaRequeridostring
Pin de firma del empleado.
Respuesta

Respuesta de éxito estándar.

POST/empleados/comunicaciones/enviar

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.

Parámetros de cuerpo
asuntoRequeridostring
Asunto o título de la comunicación.
cuilEmisorRequeridostring
CUIL del responsable emisor registrado.
cuilDestinatariosarray<string>
CUILs de los empleados destinatarios.
etiquetasDestinatariosarray<string>
Nombres de etiquetas cuyos empleados recibirán la comunicación.
aTodosRequeridoboolean
Si es 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.
archivoRequeridoBase64
PDF a enviar, codificado en Base64.
firmaPosXRequeridointeger
Coordenada horizontal de la firma (0 = extremo izquierdo).
firmaPosYRequeridointeger
Coordenada vertical de la firma (0 = extremo superior).
firmaAltoRequeridointeger
Alto en píxeles. Se recomienda 150.
firmaAnchoRequeridointeger
Ancho en píxeles. Se recomienda 300.
paginaFirmaRequeridointeger
Página del PDF donde se ubicará la firma.
Respuesta

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

nombrestring
Nombre del responsable.
apellidostring
Apellido del responsable.
cuilstring
CUIL del responsable.
descripcionstring
Descripción del responsable.
correoElectronicostring
Correo electrónico del responsable.
rolstring
Rol asignado.
sobreEtiquetasstring
Etiquetas sobre las que aplica el rol.

Endpoints

GET/responsables

Obtiene todos los roles asignados a responsables (un elemento por rol si un responsable tiene varios).

Respuesta

Array de roles asignados.

GET/responsables/{cuil}

Obtiene los roles asignados a un responsable específico.

Parámetros de ruta
cuilRequeridostring
CUIL del responsable.
Respuesta

Array de roles asignados al responsable.

POST/responsables

Da de alta un responsable con un rol específico.

Parámetros de cuerpo
cuilRequeridostring
CUIL del responsable.
nombreRequeridostring
Nombre del responsable.
apellidoRequeridostring
Apellido del responsable.
correoElectronicoRequeridostring
Correo electrónico.
descripcionstring
Descripción del responsable.
rolRequeridostring
Rol a asignar.
sobreEtiquetasstring
Etiquetas sobre las que aplicará el rol.
identificadorIdpstring
Identificador del responsable en el proveedor de identidad externo (IdP) de la organización, si se utiliza inicio de sesión federado.
Respuesta

Éxito estándar con el objeto del responsable dado de alta.

POST/responsables/asignar-rol/{cuil}

Asigna un rol adicional al responsable indicado.

Parámetros de ruta
cuilRequeridostring
CUIL del responsable.
Parámetros de cuerpo
rolRequeridostring
Rol a asignar.
sobreEtiquetasstring
Etiquetas sobre las que aplicará el rol.
Respuesta

Respuesta de éxito estándar.

POST/responsables/remover-rol/{cuil}

Remueve un rol del responsable indicado. Si tiene un único rol, no puede removerse por este medio.

Parámetros de ruta
cuilRequeridostring
CUIL del responsable.
Parámetros de cuerpo
rolRequeridostring
Rol a remover.
Respuesta

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

idinteger
Identificador único del documento.
cuilstring
CUIL del empleado asociado.
loteNombrestring
Nombre del lote al que fue cargado.
lotePeriodostring
Periodo del lote al que fue cargado.
nombrestring
Nombre descriptivo del documento.
estadostring
Ver leyenda debajo.
firmaEnProgresoboolean
Indica si el proceso de firma está en curso.
descargaOriginalURLstring
URL de descarga del documento Original. Admite ?cuil=.
descargaDuplicadoURLstring
URL de descarga del Duplicado sin firmar. Admite ?cuil=.
descargaOriginalFirmadoURLstring
Solo existe si el empleado firmó. Admite ?cuil=.
descargaDuplicadoFirmadoURLstring
Solo existe si el empleador firmó. Admite ?cuil=.
uristring
Ruta del recurso de este documento en la API (/documentos/{documentoId}).

Estados posibles

Nuevo
Cargado en el sistema.
Validado
Aprobado por el responsable para firmar.
Firmado
Firmado por el empleador.
Enviado
Visible para el empleado correspondiente.
Enviado (No firmable)
Visible para el empleado; no requiere su firma.
Conforme
Firmado por el empleado en conformidad.
No Conforme
Firmado por el empleado en disconformidad.

Endpoints

GET/documentos

Obtiene todos los documentos.

Parámetros query
cuilstring
Filtra por CUIL del empleado asociado.
Respuesta

Array de documentos.

GET/documentos/{documentoId}

Obtiene un documento específico.

Parámetros de ruta
documentoIdRequeridointeger
Identificador único del documento.
Respuesta

Objeto correspondiente al documento solicitado.

POST/documentos/{documentoId}/firmar

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.

Parámetros de ruta
documentoIdRequeridointeger
Documento a firmar.
Parámetros de cuerpo
pinFirmaRequeridostring
Pin de firma del empleado.
conformeRequeridoboolean
Firma en conformidad (true) o disconformidad (false).
tipoMotivoIdinteger
Motivo de disconformidad. Si se omite, se usa "Otro".
motivostring
Descripción de la causa. Solo aplica si conforme es false. Máximo 250 caracteres.
Respuesta

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

idinteger
Identificador único del tipo.
nombrestring
Nombre del tipo.
descripcionstring
Información adicional sobre el tipo.
tipoPorDefectoboolean
Indica si es el tipo utilizado por defecto.

Endpoints

GET/documentos/tipos

Obtiene todos los tipos de documentos configurados.

Respuesta

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

idinteger
Identificador único del lote.
nombrestring
Nombre del lote.
periodostring
Periodo mensual, formato MM-YYYY.
comentariostring
Información adicional sobre el lote.
estadostring
Nuevo, Cargado, Validado, Firmado o Enviado.
procesandoboolean
Indica si hay un proceso en curso sobre el lote.
uristring
Ruta del recurso de este lote en la API (/lotes/{loteId}).

Endpoints

GET/lotes

Obtiene todos los lotes de documentos.

Respuesta

Array de lotes de documentos.

GET/lotes/{loteId}

Obtiene un lote específico.

Parámetros de ruta
loteIdRequeridointeger
Identificador único del lote.
Respuesta

Objeto correspondiente al lote solicitado.

POST/lotes

Crea un nuevo lote de documentos con estado Nuevo.

Parámetros de cuerpo
nombreRequeridostring
Máximo 250 caracteres.
periodoRequeridostring
Formato MM-YYYY.
comentariostring
Máximo 500 caracteres.
Respuesta

Éxito estándar con el nuevo lote creado.

POST/lotes/{loteId}/cargar-documentos

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.

El parámetro 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.
Ejemplo multipart/form-data
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--
Parámetros de ruta
loteIdRequeridointeger
Lote al que se cargará el archivo.
Parámetros de cuerpo
archivoRequeridomultipart file / Base64
PDF o ZIP con los documentos a cargar.
nombreRequeridostring
Nombre agrupador visible para los empleados. Máximo 250 caracteres.
tipoDocumentoIdinteger
Si se omite, se usa el tipo por defecto de la empresa.
validarAlTerminarboolean
Si es true, los documentos se validan automáticamente al finalizar la carga. Por defecto false.
Respuesta

Respuesta de éxito estándar.

POST/lotes/cargar-documentos

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.

Admite 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.
Parámetros de cuerpo
archivoRequeridomultipart file / Base64
PDF o ZIP con los documentos a cargar.
nombreRequeridostring
Nombre agrupador visible para los empleados. Máximo 250 caracteres.
tipoDocumentoIdinteger
Si se omite, se usa el tipo por defecto de la empresa.
nombreLoteRequeridostring
Nombre del lote destino. Máximo 250 caracteres. Se crea si no existe.
periodoLoteRequeridostring
Formato MM-YYYY. Se crea el lote si no existe con ese nombre y periodo.
validarAlTerminarboolean
Si es true, los documentos se validan automáticamente al finalizar la carga. Por defecto false.
Respuesta

Respuesta de éxito estándar.

POST/lotes/{loteId}/enviar

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.

Parámetros de ruta
loteIdRequeridointeger
Lote a enviar.
Respuesta

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

idinteger
Identificador único de la solicitud.
cuilstring
CUIL del empleado solicitante.
nombre / apellidostring
Nombre y apellido del solicitante.
legajostring
Legajo del solicitante.
diasSolicitadosstring
Cantidad de días solicitados.
fechaDeSolicitudstring
Formato DD/MM/AAAA.
fechaDeInicio / fechaDeFinstring
Formato DD/MM/AAAA.
estadoLicenciastring
Ver leyenda debajo.
nombreMotivostring
Nombre del motivo de la licencia.
codigoMotivostring
Código del motivo (opcional si no está configurado).

Estados posibles

Nuevo
Creada por el empleado, aún no firmada. No aparece en el listado GET /licencias; solo al consultarla por ID.
Pendiente
Generada y firmada por el empleado.
Pendiente de cancelación
El empleado solicitó cancelar una licencia aprobada; pendiente de respuesta.
Cancelada
El empleado canceló una solicitud previa.
Aprobada
Aprobada y firmada por quien aprueba licencias.
Rechazada
Rechazada y firmada por quien aprueba licencias.

Endpoints

GET/licencias

Obtiene todas las solicitudes de licencias, con filtros opcionales.

Parámetros query
cuilstring
CUIL del empleado solicitante.
legajostring
Legajo del empleado solicitante.
nombre / apellidostring
Del empleado solicitante.
fechaDeSolicitudDesdestring
Enviar junto con fechaDeSolicitudHasta.
fechaDeSolicitudHastastring
Enviar junto con fechaDeSolicitudDesde.
fechaDeInicioDesdestring
Formato DD/MM/AAAA. Enviar junto con fechaDeInicioHasta.
fechaDeInicioHastastring
Formato DD/MM/AAAA. Enviar junto con fechaDeInicioDesde.
fechaDeFinDesdestring
Formato DD/MM/AAAA. Enviar junto con fechaDeFinHasta.
fechaDeFinHastastring
Formato DD/MM/AAAA. Enviar junto con fechaDeFinDesde.
nombreMotivo / codigoMotivostring
Motivo de licencia asociado.
estadostring
Pendiente, Pendiente de cancelación, Cancelada, Aprobada o Rechazada. No distingue mayúsculas de minúsculas.
Respuesta

Array de solicitudes de licencia según los filtros indicados.

GET/licencias/{licenciaId}

Obtiene una solicitud de licencia específica.

Parámetros de ruta
licenciaIdRequeridostring
Identificador único de la solicitud.
Respuesta

Objeto correspondiente a la solicitud deseada.

GET/licencias/motivos

Obtiene todos los motivos de licencia configurados.

Respuesta

Array con id, nombreMotivo, codigoMotivo, vacaciones.

POST/licencias/importar/consumo

Importa un consumo de días disponibles realizado por un empleado sobre un motivo de licencia.

Parámetros de cuerpo
cuilRequeridostring
Empleado que realizó el consumo.
motivoRequeridostring
Nombre o código del motivo.
diasConsumidosRequeridointeger
Cantidad de días consumidos.
fechaDeAprobacionRequeridostring
Formato DD/MM/AAAA. Fecha en que se deduce el consumo.
fechaDeInicioRequeridostring
Formato DD/MM/AAAA.
fechaDeFinRequeridostring
Formato DD/MM/AAAA.
Respuesta

Respuesta de éxito estándar.

POST/licencias/importar/periodo

Importa la cantidad de días otorgados sobre un motivo de licencia a un empleado en un periodo determinado.

Parámetros de cuerpo
cuilRequeridostring
Empleado al que se otorgan los días.
motivoRequeridostring
Nombre o código del motivo.
añoRequeridostring
Año del periodo.
diasOtorgadosRequeridointeger
Cantidad de días otorgados.
fechaDeVencimientoRequeridostring
Formato DD/MM/AAAA.
Respuesta

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

nombrestring
Descripción del feriado.
fechastring
Fecha del feriado, formato DD/MM/AAAA.

Endpoints

GET/calendarios

Obtiene los feriados asignados al calendario indicado. Si no existe un calendario con ese nombre, se devuelve error 404.

Parámetros query
nombreRequeridostring
Nombre del calendario.
Respuesta

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

POST/horarios/fichar

Carga una fichada de un empleado desde un dispositivo.

Parámetros de cuerpo
cuilRequeridostring
CUIL del empleado que fichó.
tipostring
Valores: ENTRADA o SALIDA. Tiene prioridad la configuración del dispositivo.
fechastring
Formato DD/MM/AAAA. Debe enviarse junto con hora; si se omiten ambos, se usa la fecha/hora actual.
horastring
Formato HH:mm o HH:mm:ss. Debe enviarse junto con fecha; enviar solo uno de los dos devuelve error 422.
dispositivoRequeridostring
Código del dispositivo de origen.
Respuesta

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ódigoCausa
401 UnauthorizedSe requiere autorización extra y los datos provistos son insuficientes o inválidos. Actualmente solo aplica al firmar documentos.
403 ForbiddenParámetros válidos, pero la operación no está permitida — p. ej. crear un empleado con un CUIL de otro empleado existente.
404 NotFoundNo se encontró el recurso sobre el que se intenta operar.
409 ConflictLa operación no es posible por el estado de los recursos. Suele corregirse desde la interfaz web y reintentando.
422 Unprocessable ContentParámetros inválidos: faltan obligatorios, no respetan el formato, o se envían parámetros no reconocidos.
500 Internal Server ErrorError 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

Sistema Cliente Servidor TuLegajo Crear Lote de Documentos POST /lotes Datos del Lote de Documentos Solicitar listado de Tipos de Documentos GET /documentos/tipos Listado de Tipos de Documento Subir archivo al Lote de Documentos POST /lotes/{loteId}/cargar-documentos Resultado de operación
Antes de subir el archivo puede crearse el lote y consultarse el tipo de documento a usar; el envío del archivo dispara el corte y la asignación asíncrona por CUIL.
  1. 1

    Crear Lote de Documentos

    POST/lotes

    Opcional si ya se dispone del ID de un lote existente donde cargar los archivos de liquidación.

  2. 2

    Solicitar listado de Tipos de Documentos

    GET/documentos/tipos

    Opcional si se usará el tipo por defecto de la empresa o ya se conoce el ID del tipo deseado.

  3. 3

    Subir archivo al Lote

    POST/lotes/{loteId}/cargar-documentos

    Carga 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

Sistema Cliente Servidor TuLegajo Solicitar listado de documentos GET /documentos?cuil={CUIL} Listado de documentos Firmar un documento POST /documentos/{documentoId}/firmar Resultado de operación
Cada llamada es una ida y vuelta síncrona: primero se consulta el documento pendiente de firma, luego se envía el pin de firma y se recibe el resultado.
  1. 1

    Solicitar listado de Documentos

    GET/documentos?cuil={CUIL}

    Se selecciona el documento que requiere firma; su id se usa en el paso siguiente.

  2. 2

    Firmar el documento

    POST/documentos/{documentoId}/firmar

    Solicita el firmado con el certificado del empleado. Proceso asincrónico que puede demorar varios segundos.

Historial de versiones

FechaVersiónComentario
20/10/20262.4.0Se 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/20262.3.0Se agrega Control Horario.
15/08/20262.2.2Se agregan parámetros de organigrama.
13/08/20262.2.1Se agrega parámetro esIdentificadorExtranjero en actualización de empleado.
04/02/20262.2.0Se agrega endpoint de envío de comunicaciones y envío de lote.
19/09/20252.1.5Corrección en método de endpoint de Archivos.
30/06/20252.1.4Corrección en descripción de campo "celularLaboral".
06/05/20252.1.3Se agrega validación por CUIL de archivos descargados.
24/04/20252.1.2Se corrige el tipo de parámetros en algunos endpoints.
13/12/20242.1.1Se agrega el header User-Agent.
25/09/20242.1.0Se agregan los módulos de licencias, responsables, y archivos.
05/06/20242.0.1Se agregan los endpoints para Base64.
28/05/20242.0.0Actualización de tipos de respuesta.
21/05/20241.6.0Agregado de roles de responsables.
11/11/20231.5.4Se agrega campo de etiquetas en el alta del empleado.
13/04/20231.5.3Método de consulta de campos personalizados.
14/02/20231.5.2Eliminación de parámetros legacy.
04/07/20221.5Nueva versión del módulo de licencias.
13/06/20221.4.2Agregado de sedes.
20/04/20211.3Campos personalizados de Empleado.
21/12/20201.2.3Actualización de parámetro en método de Licencias.
16/12/20201.2Agregado de Licencias.
12/05/20201.1Versión inicial.