Методы для управления сотрудниками организации.
Возвращает список сотрудников с пагинацией и поиском.
{
"status": true,
"message": "Employees retrieved successfully",
"data": {
"employees": [
{
"id": "a00e8400-e29b-41d4-a716-446655440150",
"first_name": "Иван",
"last_name": "Петров",
"email": "ivan@example.com",
"phone": "+79000000000",
"status": "active",
"is_account_linked": true,
"account_id": "550e8400-e29b-41d4-a716-446655440001",
"linked_at": "2026-04-24T00:20:54Z",
"created_at": "2026-04-24T00:17:05Z",
"updated_at": "2026-06-14T00:00:00Z"
}
],
"pagination": {
"total": 1,
"page": 1,
"limit": 20,
"pages": 1
}
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/employees",
"method": "GET"
}
}Создаёт новую карточку сотрудника. Сотрудник не обязан быть зарегистрирован на платформе.
{
"status": true,
"message": "Employee created successfully",
"data": {
"id": "a00e8400-e29b-41d4-a716-446655440151",
"first_name": "Пётр",
"last_name": null,
"email": null,
"phone": null,
"status": "active",
"is_account_linked": false,
"account_id": null,
"linked_at": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:05:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:05:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/employees",
"method": "POST"
}
}Возвращает карточку сотрудника со списком должностей.
{
"status": true,
"message": "Employee retrieved successfully",
"data": {
"id": "a00e8400-e29b-41d4-a716-446655440150",
"first_name": "Иван",
"last_name": "Петров",
"email": "ivan@example.com",
"phone": "+79000000000",
"status": "active",
"is_account_linked": true,
"account_id": "550e8400-e29b-41d4-a716-446655440001",
"linked_at": "2026-04-24T00:20:54Z",
"positions": [
{
"id": "ff0e8400-e29b-41d4-a716-446655440140",
"name": "Менеджер",
"description": "Работа с клиентами и сделками",
"permissions": ["crm.clients", "dm.deals.create"],
"created_at": "2026-04-24T00:20:54Z",
"updated_at": "2026-06-14T00:00:00Z"
}
],
"created_at": "2026-04-24T00:17:05Z",
"updated_at": "2026-06-14T00:00:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/employees/...",
"method": "GET"
}
}Обновляет данные сотрудника.
{
"status": true,
"message": "Employee updated successfully",
"data": {
"id": "a00e8400-e29b-41d4-a716-446655440151",
"first_name": "Пётр",
"last_name": "Сидоров",
"email": "petr@example.com",
"phone": "+79000000001",
"status": "active",
"is_account_linked": false,
"account_id": null,
"linked_at": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:10:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:10:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/employees/...",
"method": "PATCH"
}
}Деактивирует карточку сотрудника. После деактивации сотрудник не может быть назначен ответственным.
{
"status": true,
"message": "Employee deactivated successfully",
"data": {
"id": "a00e8400-e29b-41d4-a716-446655440151",
"first_name": "Пётр",
"last_name": "Сидоров",
"email": "petr@example.com",
"phone": "+79000000001",
"status": "inactive",
"is_account_linked": false,
"account_id": null,
"linked_at": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:15:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:15:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/employees/.../deactivate",
"method": "POST"
}
}Активирует ранее деактивированную карточку сотрудника.
{
"status": true,
"message": "Employee activated successfully",
"data": {
"id": "a00e8400-e29b-41d4-a716-446655440151",
"first_name": "Пётр",
"last_name": "Сидоров",
"email": "petr@example.com",
"phone": "+79000000001",
"status": "active",
"is_account_linked": false,
"account_id": null,
"linked_at": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:20:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:20:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/employees/.../activate",
"method": "POST"
}
}Привязывает аккаунт платформы Kroncl к карточке сотрудника. Аккаунт наследует разрешения от должностей сотрудника.
{
"status": true,
"message": "Employee updated successfully",
"data": {
"id": "a00e8400-e29b-41d4-a716-446655440151",
"first_name": "Пётр",
"last_name": "Сидоров",
"email": "petr@example.com",
"phone": "+79000000001",
"status": "active",
"is_account_linked": true,
"account_id": "550e8400-e29b-41d4-a716-446655440001",
"linked_at": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:10:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:10:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/employees/...",
"method": "PATCH"
}
}Отвязывает аккаунт платформы от карточки сотрудника.
{
"status": true,
"message": "Employee updated successfully",
"data": {
"id": "a00e8400-e29b-41d4-a716-446655440151",
"first_name": "Пётр",
"last_name": "Сидоров",
"email": "petr@example.com",
"phone": "+79000000001",
"status": "active",
"is_account_linked": false,
"account_id": null,
"linked_at": null,
"created_at": "2026-06-14T12:05:00Z",
"updated_at": "2026-06-14T12:10:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:10:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/employees/...",
"method": "PATCH"
}
}Назначает сотрудника на должность. Сотрудник наследует все разрешения должности.
{
"status": true,
"message": "Employee retrieved successfully",
"data": {
"id": "a00e8400-e29b-41d4-a716-446655440150",
"first_name": "Иван",
"last_name": "Петров",
"email": "ivan@example.com",
"phone": "+79000000000",
"status": "active",
"is_account_linked": true,
"account_id": "550e8400-e29b-41d4-a716-446655440001",
"linked_at": "2026-04-24T00:20:54Z",
"positions": [
{
"id": "ff0e8400-e29b-41d4-a716-446655440140",
"name": "Менеджер",
"description": "Работа с клиентами и сделками",
"permissions": ["crm.clients", "dm.deals.create"],
"created_at": "2026-04-24T00:20:54Z",
"updated_at": "2026-06-14T00:00:00Z"
}
],
"created_at": "2026-04-24T00:17:05Z",
"updated_at": "2026-06-14T00:00:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/employees/...",
"method": "GET"
}
}Снимает сотрудника с должности. Разрешения от должности перестают действовать.
{
"status": true,
"message": "Employee retrieved successfully",
"data": {
"id": "a00e8400-e29b-41d4-a716-446655440150",
"first_name": "Иван",
"last_name": "Петров",
"email": "ivan@example.com",
"phone": "+79000000000",
"status": "active",
"is_account_linked": true,
"account_id": "550e8400-e29b-41d4-a716-446655440001",
"linked_at": "2026-04-24T00:20:54Z",
"positions": [
{
"id": "ff0e8400-e29b-41d4-a716-446655440140",
"name": "Менеджер",
"description": "Работа с клиентами и сделками",
"permissions": ["crm.clients", "dm.deals.create"],
"created_at": "2026-04-24T00:20:54Z",
"updated_at": "2026-06-14T00:00:00Z"
}
],
"created_at": "2026-04-24T00:17:05Z",
"updated_at": "2026-06-14T00:00:00Z"
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/employees/...",
"method": "GET"
}
}