ื“ืœื’ ืœืชื•ื›ืŸ ื”ืจืืฉื™

Employee Sub-Resource Endpoints

API endpoints for employee awards, levels, settings, statistics, and recurring expenses.

Employee Awardsโ€‹

Base Path: /api/employee-awardโ€‹

GET    /api/employee-award                # List awards
GET    /api/employee-award/:id            # Get award
POST   /api/employee-award                # Create award
PUT    /api/employee-award/:id            # Update award
DELETE /api/employee-award/:id            # Delete award

Create Body:

{
  "name": "Employee of the Month",
  "year": "2025",
  "employeeId": "employee-uuid"
}

Employee Levelsโ€‹

Base Path: /api/employee-levelโ€‹

GET    /api/employee-level                # List levels
POST   /api/employee-level                # Create level
PUT    /api/employee-level/:id            # Update level
DELETE /api/employee-level/:id            # Delete level

Create Body:

{
  "level": "Senior",
  "tag": [{ "id": "tag-uuid" }]
}

Employee Settingsโ€‹

Base Path: /api/employee-settingโ€‹

Per-employee configuration, such as time tracking preferences.

GET    /api/employee-setting              # List settings
GET    /api/employee-setting/:id          # Get setting
POST   /api/employee-setting              # Create setting
PUT    /api/employee-setting/:id          # Update setting
DELETE /api/employee-setting/:id          # Delete setting

Employee Statisticsโ€‹

Base Path: /api/employee-statisticsโ€‹

Read-only aggregate statistics.

GET /api/employee-statistics/months
GET /api/employee-statistics/count
GET /api/employee-statistics/statistics

Statistics Response:

{
  "totalWorkHours": 160.5,
  "totalIncome": 8500,
  "totalExpenses": 1200,
  "totalBonuses": 500
}

Employee Recurring Expensesโ€‹

Base Path: /api/employee-recurring-expenseโ€‹

GET    /api/employee-recurring-expense                # List
GET    /api/employee-recurring-expense/:id            # Get by ID
POST   /api/employee-recurring-expense                # Create
PUT    /api/employee-recurring-expense/:id            # Update
DELETE /api/employee-recurring-expense/:id            # Delete
GET    /api/employee-recurring-expense/employee/:id   # By employee

Create Body:

{
  "categoryName": "Insurance",
  "value": 500,
  "currency": "USD",
  "startDate": "2025-01-01",
  "employeeId": "employee-uuid"
}

Employee Recent Visitsโ€‹

Base Path: /api/employee-recent-visitโ€‹

Track recently visited entities for quick access.

GET    /api/employee-recent-visit             # List recent visits
POST   /api/employee-recent-visit             # Record visit
DELETE /api/employee-recent-visit/:id         # Delete visit

Employee Notification Settingsโ€‹

Base Path: /api/employee-notification-settingโ€‹

GET    /api/employee-notification-setting                  # Get settings
POST   /api/employee-notification-setting                  # Create settings
PUT    /api/employee-notification-setting/:id              # Update settings