Методы для управления должностями в организации.
Возвращает список должностей с пагинацией.
{
"status": true,
"message": "Positions retrieved successfully",
"data": {
"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"
}
],
"pagination": {
"total": 1,
"page": 1,
"limit": 20,
"pages": 1
}
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/positions",
"method": "GET"
}
}Создаёт новую должность с набором разрешений.
{
"status": true,
"message": "Position created successfully",
"data": {
"id": "ff0e8400-e29b-41d4-a716-446655440141",
"name": "Бухгалтер",
"description": null,
"permissions": ["fm.transactions.create", "fm.analysis"],
"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/positions",
"method": "POST"
}
}Возвращает одну должность по идентификатору.
{
"status": true,
"message": "Position retrieved successfully",
"data": {
"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"
},
"meta": {
"timestamp": "2026-06-14T12:00:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/positions/...",
"method": "GET"
}
}Обновляет данные должности. Все поля опциональны.
{
"status": true,
"message": "Position updated successfully",
"data": {
"id": "ff0e8400-e29b-41d4-a716-446655440141",
"name": "Старший бухгалтер",
"description": "Полный доступ к финансам",
"permissions": ["fm.transactions.create", "fm.analysis", "fm.counterparties"],
"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/positions/...",
"method": "PATCH"
}
}Удаляет должность. Связанные сотрудники не удаляются, но теряют разрешения от этой должности.
{
"status": true,
"message": "Position deleted successfully",
"data": {},
"meta": {
"timestamp": "2026-06-14T12:15:00Z",
"request_id": "...",
"path": "/api/v1/companies/.../modules/hrm/positions/...",
"method": "DELETE"
}
}