Employees

Employees

Empleados asociados a miembros de empresa con datos laborales.

POST /api/companies/{companyId}/employees/v1

Crear empleado

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅

Request Body (requerido ✅)

{
    "memberId": "00000000-0000-0000-0000-000000000000",
    "position": "Cajero",
    "department": "Ventas",
    "startDate": "2024-01-15"
  }

Respuestas

201

Empleado creado exitosamente

{
    "id": "00000000-0000-0000-0000-000000000000",
    "memberId": "00000000-0000-0000-0000-000000000000",
    "position": "position",
    "department": "department",
    "startDate": "2024-01-15",
    "status": "ACTIVE",
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

GET /api/companies/{companyId}/employees/v1

Listar empleados activos

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅

Respuestas

200

Lista de empleados

{
    "id": "00000000-0000-0000-0000-000000000000",
    "memberId": "00000000-0000-0000-0000-000000000000",
    "position": "position",
    "department": "department",
    "startDate": "2024-01-15",
    "status": "ACTIVE",
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

GET /api/companies/{companyId}/employees/v1/{id}

Obtener empleado por ID

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅
id	string	✅

Respuestas

200

Datos del empleado

{
    "id": "00000000-0000-0000-0000-000000000000",
    "memberId": "00000000-0000-0000-0000-000000000000",
    "position": "position",
    "department": "department",
    "startDate": "2024-01-15",
    "status": "ACTIVE",
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

PATCH /api/companies/{companyId}/employees/v1/{id}

Actualizar empleado

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅
id	string	✅

Request Body (requerido ✅)

{
    "position": "position",
    "department": "department",
    "startDate": "2024-01-15"
  }

Respuestas

200

Empleado actualizado

{
    "id": "00000000-0000-0000-0000-000000000000",
    "memberId": "00000000-0000-0000-0000-000000000000",
    "position": "position",
    "department": "department",
    "startDate": "2024-01-15",
    "status": "ACTIVE",
    "createdAt": "2024-01-15T10:00:00Z",
    "updatedAt": "2024-01-15T10:00:00Z"
  }

---

DELETE /api/companies/{companyId}/employees/v1/{id}

Dar de baja empleado

Parámetros

Nombre	Tipo	Requerido	Descripción
companyId	string	✅
id	string	✅

Respuestas

204

Empleado dado de baja exitosamente

---

Schemas

CreateEmployeeRequest

Campo	Tipo	Requerido	Descripción
memberId	string (uuid)	✅	ID del CompanyMember
position	string ej: “Cajero”	❌
department	string ej: “Ventas”	❌
startDate	string (date) ej: “2024-01-15”	❌

EmployeeResponse

Campo	Tipo	Requerido	Descripción
id	string (uuid)	❌
memberId	string (uuid)	❌
position	string	❌
department	string	❌
startDate	string (date)	❌
status	EmploymentStatus	❌
createdAt	string (date-time)	❌
updatedAt	string (date-time)	❌

UpdateEmployeeRequest

Campo	Tipo	Requerido	Descripción
position	string	❌
department	string	❌
startDate	string (date)	❌