Cargo Service

Orchestrator · Remuneraciones

ServiceCargosCatálogo

CargoService administra el catálogo de cargos laborales. Expone operaciones de lectura y escritura para mantener posiciones, códigos, descripciones y jerarquía funcional usadas por contratos y reportes de remuneraciones.

Ubicación

Pieza	Ruta
Service	src/domain/cargos/CargoService.ts
Repository	src/domain/cargos/CargoRepository.ts
Route	src/routes/remuneraciones/cargos.ts
Tabla	remuneraciones.cargos

Métodos Disponibles

Método	Uso
findAll(tenantDb)	Lista cargos del tenant.
findById(tenantDb, id)	Obtiene un cargo por identificador.
create(tenantDb, userId, data)	Crea un cargo con auditoría de usuario.
update(tenantDb, userId, id, data)	Actualiza un cargo existente.
delete(tenantDb, id)	Elimina o desactiva según regla vigente.

Validaciones

Regla	Motivo
codigo obligatorio	Evita cargos sin identificación operativa.
nombre obligatorio	Permite lectura funcional en contratos y reportería.
Código normalizado	Reduce duplicados por diferencias de formato.
Existencia antes de update/delete	Evita operaciones sobre registros inexistentes.

Ejemplo

import { CargoService } from '@/domain/cargos/CargoService';

await CargoService.create('tenant_db', 'user-123', {
  codigo: 'GER-001',
  nombre: 'Gerente General',
  descripcion: 'Responsable de la dirección estratégica'
});

Ver También

Servicio de Cargos Lectura funcional y contable del catálogo de posiciones.

API de Remuneraciones Endpoints de cargos, departamentos, contratos y empleados.